Checking DS License Server Availability

About DSCheckLS

DSCheckLS is a command-line tool, installed in the licensing client runtime view, designed to contact the list of declared license servers and rapidly request and release a license to check that license servers are operating correctly, without having to run processes such as CATIA or DSLicMgt. DSCheckLS does not have a graphical interface, no shortcut is added in the Windows start menu, does not need an environment and can be run without using the catstart utility.

How to check the DS License Server Availability using DSCheckLS

This scenario shows you can check the DS License Server Availability using DSCheckLS.

  1. On the license client, go to the directory:

    LicensingClientInstallPath\OS\code\bin

    for example:

    C:\Program Files\Dassault Systemes\B216\win_b64\code\bin

    and run the DSCheckLS -h command to get the command syntax:

    DSCheckLS [-h|-l|-r lic]

    where:
    • -l: displays the status of the license servers
    • -r lic: requests license lic enrolled on the license server.
  2. Run the DSCheckLS -l command.
    DSCheckLS parses the DSLicSrv.txt client-side license server configuration file referencing the list of license servers and validates them.
    The command contacts the declared license servers and displays a status along with information about each contacted license server:
    • the pathname and contents of the DSLicSrv.txt file.
    • server status: each status is described in the following table:
      Status Description
      RUNNING License server up and running.
      NOT_SYNCHRONIZED License server and license client not time-synchronized
      HOST_UNREACHEABLE Host did not reply (for example, host has been shut down)
      NOT_RUNNING Host is up, but license server process not available or down
      CANNOT_CONNECT
      INVALID_SERVER_RESPONSE
      NO_IP_ADDRESS Unable to get license server IP address
      INVALID_SERVER_VERSION  License server too old; minimum license server level required not present
      INVALID_SERVER_VERSION  Ignored: server is declared more than once in the DSLicSrv.txt file
      INVALID_SERVER_DECLARATION Incorrect license server declaration: incorrect format or invalid characters.
    • configuration type: STANDALONE or FAILOVER
    • version number
    • build date
    • IP address
    • licensing port number
    • OS name
    • OS version
    • OS architecture
    • computer id.

    For example:

  3. Run the DSCheckLS -r lic command, replacing lic by a real license name, for example like this: DSCheckLS -r MD2.
    This grants then releases the MD2 license.
    If the request succeeds, the following information related to the granted license is displayed, for example:
    CPF successfully granted.
    #Granted license info:
    # - feature              : MD2
    # - al_id                : DSCheckLS
    # - status               : GRANTED
    # - e                    : STD
    # - model                : NAMED_USER
    # - bsp;                 : 15-Oct-2014 08:15
    # - n                    : 1
    # - customer site        : DS HQ -
    # - customer country     : FRA
    # - customer id          : DSFRA123
    # - server               : lw5sesdsy
    # - itional infos        : 0
    # - postion in queue     : 0

    Data such as authorization rules and MaxReleaseNumber are taken into account