CORE(R) Network License Manager (NLM) Service 4.3 README.TXT file Please read this document along with the WHATSNEW file in the CORE directory before installing the NLM Service 4.3 on the Windows NT/2000 machine. This file includes information not covered in the documentation. If you have questions after reviewing this document, or if you encounter any problems while installing or using the Network License Manager, please contact Vitech Product Support as instructed at the end of this document. Selecting a Host Machine for the Network License Manager (NLM) ============================================================== The CORE Network License Manager service can be run on any Windows NT/2000 machine connected to the host network. Although this is most commonly a network server, it is NOT required to be a network server. Remember that if operation of the Network License Manager is interrupted, CORE usage will be disrupted. Therefore, it is important that you select the NLM host machine carefully. Note that this version of the Network License Manager runs as a service so it is not required that a user be logged in for the NLM to run. However, Windows 95/98/Me does not support this functionality. If you need a version of the NLM for a Windows 95/98/Me platform, please install the standard version of the NLM from the installation media. Installation of the Network License Manager ============================================ Required Space -------------- The CORE Network License Manager requires approximately 1.2 MB of file space. Installing the NLM Software --------------------------- The CORE NLM 4.3 installation program is a Windows application and must be executed under Windows NT/2000. Insert the CORE installation CD into your CD-ROM drive. If the CD Browser does not automatically appear on your screen, run Setup.exe from the CD's root directory. Select "Install CORE Network License Manager" from the main setup screen and then select NLM 4.3. You will be guided through the installation process. No previous CORE installation is required to install CORE NLM 4.3. The install program will ask for the directory in which CORE NLM will be installed ("C:\Program Files\Vitech Corporation\CORE NLM 43" is the default). The installation program will create a new program folder under your Programs menu with the title "CORE NLM 4.3". This folder contains shortcuts for all associated programs and documentation files. Since the NLM itself is a service, no shortcut is created. For more information on starting the service, see "Starting the NLM Service After Installation". NOTE: The CORE NLM 4.3 requires TCP/IP support in order to function. In addition, the default configuration uses port 32000. It is very unlikely that this port assignment will conflict with other software. You should confer with your network administrator if you have any questions. Uninstalling the NLM Software ----------------------------- Select Add/Remove Programs from the Windows control panel. Select "CORE Network License Manager 4.3" from the list of applications available to uninstall, and click the Add/Remove button. Follow the instructions provided by the installer to remove the application. Licensing the Network License Manager (NLM) =========================================== To generate a license request, simply click on the icon titled "License Request" in the NLM>>Utilities program menu (or run LICREQ.EXE in the CORE Network License Manager directory). Select File>>Generate. Enter the company name and a CORE serial number (from the CORE installation media) in the appropriate fields and press the OK button to generate a license request. Then, select File>>Save to save the request file. After the request has been generated, send an email requesting a license along with a copy of the license request file to Vitech Corporation. This request must include the following: 1) The point of contact for your group including telephone and fax numbers in case there are any questions regarding the request; 2) The make, model, and serial number of the computer on which the NLM has been installed; and 3) The CORE serial number(s) to be managed by the NLM specified in (2). After the license request has been received by Vitech Corporation, a valid license registry will be e-mailed (or faxed) to the point of contact. This file should then be entered exactly as it is received using a text editor such as the Windows Notepad. You must save the new license under the file name REGISTRY.DBX in the NLM directory. Note that the license file will contain no tabs, and the lines will be separated by carriage returns (with no carriage return at the end of the last line). Starting the NLM Service After Installation =========================================== The installation procedure will place all files to run the NLM service in the directory you have designated and will load information into the system registry. When you receive a valid REGISTRY.DBX from Vitech, place it in the NLM service directory. To start the NLM service, go to Start>>Settings>>Control Panel>>Services. You will find a listing for Network License Manager v 4.3.3 that should currently be in a stop status. Select the start button to start the service. Open the NetTerm utility and verify that the network configuration has the correct IP and port number. If the network configuration is correct and the REGISTRY.DBX is valid you will see tokens displayed in the NetTerm Dialog. If not, contact our support team at (703) 883-2270. NetTerm for Client Token Administration ======================================= This version of the NLM provides the user with the ability to release (kill) a token that was not returned. Simply select the token that you want to release and right click for the popup menu item to kill token. NetTerm is installed on each client PC during the CORE installation. A shortcut to NetTerm is in the Programs>>CORE>>Utilities folder on the Windows Start menu. The IP address and port number 32000 are set under the Options>>Network option on the NLM Terminal window. Modify these two strings to the correct IP address (or symbolic name) and port and the user should be able to view the NLM information. Users can view outstanding tokens and delete any token that is checked out to them. At the PC which runs the NLM service, any token can be deleted by the Administrator. Timeout on Inactive Tokens ================================================================ In order to properly manage licenses, the NLM will automatically timeout and terminate any client which fails to poll within a given period. By default, this period is set at 90 minutes. Chosing a proper timeout interval involves balancing the desire to automatically retrieve licenses from clients not in use and needing to support long operations such as import/export or report generation. Note that in any case, an operation started will be allowed to finish even if the NLM reclaims the license token. To change the timeout period allowed, modify each controlset001,002, etc. to indicate the number of minutes before timeout. The control sets can be modified by using Regedit. HKEY_LOCAL_MACHINE\SYSTEM\CONTROLSET001\SERVICES\NLMv43\nlmsvc43.exe -D0060 Modify String Value ImagePath "c:\NLM\nlmsvc43.exe" To String Value ImagePath "c:\NLM\nlmsvc43.exe -DXXXX" Allowable limits for XXXX are 0-4320 minutes. That is, up to 3 days. Once you have changed the time parameter restart the NLM service. Host Allow/Deny Functionality ================================================================= The system administrator can specify which hosts (IP addresses) are allowed to use the NLM and which hosts can not. To do so, two files are involved. The NLM functions will first check the file called "HOSTS.ALLOW". If the incoming packet matches a pattern in the HOSTS.ALLOW file, that packet is accepted. If the incoming packet is not in the HOSTS.ALLOW file, the second file called "HOSTS.DENY" is checked. If the IP address matches a pattern in the HOSTS.DENY file, that packet is dropped and a message is written to the audit file. If an IP is not in the HOSTS.ALLOW file or the HOSTS.DENY file, that packet is accepted. Note that the NLM communicates with itself using the TCP/IP stack. The NLM must be able to "talk to itself". If you specify a pattern in HOSTS.DENY that will not allow the NLM to talk to itself, you must specifically enter into the HOSTS.ALLOW the IP address of the NLM AND the loopback device 127.0.0.1. A typical HOSTS.DENY file can include the pattern *.*.*.* This will not allow any hosts to connect unless they match a pattern in the HOSTS.ALLOW file. To make this work, you must have a pattern in the HOSTS.ALLOW file which will allow the NLM to talk to itself. For example, if your server is 192.168.111.240, you would enter into the hosts.allow file, 127.0.0.1 192.168.111.240 The NLM will process the * to match any pattern. All IP addresses must be entered in standard form (a.b.c.d) such as: 192.168.111.* 192.168.*.* *.*.*.* 10.10.8.00* Reporting Problems/Making Product Suggestions ============================================= If you should encounter a problem with the software (either an error, a deficiency, a feature that works in a manner other than you expected, or a problem with any associated documentation), please notify us via e-mail, phone, or fax as indicated below. Any information you can provide in your report regarding the hardware and software configuration of the host machine, the circumstances in which the problem occurred, conditions to reproduce the problem, and such test data as you can reasonably provide to assist Vitech in reproducing the problem would be greatly appreciated. We hope that you enjoy the new capabilities of CORE NLM Service 4.3. All customer observations and recommendations are valuable to us. Vitech Corporation 2070 Chain Bridge Road Suite 320 Vienna, VA 22182-2536 Phone: (703) 883-2270 Fax: (703) 883-1860 Email: support@vtcorp.com Web: http:\\www.vtcorp.com Copyright (c) 2000 Vitech Corporation.