Solutions

How To run Chklic on Linux/Unix and Windows



ID:    S128639
Published:    13 August 2006
Updated:    24 June 2019

Operating System(s)

  • All Unix
  • All Windows

Product(s)

  • Dimensions CM
  • Dimensions RM
  • PVCS Tracker
  • PVCS Version Manager
  • SBM
  • TeamTrack
 

Description

This article contains the Chklic tools for Windows and Linux/Unix, as well as instructions on how to install and use them. These tools are intended to be used at the request of the Customer Support team.

Resolution

If you are running SLM 2.2.0 or older, click here.
 
  • Starting with SLM 2.3.0, the Chklic utility has already been included with your SLM installation and does not need to be downloaded.

    The easiest way to collect the logs is to launch the SLM GUI (by running serenalm) and press the Collect Logs button:



    (If your SLM GUI does not have the Collect Logs button, click here.)

    Pressing Collect Logs creates a ZIP file on your Desktop with a unique filename, which you can send to Customer Support. Example:



    If you do not have graphical access to your server, the file can also be generated by typing the following command from the SLM installation directory:

    slm collect_logs

    (This command is identical to the Collect Logs button and will generate an output file on your Desktop with a unique name. If you need to save the file elsewhere, you can provide an alternate output file by specifying a path with a .zip extension. Example: slm collect_logs c:\temp\logs.zip)

    Both features are available on all SLM platforms.
     
  • If you are using SLM 2.2.0 or older

    Your GUI will look similar to this:



    As these older license manager releases do not have the Collect Logs feature built-in, use the following instructions:
     
    • For Windows:
       
      Download the file chklic_bat.txt that is attached to this article and save it to the License Manager directory as chklic.bat. The default installation directory for the License Manager is "C:\Program Files\Serena\License Manager". It is the same directory that contains your serena.lic (or merant.lic) file.

      After the file has been saved, open a Command Prompt (CMD.EXE). You may have to be an Administrator to run chklic.bat, so try opening CMD.EXE using right-click -> Run as administrator.

      In the Command Prompt window that opened, execute the following command to go the SLM installation directory:
       
         cd /d "%SERENA_LM_HOME%"
        
      Now execute:

         chklic CaseNumber

      where CaseNumber is the number of your support incident. (If you do not have a case number, you can pick an identifier of your choice, like today's date.)

      For instance, if your case number is 1234567 you should type:

         C:\Program Files\Serena\License Manager>chklic 1234567
       
      This will create a subdirectory (folder) called 1234567 and populate it with a number of files that detail the operation of your License Server. You should add the files in this subdirectory to a single ZIP file and send that ZIP file to Customer Support. You are of course welcome to first examine these files yourself, as they may provide you with additional information on the problem you are encountering.

      Once the files have been sent to Customer Support, you can safely delete the sub-directory that bears your case number, being careful not to alter its parent directory.
       
    • For Linux/Unix:

      Download the file chklic.sh that is attached to this article and save it to the License Manager directory. The default installation directory for the License Manager is /usr/serena/SerenaLicenseManager/OperatingSystem (eg. /usr/serena/SerenaLicenseManager/solaris64). It is the same directory that contains your serena.lic (or merant.lic) file.

      After the file has been saved, open a shell prompt and execute:

         cd InstallationDirectory

      Example:

         $ cd /usr/serena/SerenaLicenseManager/solaris64

      Now execute:

         chklic.sh CaseNumber

      where CaseNumber is the number of your support incident. (If you do not have a case number, you can pick an identifier of your choice, like today's date.)

      For instance, if your case number is 1234567 you should type:

         $ chklic.sh 12324567
       
      This will create a TAR file called 1234567.tar, containing a number of files that detail the operation of your License Server. Please send that TAR file to Customer Support. You are of course welcome to first examine these files yourself, as they may provide you with additional information on the problem you are encountering.

      Once the TAR file has been sent to Customer Support, you can safely delete it.

 

Migration ID

5003875

Attachment

File NameFile SizeDownLoad
chklic.sh 2K HTTP
chklic_bat.txt 3K HTTP

Rate this Solution

Find Answers

Type a question or describe what you are looking for below

My Recent Searches

Welcome kb sso

Additional Assistance

  • Submit a Case Online
  • FAQs