Agent registration for Jitterbit private agents

Introduction

Before a private agent can process Integration Studio or Design Studio project operations, it must successfully register with a Harmony server. The first time an agent starts, it reads registration information from either a user, a file, or environment variables, then stores it in the PostgreSQL TranDB database. The registration information provided and stored includes the URL of the Harmony server, the Harmony account and organization to use, and the private agent's name and group.

This page describes the following ways to register a private agent:

• Manual registration: For this, you must add an agent to a group in the Management Console before you install a private agent. Registration information is collected by the installer on Microsoft Windows, and by jitterbit-config command prompts or program options on Linux. With Docker private agents, this information is provided as environment variables.

• Automatic registration: With this method, a private agent is added to a group, registered, and optionally de-registered automatically. Automatic registration is most useful for containerized agents, but it can also be used on Linux agents.

  Note

  You cannot use a proxy with automatic registration.

Manual Registration

To use manual registration with containerized private agents, set values for the following environment variables:

docker run -it \
-e HARMONY_ORIGIN=https://na-east.jitterbit.com \
-e HARMONY_USERNAME=example@jbexample.com \
-e HARMONY_PASSWORD=P@55w0rd \
-e HARMONY_ORG_NAME="Example Org" \
-e HARMONY_AGENT_GROUP_NAME="Example Agent Group_Example Env" \
-e HARMONY_AGENT_NAME=ExampleAgent \
jitterbit/agent

Automatic Registration

Automatic registration works with Docker and Linux private agents. It uses the following environment variables or equivalent keys and values in a JSON format register.json file:

To use environment variables for automatic agent registration, create a file of variables and values, then use the --env-file option for docker run to start the private agent. Alternatively, use the -e/--env option to set environment variables individually.

To use a register.json file, create it in a conf subdirectory with the following contents:

{
    "cloudUrl": "https://REGION.jitterbit.com",
    "username": "ENCRYPTED USERNAME",
    "password": "ENCRYPTED PASSWORD",
    "agentNamePrefix": "PREFIX",
    "agentGroupId": AGENT_GROUP_ID,
    "deregisterAgentOnDrainstop": true,
    "retryCount": 10,
    "retryIntervalSeconds": 5
}

Start the containerized agent with the conf directory mounted to the container's /conf directory. (See Automatic registration with register.json file for an example.)

To use the register.json file on non-containerized Linux private agents, move or remove the /opt/jitterbit/Resources/credentials.txt file, create a /opt/jitterbit/Resources/register.json file as shown above, then restart the agent.