Using the licensing upgrade package on UNIX

The licensing upgrade package enables you to take advantage of REV11 licensing features on prior versions of Synergy/DE. It can be installed on a system with an existing Synergy/DE installation that is version 9.3*, 9.5*, 10.1*, or 10.3*.

On UNIX, the licensing upgrade package is a standard License Manager installation component (.tar file) that installs REV11 versions of synd and lmu. It also installs the lmcheck utility.

Before you install…

We recommend that your system meet the minimum operating system requirements for the current version of Synergy/DE. But we recognize that this may not be possible with the licensing upgrade package, which is intended to be run on older versions of Synergy that may not be supported on the latest operating systems. For requirement details, see the Supported Platforms pages on the Synergex website. Contact Synergy/DE Developer Support if you have questions about whether the licensing upgrade package will be compatible with your configuration.

The licensing upgrade package installation runs the lmcheck utility to verify connectivity to the Synergy
License Web Service. However, we recommend that you run lmcheck separately before installing to not only check connectivity, but also verify your license in Synergex’s database. This utility can be downloaded from the downloads area for version 9.3 or higher in the Synergex Resource Center. If you’re using a proxy server, run lmcheck with the -pp option.

You may want to make a copy of the synergyde/lm directory so that you can revert to the old licensing if you need to.

If you have multiple versions of Synergy/DE installed, be advised that older versions of lmu and synd will not work once the licensing upgrade package is installed.

Installing the licensing upgrade package

Follow these instructions to install the licensing upgrade package on a system on which Synergy/DE products have already been installed and licensed. If you need to install it on a new system on which you’ve just installed a pre-11 version of Synergy/DE, see Installing the licensing upgrade package on a new system.

1.

Go to the Downloads area of the Synergex Resource Center, navigate to the page for your version and platform, download the licensing upgrade package, and then run it to unpack the files.

2.

Extract the .tar file to your installation directory. (If you have more than one version of Synergy/DE installed, extract it to the installation directory of the newest version.)

3.

Ensure that you are root, and then run the install.sde script. Select 1 to install Synergy/DE, and then select 1 again for License Manager. You can accept the defaults for the other prompts. This will run lmcheck, which will check connectivity to the Synergy License Web Service. You’ll see a success or failure message.

If lmcheck succeeds, the current synd is stopped, lmcheck and additional files are installed, and the new synd is started and makes its first poll. Continue with step 4.

If lmcheck fails, make a note of the error message and contact Synergy/DE Developer Support. The upgrade package offers you the option to continue with the installation or abort. Go ahead and complete the installation so that the REV11 files are installed. You can then use the lmcheck utility to help troubleshoot the connectivity problem.

4.

Continue using your applications as you normally would. The license admin at your company will receive an email from Synergex Customer Service when the licensing upgrade is complete.

5.

Synchronize your license data by running lmu -sync. Or, you can just wait for the system to poll again. The polling schedule depends on how close the license is to expiring; see the Licensing FAQ for details.

Installing the licensing upgrade package on a new system

Follow these instructions when you need to install the licensing upgrade package on a new system on which you’re planning to install a pre-11 version of Synergy/DE.

1.

When you order the new license from Synergex, tell your Synergex customer service representative that you are going to install the licensing upgrade package on the system. Your company’s license admin will get a confirmation email with an install code.

2.

Install the pre-11 version of Synergy/DE as you normally would.

3.

If you don’t already have the licensing upgrade package, go to the Downloads area of the Synergex Resource Center, navigate to the page for your version and platform, download the licensing upgrade package, and then run it to unpack the files.

4.

Extract the .tar file to your installation directory.

5.

Ensure that you are root, and then run the install.sde script. Select 1 to install Synergy/DE, and then select 1 again for License Manager. You can accept the defaults for the other prompts. This will run lmcheck, which will check connectivity to the Synergy License Web Service. You’ll see a success or failure message.

If lmcheck succeeds, the current synd is stopped, lmcheck and additional files are installed, and the new synd is started. Continue with step 6.

If lmcheck fails, make a note of the error message and contact Synergy/DE Developer Support. The upgrade package offers you the option to continue with the installation or abort. Go ahead and complete the installation so that the REV11 files are installed. You can then use the lmcheck utility to help troubleshoot the connectivity problem. You will need to resolve the connectivity issue before completing step 6.

Upgrading Synergy/DE on a system that has the licensing upgrade package installed

Follow these instructions when you have installed the licensing upgrade package on an existing system and now wish to upgrade Synergy/DE on that system.

Upgrading to version 11 or higher

Just upgrade Synergy/DE as you normally would. Once the installation is complete, License Manager will poll and download new license data.

Upgrading to a version prior to 11

These instructions apply to major version upgrades as well as to patches and hotfixes.

When you install the upgrade version, do not install License Manager (choose 1 to deselect it). REV11 licensing will continue to function.

If you inadvertently install License Manager when upgrading, licensing will not work because the upgrade version cannot access the REV11 license file. You will need to reinstall REV11 by following the instructions in Installing the licensing upgrade package above.

Removing the licensing upgrade package

Follow these instructions to remove the licensing upgrade package and restore pre-REV11 licensing.

1.

Reinstall the LM component that corresponds to your installed version of Synergy/DE. This will overwrite the licensing upgrade package files, but it does not restore the pre-REV11 license file. To complete the process, you’ll need to reinitialize licensing.

2.

Contact Synergy/DE Developer Support to get the current -k password (also referred to as a kill string), and then run the following command:

lmu –kpassword

3.

Reinitialize licensing and specify the same licensee name you used previously on this system:

lmu -cLicenseeName

This will generate a new registration string.

4.

Contact Synergex Customer Service to explain that you’ve removed the licensing upgrade package and give them your new registration string. Once they’ve updated the registration string in Synergex’s database, you can generate and download a Synergy key file (.skf) from the Licenses area of the Synergex Resource Center.