Skip to main content

Starting the Agent

Follow the appropriate instructions below depending on the OS of the host machine.

Windows​

Double-click istari_agent_X.Y.Z.exe in %LOCALAPPTADA\istari_agent\ to start the agent.

The agent may take up to a minute to start. After the agent has started an Istari Digital logo will appear in the system tray. Right click this logo to open a menu that contains information about the status of the agent and the option to pause or quit the agent.

The Istari Digital icon in the systray

The Istari Digital agent menu

Optional: Diagnostics Tests with the Agent​

Starting with Agent v9.4.0, you can use the agent's diagnostics to test and validate the following Agent functionalities:

  • Ability to receive an assigned job from the Istari Digital Platform
  • Ability to run an assigned job
    • Ability to handle successful and failed jobs
  • Ability to upload the results to Istari Digital Platform
  • Ability to return to IDLE state, ready for additional jobs

Users can run the diagnostics test by right-clicking "Run Diagnostics" in the system tray.

System Tray

NOTE: When prompted, you must provided a human personal access token. The diagnostics will not work with an agent token.

Once completed, a message will pop up with the result of the test. Users can navigate to the Istari Digital Platform to look at the two models uploaded by the diagnostics thread and their associated jobs, for example:

Diagnostics files

Diagnostics job results

Additional information is available in the agent logs.

Logs (Windows)​

The agent will write logs to %LOCALAPPTADA\istari_agent\istari_agent.log.

Open this log file to confirm that the agent did not encounter any errors during startup.

You can also access the logs via the Istari Digital Agent Menu in the System Tray.

RHEL / Ubuntu​

Run ./opt/local/istari_agent/istari_agent_X.Y.Z. If any of the modules installed on the agent require environment variables to be set, you may need to run sudo -E /opt/local/istari_agent/istari_agent_X.Y.Z instead.

The agent may take up to a minute to start. After the agent has started log output will be printed to the terminal.

Logs (Linux)​

The agent will write logs to /opt/local/istari_agent/istari_agent.log.

Open this log file to confirm that the agent did not encounter any errors during startup.