Go to www.awrcorp.com
Back to search page Click to download printable version of this guide.

Chapter 3. Configuring FLEXlm

This chapter describes how to configure your site for FLEXlm licensing.

FLEXlm can be configured in a locked or floating licensing environment using either software- or hardware-based keys. For instructions on configuring your machine for locked licensing using either type of key, see “Configuring Locked Licensing”. For instructions on configuring your site for floating licensing, see “Configuring Floating Licensing”.

If you cannot successfully configure FLEXlm, see Troubleshooting FLEXlm for troubleshooting information.

NOTE: FLEXlm licensing software requires Administrator privileges for installation and configuration.

3.1. Configuring Locked Licensing

FLEXlm locked licensing can use either a software-based or hardware-based key. For instructions on configuring FLEXlm using a software-based key, see “Configuring Locked Licensing with a Software-Based Key”. For instructions on configuring FLEXlm with a hardware-based key, see “Configuring Locked Licensing with a Hardware-Based Key”.

These instructions assume that the Cadence® AWR Design Environment® platform software is installed on your machine. For installation instructions, see Installing the AWR Design Environment.

3.1.1. Configuring Locked Licensing with a Software-Based Key

The following steps configure your machine for FLEXlm locked licensing with a software-based key. In this configuration, the AWR Design Environment platform software is installed on and licensed to your particular machine.

  1. From the Windows® Start menu, choose AWRDE [version_number] > AWR Design Environment [version_number].

    Alternatively, double-click This PC on your desktop, open the folder where you installed the program and double-click MWOffice.exe to display one of the following dialog boxes.

  2. Click OK to display the AWR License Configuration dialog box.

    After your initial license file configuration you can access this dialog box by choosing File > License > Configuration while in the AWR Design Environment platform program.

  3. To obtain a valid license file from Cadence, click Information and follow the instructions. NOTE: Evaluators must complete the registration process to obtain an evaluation license. See Get Evaluation License for registration information.

  4. When you receive your license, copy it to your computer and then click the Configure button on the AWR License Configuration dialog box to display the License Configuration dialog box.

    Specify your license configuration as Locked license (filename) and set the environment variable by browsing to the location of your locked license file or manually entering the path, then click OK.

FLEXlm locked configuration using a software-based key is complete. To verify FLEXlm operation, see “Verifying that a License Can Be Checked Out”.

3.1.2. Configuring Locked Licensing with a Hardware-Based Key

The following procedure configures your machine for FLEXlm locked licensing with a hardware-based key calculated from the serial number of the hardware dongle attached to your machine's USB port. Cadence supplies you with the hardware key. In this configuration, the AWR Design Environment platform software is installed on your machine, but the license can be transferred between machines simply by moving the hardware dongle.

Installing with a USB Hardware Key

To install with a USB hardware key:

  1. Download and install the latest Sentinel HASP4 device driver from http://sentinelcustomer.safenet-inc.com/sentineldownloads/, or run the HASPUserSetup.exe file from the FLEXlm Utilities in the Cadence AWR Knowledge Base.

  2. Cadence supplies you with a license file. When you receive your license, copy it to your computer and then in the AWR License Configuration dialog box, click the Configuration button. In the License Configuration dialog box, specify the desired license configuration and directory path.

FLEXlm locked configuration using a hardware-based key is complete. To verify FLEXlm operation, see “Verifying that a License Can Be Checked Out”.

3.2. Configuring Floating Licensing

In a FLEXlm floating licensing configuration, the license file is assigned to a machine designated as the FLEXlm license server. Each client workstation runs the Cadence® AWR® Microwave Office® software or Cadence® AWR® Visual System Simulator™ (VSS) communications and radar systems design software, requesting licenses from the server when needed. If you have a floating license server running for other Cadence products, you do not need to set up a new service, but you may need to get and add the awrd.exe license daemon to your cdslmd.exe daemon location.

Cadence tools require FlexLM version 11.15 or later. You can download the FLEXlm drivers and tools as described in “Obtaining the License File”.

3.2.1. Configuring Floating Licensing on the License Server

Perform the following steps on the machine designated as the FLEXlm license server to configure the server.

NOTE: These steps direct you to create a C:\awr_flexlm folder for download of FLEXlm utilities. The "FLEXlm Utilities" link in the first step provides several download locations for the utilities. If you choose to download the utilities from the Cadence download site they are installed in a C:\Cadence\LicenseManager folder. All steps in this procedure apply when working from this folder as well.

Obtaining the License File

Skip this section if you already received your license file.

