Manage agents
Ways to manage
To manage your DigiCert® agents from the Discovery & automation tools > Agents page in DigiCert® Trust Lifecycle Manager:
To manage a single agent, select actions from the rightmost table column. Or, open the agent and select the actions from the right of the details page.
To bulk manage multiple agents at once, select them in the table and then select a bulk action from the table header.
If there are agents with deployment/configuration issues or in need of manual approval, an Alerts section appears above the agents table. Select the shortcut links in this section to take appropriate follow-up actions.
You can also manage the agent service on the host system where it's installed, using the standard operating system tools there. See the Agent service name on the local host section for information about the name of the active agent service on different OSs.
Management actions in Trust Lifecycle Manager
Available management actions in Trust Lifecycle Manager depend on the current agent configuration and status, and whether the action is run for an individual agent or multiple agents in bulk. The following tables summarize possible actions by category.
Configuration
Action | Description |
|---|---|
Assign/Update business unit | Assign or update the business unit an agent is assigned to. Only admins for the business unit can manage the assigned agents. |
Assign/Update delivery location | Assign or update the directory where an agent will deliver certificates enrolled using the admin web request method. |
Assign/Update group | Assign or update the agent group an agent belongs to. Agent groups facilitate management of multiple agents at once. |
Assign scripts | Assign pre/post-install or SNI scripts to agents. |
Edit agent name | Change the nickname assigned to an agent to help identify it in Trust Lifecycle Manager. |
Enable/Disable service restart | Enable or disable the post-install service restart feature for agents. When enabled, each agent automatically restarts the local web server application after installing a certificate during an automation event. |
Software updates
Action | Description |
|---|---|
Enable/Disable auto-update | Enable or disable the software auto-update feature for agents. When enabled, each agent automatically keeps itself up-to-date by pulling new software versions from Trust Lifecycle Manager. |
Update version | Manually update the software on an agent when a new version is available and auto-update is disabled. |
System scan
Action | Description |
|---|---|
Configure | Configure the system scan feature for agents to discover digital trust assets on the local server system. |
Resume/Suspend | Resume or suspend system scanning for agents. |
Operational
Action | Description |
|---|---|
Refresh configuration | Force activation of SNI domains after updating an agent's Server Name Indication (SNI) configuration. Used to discover and manage SNI certificates immediately after making updates without waiting for the agent to perform its daily refresh. |
Resume/Suspend | Temporarily suspend agent operations, or resume a suspended agent. |
View managed certificates | Load certificates under management by the selected agent(s) into your Inventory, where you can view and manage them. |
View unsecured IP/ports | Load unsecured IP/ports discovered by the selected agent(s) into your Inventory, where you can deploy new certificates to secure these target endpoints. |
Void | Permanently remove an agent from operation. |
View agent alerts in the dashboard
In your account dashboard in Trust Lifecycle Manager, the Alerts widget includes a section for Agents that lists the number of agents in your account with a Communication error or other statuses that may require attention.
Select the alerts here to load the applicable agents into the Discovery & automation tools > Agents page where you can take action on them.
Agent service name on the local host
The name of the DigiCert agent service depends on the operating system of the host where it's installed. The following table lists the agent service name by OS.
Operating system | Agent service name |
|---|---|
Linux | |
Windows | (Display name is DigiCert ADM Agent Service) |