Installing Polar software – versions 15.10 and later
Application Note AP618 

Installing Polar software v15.10 and later

Versions 15.10 and later versions of Polar software are based on FlexNet Publisher v11.13.1.2. Please read these notes carefully prior to installing or upgrading from earlier versions.

Upgrading floating license installations from FlexNet Publisher v10.8.7 to v11.13.1.2

For floating license installations Flexera recommends the server side is at the same version (or higher) than the clients. So existing users moving client side to 2016 versions of Speedstack and Si8000m / Si9000e / CGen also need to upgrade the server side to FlexNet Publisher v11.13.1.2

Choosing a log file location

A standard Polar server side installation for a floating license application will create a folder on the server:

  • C:\ProgramFiles\FlexLm\V11.13.1.2 for a 32-bit installation
  • C:\ProgramFiles (x86)\FlexLm\V11.13.1.2 for a 64-bit installation

This folder will, by default, contain the license manager, lmgrd.exe, the license file and the debug log file.

On the latest versions of FlexNet Publisher the service account is used for security purposes, so if you perform a standard server side installation using the Program Files folder there may be restrictions on writing to the log file. If the server will not start using the default path settings try relocating the log file to a public folder – or create a folder with appropriate read/write access outside the Program Files folder structure (e.g. C:\Logfiles).

Setting FLEXLM_TIMEOUT for slow or remote network connections

If the license server is accessed over a slow connection or from a remote location it may be necessary to set each client's FLEXLM_TIMEOUT environmental variable to allow sufficient time for the client machine to contact the server. By default, software based on FlexNet Publisher v11.13.1.x times out in 0.1 seconds (100000 microseconds) – set the FLEXLM_TIMEOUT environmental variable (in microseconds) to a value of 3000000. If necessary, increase the timeout value in increments of 1000000 until a license is obtained (acceptable values range from 0 – 2,147,483,647 microseconds.)

Download the server side installer.

Upgrading license files for FlexNet Publisher v11.13.1.2

Version 11.13.1.2 applies more stringent filtering than earlier versions to ethernet addresses that could be removable, such as virtual device addresses, Bluetooth addresses and wireless USB dongles. Version 11.13.1.2 of LMTOOLS utility may well therefore report fewer available ethernet addresses than earlier versions (see the LMTOOLS sample System Settings screen below.)

If you are upgrading from an earlier version of Polar software it may be necessary to request an updated license file if the addresses referenced by a license file are no longer seen by the license manager. If you have either node-locked or 5/1 licenses you may therefore need to resubmit your HOSTID information for Polarcare to generate a new license in order for your 15:10 license to reactivate.

Installing Polar node locked software — versions 15.10 and later

The node locked versions of Polar software look for a license file on the machine containing the software. The license file is based on the machine's ethernet address or, if a hardware key is purchased, on the serial number of the key (etched on the body of the key).

Installing hardware key drivers

If a hardware key has been purchased it will be necessary to install the key drivers (available from the Polar web site support page.) See Application Note AP620 for details.

Generating the license file

To generate the license file it will be necessary to gather information that uniquely identifies your system.

Requesting a node-locked license

Use Windows Explorer to browse to the C:\Program Files\Polar\Licences folder and run lmtools.exe.

From within LMTOOLS select System Settings (see screen shot below.)

If you are using a hardware key, ensure the key is installed as described in Application Note AP620 and that the FLEXID field is populated. The number shown should match the number etched on the hardware key. If the field is empty please contact your local Polar Representative.

System Settings

Save this information by selecting the Save HOSTID Info to a File. Enter a filename, choose a suitable folder location and select Save. The LMTOOLS utility may now be closed.

Requesting a floating 5/1 license

If you are requesting a floating (5/1) license you will need to install the server side licensing software (available from the Polar web site support page) on the target server and the Polar software on each client machine.

Download the server side installer and install on the target license server. Extract the files to a suitable folder and run SETUP.EXE from that folder.

This will create a folder on the server which by default is: C:\ProgramFiles\FlexLm\V11.13.1.2

Note: If you choose a different file location (for example, for a custom installation) do not use the name POLAR for any of the folders within the installation folder structure – it will conflict with the name of the Polar vendor daemon (POLAR.EXE) and prevent the license manager from serving licenses.

Install the Polar application software on each client machine.

Obtaining the server and client ethernet addresses

Run the LMTOOLS utility as described above on the server and on each client machine.

Email the server and client HOSTID file(s) created to polarcare@polarinstruments.com. The license file will be returned to you shortly.

Installing the license file

Once you have received the license file please complete the installation procedure below.

Node locked licenses

On a node-locked machine we recommend that you place the license file into the \Polar\Licences folder.

The Polar application software should locate the license file automatically – if not, the License Finder dialog should be displayed as decribed below; follow the instructions below to select the license file.

Floating licenses

For floating licenses the license file should be copied to the server side installation folder (by default: C:\ProgramFiles\FlexLm\V11.13.1.2 as described above.)

Use Windows Explorer to copy the license file to this location. Configure the server and Windows firewalls and start the license server as described in AP606.

Using the License Finder

Start the application program on each client machine (via the Windows Start menu or using the icon on the Windows desktop). During start up the software License Finder will prompt for a License File / Server location.

License finder 1

The License Finder prompts for the server or license file name.

Supply the name of the server or the license file name as described below.

Enter the path/filename or click the Browse button to navigate to the file. (Using the Choose License File Dialog, browse to C:\Program Files\Polar\Licences and select the license file. Select Open. The License Finder will display the license file specified. See note above relating to timeouts when contacting the server.

License finder 2

Select Next to continue. The License Finder should display its completion message. Click Finish.

License finder 3

The software may display a message to indicate how many days are remaining before the license expires.
Select OK to continue.