Co-existing with earlier versions of SySAM

Replication Server version 15.0 uses a newer version of the SySAM licensing technology and an updated license format. On any machine, you can have only one instance of a license server running. You must make some adjustments to use earlier versions of Sybase products with Replication Server 15.0.

Case 1: If you are using a central network server for Replication Server 15.0, and a network license server-based SySAM license for earlier versions of the product, migrate to Replication Server version 15.0:

  1. Update the network license software with the version provided in Replication Server 15.0. Use the instructions in “Setting up a network license server”.

  2. Copy the earlier license files (typically, a single file named license.dat) into the new $SYBASE/SYSAM-2_0/licenses directory and rename license.dat to license.lic.

  3. Shut down the old license server and start the new license server.

  4. Copy any new licenses into this new directory.

Old and new Sybase software now use this license server.

Case 2: If you are using individual license servers for earlier versions of Replication Server, with each machine running earlier Sybase software hosting a local license server, Sybase recommends that you move to a single network license server model to migrate to Replication Server version 15.0.

StepsUsing a central license server only for new licenses

  1. Select the machine for the new network license server and install the SySAM network license server supplied with Replication Server version 15.0 on that machine.

  2. If this machine is already running an older license server, use the instructions in Case 1 to migrate the local licenses. All new licenses are now installed on this machine.

  3. Point the Replication Server version 15.0 installation to this license server. Use the lmpath utility (see “Using SySAM utilities”) to do this or edit license.dat and add these lines at the beginning of the file:

    SERVER <network license server hostname> ANY <license server port>
    VENDOR SYBASE
    USE_SERVER
    

StepsMigrating old licenses to a new central license server

  1. Set up the new SySAM network license server using the instructions in “Setting up a network license server”.

  2. Collect licenses from all old local license servers to deploy to the new network license server.

    1. Create a new license file that includes the contents of all individual licenses from each earlier local license server.

      When you create the new license file, discard the license header from each file. The header is the first three lines that start with “SERVER,” “VENDOR,” and “USE_SERVER.”

    2. Create one license header with the above three lines in the merged file to match the requirements on the new network license server and save this file as license.lic in the licenses directory.

  3. Shut down the earlier individual license servers on each machine and point the software to the new license server. Use the lmpath utility (see “Using SySAM utilities”) to do this, or edit the license.dat file on each installation by adding these lines at the beginning of the file:

    SERVER <network license server hostname> ANY <license server port>
    VENDOR SYBASE
    USE_SERVER
    

Case 3 If you are not using the network license server for Replication Server version 15.0, no changes are required to the previous software. When fulfilling Replication Server version 15.0 licenses, select the unserved license model and copy the license locally on each installation. The software runs appropriately, however, you lose the asset management functionality in this approach. See “Choosing the appropriate license server configuration” for the pros and cons of using a network license server versus using a local license file.