Get a license

In this topic:
Determining the FlexNet hostid of a Linux machine Determining the FlexNet hostid of a Windows machine Choosing the proper FlexNet host ID on Windows

A Klocwork license file contains information about your license server configuration as well as what Klocwork products and features you are licensed to use. You need a license file to start the Klocwork Servers. If you are upgrading to the latest version of Klocwork, and this involves moving to a new major release, for example, from release 2019.x to Klocwork 2020.x, contact license@perforce.com to request a new license. Upgrading to a new major release of the software requires a new license.

Klocwork uses FlexNet Publisher licensing from Flexera Software. Your Klocwork license must be locked to your license manager server. In the simplest case, this will be the machine where you install the Klocwork Server package.

If you are evaluating or purchasing Klocwork, you will need to provide your Klocwork contact with:

the FlexNet host ID, host name, and IP address of the relevant computer
the host ID of the dongle if you are using a Flexera Software FlexNet ID Dongle

The following sections show you how to determine this ID.

Note: You must install the License tools component of the Klocwork Server installer in order for these FlexLM binaries to be installed.

Determining the FlexNet hostid of a Linux machine

When you install Validate, lmhostid is installed to <validate_install>/3rdparty/bin.

In an xterm, cd to the location of lmhostid, for example:
```
bash-2.04$ cd /home/validate/3rdparty/bin
```
Run lmhostid, for example:
```
bash-2.04$ ./lmhostid 
```
You see output resembling the following: lmhostid - Copyright (c) 1989-2016 Flexera Software LLC. All rights reserved. The FlexNet host ID of this machine is "000437d58057".
Send the FlexNet host ID, host name, and IP address to your Klocwork contact. If the output lists more than one host ID, select one of them.

Determining the FlexNet hostid of a Windows machine

When you install Validate, lmhostid is installed to <validate_install>/3rdparty/bin.

Open a command window.
In the command window, cd to the directory where lmhostid is installed, for example:
```
C:\>cd C:\Perforce\Validate_22.2\3rdparty\bin
```
Run lmhostid, for example:
```
C:\Perforce\Validate_22.2\3rdparty\bin>lmhostid
```
You see output resembling the following:
lmhostid - Copyright (c) 1989-2016 Flexera Software LLC. All Rights Reserved. The FlexNet host ID of this machine is "0003e9d454ed"
Send the FlexNet host ID, host name, and IP address to your Validate contact. If the output lists more than one host ID, select one of them.

Choosing the proper FlexNet host ID on Windows

On Windows, the lmhostid utility may return more than one FlexNet host ID. If this happens, ensure that you choose the correct host ID for the license file.

Running lmhostid for a Windows server results in output resembling the following:

lmhostid - Copyright (c) Copyright (c) 1989-2016 Flexera Software LLC. All rights reserved. The FlexNet host ID of this machine is ""00F0D0579C60 0003764D1BD6 00C026000002 00C038000101"" Only use ONE from the list of hostids.

In this example, lmhostid returned four FlexNet host IDs. It is important to select the FlexNet host ID of a permanent physical network adapter, rather than a virtual NIC, for example a Virtual Private Network (VPN) NIC. Therefore, you need to determine which FlexNet hostid applies to a permanent network adapter.

To list all network adapters in a Windows system:

Open a command window.
Enter the following:
```
ipconfig /all
```

The following example shows the ipconfig /all output for a Windows server with a built-in network adapter. Note that on Windows, the FlexNet host ID is the physical address (the MAC address), without the hyphens.

Windows IP Configuration
Host Name . . . . . . . . . . . . : TDM02
Primary DNS Suffix . . . . . . . : klocwork.com
...
...
Ethernet adapter Local Area Connection 4:
Connection-specific DNS Suffix . :
Description . . . . . . . . . . . : 3Com 3C920 Integrated Fast Ethernet Controller (3C905C-TX Compatible)
Physical Address. . . . . . . . . : 00-F0-D0-57-9C-60
DHCP Enabled. . . . . . . . . . . : Yes
...
...
Ethernet adapter Local Area Connection:
Media State . . . . . . . . . . . : Media disconnected
Description . . . . . . . . . . . : 3Com 10/100 Mini PCI Ethernet Adapter
Physical Address. . . . . . . . . : 00-03-76-4D-1B-D6
Ethernet adapter Local Area Connection 3:
Media State . . . . . . . . . . . : Media disconnected
Description . . . . . . . . . . . : VPN Client Virtual Adapter #2
Physical Address. . . . . . . . . : 00-C0-26-00-00-02
Ethernet adapter Local Area Connection 2:
Media State . . . . . . . . . . . : Media disconnected
Description . . . . . . . . . . . : VPN Client Virtual Adapter
Physical Address. . . . . . . . . : 00-C0-38-00-01-01

In this example, Local Area Connection 4 is a physical adapter and is currently enabled. It would be advisable to lock the license to this adapter (MAC address 00-F0-D0-57-9C-60 which corresponds to the FlexNet host ID 00F0D0579C60), because this FlexNet host ID will not change. Local Area Connection is a physical adapter but is not enabled. Local Area Connection 2 and Local Area Connection 3 are virtual adapters and may have their MAC address changed periodically. If you are not sure which to choose, ask your administrator to choose the MAC address of one of the permanent physical adapters.