The information on this page refers to License Statistics v6.11 and newer, which added a Flags setting to the configuration tool (for support purposes only). If you are using a version previous to v6.11, see documentation for previous versions. |
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.
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 |
To install License Statistics Agent:
Alternatively, you can install/update License Statistics Agent from a command line (or remotely) using the msiexec tool. You must have administrative privileges to use this tool.
The msiexec tool uses the following syntax:
msiexec /i {msi_installer} INSTALLDIR="{path}" LICSTATURL="{url}" LICSTATTOKEN="{token}" /qn
For example:
msiexec /i license_statistics_agent_v6.9.0_win64_x64.msi LICSTATURL="https://licstat.company.com" LICSTATTOKEN="a479b76168de65fe42af853f651b637d" /qn |
Note the following:
After installation, an Agent icon is visible in the tray when:
When installing License Statistics Agent on dynamically created virtual machines, either do not connect to License Statistics or be sure to delete the C:\ProgramData\X-Formation\License Statistics Agent\AgentId.txt file before creating an image of the virtual machine. Otherwise, the machines may all use the same Agent ID and License Statistics will treat all Agents on the machines as a single instance, because the ID was assigned during the first connection to License Statistics, before creating the image. |
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:
The configuration tool opens.
Configuration setting | Required | Where to find the configuration information | |
---|---|---|---|
License Statistics URL | True | The License Statistics URL is an endpoint to the License Statistics license server that License Statistics Agent will communicate with. The Agent will connect to the server and receive all necessary configuration information silently.
| |
Agent API Token | True | The Agent API Token is an authorization token, which License Statistics administrators can generate as described in API access. | |
Flags | False | Flags define custom options for Agent execution, and should not be used unless instructed to do so by X-Formation Support. |
You can also use the Agent Manager to:
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).