License Manager
The Icam License Manager (IcamLM) utility provides tools to check license availability and perform other license-related tasks. The license manager may be started either from the Start menu or from the Icam Portal. In the descriptions that follow, keep in mind that with node-locked licenses, the server and client computer are the same, and that the license manager can be run from either perspective depending on where it is started from.
To start the license manager utility from a client computer Start menu, first locate the “Icam V27 x64” Start menu and then select “License Manager (CLIENT)”. To start the utility from the Icam portal, select the Tools pane and click on the “Icam License Manager (CLIENT)” tile or icon.
To start the license manager utility from the license server computer Start menu, first locate the “Icam License Server V27 x64” Start menu and then select “License Manager (SERVER)”.
You will see a window that looks similar to the one shown below.
The title bar of the license manager window lists the server connection information.
Each line in the top half of the window lists a licensed product and its options, along with the maximum number of licenses that are available and the actual number in use. It also shows the hostname or IP address of each computer that has the license checked out.
The bottom half of the window traces the activity of the license
server. From left to right this includes: the date and time of the
action; a 3-letter code describing the action; the client hostname or
IP address, or “icamlm” if it is a server-related action; followed by
the action data (e.g., the license that was checked out). Select
Help»
The license manager functions available on the Setup menu depend on whether the manager is being run from the client or from the server.
License Manager (CLIENT)
The CLIENT version of the license manager is responsible for
establishing a connection to the Icam license server. Server
connection information is contained in the icam.key file, which is
either stored in the Icam application data directory (e.g.,
C:\
License commuting: Starting with V26, licenses can be commuted for offline use. The following rules and limitations apply:
A license can be commuted for a maximum of 7 days.
At least 2 licenses must be available to commute one.
Only licenses of version 260 or later can be commuted.
To commute or return a commuted license, right-click on the license.
The following functions are available from the Setup menu:
Server Connection: This dialog establishes a connection to an Icam floating license server. You can drag and drop an icam.key file onto this dialog, or browse for the key file, to establish a connection to the server identified in the key file.
You can set up the server connection manually, by entering the port number and name or IP address of the license server computer. A “Find LAN Servers” button will search for running Icam license servers on the same LAN only (i.e., it cannot find a server that is one or more network hops away). For cloud servers, you must also enter the cloud security ID string that was given to you by the Icam licensing department (keyfiles@icam.com), and your computer must have an Internet connection.
Change Password: A password can be set up to restrict access to changes to the client computer list from the license manager running on a client computer. To change it from the client license manager, you must enter the current password.
Manage Client List: See below.
License Manager (SERVER)
The SERVER version of the license manager is responsible for
configuring Icam product licenses and license server options.
Icam product license information is contained in the
icamls.key file in the Icam server application data directory
(e.g., C:\
The following functions are available from the Setup menu:
Update Key File: Use this function when a new icamls.key file is received from Icam. You can drag and drop the new key file onto this dialog, or browse for the key file, or open the key file directory to facilitate copying the updated key file directly there.
Server Options:
Port: Set the primary port number to be used by the license server, which will become effective once all current licenses have been checked in, or following the next reboot or license server restart. Each client computer’s icam.key license server connection file must be edited to specify the changed port number.
Client Type: Specifies how the license server identifies clients. Clients may be recorded by computer name or by user name (including Windows user and/or company domain). By default, the license server uses the client type specified in the license, which in most cases is the computer name. Selecting computer name or user name explicitly overrides the license-based setting.
Server Log Settings: Defines the use, location and contents of a licensing activity log file. These changes become effective immediately.
Change Password: A password can be set up to restrict access to changes to the client computer list from the license manager running on a client computer. The current password is shown. If there is no password (the default) then the current password field will be empty. To create or change the password, enter the new password and repeat it, then press OK. To remove the current password, simply press OK without specifying a new password. Press Cancel to exit the dialog without changing the password.
Manage Client List: This dialog lists all client computers that have ever connected to the license server and checked out a license. The list of clients is maintained on a first-come, first-served basis. If all client spaces have been used, then new client computers cannot check out licenses. You can remove obsolete client computers from this list by selecting them and pressing the Remove Client button. When doing so from a client license manager, you must enter the password if one has been set up with the server license manager. Removing obsolete client computers from the list frees up space for new client computers.
Note that once a client computer has been removed from the list, it is not eligible to check out licenses until the listed time limit has elapsed.