Modifying license configurations (Windows)

Do not remove or edit registry entries or uninstall licensing to change a license configuration.

This topic includes instructions for the following configuration changes:

Note

When you uninstall Synergy/DE, License Manager is removed but the license configuration remains. If you later reinstall Synergy/DE on the same machine, it will use the existing licensee name and registration string and will install with the same license configuration (license server/stand-alone or license client). If you need to remove your license configuration completely, run lmu -k before uninstalling Synergy/DE. The -k option requires a password, which can be obtained by contacting Synergy/DE Developer Support.

Changing a license client to use a different license server or port

From the command line

On the client, run the following command:

lmu -rNewServer -nc

If the server is running on a non-default port, append a colon followed by the port number to the end of the server name:

lmu -rNewServer:#### -nc

To change only the port number for a license client, use either of the following:

lmu -rExistingServer -nc -po####
lmu -rExistingServer:#### -nc

From the Synergy Configuration Program

1. On the license client, start the Synergy Configuration Program and click the Advanced button on the Licensing tab.
2. To change the license server, in the Advanced License Manager dialog, change the value in the Server name field. The server must have the necessary licensing in place before you can run applications on the client.
3. To change the port for the license server or specify a non-default port for the new license server, add a colon followed by the port number after the server name (e.g., Tiger:5555).
4. Click OK.

Changing a license client to a license server

You must have administrator privileges to change the license configuration from client to server.

1. Contact Synergex Customer Service and order a license for the system. You will need to provide a licensee name. Customer Service will send you an email with an install code.
2. Contact Synergy/DE Developer Support to get the current -k password (also referred to as a kill string).
3. From the command line, run 
lmu –kpassword
4. Start the Synergy Configuration Program. When you are prompted to configure licensing, select Server and, in the Licensee name field, enter the name that you provided to Synergex when you ordered the license for this machine.

Or, from the command line, run lmu -cLicenseeName -ns

SynConfig (or lmu) will report “Reg string not found.”

5. Apply the install code sent to you by Synergex Customer Service. (See Applying an install code.) License Manager will automatically sync with the Synergy License Web Service, and your product keys will be downloaded and installed.

Changing a license server to a license client

If the machine you are changing to a license client was serving licenses, you will need to update its license clients to use a different license server. See Changing a license client to use a different license server or port.

From the command line

Run the following command: 

lmu -rServerName -nc

To specify a non-default port, append a colon followed by the port number to the end of the server name:

lmu -rServerName:#### -nc

From the Synergy Configuration Program

1. Start the Synergy Configuration Program and click the Advanced button on the Licensing tab.
2. In the Advanced License Manager dialog box, select Client and type the DNS name or IP address of the network license server in the Server name field. If your configuration includes a backup license server, you must use the DNS name.
3. If the license server is not running on the default port (2380), specify the port by adding a colon followed by the port number after the server name or IP address (e.g., Tiger:5555).
4. Click OK.

Changing a license server’s port

By default, License Manager server (synd) runs on port 2380. We recommend that you use this port if at all possible, because a non-default port must be specified not only on the license server, but—for network licensing—on all the license clients as well.

To change the License Manager server port, you will first need to change it on the license server using an lmu command line option. (It cannot be changed from SynConfig on the server.) Then, you will need to specify the new port on each client, which can be done from either SynConfig or from the command line.

1. Change the port on the server using lmu with the -ns, -r, and -po options. Valid ports are in the range 1024 through 32767. For example, 
lmu -r -ns -po5555

You’ll be prompted to confirm the change. (Or, you can include the -y option to skip the prompt and automatically accept the change.) If you have stand-alone licensing, you are done.

2. Change the port on each license client from either the command line or the Synergy Configuration Program: 
lmu -nc –rTiger –po5555
lmu –nc –rTiger:5555

Changing back to the default port

To change the License Manager server port back to the default, you’ll first need to change it on the server, then on the license clients.

1. Change the port on the server using lmu with the -ns and -r options. Do not specify a port. 
lmu -ns -r

You’ll be prompted to confirm the change. (Or, you can include the -y option to skip the prompt and automatically accept the change.) If you have stand-alone licensing, you are done.

2. Change the port on each license client from either the command line or SynConfig: 
lmu -nc –rTiger