Use command line license administration

The AVEVA Enterprise License Administration command tool emulates in command line format some of the functions of the licensing subsystem's license administration tool. The command line tool enables you to add a local or remote license server to your License Manager, import an entitlement, and activate all licenses on that entitlement using the command prompt tool rather than the application interface.

Important: You must have at least local administrative privileges within your local hosting process or remote to use command line activation. This tool can only be used on a node where the full License Manager directory has been installed, and only supports online activation.

Using Command Line Functionality

The syntax for using the command line tool is organized around three basic operations:

1. The "import" action allows entitlements to be imported and licenses in the entitlements to be optionally activated against a license server node.

2. The "addserver" action allows one or more license servers to be added to a License Manager instance.

3. The "deactivate" action allows the user to deactivate licenses associated with a particular license server.

Do the following

4. Open the command prompt from Start, Run.

   The Run dialog box appears.

5. Enter "cmd" in the listbox.

6. Change the directory to the License Administration command tool install location: C:\ Program Files(x86)\ Common Files\ ArchestrA\ Licensing Framework\ License Manager\ LMWebApp\ bin\AELicManagerCmd.

   Note: You can access command line help at any time by entering any of the following into the command prompt: -h, -H, or ?. For example: C:\ Program Files (x86)\ Common Files\ ArchestrA\ Licensing Framework\ License Manager\ LMWebApp\ bin\ AELicManagerCmd ?

7. Enter the following syntax to complete the "addserver" operation:

   AELicManagerCmd addserver -n <nodename>, where <nodename> is the name of the node with the license server directory installed. For example:

   C:\Program Files (x86)\Common Files\ArchestrA\Licensing Framework\License Manager\LMWeb.App\bin\AELicManagerCmd addserver -n RM-NGLMv3

   A "Success" status will appear beneath each line of syntax to indicate the action was successful.

8. Enter the following syntax to complete the "import entitlement" and "activate" operations:

   AELicManagerCmd import -e <folder path> -n<nodename> -a, where <folder path> is the folder location of the entitlement you want to import. For example:

   C:\Program Files (x86)\Common Files\ArchestrA\Licensing Framework\License Manager\LMWeb.App\bin\AELicManagerCmd import -e C:Users\Documents\ License Entitlement.xml -n RM-NGLMv3 -a

   Note: If you do not want to activate your licenses after the import operation, remove -a from the end of the command syntax. If you choose not to use the -a switch you must activate your licenses through the UI or run the command again with the -a switch.

   There is no separate "activate" command. The "import, activate" command can be run to activate licenses. This will not import the entitlement again.

Deactivation

To complete the "deactivation" operation enter the following syntax :

AELicManagerCmd deactivate -n <nodename>, where <nodename> is the name of the node with the License Manager directory installed. For example:

C:\Program Files\<install directory> AELicManagerCmd deactivate -n RM-NGLMv3