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:
- •You can install the Secure Agent on one of the following operating systems:
- - Red Hat Enterprise Linux version 6.x and above
- - SUSE Linux Enterprise version 11.0 and above
- •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.
For more information about Secure Agent requirements, contact Informatica Global Customer Support.
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 agent_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:
agent_install.bin –i console
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. The installer completes.
2. To start the Secure Agent, navigate to the directory where you installed the Secure Agent and enter the following command:
infaagent startup
After the Secure Agent starts, register the Secure Agent.
3. To register the Secure Agent, navigate to the following directory:
<Secure Agent installation directory>/main/agentcore
4. 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 in the same directory:
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>\main\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 directory where you installed the Secure Agent.
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, make sure no connections are configured to use it.
To uninstall the Secure Agent on Linux:
1. Open the command line.
2. Navigate to the directory where you installed the Secure Agent.
3. Enter the following command in the command line to stop the Secure Agent Linux process:
infaagent shutdown
4. To uninstall the Secure Agent, run rm -rf on the directory where you installed the Secure Agent to remove Secure Agent files.