Contents

• What is PQ Systems License Manager?
• Preparing to install PQ Systems License Manager
• Installing PQ Systems License Manager
• Administering PQ Systems License Manager
• Uninstalling PQ Systems License Manager

What is PQ Systems License Manager?

This document is available on the web here.

The PQ Systems License Manager (PQLM), referred to as the license manager in this document, is used to support the concurrent-user license model with PQ Systems software products. It is not used for the per-computer license model. Please refer to the concurrent-user license information page for more information about this license model.

The license manager is installed as a Windows service on one computer in your network.

IMPORTANT: Unless you obtain specific written permission from PQ Systems, you are only authorized to run a single instance of the license manager within your network. To do otherwise is in violation of your concurrent-user license agreement.

When a user starts a PQ Systems application (licensed under the concurrent-user license model) on a computer in your network, the license manager is contacted to verify that the application may run based upon the number of users who are concurrently running the application at that time.

Preparing to install PQ Systems License Manager

Obtain the license manager setup program. This setup should be available on the PQ Systems' Quality Suite CDROM, however if you have internet access please download the most current version of the setup program here.

Follow these steps to prepare to install the license manager at your site.

1. The license manager is installed as a Windows service on one computer in your network. Determine which computer will be used to run the license manager service. It is strongly recommended that the computer have a static IP address.
   
   You should choose a computer that will be running whenever someone wants to use the PQ application, since the PQ application will not run if it cannot contact the license manager. The license manager is typically installed on a Windows server, but it can be installed on either a workstation or server version of Windows 2000 or higher. If the computer is running a firewall, you will need to ensure that you allow the service to accept connections from other computers in your network.
2. The license manager uses the Reprise License Manager (RLM) software from Reprise Software.
   
   If another software vendor is also using RLM, and you want to install that vendor's RLM license service as well as the PQ Systems License Manager on the same computer, please contact PQ Systems technical support for help in accomplishing this.
3. When the license manager is installed it will use the service option defaults shown below. If you want to use different service options, you must delete the license manager service and re-install it to reflect your desired options (more on how to do that below).
   
   Listed below are the various service options and their default values:
   
   Web administration interface - The license manager service has a web based administration interface that is very useful in administering the license manager. You have the option of disabling this administration interface. However, administering the license manager without the administration interface can be cumbersome. Unless you have a definite need not to have a web administration interface, it is suggested that you use it. If you are concerned about your users finding the web administration interface and making unauthorized changes, then change the administration interface port number to one known only to authorized personnel. The default is to use the web administration interface.
   
   Web administration interface port number - The default TCP/IP port number for the web administration interface is port 9000. You can specify a different port number if you desire.
   
   Respond to the rlmdown command? - It is possible to shut down the license manager by running the administration tool rlmdown.exe. The default behavior is for the license manager service to shut down when commanded to do so by rlmdown. You have the option to tell the license manager to ignore a shut down command sent from rlmdown.
   
   Respond to the rlmremove command? - It is possible to remove a checked-out license by running the administration tool rlmremove.exe. The default behavior is for the license manager to remove the specified checked-out license when commanded to do so by rlmremove. You have the option to tell the license manager to ignore a license removal command sent from rlmremove.

Installing PQ Systems License Manager

Follow these steps to install the license manager at your site.

1. Use an account with local administrator privileges to perform these steps.
2. Run the license manager setup program (which typically is pqlm5.0_setup.exe). The license manager setup program is available here.
3. After the setup program has completed, the Windows service called "PQ Systems License Manager" will be installed and started using the service options default values.
4. Follow these steps if you want to use service options that are different from the defaults discussed above.
   • Use the Windows Services applet (Control Panel > Administrative Tools > Services) to stop the service named "PQ Systems License Manager."
   • Run the RLM_Delete_Service.bat file in the installation folder. This deletes the "PQ Systems License Manager" service. The installation folder defaults to "C:\Program Files\PQ Systems\License Manager" unless you specified a different folder.
   • Edit the RLM_Install_Service.bat file in the installation folder using a text editor like NotePad. Make the desired changes to RLM_Install_Service.bat and save the changes. Run the RLM_Install_Service.bat file in the installation folder to create the "PQ Systems License Manager" service using the service options you specified.
   • Use the Windows Services applet (Control Panel > Administrative Tools > Services) to start the service named "PQ Systems License Manager."
