Runtime Environments

Back Next

Downloading and installing the Secure Agent on Linux

To install the Secure Agent on a Linux machine, download and run the Secure Agent installer and then register the agent.

Before you download and install the Secure Agent, verify that no other Secure Agent is installed on the machine using the same Linux user account. If any other Secure Agent exists, you must uninstall it first.

To verify the checksum of the Secure Agent installation program, use the agent REST API version 2 resource. For more information about the agent resource, see

REST API Reference

Open

Administrator

and select

Runtime Environments

On the

Runtime Environments

page, click

Download Runtime Installer

Select

Secure Agent

as the Environment Type.

Select

Linux 64

as the Platform.

Click

Copy

to copy the install token.

You will need this token to install the Secure Agent. The token expires after 24 hours. If the token expires before you install the Secure Agent, repeat steps 1 to 5 to obtain a new token. You don't need to download the installer again.

Click

Download

The installer is downloaded to your machine. The name of the installer is

agent64_install_ng_ext.<agent core version>.bin

Save the installer to a directory on the machine where you want to run the Secure Agent.

Ensure that the file path doesn't contain spaces or multibyte characters. If the file path contains spaces, the installation might fail. If the path contains multibyte characters, the Secure Agent might not start.

From a shell command line, navigate to the directory where you downloaded the installation program and enter the following command:

./agent64_install_ng_ext.bin -i console

When the installer completes, navigate to the following directory:

<Secure Agent installation directory>/apps/agentcore

To start the Secure Agent, enter the following command:

./infaagent startup

The Secure Agent Manager starts. Register the agent using the user name that you use to access

Informatica Intelligent Cloud Services

and also supply the install token.

To register the agent, in the

<Secure Agent installation directory>/apps/agentcore

directory, enter one of the following commands using your

Informatica Intelligent Cloud Services

user name and the token that you copied:

To add the agent to its own Secure Agent group, use the following command:

./consoleAgentManager.sh configureToken <user name> <install token>

To add the agent to an existing Secure Agent group, use the following command:

./consoleAgentManager.sh configureTokenWithRuntime <user name> <install token> <Secure Agent group name>

If the command includes a Secure Agent group name that doesn't exist, the Secure Agent is not assigned to a group. Be sure to use a valid Secure Agent group name.

The following table lists the command options:

Option	Description
User Name	Required. Informatica Intelligent Cloud Services user name of the user installing the Secure Agent.
Install Token	Required. The install token that you copied when you downloaded the runtime installer.
Secure Agent group name	Optional. Include a group name when you want to add the agent to an existing Secure Agent group instead. If this option isn’t included in the command, the agent will be in its own Secure Agent group.

You can check the registration status of a Secure Agent using the following command:

Rename Saved Search

Table of Contents

Runtime Environments

Runtime Environments

Downloading and installing the Secure Agent on Linux

Downloading and installing the Secure Agent on Linux