After you create a Secure Agent group, you can rename or delete the group and add and remove Secure Agents.
Click the refresh icon next to
New Runtime Environment
to refresh the page before performing any actions on Secure Agent groups.
You can complete the following tasks:
Create a Secure Agent group.
To create a Secure Agent group, click
New Runtime Environment
and enter a name and optionally a description for the group. After you create a group, you can add Secure Agents to the group.
If you use multi-byte characters in the Secure Agent group name and you create the group in a cloud-hosted environment, verify that the environment also supports these characters.
Edit Secure Agent group properties.
To rename a Secure Agent group or to add or update the description, expand the Actions menu, select
Edit Environment Properties
, and complete the fields in the dialog box.
Informatica Intelligent Cloud Services
updates the group name in all services that use the group.
Enable or disable Secure Agent services for a Secure Agent group.
To enable or disable Secure Agent services for a Secure Agent group, expand the Actions menu, select
Enable or Disable Services
, and select the services to enable or disable. You can enable or disable any service that your organization uses.
Before you disable a service, verify that no connection, task, or process that uses the group as the runtime environment requires the service. If a connection, task, or process has a Secure Agent group selected as the runtime environment and you disable a required service, the task or process can't run. Similarly, if a feature has a Secure Agent group selected as the runtime environment and you disable a required service, the feature can't be used.
Add Secure Agents to a group.
To add Secure Agents to a group, expand the Actions menu and select
Add or Remove Secure Agents
. You can add any agent that is in the Unassigned Agents group on the
Runtime Environments
page.
Alternatively, you can add a new Secure Agent to an existing group by setting the InfaAgent.GroupName property in the infaagent.ini file before you register the agent. When you add a Secure Agent to a Secure Agent group, the Secure Agent inherits the services and connectors that are configured for the Secure Agent groups.
For
Application Ingestion and
Replication
and
Database Ingestion and
Replication
, if you remove a Secure Agent
from a Secure Agent group and add it to another Secure Agent group, wait at
least 60 minutes before trying to use it to run application or database
ingestion and replication jobs. The internal cache of Secure Agent runtime
information is refreshed every hour by default.
When you add more than one Secure Agent to a Secure Agent group, all agents must meet the following requirements:
All of the agents must be of the same type, for example, all local agents or all agents that run on Amazon EC2 machines.
Each Secure Agent must be configured to connect to the same external systems and have access to files such as libraries, initialization files, and JAR files.
Each Secure Agent must have access to the files used in tasks. Ensure that all files used in a task are available in a shared location.
Remove Secure Agents from a group.
To remove Secure Agents from a group, expand the Actions menu and select
Add or Remove Secure Agents
. When you remove an agent from a group,
Informatica Intelligent Cloud Services
adds it to a group named "Unassigned Agents."
You can remove an agent from a Secure Agent group if the group is not used as the runtime environment for a connection or task. If the group is used, you can remove an agent if it is not the only agent in the group.
Delete a Secure Agent group.
To delete Secure Agent group, expand the Actions menu and select
Delete
. You can delete a Secure Agent group if it does not contain any Secure Agents.
Share or unshare a Secure Agent group.
If you are the administrator of a parent organization, you can share a Secure Agent group so that the sub-organizations can use it. You can unshare a group if it is not used in a connection or task. From the Actions menu associated with the group, choose