LeCroy Software Licensing Guide

Transcription

1 LeCroy Software Licensing Guide Overview This guide is intended to be used by an IT professional; it walks through the steps needed to activate and install software licenses for LeCroy software applications. The latest version of the license components and utilities are available online: Licensing Models In general, LeCroy applications enforce licensing on a feature-level granularity. These features are called licensed features. Typically, a license is not required to use a LeCroy application for viewing purposes; this means that most LeCroy applications can be used for free as a viewer. However, each LeCroy product has different features, so consult the product documentation for licensing information about a specific product. LeCroy applications support two licensing models: 1) Node-locked and 2) Floating. The application will only use one of these models; the one that is used depends on which product SKU was ordered. Node-locked Licenses Node-locking means the licensed features of a LeCroy application can only be used on specified host systems. Each node-locked license is bound to the Ethernet MAC address of a host; a node-locked license is not transferrable to another host. When a node-locked license file is installed on the host, it enables that host to use the licensed features specified in the license file. Floating Licenses A floating license allows anyone on the network at the installation site to use the licensed features of the LeCroy application, up to the concurrent usage limit specified in the license file. Floating licenses are managed by a License Server at the installation site; the License Server is needed to enforce the limit of concurrent usage of the licenses. The licenses are bound to the Ethernet MAC address of a specific License Server and may not be transferred to another License Server. Any computer with network access to the License Server may use the licensed features specified in the license file as long as the concurrent usage count is not exceeded. Page 1 of 7 v1.2

2 License Activation Procedure Please follow the procedure that matches the licensing model you will be using (either node-locked or floating). Node-locked Licenses 1. Obtain the Activation Code file (.txt) from LeCroy. In most cases, this would be distributed electronically via . This file contains the activation codes for all purchased licenses. 2. Perform the following steps on each machine on which you will install a license. Use a separate line of the Activation Code file for each computer: a. Download the Node Identification utility lmutil from the website listed above. Make sure to get the correct version for your platform. Extract the lmutil file from the downloaded zip/tar.gz file. b. Linux machines: Make sure your Linux installation is Linux Standard Base compliant. Consult the documentation for your Linux distribution for details on how to check this. For many distributions, you may install a special LSB package to enable compliance. c. Run the following command from a command prompt: lmutil lmhostid d. You will see output such as: e. Copy the part in quotes (including the quotes) and insert it at the end of a line of the Activation Code file. Make sure to only include one set of quotes. You may see multiple items in the list if you have both wired and wireless network interfaces; if this is the case (as shown above) only use one of the items. 3. Send the completed Activation Code file back to LeCroy. 4. This completes the Activation. LeCroy will then send back the license file(s) for the activated licenses. When you receive the license files(s) continue with the License Installation Procedure section of this guide. Floating Licenses Perform the following steps on the machine that will be License Server. Refer to the FlexNet License Administration Guide for details on considerations for choosing a License Server machine. Currently Windows x86 and Linux x86 are supported. 1. Obtain the Activation Code file (.txt) from LeCroy. In most cases, this would be distributed electronically via . This file contains the activation codes for all purchased licenses. Page 2 of 7 v1.2

3 2. Download the Node Identification utility lmutil from the website listed above. Make sure to get the correct version for your platform. Extract the lmutil file from the downloaded zip/tar.gz file. 3. Linux machines: Make sure your Linux installation is Linux Standard Base compliant. Consult the documentation for your Linux distribution for details on how to check this. For many distributions, you may install a special LSB package to enable compliance. 4. Run the following command from a command prompt: lmutil lmhostid 5. You will see output such as: 6. Copy the part in quotes (including the quotes) and insert it at the end of a line of the Activation Code file. Make sure to only include one set of quotes. You may see multiple items in the list if you have both wired and wireless network interfaces; if this is the case (as shown above) only use one of the items. 7. Send the completed Activation Code file back to LeCroy. 8. This completes the Activation. LeCroy will then send back the license file for the activated license. When you receive the license files(s) continue with the License Installation Procedure section of this guide. Page 3 of 7 v1.2

4 License Installation Procedure Please follow the procedure that matches the licensing model you will be using (either node-locked or floating). Node-locked Licenses 1. Obtain the required license file (.lic) from LeCroy. In most cases, this would be distributed electronically via Launch the LeCroy software application for which you are installing the license. 3. Select Help Display License Information menu item. License Information window opens. 4. Click Install License File button. File browser window opens. 5. Select.lic file from Step #1. 6. If successful, you will see a message box that states License file installed successfully. Floating Licenses 1. Obtain required license files (.lic) from LeCroy. In most cases, these would be distributed electronically via . You should receive one file named as XXXX_server.lic and one file named as XXXX_client.lic. 2. Retrieve the host name of your license server by running the following command from a command prompt: lmutil lmhostid -hostname 3. You will see output such as: 4. Specify the host name of your license server in the license files: a. Open the XXXX_server.lic file in any text editor. b. On the first line, replace the text this_host with the host name of your license server. For example: c. Save and close the file. Page 4 of 7 v1.2

5 d. Repeat for the XXXX_client.lic file. 5. License Server Configuration for Windows: a. Obtain required server components: - lmtools.exe - lmgrd.exe - lecroy.exe These may be downloaded from the website listed above. In some cases, one or more of these components may be sent via . b. On the license server machine, create a directory anywhere named LeCroy_License_Server. Copy the server components and the XXXX_server.lic file into this directory. If any components were sent via , be sure to rename the attachments to match the names above. c. Make sure you have administrator privileges. d. Launch lmtools.exe e. From the Server/License File tab, click the Configuration using Services option, and then click the Config Services tab. f. In the Service Name field, enter the name of the service as LeCroy License Server. g. In the Path to the lmgrd.exe file field, type the path or browse to the file lmgrd.exe h. In the Path to the license file field, type the path or browse to the XXXX_server.lic file. i. In the Path to the debug log file field, type the path or browse to the debug log file that this license server writes. Prepending the debug log file name with the + character appends logging entries. The default location for the debug log file is the c:\winnt\system32 folder. To specify a different location, specify a fully qualified path. j. Select the Use Services check box. k. Click Save Service. l. Click the Start/Stop/Reread tab. m. Select the license server service name configured above. n. Click Start Server. o. On each client running the LeCroy software application, install the XXXX_client.lic license file as described above in the Node-locked Licenses section. 6. License Server Configuration for Linux: a. Make sure your Linux Server is Linux Standard Base compliant. Consult the documentation for your Linux distribution for details on how to check this. For many distributions, you may install a special LSB package to enable compliance. b. Obtain required server components: - lmgrd - lecroy These may be downloaded from the website listed above. In some cases, one or more of these components may be sent via . c. On the license server machine, create a directory anywhere named LeCroy_License_Server. Copy the server components and the XXXX_server.lic file Page 5 of 7 v1.2

6 into this directory. If any components were sent via , be sure to rename the attachments to match the names above. d. Open a Terminal window and change directories to the LeCroy_License_Server directory you created in the previous step. e. Run the following command line:./lmgrd c XXXX_server.lic f. On each client running the LeCroy software application, install the XXXX_client.lic license file as described above in the Node-locked Licenses section. Page 6 of 7 v1.2

7 Support If assistance is required for activating or installing licenses, please contact LeCroy PSG Support: Online Support Web: Phone Support Voice: Fax: (USA/Canada) (worldwide) (worldwide) Page 7 of 7 v1.2