NPA XI school - gELBE hands-on activity

Here you can find information about the electron accelerator ELBE and the gELBE bremsstrahlung facility.

Practical informations

• The hands-on activity will happen on Sep. 12th from 09:00 a.m. till 05:15 p.m.
• A bus will pick you up at the parking lot of the Burghotel at 08:40 a.m.
• Please bring your own PC with you. If you don't have one please contact Roland Beyer.

Preparations

Please install the docker runtime engine and the gELBE_activation_hands-on container prior to the hands-on day. To do so, please follow the following instructions.

1. Install Docker runtime engine

Install the docker engine (or Docker Desktop) for your operating system.

OS-specific instructions can be found here (https://docs.docker.com/engine/install/).

A brief overview on how to install the runtime engine on Windows- and Debian-based systems is listed below.

Windows

On windows machines we recommend to install Docker Desktop. To install this graphical interface for the Docker runtime engine go to https://docs.docker.com/desktop/install/windows-install/ and download the latest Docker Desktop Image. Follow the instructions to install the program.

Linux

If you use Linux as your operating system, we recommend installing the runtime engine via the official package sources.

Set up Docker's apt repository.

# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

Install the Docker packages.

To install the latest version, run:

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Verify that the installation is successful by running the hello-world image:

sudo docker run hello-world

2. Download gELBE docker

Windows

Start Docker Desktop. Search for "koeglerto" and click on "pull" to download the container.

Linux

Open a terminal and type:

docker pull koeglerto/gelbe_activation_hands-on

Wait until the download was completed.

Run gELBE docker

1. Start the gelbe_activation_hands-on container on your machine

On Windows:

In Docker Desktop click on Images. The docker koeglerto/gelbe_activation_hands-on should be listed there. Click on the play button to run the docker.

In the opening dialog window:

• Choose a name for the container (e.g. "NPAdocker").
• Enter the Port 8895 for forwarding in the field "Host port".
• In "Host path" you should select a directory on your local disk to share persistent data with the container.
• Copy the container paths: /home/physicist/Notebooks/ to field "Container path".
• Click on the "Run" button.

On Linux:

In linux the following command should be executed from the command line interface (CLI):

docker run --rm -it \
-p 149.220.82.133:8895:8895 \
-v /home/koeglert/Dokumente/Notebooks:/home/physicist/Notebooks/ \
--hostname NPAdocker \
koeglerto/gelbe_activation_hands-on

2. Open the Jupyter Notebook "ActivationOfNickel.ipynb"

Open a local (internet) browser and copy (or click on) the link to the jupyter-lab from the Docker Desktop or the Linux CLI. Do not forget to include the hash-tag.

• Jupyter should the open in the browser. Right-click on "NPA-hands-on" --> "Copy"
• Navigate to "Notebooks" --> Right-click "Paste"
• Switch to "Notebooks/NPA-hands-on" and double-click on "ActivationOfNickel.ipynb"
• The jupyter notebook should open now.