Get a license

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 uses Reprise License Manager from Reprise 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 Reprise host ID, host name, and IP address of the relevant computer
The following sections show you how to determine this ID.

When you install the Validate Server package, rlmhostid is installed to <validate_install>/3rdparty/bin.

  1. In an xterm, cd to the location of rlmhostid, for example: 
    bash-2.04$ cd /home/validate/3rdparty/bin
  2. Run rlmhostid, for example: 
    bash-2.04$ ./rlmhostid

    You see output resembling the following: 

    rlmhostid v14.2
Copyright (C) 2006-2021, Reprise Software, Inc. All rights reserved.

Hostid of this machine: 26be688ebb04
  3. Send the Reprise host ID, host name, and IP address to your Validate contact. If the output lists more than one host ID, select one of them.

Determining the Reprise hostid of a Windows machine

When you install the Validate Server package, rlmhostid is installed to <validate_install>/3rdparty/bin.

  1. Open a command window.
  2. In the command window, cd to the directory where rlmhostid is installed, for example: 
    C:\>cd C:\Perforce\Validate_22.2\3rdparty\bin
  3. Run rlmhostid, for example: 
    C:\Perforce\Validate_22.2\3rdparty\bin>rlmhostid ether

    You see output resembling the following:

    rlmhostid v14.2


Copyright (C) 2006-2021, Reprise Software, Inc. All rights reserved.

Hostid of this machine: 747827e3990f
  4. Send the Reprise 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 Reprise host ID on Windows

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

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

rlmhostid v14.2 

Copyright (C) 2006-2021, Reprise Software, Inc. All rights reserved. 

Hostid of this machine: 747827e3990f 00059a3c7a00 7cb27d82731e 00155d09ba11 00155d09ba17

In this example, rlmhostid returned five Reprise host IDs. It is important to select the Reprise 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 Reprise hostid applies to a permanent network adapter.

To list all network adapters in a Windows system:

  1. Open a command window.
  2. 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 Reprise 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 Reprise host ID 00F0D0579C60), because this Reprise 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.