VCA/Enterprise Floating license server management (token based)

vca-daemon-tool

This is a license manager command line application.

Usage: /opt/vca/bin/vca-daemon-tool command [options]

Commands:

• get-guid                      Shows HWGUID of a machine where the VCA daemon is running on
• activate-license          Activates a license key provided from the command line
• activate-token             Activates a license token provided from the command line
• list-licenses                 Shows overall license information installed
• get-license-info           Shows detail information of the license specified in the command line
• get-system-info           Shows all license information in detail
• deactivate-license       Deactivates a specified license installed and gets a corresponding token from the activation manager
• get-deactivation-code Shows a deactivation code which was deactivated previously
• update-client               Updates list of clients who can get a license
• kill-daemon                 Provides a way to terminate daemon gracefully
• get-daemon-status      Gets license key and clients information in XML format

Options:

• -h [ --help ] Show s this help message
• -c [ --command ] arg The command to run. Use --help-commands for valid commands
• -s [ --server ] arg (=127.0.0.1) IP address of the license daemon to connect to
• -d [ --license-handle ] arg Specifies the license handle to process. The handle is usually a number, 1, 2, 3, ....
• -l [ --license ] arg A license key from the activation manager
• -t [ --token ] arg Token to activate
• -n [ --client ] arg Client ID to update information
• -a [ --channels ] arg Number of channels to be updated for the specified client ID
• --email-address arg Email address to receive activation confirmation
• --comment arg (=no comment) Comment to store with token activation
• --help-commands Displays a list of valid commands

1. Activating a token

   We need a valid token before we can continue. A paid token or evaluation token for the enterprise license is accepted. The machine also has an Internet connection so that it can reach to the Activation Manager Server.

   Note: To get the floating license, you need to purchase them from the VCA sales team, not from the VCA license portal.

   
   

   In order to activate a license run vca-daemon-tool with activate-token command and a token specified by -t . A license token is a 12 digits alphanumeric number and is separated in 4 digits by - . Please note that we show in abbreviated form replacing the middle four numbers with ... . Example:

   /opt/vca/bin/vca-daemon-tool activate-token -t 0W03-....-06KA

   
   

   After such command we should see something like this if it was successful:

   Activated token, New handle: 1

   
   

   You should supply your token instead of the shown above. After it successfully activated the token, the license was activated as a handle with some number starting from 1. Later in order to see the full license string, you need to login to the Activation Manager Server and input the token in the REDEEM A TOKEN menu. It will show the issued license key with a message saying that the token was already redeemed. Usually, it is of no use of having a full license key string, because you have already activated the license.

   Also if you want to get a full string of a license key, you can add an option to specify an email address. You would get an email from the server with the all information of the issued license key:

   
   

   /opt/vca/bin/vca-daemon-tool activate-token -t 0W03-....-06KA --email-address someone@acompany.com

   
   

   You can also add a comment option to send a hint to the Activation Manager Server. The hint is used for recording:

   /opt/vca/bin/vca-daemon-tool activate-token -t 0W03-....-06KA --email-address someone@acompany.com --comment "For Dell Server"

   
   

   
   

   ATTENTION. If for some reason fail to activate token in such way there is an alternative scenario through web site. Please look into next step.

2. Activating a token through web site. Paste token into https://activationmanager.com , get guid of license server PC using step 5 and paste it with other optional info into next form after clicking 'SUBMIT' button. Then click on 'SUBMIT' button again. Copy and paste activation code into next command: /opt/vca/bin/vca-daemon-tool activate-license -l <ACTIVATION CODE>

3. Give Client an access

   The license daemon server checks the client's credential. If the credential is not in the list, it blocks accessing to get an license.

   To give 'client1' a full access type the following command:

   /opt/vca/bin/vca-daemon-tool update-client -d 1 -n "client1" -a 10

   , where 10 is a number of provided channels and 1 - handle of the license.

   
   

   To give anonymous client a full access type the following command:

   /opt/vca/bin/vca-daemon-tool update-client -d 1 -n "" -a 10

   
   

   If successful, in both cases we should see the following:

   Client is updated

   
   

4. Getting information of activated licenses

   /opt/vca/bin/vca-daemon-tool list-licenses

   1. Pro 10ch Enterprise

   It is a 10 channel VCA pro Enterprise license whose handle value is 1.

5. We can obtain hardware GUID by running following command: 

   /opt/vca/bin/vca-daemon-tool get-guid

   GUID: C8A7..........4C0D   
6. Specific license deactivation example

   /opt/vca/bin/vca-daemon-tool deactivate-license -d 1

   Successfully deactivated license handle 1 token assigned is 0K0S-....-0DST

   Deactivated license: 1 Token: 0K0S-....-0DST

   
   

   After that, you can re-activate such token on this or another VCA Enterprise Floating license server. 
7. To completely remove all installed licenses including expired and deactivated (ATTENTION: use with caution and only if you fully understand what you are doing)rm -rf /var/lib/vdm  

   /opt/vca/bin/vca-daemon-tool kill-daemon

   Daemon is killed

Some additional steps will be described later TBD.