Runtime Environments > Secure Agents > Working with Secure Agents
  

Working with Secure Agents

After you create a Secure Agent, you might need to perform management tasks such as viewing and configuring agent properties, checking the host information, viewing audit logs, or refreshing the agent status. You can also delete a Secure Agent if it is no longer used.
You perform most management tasks for Secure Agents on the agent details page. To access the agent details page, click a Secure Agent on the Runtime Environments page.
The following image shows the agent details page:
The agent details page displays agent details, agent service details, package details, configuration properties, and information about the agent host. You can start and stop services and change the configuration details on this page.
You can complete the following tasks:
View the Secure Agent details.
View details such as the host name, the current status, the last date and time that the agent was updated, and the agent version.
The Secure Agent can have any of the following statuses:
Status
Description
Agent Core is not running.
The Secure Agent is not available, but one or more of the services is running.
Not all the services are running.
The Secure Agent is available, but one or more of the services is not available.
Agent Core Upgrading
The Secure Agent is upgrading to a new version.
Stopped
The Secure Agent is not available.
Up and Running
The Secure Agent and all of the services that the agent runs are available.
View the Secure Agent service details.
View details for Secure Agent services that run on the Secure Agent such as the service name, status, version, and last update time.
A Secure Agent service can have any of the following statuses:
Status
Description
Error
The process failed.
Restarting Due to Error
The service is starting due to a failure.
Shutting Down
The service is shutting down.
Standby
The service is running, but it is not compatible with Informatica Intelligent Cloud Services.
Starting Up
The service is starting up.
Stopped
The service is not available.
Up and Running
The service is running.
User Stopped
The service was stopped by a user.
Warning
The service is running, but it cannot accept work.
The version number changes each time you modify the service. The Secure Agent retains the directories for the old version of the service for seven days. For example, if you update the NetworkTimeoutPeriod for version 55.0.2 of the Data Integration Server, the agent increments the version number to 55.0.3 and creates the following directory:
<Secure Agent installation directory>/apps/Data_Integration_Server/55.0.3.1
It deletes the <Secure Agent installation directory>/apps/Data_Integration_Server/55.0.2.x directories after seven days.
Stop and start Secure Agent services.
Stop and start the services that run on a Secure Agent to perform troubleshooting, optimize resources on the agent machine, or make service configuration changes. When you stop or start a Secure Agent service, other services that run on the agent are not affected.
View the Secure Agent package details.
Expand the Agent Package Details section to see the name and version number for the packages in each service that runs on the Secure Agent. You can filter the packages by service.
View and edit Secure Agent service properties.
Expand the System Configuration Details section to see the Secure Agent service properties. You can filter the properties by service and type.
To configure the properties, click Edit. You can configure properties for each service that runs on the Secure Agent. You can also add and remove custom properties, which are used by connectors. For more information about Secure Agent services and service properties, see Secure Agent Services. For more information about custom properties, see the help for the appropriate connector.
View the Secure Agent host properties.
Expand the Agent Host section to see information about the machine that hosts the Secure Agent. For example, you can view the machine name, operating system, and available disk space.
To refresh the information, click Refresh. The last date and time that the information was refreshed appears next to the Agent Host | Updated heading.
View the Audit Log.
To view audit information such as start and stop times, server connections, and upgrade messages, click Audit Log.
Refresh the Secure Agent status.
To refresh the status of the Secure Agent, click Refresh Status in the upper right corner of the page.
To view the status on Linux, you can also navigate to the following directory:
<Secure Agent installation directory>/apps/agentcore
Then run one of the following commands:
./consoleAgentManager.sh getstatus
./consoleAgentManager.sh updatestatus