Installation
🚧 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.
Installation
This page installs the Test Orchestrator Server and dashboard on the host computer, and the device agent on the embedded device.
The commands in each section must be executed on the computer identified in the section title.
The software is delivered through the RidgeRun Test Orchestrator customer repository. Access to this repository and a configured GitLab SSH key are required before continuing.
1. Download the Customer Repository on the Host Computer
Open a terminal on the host computer and run:
cd "$HOME" git clone git@gitlab.ridgerun.com:ridgerun/customers/embedded-test-orchestrator/embedded-testing-tool.git cd embedded-testing-tool
The command creates a directory named embedded-testing-tool containing the customer distribution of the software.
2. Install the Test Orchestrator Server
Run the following commands from the repository root on the host computer:
python3 -m venv server/.venv source server/.venv/bin/activate python3 -m pip install --upgrade pip python3 -m pip install -r server/requirements.txt
Verify the installation:
test -x server/.venv/bin/python && echo "Server installation complete"
The terminal should display:
Server installation complete
3. Install the Web Dashboard
Continue on the host computer and run:
cd dashboard npm ci cd ..
Verify the installation:
test -d dashboard/node_modules && echo "Dashboard installation complete"
The terminal should display:
Dashboard installation complete
4. Download the Customer Repository on the Embedded Device
Open a terminal on the embedded device and run:
cd "$HOME" git clone git@gitlab.ridgerun.com:ridgerun/customers/embedded-test-orchestrator/embedded-testing-tool.git cd embedded-testing-tool
The host computer and embedded device must use the same customer software version.
5. Prepare the Device Agent
Run the following commands from the repository root on the embedded device:
chmod +x agent/tests/*/run.sh python3 -m compileall -q agent
The device agent uses the Python standard library and does not require additional Python packages.
Verify the installation:
test -f agent/run_agent.py && echo "Device agent ready"
The terminal should display:
Device agent ready
Next Step
The Test Orchestrator Server, dashboard, and device agent are now installed. Continue to Starting the System to launch each component.