This file documents the required steps to get the UVIE EGSE software up and running on a freshly installed Linux system (tested on manjaro-xfce-21.3.7 linux5.15).

PREREQUISITES

1) Get CCS repository $> git clone https://gitlab.phaidra.org/mecinam2/CCS.git

2) Required packages/devtools

• make
• gtk3
• gtksourceview3
• python-pip
• python-gobject
• dbus-python
• mariadb
• mysql-workbench (optional)

3) Initialise MySQL/MariaDB and set it up

$> sudo mariadb-install-db --user=mysql --basedir=/usr --datadir=/var/lib/mysql
$> sudo systemctl enable --now mariadb
$> sudo mariadb-secure-installation  (optional)

To create a MariaDB user, in the CCS base directory execute

$> make db-user USER=<user> PW=<password>

Alternatively, execute the following SQL statements:
mysql> CREATE USER 'user'@'localhost' IDENTIFIED BY 'password';
mysql> GRANT ALL PRIVILEGES ON * . * TO 'user'@'localhost';
mysql> FLUSH PRIVILEGES;

4) Install Python packages. To install the required modules with pip in userspace or a venv, run 'make python-requirements' in the CCS base directory or use 'pip install [--user] -r requirements.txt'. If using a venv, it must have been created using the --system-site-packages option. For more details, see requirements.txt Since Python 3.11, pip --user installs of packages are denied by default to avoid conflicts with system-managed packages - the recommended solution is to use a venv. Alternatively, installing in local userspace is still possible by passing the --break-system-packages flag.

INSTALLATION

In the CCS base directory,

- first configure the [database] section in egse.cfg!
- then execute:

$> make confignator
$> make databases

MIB

Use CCS/Ccs/tools/import_mib.py to import a set of SCOS2000 MIB files into the MySQL mib-schema set in egse.cfg

CCS & TST

./start_ccs: starts the CCS ./start_tst: starts the TST