Setting up License Manager on UNIX

This topic includes the following sections:

 

License Manager is a set of utilities that controls the use of Synergy/DE products. On UNIX, License Manager runs as the synd daemon.

Note

License Manager can also be used to secure the applications that you create with Synergy/DE. When a product is secured with License Manager, it will not run unless License Manager is installed and has been configured to recognize the product. To build License Manager protection into your own applications, you’ll need Synergy/DE Licensing Toolkit. For more information about this product, view the Licensing Toolkit User’s Guide or contact your Synergy/DE account manager.

On UNIX, License Manager enables all connected users to share licenses. To use License Manager—and your Synergy/DE products—you’ll need to complete these steps:

1. Install the Synergy/DE products; License Manager is included with Synergy DBL. See Installing License Manager.
2. Obtain license configuration keys from Synergex. See Obtaining configuration keys.
3. Configure License Manager (i.e., install the configuration keys) to allow your Synergy/DE products to continue running after the 14‑day evaluation period. See Installing configuration keys.
Important

When you first install Synergy/DE on a machine that has never before had it installed, you will have unlimited evaluation use of all products for 14 days. After 14 days, you can run only the products that you have configured. Once you configure a particular product, your use of that product is limited to the number of licenses you purchased. After the 14‑day evaluation period expires, if you want to evaluate a product, you must obtain a special configuration key from Synergex.

Each time you access the runtime during the evaluation period, the Synergex copyright message will display, along with the licensee name and the number of days remaining in the evaluation period. After you configure the runtime, this message no longer display.

Installing License Manager

These instructions are for new installations. If you are updating an existing installation, refer to the installation instructions that accompanied your distribution. If you need to reinstall Synergy/DE licensing software, call Synergy/DE Developer Support for assistance.

1. Install your Synergy/DE products using the installation instructions included with your distribution.

When you execute the installation script program, install.sde, License Manager is initialized, the file register.lm is created, and the License Manager daemon (synd) is started. (For more information on synd, see Starting and stopping the License Manager daemon (synd) and synd program.)

2. When prompted for the licensee name, enter the unique name that you provided to Synergex when you ordered Synergy/DE products. This name will display in the copyright notice when you run licensed Synergy/DE products.
Tip

We recommend that your company establish a licensee naming standard. If your company installs Synergy/DE on multiple systems at one site, we recommend that you use the name of the company followed by the user or machine name (e.g., “ABC Computers, Mary Smith” or “ABC Computers, Tiger”). If your company installs Synergy/DE at multiple sites, we recommend that you specify the company and city or location (e.g., “ABC Computers, Gold River” or “ABC Computers, store 215”).

3. The licensee name you enter is echoed on the screen, and you are asked to confirm that it is correct.

You can also use lmu ‑r to correct the licensee name. See lmu utility.

Obtaining configuration keys

There are two ways to obtain configuration keys.

Obtaining keys online

To complete this procedure, you will need your Resource Center user name and password. The configuration keys are delivered in a Synergy Key file.

1. Locate the file register.lm in the synergyde/lm directory and print it.
2. Start your web browser and go to the Synergex website.
3. Log into the Resource Center, go to the Online keys section, and click on the Generate Configuration Keys link. Follow the instructions on screen to obtain configuration keys.
4. When prompted, download the Synergy key file (.skf file) or select to have it sent to you as an e‑mail attachment. Save the key file to your hard drive. It contains configuration keys for the products you are licensing. This key file can be run from lmu and greatly simplifies the configuration process (see Installing configuration keys).

Obtaining keys manually

1. Locate the file register.lm in the synergyde/lm directory and print it.
2. Use the information in register.lm to complete the Synergy/DE Product License Agreement. Carefully transcribe the licensee name, registration string, and system code onto the license agreement. Accuracy is important! Pay attention to case, punctuation, and spaces in the registration string.
3. Mail or fax the agreement to Synergex. You can indicate on the agreement how you want to receive your keys. If you select e‑mail, you will receive a Synergy key file (.skf file) as an e‑mail attachment. Save the file to disk, and use it to install the keys (see next section).

Installing configuration keys

1. If you have not already done so, set your PATH environment variable on the command line or in the .profile file to include the License Manager directory. For example:
PATH=/usr/synergyde/lm:$PATH ;export PATH
2. Ensure that the system date and time are correct, and that no Synergy applications are running.

If you have a Synergy key file

Run lmu with the ‑f option and include the path and filename of the Synergy key file on the command line:

lmu -ffilename.skf

This command runs the lmu utility and installs keys for all products in the specified key file for the current machine. See the lmu Error Messages table for a list of errors returned by lmu.

If you do not have a Synergy key file

1. Execute the configuration utility:
config_lm
2. Enter the following information when prompted. You must enter this information for each Synergy/DE product you want to license. If you get lmu errors, see lmu Error Messages table.

Product Code

Enter the code for the product you’re configuring. Synergex will give you this code. For example, the product code for Synergy/DE Professional Series is PSDE10.

Producer Code

Enter the code for the company that produces the product you’re configuring. Synergex’s producer code is 999.

Configuration Key

Enter the key that Synergex sent you for this product. This key must be entered correctly! Pay special attention to occurrences of the number one (1) and the lowercase letter “L”, as well as occurrences of the number zero (0) and the uppercase letter “O”.

Note

If you need to enter an extended data string, you must configure the key using the command line syntax rather than with config_lm. Include the ‑x option for the extended data string. For example,

lmu -a PROD9 -p 999 -i 58W4-ZA2T-BO42-X4AP -x 1234
3. After each configuration, you’ll be prompted to configure another license. Enter y to configure another product or n to exit the configuration program.   

Starting and stopping the License Manager daemon (synd)

The License Manager daemon, synd, is a background process that must be running in order for Synergy/DE products to run. It provides licensing and SEND/RECV message services to Synergy/DE products. It is initially started when you execute install.sde. (For information about the synd command‑line syntax and options, see synd program.)

Starting License Manager automatically

To start License Manager automatically when the system reboots, add the full path name of synd to your system start‑up file (the run command file (rc)). This ensures that synd will restart automatically if your system goes down. Consult your UNIX system administrator manual for more information about starting multi‑user daemons.

For example, on some machines you might add this line to the /etc/rc file:

/usr/synergyde/lm/synd

Starting License Manager manually

To start License Manager manually, restart synd without rebooting or reinstalling. For example, on some machines you might enter

/usr/synergyde/lm/synd

Stopping License Manager

To stop License Manager, you must be UID=0. Use this command:

synd -q

Error logging

By default, synd logs caught signals (15 “Software terminate”, 11 “Segmentation error”, and so forth) to the log file /usr/lib/synd.log and stamps each signal with the date it occurred. You may want to examine this file when you have problems running License Manager. (Note: “Software terminate” is a normal signal to receive; it usually occurs when you shut down the machine.)

The default location for synd.log is /usr/lib, but it can be located elsewhere if the environment variable SYNDLOG is set.

For more verbose debug logging, use the lmu ‑2 option.

lmu -2

(This command also starts debug logging for Synergy message manager. For more information on the Synergy message manager, see Messaging.)

lmu -1

This command sends a reset signal to License Manager. It can also be used to help restart synd if it gets into a frozen state.

Important

Issuing two lmu ‑1 commands within 60 seconds of each other will start debug logging.

The log file can get quite large if you do not periodically clear it out. To clear it out and start with a fresh file without stopping synd, run this command, when logged in as root:

>/usr/lib/synd.log