On-Prem Agent Operations and Health

Common Commands

Commands shown with sudo apply to Docker deployments. Omit sudo when using Podman — see the Installation Guide for details.

Task	Command
Start agent containers	`sudo ./setup_agent.sh --start`
Stop agent containers	`sudo ./setup_agent.sh --stop`
Reconfigure (credentials, URLs, connectors)	`sudo ./setup_agent.sh --reconfigure`
Upgrade to the latest version	`sudo ./setup_agent.sh --upgrade`
Validate OS, folder ownership, and connectivity	`sudo ./setup_agent.sh --validate`
Fix agent folder permissions	`sudo ./setup_agent.sh --permissions`
Check running containers	`sudo docker ps`
Follow live container logs	`docker logs -f <container_name>`
Tail agent log files	`tail -f /var/log/moveworks/*.INFO.log`

Monitoring and Health

Navigate to Moveworks Setup > Core Platform > On-Premise Agents to see all deployed and reachable agents.

Agent Health

Agent health reflects the agent’s ability to serve requests from the Moveworks platform.

Status	Meaning
Healthy	Agent successfully serves requests more than 90% of the time
Unhealthy	10 or more out of 100 connection attempts from Moveworks failed
Unknown	No calls have been made to this agent yet — health cannot be determined

Agent health reflects the ability to serve requests, not the health of the Docker container itself. A running container can show as Unknown if it has not yet received any requests.

Agent Status

Status	Meaning
Active	Container is running and connected to the Moveworks platform
Inactive	Agent has stopped or failed to connect. Remains visible for ~30 minutes before being removed from the list

Credential Rotation

To rotate the Moveworks org access secret, an LDAP or REST service account password, a secret in AWS Secrets Manager or Azure Key Vault, or a TLS certificate, see Rotate On-Prem Agent credentials and certificates. It also covers restarting the agent and running ./setup_agent.sh --validate to confirm the agent can write its files.

For LDAP over SSL or StartTLS, see Configure an LDAP SSL certificate for the On-Prem Agent.