Activating Your SySAM RAPStore License

Activate your SySAM license after you obtain the license file and install RAP on your host machine.

Prerequisites
Obtain a license from SPDC.
  1. Change to $RAP/RAPStore/, where $RAP is your RAP installation directory. The default installation directory is /opt/sybase/RAP.
  2. Source the environment variables: source SYBASE.sh.
  3. Log in to the RAPStore server.

    • To check the license type, enter:
      sp_iqlmconfig
      The valid license types for RAP are:
      • CP (CPU license for Production)

      • DT (Development and Test, not CPU dependent)

      • SF (CPU license for Stand By Production)

    • To change the license type, run the appropriate command:
      sp_iqlmconfig ‘Edition’, ‘EE’
      where EE is the Enterprise Edition.
      and
      sp_iqlmconfig ‘license type’, ‘LT
      where LT is a valid license type.
  4. To shut down the RAPStore server run the stop_iq script, and stop the appropriate server.
  5. If you are running in unserved mode, copy the license file saved from SPDC to $RAP/RAPStore/SYSAM-2_0/licenses on the host machine.
    Note: Supplement the dynamically generated licenses you downloaded from SPDC with static licenses provided on the license CD in your RAP package. Copy the file for the appropriate license type (CP, DT, SF) to the $RAP/RAPStore/SYSAM-2_0/licenses directory on the host machine.

    If you use the ftp utility to transfer the license file, be sure to specify ASCII mode.

  6. If you are running in served mode, copy the license file to <license_server_install_dir>/SYSAM-2_0/licenses on the license server.
    Note: Supplement the dynamically generated licenses you downloaded from SPDC with static licenses provided on the license CD in your RAP package. Copy the file for the appropriate license type (CP, DT, SF) to the directory <license_server_install_dir>/SYSAM-2_0/licenses on the license server.
  7. Change to $RAP/RAPStore/SYSAM-2_0/bin. If the license server is not running, start the license server:
    sysam start

    If the license server has been started before the RAP license is downloaded, run:

    sysam reread

    You must have at least one served license in the licenses directory $RAP/RAPStore/SYSAM-2_0/licenses, or the error “License Manager: Can’t initialize...” is reported when you attempt to start the license server.

  8. Update the license server options file:
    1. Change to the <license_server_install_dir>/SYSAM-2_0/licenses directory on the license server.
    2. Add INCLUDE SY_RAP PROJECT RAP to the file SYBASE.opt.
    3. Change to <license_server_install_dir>/SYSAM-2_0/licenses on the license server.
  9. Create a sybase.lic file in $RAP/RAPStore/SYSAM-2_0/licenses.
    The sybase.lic file specifies the port number of the license server, so SySAM can retrieve the appropriate license. The contents of the sybase.lic file is:
    SERVER <license_server_host_name> ANY 27000
    USE_SERVER
    where 27000 is the default port. You can use a different port number.
  10. Restart the RAPStore server.
Note:

To verify your license, you can run the sp_lmconfig stored procedure in Interactive SQL (isql) or check the IQ error log.

In the IQ error log, a line beginning with “Checked out license...” indicates that the license configuration is successful. If you see a “Sysam: FLEXnet Licensing error:” message, check with your Sybase technical support or customer service representative to resolve the issue.

Related tasks
Obtaining Licenses