5. PQ Systems will send you a license file (a text file with a LIC file extension) that enables your license entitlement for each PQ Systems software product that you run under the concurrent-user license model. If you have one or more LIC files at this time, copy the file(s) into the installation folder, which typically is "C:\Program Files\PQ Systems\License Manager" and follow the instructions for Adding or changing a license entitlement.

Administering PQ Systems License Manager

The PQ Systems License Manager (PQLM) is implemented by using the Reprise License Manager (RLM) software from Reprise Software.

The RLM end-user manual, provided by Reprise Software, contains information that, despite the name, is primarily oriented toward the person who installs and administers RLM. In general, you should not need to refer to this manual, but if you do, the RLM end-user manual can be viewed locally here, or here on the web. If you have a question that is not addressed by this guide, you may find the answer in the RLM end-user manual, and you can always contact PQ Systems technical support for help. Some topics in the RLM end-user manual, as noted below, do not apply to the PQ Systems License Manager:

• The topic "How to Queue for Licenses" does not apply. License queuing is not implemented by PQLM.
• The instructions in the topic "How to use Roaming Licenses" should not be used. Instead, use the roaming license facilities built into the PQ product.

Using the web based administration interface

The web based administration interface to the license manager service is enabled by default, but you may have disabled it at the time the service was installed. The following information about how to open the administration interface in a browser is useful only when the web interface is enabled.

The web administration interface to the license manager service can be reached using a web browser (like Internet Explorer or Firefox) via a URL similar to that shown below. The following example assumes that port 9000 is used, and that the license manager service is installed on the local computer.

http://localhost:9000

If you want to contact the license manager service on another computer, substitute the name of the computer in place of localhost, and specify the appropriate port number in place of 9000. For example, use http://MyLicenseServer:9500 to contact the license manager service on the computer named MyLicenseServer using port 9500.

Adding or changing a license entitlement

PQ Systems will send you a license file (a text file with a LIC file extension) that enables your license entitlement for each PQ Systems software product that you run under the concurrent-user license model. When you receive a new license file from PQ Systems, please copy the file into the installation folder, which typically is "C:\Program Files\PQ Systems\License Manager". Next, you must tell the license manager to reread the license file(s) so that your new license entitlement becomes active. In order to do that use one of the following methods:

• If the web administration interface is enabled, open it and click on Reread/Restart Servers on the left side, then click on REREAD LICENSES.
• If the web administration interface is not enabled, or you prefer this method, use Windows Explorer to run the RLM_Read_Licenses.bat command file in the installation folder. The installation folder defaults to "C:\Program Files\PQ Systems\License Manager" unless a different folder was specified during installation. This command file runs the rlmreread.exe utility and then pauses to let you see if the utility was successful. If the utility indicates that an error occurred, then you must stop and restart the 'PQ Systems License Manager' service.

Configuring PQ applications to use the license manager

Each PQ Systems software application that is licensed under the concurrent-user model must have a LicenseServer.ini file placed in its installation folder. This file tells the application how to contact the license manager.

A sample LicenseServer.ini file can be found in the installation folder of the license manager, which typically is "C:\Program Files\PQ Systems\License Manager".

You must edit your LicenseServer.ini file so that it specifies the proper information for your site. Do not change the file name. Please refer to the comments in the file for specific information. Then you must copy your customized LicenseServer.ini file into the installation folder of each PQ Systems software application that is licensed under the concurrent-user model.

Helpful hint: This tip will make your life easier. Have all your users install their PQ applications from the same shared network folder. Put a copy of your customized LicenseServer.ini file in this folder along with the setup program for the PQ Systems software application. When the PQ application is installed on a computer in your network, the setup program will automatically copy the LicenseServer.ini file into the installation folder of the installed PQ application.

Uninstalling PQ Systems License Manager

Please follow these steps to remove the license manager from a computer.

1. Use "Control Panel" > "Add or Remove Programs" to uninstall  the "PQ Systems License Manager". As an alternative, you can click on the "Uninstall PQ Systems License Manager" shortcut under your Start menu.
2. Any license files that were copied into the installation folder, which typically is "C:\Program Files\PQ Systems\License Manager", will remain in that folder. If desired, you must manually remove those files.