Using the DSCheckLS Tool

When setting up the connection between the License Server and Client machines, users may encounter communication issues between the two machines with no obvious source of error. Some common issues are that the client machine cannot communicate with the DS license server, or the DS license server may not be available. The DSCheckLS Tool is a command-line tool that runs from a user’s computer to confirm that the Dassault Systèmes License Server (DSLS) has been set up properly. 

This article explains how to use the DSCheckLS Tool and what information to expect.  

Accessing the DSCheckLS Tool

1. On the Client Machine, search for Command Prompt and Run the program as Administrator in the Windows Start Menu 
   
2. Open Windows File Explorer and navigate to the directory:
   <LicensingClientInstallPath>\OS\code\bin
   This location varies depending on the installation path. For example:
   C:\Program Files\Dassault Systemes\B34\win_b64\code\bin
3. Drag the DSCheckLS.exe file into the Command Prompt or Right-Click on the Tool and select Copy as path, and Paste the file location in the Command Prompt window
   
4. Hitting Enter on the Command Prompt will display the status of the license server.
   If you run the DSCheckLS Tool with [ -h] appended at the end, you will get the command syntax where:
   

   [ -l]: displays the status of the license servers
   [ -r lic]: requests license "lic" enrolled on the license server.
   [ -t lic]: requests Token licenses enrolled on the license server.
   
   While the [ -r lic] existing option requests Named User and Concurrent User type licenses, the
   [ -t lic] option requests Token type licenses.
   Note: There is no option available to request Credit type licenses.

Running the [ -l] Command

This is what tends to be run first and is run by default when running the DSCheckLS Tool without additional switches. The DSCheckLS connects with the list of declared license servers in DSLicSrv.txt file (Located in C:\ProgramData\DassaultSystemes\Licenses folder) and rapidly requests and releases a license to check that license servers are operating correctly, without having to run processes such as CATIA or DSLicMgt.

It will display a status along with information about each contacted license server:

• The pathname and contents of the DSLicSrv.txt file
• *Server status
• configuration type: STANDALONE or FAILOVER or MANAGED
• version number
• build date
• if offline extraction is Enabled or Disabled
• IP address
• licensing port number
• exchange message duration with server (ms)
• OS name
• OS version
• OS architecture
• computer id

*Each status is described in the following table:

Depending on the status displayed after having run the command, you may be able to diagnose the issue.

Running the [ -r lic] Command

This grants and then releases the license of interest. You will need to spell out the entire license key feature as shown on the DSLS.

If the request succeeds, the following information related to the granted license is displayed, for example:

Information Displayed:

• feature
• internal_id
• status
• com_type
• model
• exp_date
• nb_token
• customer site
• customer country
• customer id
• server
• nb addditional infos (if available)
• postion in queue (if available)

If the request fails, the reason is provided.

Data such as authorization rules and MaxReleaseNumber are taken into account

For further technical support, please contact Hawk Ridge Systems at 877.266.4469 for the U.S. or 866.587.6803 for Canada and support@hawkridgesys.com.