Secure Agent Installation on Linux
On Linux, the Secure Agent runs as a process. You can use a shell command line to install, register, start, stop, and uninstall the Secure Agent.
You can also use the shell command line to check the Secure Agent status.
When you install a Secure Agent, you perform the following tasks:
- 1. Verify that the machine where you install the Secure Agent meets the minimum requirements.
- 2. Download the Secure Agent installer files.
- 3. Install and register the Secure Agent.
Secure Agent Requirements on Linux
You can install the Secure Agent on any machine that has internet connectivity and can access Informatica Cloud. Before you install the Secure Agent on Linux, verify the system requirements.
Verify the following requirements before you install the Secure Agent on Linux:
- •Verify that the machine on which you install the Secure Agent uses a supported operating system. For the list of supported operating systems for the Secure Agent, see the Product Availability Matrix (PAM) for Informatica Cloud on Informatica Network:
The Product Availability Matrix for Informatica Cloud is named PAM for Informatica Cloud <version>.
- •Verify that the machine where you install the Secure Agent has at least 500 MB of free disk space.
- •The account that you use to install the Secure Agent must have access to all remote directories that contain flat source or target files.
- •If you use PowerCenter, install the Secure Agent using a different user account than the account you used to install PowerCenter.
Informatica Cloud and PowerCenter use some common environment variables. If the environment variables are not set correctly for Informatica Cloud, your jobs might fail at run time.
For more information about Secure Agent requirements, contact Informatica Global Customer Support.
Secure Agent Install Prerequisites for Cloud Application Integration
To use the Secure Agent with Cloud Application Integration, perform the following tasks before you download and install the Secure Agent:
- •On Windows, you must log in as a non-administrative user. On Linux, you must log in as a non-root user. If you install the Secure Agent as a user with administrative rights or with root access, the underlying Secure Agent database does not start.
- •(Optional) If you want use JDBC and SAP connector third party libraries with the Process Server, copy the third party libraries to the following location: <Secure Agent Installation Directory>/apps/process-engine/ext
Download the Linux Secure Agent Installer
Download the Secure Agent installer from Informatica Cloud. You can download and run the Secure Agent on any machine that meets the minimum requirements.
1. Click Configure > Runtime Environments, and then click Download Secure Agent.
2. Select the operating system on which you will run the Secure Agent, and then click Download.
3. Save the installer to a path on the machine where you want to run the Secure Agent.
Note: If the path contains spaces, the installation might fail.
The name of the Linux Secure Agent installation file is agent64_install.bin.
Install and Register the Secure Agent on Linux
You can install one Secure Agent on a machine. You must uninstall the existing Secure Agent from the machine before you install a Secure Agent. After the installation completes, start the Secure Agent, then use your Informatica Cloud username and password to register the Secure Agent.
1. From a shell command line, navigate to the directory where you downloaded the file and enter the following command:
agent64_install.bin –i console
Note: If you install the Secure Agent on Linux, do not include spaces in the directory path. If you include spaces, the Secure Agent installation might stop responding.
2. When the installer completes, navigate to the following directory:
<Secure Agent installation directory>/apps/agentcore
3. To start the Secure Agent, enter the following command:
infaagent startup
4. After the Secure Agent starts, register the Secure Agent. In the same directory, enter the following command using your Informatica Cloud user name and password:
consoleAgentManager.sh configure <username> <password>
You can check the registration status of a Secure Agent using the following command:
consoleAgentManager.sh isConfigured
Configure the Proxy Settings on Linux
If your organization uses an outgoing proxy server to connect to the internet, the Secure Agent connects to the Informatica Cloud application through the proxy server.
The Secure Agent installer configures the proxy server settings for the Secure Agent based on settings configured in the browser. You can update the proxy server settings defined for the Secure Agent from the command line.
To configure the proxy server settings for the Secure Agent on a Linux machine, use a shell command that updates the proxy.ini file. Contact the network administrator to determine the proxy settings.
1. Navigate to the following directory:
<Secure Agent installation directory>/apps/agentcore
2. To update the proxy.ini file, enter the following command:
consoleAgentManager.bat configureProxy <proxy host> <proxy port> <proxy user name> <proxy password>
3. Restart the Secure Agent.
Starting and Stopping the Secure Agent on Linux
After you download the Secure Agent program files on a Linux machine, you can run the Secure Agent as a Linux process. Manually start the Secure Agent process on Linux.
1. From the command line, navigate to the following directory:
<Secure Agent installation directory>/apps/agentcore
2. To start the Secure Agent, enter the following command:
infaagent startup
3. To stop the Secure Agent, enter the following command:
infaagent shutdown
You can view the Secure Agent status from Informatica Cloud or from a Linux command line.
Uninstalling the Secure Agent on Linux
You can uninstall the Secure Agent. You might uninstall the Secure Agent if you no longer want to run the Secure Agent on the machine or if you want to reinstall the Secure Agent.
Before you uninstall the Secure Agent, verify that no connection or task is configured to use it.
1. From the command line, navigate to the following directory:
<Secure Agent installation directory>/apps/agentcore
2. Stop the Secure Agent Linux process by entering the following command:
infaagent shutdown
3. To uninstall the Secure Agent, run rm -rf on the directory where you installed the Secure Agent to remove Secure Agent files.