Agent Lifecycle Management
Restart, update, stop or delete a CommandLyne agent, with the impact of each action and a summary of which lifecycle control to reach for when.
Overview
CommandLyne provides full control over your agent and its dedicated VM. Lifecycle controls are available inside the Agent Configuration panel.
How to Access Lifecycle Controls
-
1
Go to Agents.
-
2
Click your running agent.
-
3
Open the Config panel.
-
4
Use the available controls: Restart, Update, Stop, or Delete.
Restart Agent
Use Restart when:
- The agent becomes unresponsive.
- You want to refresh the VM.
- Configuration changes require a reboot.
Steps:
-
1
Click Restart.
-
2
Wait around 1–2 minutes.
-
3
Reload the interface.
After restart, the agent status should return to Running.
Update Agent
Use Update to upgrade your agent to the latest version.
Updates may include:
- Bug fixes
- Security patches
- Feature improvements
- Performance enhancements
Steps:
-
1
Click Update.
-
2
Confirm the action.
-
3
Wait around 2–3 minutes.
-
4
Refresh the page.
-
5
Check the version number in the configuration panel.
After update, the agent status should return to Running.
Stop Agent
Use Stop when:
- You are not actively using the agent.
- You want to temporarily stop the VM.
- You want to conserve resources.
Steps:
-
1
Click Stop.
-
2
Wait for the status to change from Running to Stopped.
When stopped, the agent cannot process requests. You can restart it anytime.
Delete Agent
Use Delete only when you want to permanently remove the agent.
Steps:
-
1
Click Delete.
-
2
Confirm the deletion.
This permanently removes:
- The agent
- The associated VM
- Configuration and integration settings
- Agent data
Lifecycle Summary
| Action | What It Does | Downtime | Reversible |
|---|---|---|---|
| Restart | Reboots the VM | 1–2 mins | Yes |
| Update | Upgrades to latest version | 2–3 mins | Yes |
| Stop | Temporarily shuts down the VM | Immediate | Yes |
| Delete | Permanently removes the agent | Permanent | No |
