This section covers various administrative tasks necessary to maintain and control agents within Data Integrity Suite. The actions include re-registering, editing, deleting, uninstalling, and viewing the status of agents. These management operations are important for ensuring agents are properly configured, up-to-date, and functioning as expected within Data Integrity Suite.
Re-register an agent
Re-registering replaces an existing agent with a new one while preserving all existing associations. This includes data sources, engines, and any other services previously linked to the agent. Re-registration is useful when the agent needs to be refreshed or replaced without disrupting configured relationships or requiring manual re-linking.
The re-registration option is only visible when an agent has an Action Required
status. You can re-register a down agent if the existing agent stops communicating due to technical issues.
- Click the ellipsis next to the agent's name and choose Re-register from the dropdown menu.
- The Re-register Agent page will open.
- Click the copy icon next to the Install Agent command and paste the copied command into your terminal to install the agent.
Edit an agent
The edit agent function allows you to modify the name and description of an existing agent. This feature is useful for updating or clarifying the agent's purpose.
- Click the ellipsis next to the agent's name and choose Edit from the dropdown menu.
- The Edit agent page will open, allowing you to modify the name or description of the agent.
- Click Save to apply the modifications.
Delete an agent
Deleting an agent removes it from the Precisely Cloud interface, such as the workspace or catalog. However, it does not remove the agent software from the local system. Once deleted, the agent and its associations (e.g., data sources or engines) are lost, and a new agent must be registered and fully reconfigured if needed again.
./discli agent cleanup.- Identify and remove the agent that is not in a healthy state from the list.
- Click the ellipsis next to the agent's name and choose Delete from the dropdown menu.
- A confirmation popup will appear to confirm the deletion.
- Click Delete to proceed with removing the agent, or select Cancel if you do not wish to delete the agent.
Uninstall an agent
The uninstall agent function involves removing the agent software from your local system. This process deletes the agent files and cleans up any associated configurations. Uninstalling an agent is necessary if you no longer need it or if you need to reinstall it to resolve issues.
- Ensure the agent is removed from the list.
- Run the following command to delete the agent and its associated services from your environment:
./discli agent cleanup
View status details for an agent
The view details of an agent function provides information about the agent’s configuration and status. Viewing these details helps you monitor the agent’s performance and verify that it is set up correctly.
- If the health of the agent has a Action Required
status, it means the agent has stopped communicating with the Precisely Cloud. The UI shows the last successful communication time to help identify when the issue began, usually due to the agent being down or a network connectivity issue. In this state, the system cannot confirm the agent's status and does not receive signals. As a result, processes using the agent cannot be monitored, started, stopped, or modified, and the agent requires immediate attention. These agents appear at the top of the Manage Agents page. - If the health of the agent has a Not Registered
status, it means the agent is not currently registered and cannot be used. Registration occurs when the installation package is run on a host using the Agent ID and Registration Key provided during agent creation. If these credentials are unavailable, the agent cannot be re-registered and must be deleted and recreated. In such cases, a new agent must be created through the UI to obtain fresh credentials. - If the health of the agent has a Service Down
status , one or more services are down. Processes using these services cannot be monitored, started, stopped, or modified. Services that are down cannot report status. - If the health of the agent has OK
status, all services are running properly and are up to date.
To rectify or view the health status of an agent, follow these steps:
- Click the name of the agent to open the Agent Details page. This page displays the agent's name, version, hostname, and last check-in details.
- Review the health information in the Services section to determine if any actions are needed..
- Click Close once you have performed the necessary actions.
Agent check-in notification system
This section outlines the process and conditions under which email notifications will be sent to you regarding agents that have not checked in for more than an hour. These notifications are sent for theAgent Manager role and are triggered based on specific conditions.
Notification trigger conditions:
-
Agent check-in time: An email notification will be sent to customers if an agent's last check-in was received more than one hour ago. The system checks the timestamp of the agent's last check-in, and if the agent hasn't checked in within the past hour, a notification will be triggered.
-
Agent deletion status: A notification will only be sent if the agent has not been deleted within the last hour.