How to install OpenLM Log Reader on UNIX/Linux

The purpose OpenLM Log Reader is to send the information from FLEXlm report log to OpenLM server. You have to install OpenLM Log Reader on every FLEXlm server you monitored by OpenLM. If you have more then one FLEXlm server installed on one server you will need only one installation on the server, it will monitor all the log files.

OpenLM Log Reader was developed using Java so it can run on any operating system supported by FLEXlm floating license manager.

First download OpenLM Log Reader software from OpenLM website downloads area. The download include the following files and folders:

Main folder: openlm_log_reader

lib - Java libraries used by OpenLM Log Reader.
openlm_log_reader.jar - Log Reader executable.
openlm_log_reader_config.xml - OpenLM Log Reader configuration file.
openlm_log_reader.properties - Logger properties.

The steps we need in order to accomplish the task are:
1. Make sure that JRE with version of at least 1.5 is available on the machine (where you typically install software /usr/local).
2. Copy the software to the FLEXlm server (where you typically install software /usr/local).
3. Create a software service that will start with the operating system and run in the background (command: java -jar MyLogReader.jar config.xml).
4. Configure the software.


Configure the path of your log file (Optional)

Edit openlm_log_reader.properties and modify the log file path so it will fit your installation. By default it will create a directory named log under the installation folder.

Configure OpenLM Log Reader (Mandatory)

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 it shows 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.