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 10.1* or 10.3*. (If you need help determining the installed version of Synergy/DE, see Synergex KnowledgeBase article 2491.)

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.

This topic includes instructions for the following:

Installing the licensing upgrade package

Installing the licensing upgrade package on a new system

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

Removing the licensing upgrade package

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. Log into the Synergex Resource Center, navigate to Downloads, and go to the REV11 Licensing Upgrade Package page. Download the licensing upgrade package for your version of Unix 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. Stop any running Synergy programs using dbr or dbs. Also stop the xfServer/xfServerPlus and SQL OpenNet servers. For rsynd, use the -q option. For vtxnetd, use the vtxkill utility.
4. Ensure that you are root, and then execute 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.
5. 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.
6. 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, download the package for your version of Unix from the REV11 Licensing Upgrade Package page in the Synergex Resource Center, and then run it to unpack the files.
4. If there are any registered dbs services running, stop them.
5. Extract the .tar file to your installation directory.
6. Ensure that you are root, and then execute 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.
7. Apply the install code (from step 1) with lmu -installcode. See Applying an install code.

The install code transmits your registration string to Synergex. Then, product keys will be generated, downloaded to your system, and installed automatically.

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.

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

Note

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

If LicenseeName contains spaces, it must be enclosed in quotation marks (" "). 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.
5. Use the .skf file to install your product keys. See Installing product keys.