Run the Remote Agent Docker on Linux

Run the Remote Agent docker container as part of the remote agent connection configuration for Oracle NetSuite Analytics Warehouse.

The docker image name for release 25.R2 is container-registry.oracle.com/fdi/remoteagent:22.5.0. Use this name in any commands that call for <docker_image>.
  1. Open a terminal on the host VM and run the following commands to create required directories and apply appropriate permissions.
    1. mkdir /faw/software/remoteagent/
    2. chmod -R 0777 /faw/software/remoteagent/
    3. mkdir /faw/logs/RemoteAgent/config
    4. chmod -R 0777 /faw/logs/RemoteAgent/config
  2. Log in to the docker registry with the following command, replacing <username> with the email ID used to log into Oracle Container Registry, and <Auth_Token> with the value created earlier.
    docker login container-registry.oracle.com -u <username> -p <Auth_Token>
  3. Create and run the docker container with the appropriate docker image name in place of <docker_image>
    docker run -d -p 9091:9091 --name remoteagent -v /faw/software/remoteagent/config/:/faw/software/remoteagent/config/ -v /faw/logs/RemoteAgent/:/faw/logs/RemoteAgent <docker_image>

    For example:

    docker run -d -p 9091:9091 --name remoteagent -v /faw/software/remoteagent/config/:/faw/software/remoteagent/config/ -v /faw/logs/RemoteAgent/:/faw/logs/RemoteAgent container-registry.oracle.com/fdi/remoteagent:22.5.0

    If the remote agent user interface isn't accessible, then run this script:

    sudo docker run -d -p 9091:9091 --name remoteagent --network host -v /faw/software/remoteagent/config/:/faw/software/remoteagent/config/ -v /faw/logs/RemoteAgent/:/faw/logs/RemoteAgent <docker_image>

    Note:

    Ensure that the logs directory in /faw/logs/RemoteAgent/ has write permissions and the config folder in /faw/software/remoteagent/config/ is present in case you need to add custom properties.
  4. Verify that the container has started successfully using this script: 
    run '$ docker ps'
  5. If you need to upgrade the remote agent in the Linux host, then use the following script:
    
Stop Remoteagent docker
sudo docker stop remoteagent

Remove Remoteagent docker
sudo docker rm remoteagent

Run the image:       
sudo docker run -d -p 9091:9091 --name remoteagent -v /faw/software/remoteagent/config/:/faw/software/remoteagent/config/:Z -v /faw/logs/RemoteAgent/:/faw/logs/RemoteAgent:Z <docker_image>