Vector License Client » Command Line Interface » Parameter Overview

Parameter Overview

 

To use the commands activate, deactivate, reactivate, repair, updateLicenses and listLicenses, different parameters that correspond to your specific use case must be set. The following table gives you an overview of the possible parameters and their description. The use of the parameters is explained on the help pages of the commands.

Parameter Group

Parameter

Description

—

ActivationKey

Mandatory parameter for the activate command. The licenses from this key are activated.

License Carrier

  1. deviceSerial
    1. for computers: serial number from the container.
      Example: 130-3026355526,
    2. for keymen: serial number from the container (is also written on the device).
      Example: 3-3665797
    3. for Vector network interfaces: serial number of the device (indicated on the device).
      Example: 007150-028399
  2. local – Computer
  3. dongle
  4. hardwareType - Vector network interface type, e.g., VN1610
  5. anyVNI
  6. anyVNIDongle

Mandatory parameters (all) for the activate and repair command.

Optional parameters (all) for the deactivate or reactivate command.

They must or can be used to define the license carrier on which licenses are to be activated.

Note

Note regarding the activate and repair commands:

  • The parameters dongle, hardwareType, anyVNI and anyVNIDongle can only be used if a device of exactly the same type is connected.
  • If several devices are connected, the command will fail since the device cannot be clearly identified.

Note

Note regarding the deactivate/reactivate command:

  • If the device cannot be found, the command will fail.
  • If several devices have been found, the licenses of all detected devices are deactivated/reactivated.
  • If this parameter is not entered, the connected devices are scanned for licenses and the detected licenses are deactivated/reactivated.

Licenses
  1. Licenses – List of Vector License IDs,
    Separator: semicolon
    Example: 5000123;5028471;5002836
  2. Products – List with products and their versions,
    Format for a product: <Product name>,VERSION=<version> ,
    Separator: semicolon
    Example: „CANoe“,VERSION=10.0;“CANoe Option .CAN“,VERSION=10.0
  3. ProductCodes – Similar to Products but, instead of product names, product codes are used.
    Format for a product code: <Product code>,VERSION=<version> ,
    Separator: semicolon
    Example: 55000,VERSION=10.0;55001,VERSION=10.0

Optional parameters (all) for the activate, deactivate, and reactivate command.

They can be used to define which licenses from the activation key are to be activated or deactivated/reactivated.

Note

Note

  • If this parameter is not set, all licenses from the activation key are activated or all detected licenses are deactivated/reactivated.
  • If, for a Vector license ID (or product / product code), several licenses can be found, only one (the first one) is activated or all licenses are deactivated/reactivated
  • If specified licenses cannot be found, the command fails, i.e., no license is activated or deactivated/reactivated.

License type
  1. NamedUser – Optionally, Named User licenses can be activated by a specific user.
    Example: -NamedUser visxyz
  2. DeviceLocked – Find and activate Device Locked licenses
  3. DeviceLockedAssigned – Find and activate licenses assigned to the specified license carrier.
  4. NamedUserDeviceActivation - Find and activate Named User (Device Activation) licenses that are assigned to the specified user, example: -NamedUserDeviceActivation visxyz
  5. Floating - Find and activate Floating licenses.
  6. NamedUserNetworkActivation - Find and activate Named User (Network Activation) licenses.
  7. CITeam – Find and activate CI Team licenses.
  8. TestBench – Find and activate Test Bench licenses.
  9. CIAgentCount- Find and activate CI Agent Count license.

Optional parameters (all) for the activate command. You can enter the license type.

Note

Note

If this parameter is not entered, the first license that can be activated is activated.

—

DisableLogging

Optional parameter for all commands. Normally, all actions are recorded in a logging file (in User|ApplicationData: Vector\Vector License Client\LogFile.log). This parameter can be used to deactivate this function

—

V

Optional parameter for all commands. This parameter can be used to display further detailed information on the console

—

Offline

Mandatory parameter for offline activate, deactivate, reactivate and repair commands. First of all, this parameter is only used to create a vlc file. For the complete procedure, further steps are required.

—

Upload

Mandatory parameter for the upload command in all offline actions.

As parameter, enter only the complete path to the file.

By this, a previously generated context or Receipt file is uploaded. During this process, an update file (*.vlu) may be generated.

—

OutputPath

Optional parameter for offline activate, deactivate, reactivate,repair, upload and update commands.

Enter the complete path where the output file (*.vlc, *.vlu or *.vlr) is to be saved.

Note

Note

  • If you do not enter this parameter, the default name of the file is stored in the temp directory of the system.
  • When uploading a receipt file, no output file is generated and therefore no OutputPath can be entered.

—

Update

Mandatory parameter for the update command in all offline actions.

As parameter, enter only the complete path to the file.

During this process, a receipt file (*.vlr) is generated that can be uploaded via the upload command.

—

Overwrite

Optional parameter for offline activate, deactivate, reactivate, repair, upload and update commands.

Overwrites the already existing file.

Note

Note

  • This parameter can only be used if the parameter OutputPath is specified. If available, the specified file is overwritten.

—

Remote

Optional parameter for online activate, deactivate, reactivate, repair, updateLicenses commands. Enter the IP-address of the remote computer.

—

NameListFile

Optional parameter for commands to manage user assignments.

 

—

NameList

Optional parameter for commands to manage user assignments.

Note

Note Proxy Settings:

The proxy server parameters are optional parameters. If you do not enter proxy server parameters, the system proxy settings are used.
Additionally you have the following options to manage your proxy settings:

  1. Connect without proxy settings
    For the direct connection without proxy use the parameter:
  • -withoutProxy
  1. Use custom proxy settings
    To use a custom proxy use the parameters:
  • -Proxy <Proxy URL>
  • -proxyPort <port>
  • -proxyUserName <username>
  • -proxyPassword <Password>