To obtain the FLEXlm license file:

  1. Create a C:\awr_flexlm directory and download the FLEXlm Utilities from the Cadence AWR Knowledge Base. These files run, debug, and maintain the FLEXlm license manager. Cadence license files are sent as .txt files. You can configure the server using this file, but LMTOOLS filters for .lic files, so you need to either override the filter or change the file extension.

  2. To obtain a valid FLEXlm license file, you must provide the machine's Ethernet address (hostID) as well as the hostname. Locate and launch the lmtools.exe program included with the FLEXlm files. The LMTools dialog box displays.

  3. Click the System Settings tab.

  4. E-mail the value in Ethernet, the value in Computer/Hostname, and your name, company name, address, phone number, and purchase order number or invoice number to Cadence at .

Editing the License File

  1. After you receive the license file, Cadence highly recommends you rename the file to awrd.lic and place it in your C:\awr_flexlm directory.

  2. Open awrd.lic in a text editor and check the line starting with "SERVER". If you see "Cadence_SERVER" as shown here, replace it with the correct machine name and save the file.

    SERVER Cadence_SERVER 00abcdef1234 5280

  3. In the "SERVER" line, there is a port number assigned for use with the server. By default the port number assigned is 5280 per the previous example. You can use this port number or replace it with a different number. If there is a port number currently used with the Cadence license server, for simplicity you should use that port number.

Installing the FLEXlm Server

These instructions cover a simple FLEXlm license server installation. More complex configurations are described in the License Administration Guide included with the FLEXlm Utilities in the Cadence AWR Knowledge Base.

To install the FLEXlm Server:

  1. If applicable, copy to your C:\awr_flexlm directory the awrd.exe, lmflex.exe, lmgrd.exe, lmtools.exe, lmutil.exe, cdslmd.exe, and lmutil.exe files by downloading the FLEXlm Utilities.

  2. If the Cadence license file awrd.lic is in the same folder as awrd.exe and cdslmd.exe you can proceed to the next step, otherwise you need to edit the license file with a text editor to include the absolute path to awrd.exe and cdslmd.exe.

  3. Start lmtools.exe. The LMTOOLS dialog box displays.

  4. Click the Service/License File tab.

  5. If you previously installed and set up FLEXlm services, select Config Services and specify AWR License Manager. If you have not previously installed FLEXlm services, proceed to the next step.

  6. Click the Config Services tab and verify that your settings match the following:

    Service Name: "AWR License Manager"

    Path to the lmgrd.exe file: "C:\awr_flexlm\lmgrd.exe"

    Path to the license file: "C:\awr_flexlm\awrd.lic"

    Path to the debug log file: "C:\awr_flexlm\debug.log"

    Use Services: (selected)

    Start Server at Power Up: (selected)

  7. Click Save Service to save these settings. When asked to confirm saving the settings for the license server, click Yes.

  8. Click the Start/Stop/Reread tab and click the Start Server button to start the FLEXlm license server.

    Note the "Server Start Successful" message that displays in the Status bar at the bottom of the dialog box.

  9. Click the Server Status tab and specify awrde as the Individual Daemon, then click Perform Status Enquiry to display information about the server status.

    NOTE: The first few times you start the license server, you should view the debug file C:\awr_flexlm\debug.log for any messages. You may first need to stop the license service if it has a lock on the file.

  10. If necessary, click the Server Diags tab and then click the Perform Diagnostics button to diagnose any problems.

  11. Choose File > Exit to close the LMTOOLS license service.

FLEXlm server configuration is complete. To verify FLEXlm server operation, see “Verifying that a License Can Be Checked Out”.

3.2.2. Configuring Floating Licensing on Client Workstations

The AWR Design Environment platform software must be installed on the client machines. For instructions on installing the program, see Installing the AWR Design Environment.

Perform the following steps on the client machines to configure FLEXlm clients:

  1. In the AWR License Configuration dialog box, click the Configure button to display the License Configuration dialog box and set the CDS_LIC_FILE environment variable.

  2. In the License Configuration dialog box, select Floating license (port@server or port@server1;port@server2...) to set <portNumber>@<serverName>

    where <portNumber> is the port number described in the license file and <serverName> is the name of the server machine. These variables are defined on the SERVER line of the license file in the following format:

     SERVER <serverName> <hostID> <portNumber>

    For example:

     SERVER lenny-19 00abcdef1234 27007

    To use the floating license file directly, select Floating license with file (filename) to specify the file name. This option only works if the client computers can access the network location where the license file is located. In this mode, the port number and host name are read directly from the license file instead of setting them directly. The advantage of this method is that if you need to change port numbers, you can change the license file only, with no need to update client machine settings.

  3. If applicable, copy the lmflex.exe, lmutil.exe, and lmtools.exe files FLEXlm Utilities in the Cadence AWR Knowledge Base to your C:\awr_flexlm directory. These utilities are used to troubleshoot the FLEXlm licensing configuration.

FLEXlm client configuration is complete. To verify FLEXlm client operation, see “Verifying that a License Can Be Checked Out”.

Legal and Trademark Notice