Configuring the Agent Properties

{"URL":["/*.*/awa/pa_view_HOST_CIT","/*.*/awa/pa_view_HOST_OS400","/*.*/awa/pa_view_HOST_WINDOWS","/*.*/awa/pa_view_HOST_UCTLSTGW","/*.*/awa/pa_view_HOST_NSK","/*.*/awa/pa_view_HOST_BS2000","/*.*/awa/pa_view_HOST_UNIX","/*.*/awa/pa_view_HOST_PS","/*.*/awa/pa_view_HOST_MVS","/*.*/awa/pa_view_HOST_SQL","/*.*/awa/pa_view_HOST_VMS","/*.*/awa/pa_view_HOST_JMX","/*.*/awa/pa_view_HOST_R3","/*.*/awa/pa_view_HOST_IA"],"heroDescriptionIdentifier":"ice_agents_configure_intro","customCards":[{"id":"ice_agentsettings","title":"Advanced Agent Settings","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/AdministrationPerspective/AG_Agents_AgentSettings.htm","languages":["en-us"]},{"id":"ice_adding_agents","title":"Adding Agents","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/AdministrationPerspective/AG_Agents_Adding.htm","languages":["en-us"]},{"id":"ice_workingwithagents","title":"Working with Agents","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/AdministrationPerspective/AG_Wkg_With_Agents.htm","languages":["en-us"]}]}

After an Agent is installed, the corresponding Agent object is created automatically and it is available in AWI, in the Administration perspective and it is ready to be configured. You can do so using their INI file. For more information, see Agents INI Files.

However, you can also edit certain Agent properties from the Automic Web Interface in Client 0. An Agent object definition is made up of the following pages:

  • Standard pages that are always available, no matter what type of object you are defining:

  • The Agent page, which is an object-specific page and available for all Agents. The settings available on this page are described here.

Defining the Agent Rights on Clients

In Client 0 the Agent page contains an Authorizations section with a table where all the Clients in the system are listed. You use this table to specify which rights the Agent will have in each Client. Consider the following:

File Transfers

  • The Agent needs Read rights to be able to send files for transfer.

  • The Agent needs Write rights to be able to receive files.

Jobs

The Agent needs Execute rights to be able to start Jobs.

Note: The Authorizations section is not available if the Agent is installed in a Client other than 0.

Defining the Trusted IPs

In the Attributes section of the Agent page you specify the IPs that the Agent will trust.

Trusted IPs must be separated by semicolons. Communication to components such as the Event Monitors (BS2000, z/OS) or the Output Collector (NSK) takes place without encryption.

By default, the Agent accepts non-authenticated messages from the local host (127.0.0.1 on IPv4 and ::1 on IPv6) and its own IP address. If Event Monitors on z/OS are used in LPARs on different computers, you must specify the relevant IP addresses here.

Releasing individual IP addresses is only reasonable if login attempts of former Agent versions should be rejected.

Connecting to the Service Manager

In the Service Manager section you specify the properties that are necessary for the connection between the Agent and the Service Manager, an external monitoring tool that allows you to start and stop the Automation Engine.

The Service Manager comes with a proprietary user interface. If you want to use the AWI instead, you can do so provided you enter the necessary information. This way, Agents can start directly via the User Interface or via the script element MODIFY_SYSTEM.

All values will automatically be replaced if the connection to the corresponding Service Manager service was successful.

To refresh the connection, right-click the Agent and select Update Service Manager Link from the context menu. The default port number 8871 is used, unless a different specification is provided in the SMGR_PORT_RANGE key in the UC_SYSTEM_SETTINGS variable.

  • Phrase is the name of the Service Manager environment.
  • Name refers to the service in the Service Manager.
  • Port is the port number of the Service Manager.
  • Activate Link Agent to Service Manager, otherwise you can no longer start the Agent either through the Administration perspective or using the MODIFY_SYSTEM script element. This specification is automatically set if the Service Manager scan for the Agent was successful.

More information:

Additional Agent Configuration Page

Some Agents, such as RA or GC Composer also have an additional configuration page that is specific to that agent.

For more information on the agent-specific pages for Rapid Automation agents, please refer to the relevant RA solution documentation at https://docs.automic.com/documentation.

See also: