Sunday, August 10, 2008

How to install OpenLM Log Reader on your FLEXlm server

What is the purpose of OpenLM Log Reader?

OpenLM Log Reader is a daemon service that reads FLEXlm debug log file and sends the information to OpenLM Server.

The action enables OpenLM to offer additional capabilities:

  • Store important information in OpenLM Database.
  • Store and report information about license denials that users experience.
  • Send users notice when the software they need becomes available.

How is the OpenLM Log Reader implemented?

OpenLM is a Java program that can run on multiple platforms - Windows, UNIX, Linux and more. OpenLM Log Reader for Windows is distributed with an MSI installer that installs the files to the hard disk and creates a windows service called: OpenLM Log Reader.

How to install?

OpenLM Log Reader on Windows Installation is a typical "Next, Next" installation. Double Click the MSI file and follow the instructions. Following to the software installation a new service is added to windows services. The service is yet to be configured and theretofore will not get started just yet.



Requirements

OpenLM Log Reader service configuration requires some data regarding the monitored license manager. It is simple to collect the information by using LMTOOLS program - lmtools.exe.

Open LMTOOLS and go to the "Config Services" tab. Locate the path of FLEXlm debug log file and copy and save it for the next step.

Once done, go to the "Services" tab and click the "Perform Status Inquiry" button. The text will show in the window in the top search for the string similar to: 27000@license_server_status

You will need the port and server name for the next stage.


OpenLM Log Reader configuration

You have to configure OpenLM Log Reader so it will be able to track your log file.

Navigate to OpenLM Log Reader installation folder: C:Program FilesGlobalMapsOpenLMLogReader

Open the file config.xml using your favorite text editor.

You need to modify several parameters in order to allow OpenLM Log Reader, to read and send the information to the OpenLM Server. The required information is:

  1. The name of OpenLM server.
  2. The name of FLEXlm server (exactly as shown in FLEXlm output).
  3. The port of FLEXlm server.
  4. Path to FLEXlm debug log file.

An example (attributes that need to be edited are marked red):

<ulm>
<receiver receiver_url="http://openlm_server:7016/OpenLMServer" sending_time_out="45"/>

<log_files>
<log server="license_manager_name" port="27000" file_path="C:Templmgrd9.log" size_limit="1" time_interval="10"/>
<log server="license_manager_name" port="9857" file_path="C:Tempacadlmgrd_acad.log" size_limit="1" time_interval="10"/>
...
</log_files>
</ulm>

Any number of port/files can be added, according to the number of FLEXlm servers that run on the machine. When you are done with all the modifications, restart the OpenLM Log Reader server.


No comments: