ArcGIS Monitor Agent must be registered with ArcGIS Monitor Server before you can begin collecting data.
Register as a new agent
To register a Monitor Agent installation for the first time, complete the following steps:
- Open a command prompt window on the Monitor Agent machine.
- Run the command below, editing the parameters to include the root URL to Monitor Server and your username and password.
<Monitor Agent installation location>\bin\arcgis-monitor-agent.exe admin:system:register --server-url <https://monitorserver.domain.com:30443/arcgis> --username <user> --password <password>
The following is an example:
"C:\Program Files\ArcGIS\Monitor\Agent\bin\arcgis-monitor-agent.exe" admin:system:register --server-url https://monitorserver.domain.com:30443/arcgis --username jdoe --password "my password"
Tip:
For more information about the admin:system:register command, run the command with the --help parameter.
The following is an example:
"C:\Program Files\ArcGIS\Monitor\Agent\bin\arcgis-monitor-agent.exe" admin:system:register --help
A confirmation message appears.
The Monitor Agent instance is registered with Monitor Server. The host machine is automatically registered as a Windows host component and added to the list of monitored components on the Monitoring page.
Register as an existing agent
To reconnect a Monitor Agent installation or transfer its responsibilities to another Monitor Agent installation, you must register it as an existing agent. Before completing these steps, ensure that the Monitor Agent connection that you want to register as an existing agent is disconnected from Monitor Server. To register as an existing agent, complete the following steps:
- Open a command prompt window on the Monitor Agent machine.
- Run the command below, editing the command line parameters to include the root URL to Monitor Server, your username and password, and the ID of the ArcGIS Monitor Agent machine.
<Monitor Agent installation location>\bin\arcgis-monitor-agent.exe admin:system:register --server-url <https://monitorserver.domain.com:30443/arcgis> --username <user> --password <password> --agent-id <agent ID>
The following is an example:
"C:\Program Files\ArcGIS\Monitor\Agent\bin\arcgis-monitor-agent.exe" admin:system:register --server-url https://monitorserver.domain.com:30443/arcgis --username jdoe --password "my password" --agent-id 28
Tip:
For more information about the admin:system:register command, run the command with the --help parameter.
The following is an example:
"C:\Program Files\ArcGIS\Monitor\Agent\bin\arcgis-monitor-agent.exe" admin:system:register --help
A confirmation message appears.
The Monitor Agent instance is registered with Monitor Server as an existing agent. The host machine is automatically registered as a Windows host component and added to the list of monitored components on the Monitoring page.