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 (Sybase Product Download Centre).

Task

Change to $RAP/RAPStore/, where $RAP is your RAP installation directory. The default installation directory is /opt/sybase/RAP.
Source the environment variables: source SYBASE.sh.
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.
To shut down the RAPStore server, run the stop_iq script.
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: If you are using a version of RAP that includes secondary static license files, 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.
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: If you are using a version of RAP that includes secondary static license files, 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.
Change to <license_server_install_dir>/SYSAM-2_0/bin. Start the license server, if neccessary:
```
sysam start
```
If the license server was started before you copied the license information to <license_server_install_dir>/SYSAM-2_0/licenses run:
```
sysam reread
```
SySAM reloads all licenses located in <license_server_install_dir>/SYSAM-2_0/licenses.

You must have at least one served license in <license_server_install_dir>/SYSAM-2_0/licenses, or you see “License Manager: Can’t initialize...” when you attempt to start the license server.
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.
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.