Skip to content

Commit da86e7f

Browse files
Add agent hub join troubleshooting
1 parent 824f92f commit da86e7f

File tree

1 file changed

+11
-1
lines changed

1 file changed

+11
-1
lines changed

docs/hub/guides/agent.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -75,4 +75,14 @@ When the service is installed using systemd the following commands can be useful
7575
|---|---|
7676
|Restart the Service | `sudo systemctl restart certify-agent` |
7777
|Check systemd log | `journalctl -u certify-agent` |
78-
|Follow current log | `journalctl -u certify-agent -f` |
78+
|Follow current log | `journalctl -u certify-agent -f` |
79+
80+
81+
## Troubleshooting
82+
83+
If the agent is listed in the hub, but viewing managed certificates etc fails there may be a mismatch between the instanceID assigned by the hub and the settings currently stored in the agent config.
84+
85+
To resolve this:
86+
- Remove the instance from the hub (Managed Instances > Remove)
87+
- Edit the agents config at `/usr/shre/certify/serviceconfig.json` and remove the `"HubAssignedInstanceId": "<GUID>",` line, then restart the certify-agent service.
88+
- Re-join the agent to the hub

0 commit comments

Comments
 (0)