1. How to quickly test SimDB tool?
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
In order not to overwrite installed python versions, it is recommended to use a virtual environment when installing the tool on GW
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
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
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:
pytest
4.2. Running a development server
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.