Run the Remote Agent Docker on Windows

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.
    icacls "C:/faw/software/remoteagent/" /grant Everyone:F /t
         icacls "C:/faw/logs/RemoteAgent/" /grant Everyone:F /t

    Note:

    • icacls: This is a command-line tool used to manage file and directory access control lists (ACLs).
    • "C:/faw/software/remoteagent/": This specifies the target directory where ACL changes will be applied.
    • /grant Everyone:F: This grants the "Everyone" group Full Control (F) permissions to the specified directory and all subdirectories and files recursively due to the "/t" switch. The user needs write permissions, hence "F" (full control was given). To use user-specific permission, replace "Everyone" with username.
  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
  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 Windows host, then use the following script:
    docker run -d -p 9091:9091 --name remoteagent -v C:/faw/software/remoteagent/config/:/faw/software/remoteagent/config/:Z
      -v C:/faw/logs/RemoteAgent/:/faw/logs/RemoteAgent <docker_image>