Returning a Borrowed License to a Server

You can return a license that was borrowed from a license server before it expires, so that it can be borrowed on another machine.

  1. Launch License Wizard—see Starting the License Wizard.

    The License Wizard launches and displays the Welcome Screen.

  1. Click on Manage Licenses.

    The License Management screen appears.

  1. Click on Manage Local Licenses.

    The Local License Manager opens and displays your product licenses.

  1. Select the license you want to return.

  1. Click on the Return button.

    The license is returned and the product is no longer activated.

You can also return a license in a terminal. This can be useful if you want to script the return procedure to automate the configuration of clients.

  1. Open a Command Prompt with administrator privileges.

  1. In the Command Line prompt, type in the following command to display information on your activated licenses:

    > C:\Program Files (x86)\Toon Boom Animation\Toon Boom [Product Name] [Version] [Edition]\win64\bin\ClientActivation.exe -batch -list

    The utility will output a lot of information about each installed license and each feature they support. We are looking for the block specifying a license's Fulfilment ID, which is output in this format:

    Trust Flags: FULLY TRUSTED Fulfillment Type: PUBLISHER ACTIVATION Status: ENABLED Fulfillment ID: <fulfillment id> Entitlement ID: <product code> Product ID: NAME=<product>;VERSION=<product version> Suite ID: NONE Expiration date: <expiration date>

    Make note of the fulfilment ID for your license.

  1. In the Command Line prompt, type in the following command:

    > C:\Program Files (x86)\Toon Boom Animation\Toon Boom [Product Name] [Version] [Edition]\win64\bin\ClientActivation.exe -batch -return <fulfillment ID> -comm soap -commServer <port@license server>

    • Replace <fulfilment ID> with the fulfillment ID of the license you want to return, obtained in the previous step.
    • Replace <port@license server> with the port number and hostname or IP address of the license server, separated by an @ symbol. If the license server is not configured to use a specific port, simply type an @ symbol followed by the hostname or IP address of the license server.

    If successful, the utility will output the message SUCCESSFULLY SENT RETURN REQUEST at the end of the procedure.

  1. Open a Terminal.

  2. In the terminal, type in the following command to display information on your activated licenses:

    $ sudo /Applications/Toon Boom [Product Name] [Version] [Edition]/[Product Name].app/Contents/tba/macosx/bin/ClientActivation.app/Contents/MacOS/ClientActivation -batch -list | grep -A 7 'Trust Flags:'

    The utility will output detailed information about each installed license including each license's Fulfilment ID, in this format:

    Trust Flags: FULLY TRUSTED Fulfillment Type: PUBLISHER ACTIVATION Status: ENABLED Fulfillment ID: <fulfillment id> Entitlement ID: <product code> Product ID: NAME=<product>;VERSION=<product version> Suite ID: NONE Expiration date: <expiration date>

    Make note of the fulfilment ID for the license you want to return.

  1. In the Command Line prompt, type in the following command:

    $ sudo /Applications/Toon Boom [Product Name] [Version] [Edition]/[Product Name].app/Contents/tba/macosx/bin/ClientActivation.app/Contents/MacOS/ClientActivation -batch -return <fulfillment ID> -comm soap -commServer <port@license server>

    • Replace <fulfilment ID> with the fulfillment ID of the license you want to return, obtained in the previous step.
    • Replace <port@license server> with the port number and hostname or IP address of the license server, separated by an @ symbol. If the license server is not configured to use a specific port, simply type an @ symbol followed by the hostname or IP address of the license server.

    If successful, the utility will output the message SUCCESSFULLY SENT RETURN REQUEST at the end of the procedure.

  1. Open a Terminal.

  2. In the terminal, type in the following command to display information on your activated licenses:

    $ sudo /usr/local/ToonBoomAnimation/harmony[Edition]_[Version]/lnx86_64/bin/ClientActivation -batch -list | grep -A 7 'Trust Flags:'

    The utility will output detailed information about each installed license including each license's Fulfilment ID, in this format:

    Trust Flags: FULLY TRUSTED Fulfillment Type: PUBLISHER ACTIVATION Status: ENABLED Fulfillment ID: <fulfillment id> Entitlement ID: <product code> Product ID: NAME=<product>;VERSION=<product version> Suite ID: NONE Expiration date: <expiration date>

    Make note of the fulfilment ID for the license you want to return.

  1. In the Command Line prompt, type in the following command:

    $ sudo /usr/local/ToonBoomAnimation/harmony[Edition]_[Version]/lnx86_64/bin/ClientActivation -batch -return <fulfillment ID> -comm soap -commServer <port@license server>

    • Replace <fulfilment ID> with the fulfillment ID of the license you want to return, obtained in the previous step.
    • Replace <port@license server> with the port number and hostname or IP address of the license server, separated by an @ symbol. If the license server is not configured to use a specific port, simply type an @ symbol followed by the hostname or IP address of the license server.

    If successful, the utility will output the message SUCCESSFULLY SENT RETURN REQUEST at the end of the procedure.