Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

1. How to quickly test SimDB tool?

Code Block
module load itm-python/3.10.2 simdb
simdb remote token new
simdb remote list

2. How to install SimDB client?

2.1. GW installation

Tip

In order not to overwrite installed python versions, it is recommended to use a virtual environment when installing the tool on GW


Code Block
git clone ssh://git@git.iter.org/imex/simdb.git
python -m venv venv
source venv/bin/activate
cd simdb
git checkout <VERSION_YOU_NEED>
pip3 install -t <INSTALL_PATH> .
pip3 install -t <INSTALL_PATH>/python/<PYTHON_VERSION> -r dev_requirements.txt

2.2. Default way of installation

Code Block
git clone ssh://git@git.iter.org/imex/simdb.git
cd simdb
git checkout <VERSION_YOU_NEED>
pip3 install -t <INSTALL_PATH> .

3. How to update SimDB server?

3.1. Updating the EUROfusion simDB server

Code Block
git clone ssh://git@git.iter.org/imex/simdb.git simdb_<version>
cd simdb_<version>
conda create -p venv python=3.9 openssl=1.1.1
conda activate ./venv
pip install -r requirements.txt
pip install psycopg2-binary gunicorn
pip install .
cd ..
rm simdb
ln -s simdb_<version> simdb
kill `ps aux | grep gunicorn | grep 8088 | awk '{split($0,a," "); print a[2]}' | head -n 1`
service simdb restart

4. Developer guide

4.1. Running the tests

In the SimDB root directory run:

Code Block
pytest

4.2. Running a development server

Code Block
simdb_server

This will start a server on port 5000. You can test this server is running by opening htpp://localhost:5000 in a browser.