Solutions
How To run Chklic on Linux/Unix and Windows
| ID: | S128639 | |
| Published: | 13 August 2006 | |
| Updated: | 07 July 2022 |
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. Note that upgrading to SLM 2.3.0 is strongly recommended.
-
In SLM 2.3.0 the Chklic utility has been included with your SLM installation, so it does not have to be downloaded.
The easiest way to collect the logs is to launch the SLM GUI (by runningserenalm) 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_logsc:\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 12324567This 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
