Administer Agents › Install an Agent Interactively

Install an Agent Interactively

Processes can include operators that must run on servers with a target application, database, or system. If possible, install an agent on such a server. If not possible, install the agent on a host that can connect to that server through SSH.

Important! Before you install an agent, verify that the Domain Orchestrator is running.

Follow these steps:

1. Click the Configuration tab.
2. Click the Installation palette.
3. Click Install for Install Agent.

   A dialog appears showing the progress for downloading the application.

4. If you receive a security warning, click Run.

   The Language Selection dialog opens. The language of the host computer is selected by default.

5. Click OK or select another language and click OK.

   The welcome page of the CA Process Automation Agent Setup wizard appears.

6. Click Next.

   The License Agreement opens.

7. Read the license. If you accept the terms, click I accept the terms of the License Agreement. Click Next.

   The Set Java Home Directory page opens.

8. If the displayed Java home directory is not correct, browse to the JRE folder.

   All platforms support jre6; Windows supports jre6 and jre7.

   See the following example path for the Windows platform:

   C:\Program Files\Java\jdk1.7.0_45
   

9. Click Next.

   The Select Destination Directory page opens. On Windows hosts, the default path follows:

   C:\Program Files\CA\PAM Agent
   

10. Click Next to accept the default or enter a destination directory for the new agent, and click Next.

    The Select Start Menu Folder page opens.

11. (Windows only) Click Next to accept CA Process Automation Agent as your Start menu shortcut or type a new name and click Next.
    • (Optional) Create short cuts for all users on this host.
    • (Optional) Do not create a Start menu folder.
12. Examine the Domain URL. This is the URL from which you launched the agent installation. Click Next.
13. If the domain is secured (Support Secure Communication was selected during the installation of the Domain Orchestrator), provide the same Certificate Password that was used to install the Domain Orchestrator (and other Orchestrators).
14. Complete the General Properties page and then click Next.
    1. Enter the agent host name for Agent Host. This name identifies the host from which you started the installation.
    2. Change or accept the default Display Name, the host name.
    3. If you launched the agent installation from a Windows host, select Install as Windows Service.
    4. To force a new connection for each communication from an Orchestrator to an agent, select Use deprecated communication.

       We recommend that you leave this check box cleared. Simplified communications, the default, is preferred because it uses one persistent connection.

    5. If you selected Use deprecated communications, accept 7003 as the Agent Port unless this port is used. If the default port is used, enter an unused port number such as 57003 as the port on which the agent listens for communication with Orchestrators.

       Note: If deprecated communication is not used, then Orchestrators use a web-socket connection (established by agents) to communicate to agents. Orchestrators use port 80 to communicate with agents over HTTP. Orchestrators use port 443 to communicate with agents over HTTPS.

    6. Select Start Agent after Installation.

       Starting the agent lets you view the active agent and continue with the agent configuration.

15. Click Next to accept the default temporary directory for executing scripts or enter another path and then click Next.

    Note: An acceptable path contains no spaces.

    The Set PowerShell execution policy page appears.

16. Complete the setting in one of the following ways.
    • To run Windows PowerShell scripts through this agent:
      1. Select the Set PowerShell Execution Policy check box.
      2. Browse to the PowerShell host location if different from the displayed default.
      3. Click Next.
    • If you do not use Windows PowerShell, click Next.

    The Agent installation starts.

17. Click Finish.
18. (Windows only) Start the agent service. Click Start, Programs, CA, CA Process Automation Agent, Start Agent service.
19. Click the Configuration Browser palette on the Configuration tab.
20. Click Refresh. (Or, log out and log back in.)
21. Expand Agents and verify that your agent name is listed.

    Note: To use the agent host as a target, configure a touchpoint. To use the agent host as a gateway to a remote host, configure a proxy touchpoint.

More Information

About Agent Communication