For the workshop, we provide two virtual accelerator environments (emulates interface to the control system): one for BESSY II (EPICS) and one for SOLEIL II (TANGO)
BESSY II virtual accelerator (EPICS)
1. Install Apptainer (https://apptainer.org/docs/admin/main/installation.html) in case you don't already have it.
2. Open a terminal and start the container.
apptainer run oras://registry.hzdr.de/digital-twins-for-accelerators/containers/pyat-softioc-digital-twin:default-v0-5-1-bessy.2711893
Keep this terminal running and don't do anything else in it. The virtual accelerator will run there, and you will be able to interact with it from other terminals, jupyter notebooks, IDEs, etc., over the network.
3. If you want to see which PVs are available in the twin you need EPICS tools. A separate container is available for this.
Open a new terminal and start the container.
apptainer run oras://registry.hzdr.de/digital-twins-for-accelerators/epics-tools:latest
In the container, run `pvlist`. It will output something like:
GUID 0x15EB588C5158BCD5284BE8F0 version 2: tcp@[ 134.30.9.13:5075 134.30.190.240:5075 ]
To see the list of available PVs do:
pvlist 0x15EB588C5158BCD5284BE8F0
You will see that all PVs start with a prefix corresponding to your username. This is to make the PVs for your virtual accelerator instance unique on the network.
SOLEIL II virtual accelerator (TANGO)
1. Install Apptainer (https://apptainer.org/docs/admin/main/installation.html) in case you don't already have it.
2. Pull the image from the network
apptainer pull -F virtual-accelerator.sif oras://gitlab-registry.synchrotron-soleil.fr/software-control-system/containers/apptainer/virtual-accelerator:latest
Run it
apptainer run --cleanenv virtual-accelerator.sif
This will run the virtual accelerator locally on your computer. It will take about 1 minute to initialize.
3. In order to check that everything is working you can run jive (GUI for TANGO).
apptainer pull jive.sif oras://gitlab-registry.synchrotron-soleil.fr/software-control-system/containers/apptainer/jive
apptainer run jive.sif
A window with a GUI should appear before you. You can check all available devices in the Devices tab.
Simple TANGO server environment
For some ESRF examples, a simple TANGO server is sufficient to run them.
apptainer pull orm-tango-server.sif oras://gitlab-registry.synchrotron-soleil.fr/software-control-system/containers/apptainer/orm-tango-server:latest
apptainer run --cleanenv orm-tango-server.sif
