Manage agents

Cayosoft Guardian uses agents to back up and recover domain controllers in an Active Directory forest.

In most cases, agents are deployed and upgraded automatically on managed machines (such as domain controllers and recovery-site machines) during backup plan or recovery plan execution. Manual installation is only required if you need to deploy an agent outside of the normal backup or recovery workflow.

Manually install an agent

1. In the Cayosoft Guardian web portal, expand Forest Recovery.
2. Click Agent Management.
3. Click Download agent, and then save the installer file.
4. Copy the installer file to the target machine.
5. On the target machine, open Command Prompt as an administrator.
6. Run the following command to install the agent and point it to the Cayosoft Guardian server:

   msiexec.exe /i "C:\Path\CayosoftGuardianDRAgent.msi" /GUARDIAN_SERVICE_ENDPOINT="https://YOUR_SERVER_IP_OR_NAME/guardian"

   Note: Replace C:\Path\CayosoftGuardianDRAgent.msi with the actual path to the installer file, and replace https://YOUR_SERVER_IP_OR_NAME/guardian with the URL of your Cayosoft Guardian server.

7. After the installation is complete, return to the Cayosoft Guardian web portal.
8. Expand Forest Recovery, and then click Agent Management.
9. Select the newly installed agent, and then click Approve.

Agent Management actions

The Agent Management node displays hosts whose agents have communicated with the Cayosoft Guardian server.

Delete a host

Delete a host if it is no longer managed by Cayosoft Guardian or no longer exists.

1. In the Cayosoft Guardian web portal, expand Forest Recovery.
2. Click Agent Management.
3. Select the host.
4. Click Delete Host.

Uninstall an agent

1. In the Cayosoft Guardian web portal, expand Forest Recovery.
2. Click Agent Management.
3. Select the host that has the agent installed.
4. Click Uninstall Agent.

Retrieve agent logs

1. In the Cayosoft Guardian web portal, expand Forest Recovery.
2. Click Agent Management.
3. Select the host that has the agent installed.
4. Click Retrieve Logs.

Agent upgrades

Agent installation and upgrades are typically handled automatically during backup plan or recovery plan execution. If an agent requires manual intervention, use the Agent Management node to review its status and perform the necessary actions.