Debian GNU/Linux: Difference between revisions

Revision as of 15:16, 30 December 2024

Following are the steps to install the toolchain on a Debian 11 system:

Main control application

Install the necessary packages for building and compiling Rust programs: sudo apt install build-essential curl -y

Install additional packages: sudo apt install libssl-dev pkg-config sudo apt install libudev-dev

Download and install Rust: curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Update current shell: source ~/.cargo/env

Verify Rust installation: rustc --version

As of December 2024, Rust version is 1.83.0.

Install git: apt-get install git

Clone the git repositories into /usr/local/src:

Main control application: git clone https://in-dubio@bitbucket.org/in-dubio/aquarium_control.git
Client application: git clone https://in-dubio@bitbucket.org/in-dubio/aquarium_client.git
Test server: git clone https://in-dubio@bitbucket.org/in-dubio/aquarium_test_server.git
Databases

Verify if control application, client application and test server can be build using cargo build.

Create the message queues required for operation or testing by running create_mqueues.sh with root privileges.

Create the folder for the file-based output matching to the .toml file configuration: mkdir /var/local/aquarium-ctrl.

After installation of the databases, you can proceed with the tests using cargo test -- --test-threads=8.

As of December 2024, running testing with more than eight threads may result in flaky test cases (failing randomly).

Client application

Run cargo build in the installation directory of the client.

Test server

Run cargo build in the installation directory of the client. Run cargo test in the installation directory of the client.

Start simulation run

Adapt the configuration file of the main application. Set all parameters named use_simulator to true. First start the test server using cargo run, then start the main application with cargo run.

@@ Line 57: / Line 57: @@
 Run <code>cargo build</code> in the installation directory of the client.
 Run <code>cargo test</code> in the installation directory of the client.
+== Start simulation run ==
+Adapt the configuration file of the main application. Set all parameters named <code>use_simulator</code> to <code>true</code>.
+First start the test server using <code>cargo run</code>, then start the main application with <code>cargo run</code>.