Using the licensing upgrade package on Windows

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

For network licensing, the licensing upgrade package needs to be installed only on the license server machine. Although it’s not required to install the upgrade package on the license clients, you may want to in order to get updated versions of lmu and the Synergy Configuration Program, which can display the new, longer registration string. (Otherwise, you will see “New-----Reg” instead of the actual string.)

On Windows, the licensing upgrade package installs REV11 versions of synd, lmu, lmuelevate, the Synergy Configuration Program (SynConfig), and the SynConfig online help. It also installs the lmcheck utility.

Note

If you install the licensing upgrade package on a system that currently has version 9.5.3b, the system will be updated to use IP-based licensing. IP-based licensing (introduced in version 10.1) uses sockets to communicate rather than pipes. The updated license server can accept connections from license clients using either sockets or pipes, so you don’t need to update your license clients. By default, synd runs on port 2380; we strongly recommend you use this port if at all possible. If you need to change it, see Changing a license server’s port. If there is a firewall between your License Manager server and its license clients, you’ll need to allow an exclusion for the port that License Manager is using. See Cannot access Network License Server error.

This topic includes instructions for the following:

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 to your license server.
2. If there are any registered dbs services running, stop them.
3. Run the downloaded executable and follow the instructions in the wizard. The installation will check connectivity to the Synergy License Web Service.

If the connectivity check fails, you’ll see a “cannot access the Synergy License Web Service” message and be offered the option to abort or continue the installation. We recommend you 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. 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. To manually sync, do one of the following:

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.

Important

If you are installing both 32-bit and 64-bit Synergy/DE on a 64-bit system, install both versions of Synergy/DE before installing the licensing upgrade package.

1. When you order the new license from Synergex, tell your Synergex customer service representative that you’re going to install the licensing upgrade package on the system. Your company’s license admin will be sent 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 it from the REV11 Licensing Upgrade Package page in the Synergex Resource Center.
4. If there are any registered dbs services running, stop them.
5. Run the downloaded executable and follow the instructions in the wizard. The installation will check connectivity to the Synergy License Web Service.

If the connectivity check fails, you’ll see a “cannot access the Synergy License Web Service” message and be offered the option to abort or continue the installation. We recommend you 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 5.

6. Apply the install code (from step 1) by doing one of the following:

The install code transmits your registration string to Synergex. Then, products 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. These instructions assume that you have already contacted Synergex Customer Service to request an upgrade.

1. Uninstall the licensing upgrade package: Go to Programs and Features (accessed from Windows Control Panel), right-click on “REV11 Licensing Upgrade Package,” and select Uninstall. Licensing will be “broken” until you upgrade Synergy/DE.
2. 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.

1. Upgrade Synergy/DE as you normally would. If you have both 32-bit and 64-bit Synergy/DE installed on a 64-bit system, upgrade 64-bit first, and then 32-bit, before going to step 2.
2. Repair the licensing upgrade package installation: Go to Programs and Features (accessed from Windows Control Panel), right-click on “REV11 Licensing Upgrade Package,” select Change, click Next, and then select Repair.

Removing the licensing upgrade package

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

1. Uninstall the licensing upgrade package: Go to Programs and Features (accessed from Windows Control Panel), right-click on “REV11 Licensing Upgrade Package,” and select Uninstall.

This will remove the licensing upgrade package files and restore your original executable 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 from the command line:
lmu –kpassword
3. Start the Synergy Configuration Program. You’ll be prompted to configure licensing. Select server and specify the same licensee name you used previously on this system. Or, reinitialize licensing from the command line with the following:
lmu -cLicenseeName -ns

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.