What do I do if the agent connection state shows Disconnected(N) on Management Service
CLI?
-
Verify network connectivity — Ensure the Vscan server can reach the Management Service in the Containerized Scanner cluster
-
Check agent logs — If network connectivity is stable, review the agent logs in Windows Event Log for additional troubleshooting information
-
Disconnection during agent installation:
-
Search the logs for
Failed to connect using onboarding tokenand review the error message -
If the error indicates an expired token, issue a new onboarding token and reinstall the agent
-
-
Disconnection after the agent has been running:
-
Search the logs for
Failed to connect using device tokenand review the error message -
If the error indicates an expired token, proceed with agent re-onboarding (see below)
-
How do I re-onboard an agent?
-
Stop the ONTAP agent service (v1fs-ontap-agent) on Vscan server
-
Re-onboard the agent and issue a new onboarding token via Management Service CLI:
clish agent re-onboard --instance <agent-name> -
Modify the
config.yamlfile in the ONTAP agent installation folder (default:C:\Program Files\v1fs-ontap-agent\) -
Remove the device_token key and its value
-
Add the onboarding_token key with the newly issued token:
onboarding_token: eyJh...... -
Start the ONTAP agent service (v1fs-ontap-agent)
-
Verify the agent connection status using the Management Service CLI
-
After the agent connects successfully, re-enter credentials using:
clish agent credential modify --instance <agent-name>
