Starting the System
🚧 Documentation under development
The RidgeRun Embedded Test Orchestrator guide is currently under active development. Some sections may be incomplete or change without notice.
Questions? Contact RidgeRun or email to support@ridgerun.com.
Starting the System
This page starts the server and dashboard on the host computer, then connects the device agent from the embedded device.
Keep each component running in its own terminal.
1. Find the Host Computer IP Address
Run the following command on the host computer:
hostname -I | awk '{print $1}'
Record the displayed address. It will be used as HOST_IP_ADDRESS when starting the device agent.
2. Start the Test Orchestrator Server
Open a terminal on the host computer and run:
cd "$HOME/embedded-testing-tool" source server/.venv/bin/activate python3 server/run_server.py
Leave this terminal open. The server listens on port 8000.
Open another terminal on the host computer and verify the server:
curl http://127.0.0.1:8000/health
The terminal should display:
{"status":"ok"}
3. Start the Web Dashboard
Open another terminal on the host computer and run:
cd "$HOME/embedded-testing-tool/dashboard" VITE_API_BASE_URL=http://127.0.0.1:8000 npm run dev -- --host 0.0.0.0
Leave this terminal open. Open the following address in a browser on the host computer:
http://127.0.0.1:5173
The Test Orchestrator dashboard should appear.
4. Start the Device Agent
Open a terminal on the embedded device. Replace HOST_IP_ADDRESS with the address recorded in step 1, then run:
cd "$HOME/embedded-testing-tool" export SERVER_URL="http://HOST_IP_ADDRESS:8000" export AGENT_DEVICE_ID="$(hostname)" export AGENT_DEVICE_NAME="NVIDIA Jetson" export AGENT_PLATFORM="NVIDIA Jetson" python3 agent/run_agent.py
Leave this terminal open. The agent should report that it registered the device and started successfully.
5. Verify the Device Connection
Return to the dashboard and open Devices. The NVIDIA Jetson should appear in the device list.
You can also verify the connection from the host computer:
curl http://127.0.0.1:8000/api/devices
The response should include the device name, hostname, platform, and last connection time.
Next Step
The server, dashboard, and device agent are now running. Continue to Running Your First Test to execute a validation on the embedded device.