Run the Remote Agent Docker on Windows

Run the Remote Agent docker container as part of the remote agent connection configuration for Oracle Fusion Data Intelligence.

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. See Perform Remote Agent Connection Prerequisites.

   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:23.2.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>