PMOD License Server Installation

PMOD Software Installation

The computer for the PMOD license server doesn't require a high performance, but needs to be running continually. Therefore, a robust, vintage machine is well suited as a PMOD license server. Preferably, it is also dedicated to serving the PMOD license, because the license server is a standard process rather than a Windows service.

To install the PMOD license server first perform the steps described in the Stand-Alone PMOD installation including copying of the license file and plugging the USB key in.

Multiple Licenses Management

A license server can manage multiple licenses simultaneously. In order to use this feature please rename the different license files (pstarter.lcs) by appending the license numbers (pstarter860.lcs, pstarter912.lcs, ...) and copy them into the Pmod3.5/properties/system/lcs folder.

Starting the License Server

The PMOD license server can then be started by executing the Pmod3.5/Start/RunLcsSvr.bat script containing the following lines

C:
cd "C:\Pmod3.5"
.\java\jre\bin\java -Xmx2G-jar pmtsvr.jar 5000 -ls -d
Pause

The meaning of the command arguments is:
5000: IP port over which the license server communicates
-ls: license server only, no data sharing
-d: verbose output

Note: The script has been tailored to the installation directory. Therefore, if the Pmod3.5 directory is moved to a different location, the path needs to be adjusted. The USB key needs to remain connected at all times during license server operation.

Log Output

The command window will show startup information and log the checking out/in events as illustrated below. In this example, two clients are started, and then the one of them is stopped again.

C:\Pmod3.5\Start>C:
C:\Pmod3.5\Start>cd "C:\Pmod3.5"
C:\Pmod3.5>.\java\jre\bin\java -Xmx1200M -jar pmtsvr.jar 5000 -ls -d
***
Started on license [912]
***
License Server [Version 3.501 A (c) 1996 - 2012 by PMOD Technologies]
Verbose: true, Secure: false, Compressed: false
***
Port: 5000
Started on: PMOD-ASUS/192.168.55.109
License Server: [ ON ] STANDALONE, Number of Server Licenses: 3
Memory Assigned: 1160 MB
--> License Server started [Tue Oct 25 15:38:19 CEST 2011] : on port 5000
[20111025 15:39:27.890] LCS: ADDED CLIENT [192.168.55.102-192.168.55.102].
Active LCS clients:
1) 192.168.55.102-192.168.55.102
Number of free licenses: 2

2011.10.25 - 15:39:28 [5000] -> 192.168.55.102 -> GET TS Version -> 3.501

[20111025 15:39:41.156] LCS: ADDED CLIENT [192.168.55.102-192.168.55.102].
Active LCS clients:
1) 192.168.55.102-192.168.55.102
2) 192.168.55.102-192.168.55.102
Number of free licenses: 1

2011.10.25 - 15:39:41 [5000] -> 192.168.55.102 -> GET TS Version -> 3.501
[20111025 15:39:54.234] LCS Command: REMOVED CLIENT [192.168.55.102-192.168.55.102]. Active clients:
1) 192.168.55.102-192.168.55.102
Number of free licenses: 2

Emergency Restart

In the case of connection or license management problems the following procedure is recommended for restoring clean license handling:

1. Stop the license server.
2. Delete the contents of the Pmod3.5/properties/system/lcs/lct/ directory.
3. Start the license server again.

If this procedure is completed within 5 minutes, no shutdown of running PMOD clients is required.

Client Processing on License Server Machine

Although it is not recommended, client processing can be done on the same machine. To do so, a second PMOD installation has to be prepared as follows:

1. Copy Pmod3.5 to Pmod3.5LS. Pmod3.5 will be used for client processing, Pmod3.5LS for license serving.
2. Ensure that the license file (pstarter.lcs) is copied to Pmod3.5LS/properties/system/lcs.
3. Remove the license file from Pmod3.5/properties/system/lcs.
4. Modify Pmod3.5LS/Start/RunLcsSvr.bat to use the new path (Pmod3.5LS). Remove the other .bat files from this Start directory.
5. Remove RunLcsSvr.bat from Pmod3.5/Start.
6. Use Windows Switch User to login as different user (dedicated to run the License Server) e.g.: admin.pmod.
7. Start Pmod3.5LS/Start/RunLcsSvr.bat as admin.pmod user.
8. Switch back to the standard user and run Pmod3.5/Start/RunPmod.bat. Provide the computer name or the local IP to access the license server.

Please note that you need to provide proper RW privileges:

• admin.pmod - RW access to Pmod3.5LS
• other Pmod users - RW access to Pmod3.5
• all other non-Pmod users - no access to Pmod3.5 nor Pmod3.5LS

In this way the License Server will be running for all users, as long as the computer is not shut down.