Table of Contents Previous Chapter 4 The Software License Server

4 The Software License Server

SDT uses a software license mechanism that determines how many instances of the software are allowed to run simultaneously on a site. This chapter describes the software license control server and its essential components. The following topics are discussed:

General

Your company has purchased a certain number of SDT licenses. These licenses are controlled by a third party software, FLEXlm\xaa , which serves the SDT applications license check-in and check-out requests.

FLEXlm is designed to serve multiple applications, so installing SDT on your site should not cause any problems if the applications already installed on your computer environment use FLEXlm.

The process of checking licenses in and out from the pool is controlled by dedicated software that may run on any of the nodes in a network. The license control software consists of two processes, with the process names:

These two processes make up the license server, and must run in the same physical node of the network. The node is determined when you install the SDT software (see chapter 3, Installation Procedure).

----------------------------------------------------------------------
Caution!                                                                
Once it is properly installed and running, the license control mech     
anism will work on its own without any user having to operate it. All   
necessary operations, such as upgrading licenses, should be restrict    
ed to authorized personnel, such as the system manager. Otherwise,      
malfunctions may occur.                                                 
----------------------------------------------------------------------
Each time you start up an application which is license controlled (such as the SDT Organizer, the Message Sequence Chart Editor and the Validator), one license is reserved for you.

Each time an application terminates, the license is returned to the pool. SDT's code generating tools, which are licensed separately, are however an exception to this rule. Once a code generator license is checked out, it is reserved for the user until he exits SDT or explicitly gives up the license, which returns it to the pool. To give up a license, the Organizer's Give Up License command is used (the command is available as an option from the Organizer's Help menu; see "License Info" on page 1131 in chapter 22, The SDT Organizer in the volume SDT 3.01 Reference Manual.)

Starting the License Server

Automatic Startup

If you have followed the instructions in chapter 3, Installation Procedure properly, the license server will start up automatically when you boot the computer.

Manual Startup

If you have not inserted the line to startup the license server in your boot file, or if the license server goes down for some reason (but the computer does not need to be restarted), you will have to start the license server manually.

You restart the license server as follows:

  1. Make sure you are logged in on the computer where the license server is to run.
  2. Type:
$telelogic/bin/startlicd 
where $telelogic points to the root directory where you have installed SDT. If this variable is not set, first do as follows:
   cd /appl/telelogic

Updating the License File

There may be times when you will need to update your license file, for instance when you have purchased additional tools or licenses, or are upgrading SDT towards a higher version. You do this as follows:

  1. Update the license file according to the instructions in the document Product License Key. Use the provided script with the name sdt/bin/updatelicd to do this.
  2. If the license server is not updated correctly, you first must stop the license control processes lmgrd and telelogic, using the provided script with the name $telelogic/bin/stoplicd. Remember, you must be the owner of the processes in order to be authorized to kill them.
  3. Restart the license server. See "Starting the License Server", above.

Adding SDT Features to an Existing FLEXlm Server

If any of the applications installed on your computer already uses FLEXlm, it should be sufficient to add the FEATURE lines and the DAEMON line that are included in the Product License Key document to the already existing license.dat file.

The SDT installation must however be updated to use the already existing license.dat instead of the default $telelogic/license.dat

To specify the location of license.dat:

  1. Run the script $telelogic/bin/configlicd
  2. The scripts prompts you to specify the location of the existing license.dat

When the License Server Goes Down

In some cases, the SDT applications may lose contact with the license server. This could happen, for instance, if there is a communication failure in your network, or if the license control processes terminate for some reason. A recovery mechanism is provided. The current SDT users will only have to wait for the license server to come up again. (They will not have to perform any special operations.)

Losing Contact with the License Server

From an SDT user's point of view, the following will happen if the license server goes down:

Regaining Contact with License Server

When the license server comes back up, the SDT tools can be used again. Users are notified of this by a message in the Organizer's log window and by the SDT tools reverting to their normal functionality.

Logging

All events that the license control mechanism administrates are logged in a file named $telelogic/license.log. These events include:

Each log also specifies:

Reference Part: The License File

The SDT installation includes a license file, license.dat, along with instructions on how to fill in proper values. An example of a license file is shown below.

Example 6    
---------------------------------------------------
SERVER hostname hostid 1763                          
DAEMON telelogic /install/sdt/flex/telelogic         
FEATURE SDT-Base telelogic 3.000 1-mar-95 0 CODE ""  
FEATURE SDT-MSCE telelogic 2.010 1-mar-95 0 CODE ""  
---------------------------------------------------
Where the following are keywords:
SERVER, 1763, DAEMON, FEATURE.

At Installation Time

When you install SDT as described in chapter 3, Installation Procedure, the following parameters will automatically be set to the appropriate values:

After Installation

You will have to fill in the strings CODE (see Example 6 above) with the values that are provided in the separate document Product License Key.

Each line that begins with FEATURE contains the following information:

Reference Part: Error Messages

This section contains a list of the most common error messages which are issued by the software license server.

The error codes that are issued are in the range 7101 - 7147.

In the event of an undocumented error message, please contact Telelogic Customer Support. The phone number can be found on page 1 of this manual.

-------------------------------------------------------------------
Error Code  Message         Suggested Action                         
-------------------------------------------------------------------
7101        cannot find     The license.dat file cannot be           
            
license file   found via the environment variable       
                            LM_LICENSE_FILE. The file                
                            license.dat is stored at the root        
                            directory of your SDT installation       
                            ($telelogic).                            
                            1.  Check that this variable is set up   
                            correctly. For instance, the com         
                            mand: 
more $LM_LICENSE_FILE should result in a printout like: SERVER xxx yyy 17xx DAEMON telelogic etc. 2. If the license.dat file is not displayed as described above, edit the file sdt.sou
Change the path name to the di rectory containing license.dat to the correct one, according to where SDT is installed. 7103 cannot 1. Examine the log file connect to a license.log which is stored in license the root directory of your SDT installation. If you find the mes sage Retry socket bind address in use, edit the license.dat file and change the number 17xx at the end of the first line (which begins with SERVER).
Change the number to any other higher octal number e.g. 1767. 2. Terminate the processes lmgrd and telelogic 3. Restart the license server by ex ecuting startlicd 7105 no such A typing error has been introduced feature in license.dat exists 1. If the message is displayed when you start SDT, the prob lem is at the first FEATURE line, in which the name SDT is mis spelled. Correct it to SDT. 2. Terminate the license server (see step 2. under error code 7103 above) 3. Restart the license server (see step 3. under error code 7103 above) 7107 no socket The license.dat file has not a connection suitable file protection mode. to license 1. Change the file protection so manager that all users have read access.
server chmod 644 license.dat 2. Terminate the license server (see step 2. under error code 7103 above) 3. Restart the license server (see step 3. under error code 7103 above) 7108 encryption This message is displayed when a code in SDT tool is started. The problem is license file due to an inconsistency in the is encryption key for that tool. inconsistent 1. Verify the contents of the file license.dat with the infor mation in the Product License Key. The information is case sensitive and must match ex actly. 2. Locate the mismatch(es) and correct them 3. Terminate the license server (see step 2. under error code 7103 above) 4. Restart the license server (see step 3. under error code 7103 above) 7115 cannot The license server has not been connect to started properly. license 5. Terminate the license server server (see step 2. under error code 7103 above) 6. Restart the license server (see step 3. under error code 7103 above) -------------------------------------------------------------------
This page intentionally left blank

 
Table of Contents Next Chapter