Open topic with navigation
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.
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.|
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.
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.
|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 before configuring products. See lmu utility.
There are two ways to obtain configuration keys.
Obtaining keys online
To complete this procedure, you will need your Resource Center username 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, navigate to Products & Support, and then to Licenses.|
|4.||On the Synergy Licenses page, select the Manage Licenses button to display a list of your company’s licenses.|
|5.||Use search or sort to locate the license on the list. You can change the Show dropdown to New Licenses to limit the list to only those licenses for which keys have not yet been generated.|
|6.||When you find the license, click on the license number, and then follow the instructions to generate keys.|
If you need to change the licensee name, do it now, before generating keys. The licensee name entered on the machine during installation must match the one you see on the licenses website (which is the licensee name given to Synergex when products were ordered). You can easily change either of them at this point. On the website, you can change the licensee name on the Edit page; to change the name on the machine, run lmu with the -r option.
|7.||When prompted, download the Synergy key file (.skf file) or select to have it sent to you as an email 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. (A copy of this form is available in the Downloads area of the Synegex Resource Center.) 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 email, you will receive a Synergy key file (.skf file) as an email attachment. Save the file to disk, and use it to install the keys (see next section).|
|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:
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:|
|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 the lmu Error Messages table.|
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.
Enter the code for the company that produces the product you’re configuring. Synergex’s producer code is 999.
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”.
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.|
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:
Starting License Manager manually
To start License Manager manually, restart synd without rebooting or reinstalling. For example, on some machines you might enter
Stopping License Manager
To stop License Manager, you must be UID=0. Use this command:
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.
(This command also starts debug logging for Synergy message manager. For more information on the Synergy message manager, see Messaging.)
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.
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: