Registering Agents in Connectware

Registering agents in Connectware enables them to connect to Connectware.

You must register agents in any of the following cases:

• The agent is being started for the first time.

• The persisted credentials have been deleted.

• The agent is unable to log into Connectware with its cached credentials.

In all other cases, registering agents is not required and the agent will run using the stored credentials from the volume it is mounted on.

If multiple agents are to run on the same computer, each agent must use its own volume mount, otherwise the agents will overwrite each other's credentials.

During the initial deployment, the registration process is as follows:

1. Start the agent container. The container's console log should display messages like this:

{"level":30,"time":1590665714502,"msg":"Starting in distributed (edge) mode","pid":6,"hostname":"someHost","v":1}
{"level":30,"time":1590665714568,"msg":"Asking for Connectware registration at 1.2.3.4 with newly generated credentials...","pid":6,"hostname":"someHost","v":1}
{"level":30,"time":1590665714568,"msg":"The registration process must be finished using the web-interface.","pid":6,"hostname":"someHost","v":1}
{"level":30,"time":1590665714568,"msg":"Navigate to \"User Management -> Client Registry\", click unlock and authorize this client.","pid":6,"hostname":"someHost","v":1}
{"level":30,"time":1590665714568,"msg":"Username: cybus-sample-agent, pairing ID (should match in UI): a82123","pid":6,"hostname":"someHost","v":1}

If you encounter a 409 Conflict error, it means that there is a registration conflict that must be resolved. For more information, see User Registration Conflict (409 Conflict).

2. To complete the agent registration, log into Connectware and authorize the client through the Client Registry view. For more information, see Client Registry.

In addition to the agent name, you can also compare the Pairing ID to verify that you are granting access to the correct agent instance.