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.