📄 EasyTask Worker Agent Management Guide¶
🚀 Starting an Agent¶
The EasyTask worker agent is started by a watchdog process that runs continuously. The watchdog automatically monitors the agent and restarts it if it crashes, ensuring high availability.
- On-Prem / Cloud: Use the system service manager or the startup command provided during installation to start the watchdog process.
- Sandbox: The agent is managed by the EasyTask team.
✅ Confirming a Successful Start:
After starting the agent, check the agent logs for a startup confirmation message. The logs should indicate: - The agent has successfully initialized - The agent has registered with the scheduler - The agent is ready to execute tasks
💬 Important: Look for the
Worker agent startedmessage in the agent logs to confirm successful initialization.
🔐 Multiple Agent Safeguards¶
The agent uses a combination of safeguards to detect duplicate processes on the same host.
If you accidentally attempt to start another watchdog on the same host, you will see an error message indicating an existing agent process is already running.
💬 Why it matters: These safeguards prevent accidental resource conflicts or task duplication by enforcing a single agent process per host.
🛑 Stop Worker Agent¶
- On-Prem / Cloud: Use the system service manager to gracefully stop the agent process. A graceful stop ensures any in-progress tasks complete before the agent shuts down.
- Sandbox: Contact EasyTask support.
✅ Confirming a Clean Shutdown:
A graceful shutdown ensures active tasks are completed and resources are cleaned up safely.
🔄 Restarting an Agent¶
To restart an agent:
- On-Prem / Cloud: Stop the agent gracefully using the system service manager, then start it again. Confirm the restart by checking the agent logs for the startup confirmation message.
- Sandbox: Contact EasyTask support.
✅ Summary¶
| Action | Method |
|---|---|
| Start Agent | System service manager or startup command |
| Stop Agent | System service manager for graceful shutdown |
| Restart Agent | Stop then start via system service manager |
| Check Logs | Agent logs via system service manager |
| Verify Startup | Look for Worker agent started message in logs |
⚠️ Best Practices¶
- Always check agent logs after startup to confirm the agent is running smoothly.
- Look for the
Worker agent startedmessage to verify successful startup. - Do not manually start multiple agents on the same host — rely on the watchdog process.
- Use restart only if you need to apply updates, change configurations, or recover from issues.
Frequently Asked Questions¶
Q: How do I start a Worker Agent?
A: Use the system service manager or the startup command provided during installation to start the watchdog process. The watchdog monitors the agent and automatically restarts it if it crashes. Confirm startup by looking for Worker agent started in the agent logs.
Q: What prevents me from accidentally running multiple agents on the same host? A: The agent process uses built-in safeguards to detect duplicate instances. If you try to start a second agent on the same host, an error message will indicate an existing process is already running.
Q: How do I safely restart an agent? A: Stop the agent gracefully using the system service manager, then start it again. Always verify the restart by checking the agent logs for the startup confirmation message.