Configure the Remote Agent Using the Command Line Interface Tool on Windows

Use the Remote Agent command line interface (CLI) tool to configure the remote agent.

  • Ensure that Windows Subsystem for Linux (WSL) is installed on your system.
  • Administrator access is required.
  1. Open WSL in Administrator Mode.
  2. Run the following command to check if the jq package is already installed:
    jq --version
    If the output displays a version number, that means jq is installed. If you see any other output or an error, run the following commands to install jq. Use your WSL Linux user password if you are prompted for credentials.
    sudo apt update
    sudo apt install jq -y
  3. Run the following command to verify that jq is now installed.
    jq --version
    You should see the version number of jq that you just installed.
  4. If you do not know your WSL Linux user password:
    1. Open PowerShell and run the following command to display the list of installed WSL distributions. Note the distribution name, such as "Ubuntu": wsl -l -v.
    2. Run the following command, replacing <distroName> with your actual distribution name:wsl -d <distroName> -u root. For example, wsl -d Ubuntu -u root
    3. In the root shell, reset your user password with the following command: passwd <username>, replacing username with your Linux username. You can find your Linux username with the following command: ls /home. Enter a new password when prompted.
    4. Exit the root shell with the command exit.
    5. Open your WSL terminal and use the newly created password.
  5. On the machine running docker, navigate to the remote agent setup directory:
    cd C:\faw\software\remoteagent\config\setup
    
  6. Run the Remote Agent CLI script.
    ./remoteAgentCLI.sh
  7. Type 1 in RemoteAgentCLI and press Enter.
    You can form the extract service URL based on your Oracle NetSuite Analytics Warehouse URL by replacing ui/oax/ with the extract service context path. For example, if your product URL is https://myinstance.example.com/ui/oax/ then the extract service URL would be https://myinstance.example.com:443/extractservice.

    The default save location for configuration details (config.json) is C:\faw\software\remoteagent\config\config_json\. You may also choose to specify a save location.

  8. Optional: Type 3 in RemoteAgentCLI to generate RemoteAgent logs (remote_agent_logs.zip), which are saved by default to C:\faw\logs\RemoteAgent. You may also choose to specify a save location.
  9. config.json needs to be on the same system as the one that will access the oax URL. Copy the full config.json file or copy the contents of the file (and save it in JSON format) from the VM to your local machine. You will use it to set up the connection on the Data Configuration page in Oracle NetSuite Analytics Warehouse.