The information on this page refers to License Statistics v6.8 and newer, which introduced the License Statistics Agent Manager tool and a new administrative page for reviewing License Statistics Agents in use. |
This section describes the installation and configuration of the License Statistics Agent add-on tool. Also see Reviewing License Statistics Agents for information on viewing a report of all agents in use.
System requirements
Installation of License Statistics Agent has the following requirements:
Operating system | Windows 10 or Windows Server 2012+ (64-bit) |
Resources | 2-core CPU 1 GB of available RAM 1 GB of available disk space |
Installation procedure
To install License Statistics Agent:
- Download the License Statistics Agent installation from the License Statistics download page, or open the .msi installation file from the License Statistics installation "tools" directory (by default: C:\Program Files\X-Formation\License Statistics\tools).
- An installation wizard will step you through the installation procedure.
Note the following:
- By default, all of the application files will be located in the "C:\Program Files" directory. You may choose a different folder during the installation if desired.
- All associated data (including logs, configuration file, etc.) is stored under the "C:\ProgramData\X-Formation\License Statistics Agent" directory.
- As part of the installation, a configuration tool is also installed. You must use this tool to enter information that identifies and allows access to the license server that License Statistics Agent will be used for, as described in the next section.
- After installation, you can optionally start License Statistics Agent before exiting the installation wizard.
Configuration settings
You provide configuration information for License Statistics Agent using the Agent Configuration tool, which is installed along with the Agent. You must have administrative privileges to use this tool.
To access the configuration tool:
- Select License Statistics Agent Manager from the main menu, or use the Agent settings icon from the tray:
- Select Configuration from the Agent Manager options.
The configuration tool opens.
Required configuration settings include the following.Configuration setting Where to find the configuration information License Statistics URL The License Statistics URL is an endpoint to the license server (which must first be configured in License Statistics) that License Statistics Agent will communicate with.
You can find this URL using the "Copy URL to clipboard" action from the Realtime License Servers grid for supported license servers (currently limited to Autodesk license servers).
Agent API Token The Agent API Token is an authorization token, which License Statistics administrators can generate as described in API access.
Starting and stopping the service
You can also use the Agent Manager to:
- Start/stop the service
- View Agent service status (in the illustration below, the service is shown as "stopped")
Uninstalling License Statistics Agent
License Statistics Agent can be uninstalled using the standard Windows uninstallation procedure. Uninstalling License Statistics Agent stops the service and removes it from the system. Optionally, you can specify during uninstallation to remove the user data, including logs, configuration file, etc.
If you choose to retain the user data, it will be reused if License Statistics Agent is reinstalled (for example, the configuration data will be automatically filled in on the configuration form during installation).