Starting an Agent

To start an agent, use the Docker command line specified in this task.

Prerequisites

Docker must be installed on the host computer.

Procedure

  • Start the agent container.
    docker run -d --restart=unless-stopped -v /var/run/docker.sock:/var/run/docker.sock -p 13139:13139 -p 13140:13140 my_docker_repo/ftl-tibagent -rs realm_server_location
    The agent must always be running to facilitate communication among containerized applications. The parameter --restart=unless-stopped ensures that if the agent container stops running, Docker automatically restarts it.
    The agent gets the network configuration of the host environment from the Docker daemon. The agent communicates with the Docker daemon service through the socket /var/run/docker.sock. The command line must bind that socket as a volume.
    The agent requires that the Docker container publish the following external ports. The host ports and container ports must be identical.
    • 13139 - agents forward data among application containers
    • 13140 - protocols among agent containers
    If the agent image is not loaded in your Docker environment, this command line automatically pulls the image from your Docker repository.
    Supply the host and port of the realm server using the agent's required -rs parameter. If you also run a backup realm server, supply its location using the agent's -s parameter.