diff --git a/install_docker.rst b/install_docker.rst index 1e16bf49..e7fdf5d0 100644 --- a/install_docker.rst +++ b/install_docker.rst @@ -152,3 +152,38 @@ If you bring the container back-up you should be able to see your pSConfig chang # docker-compose up -d # docker-compose exec testpoint psconfig remote list + + +Running the Systemd based image +=============================== + +The container image adopted in the previous steps makes use of `supervisord `_ to manage system processes. In addition to that, perfSONAR also provides an image based on `systemd `_. + +As systemd is the system and service manager adopted by most linux distributions, both installation and management of services are done in the same way inside the container as in a bare metal host, which facilitates the container maintenance and automation. Also, in scenarios where the testpoint container is expected to run for long periods without stopping, systemd guarantees better stability. + +On the other hand, to run a docker container with systemd, additional parameters are needed and because of that, a dedicated `docker-compose `_ YAML file was provided to assist in this process. + +Build the image locally:: + + # docker-compose -f docker-compose.systemd.yml build + +Start the container in the background:: + + # docker-compose -f docker-compose.systemd.yml up -d + +Your container is now running. You can enter the container, verify it is working and add a remote pSConfig file that will be persisted in the `./compose/psconfig` directory:: + + # docker-compose -f docker-compose.systemd.yml exec testpoint bash + [docker-desktop /]# systemctl status + [docker-desktop /]# pscheduler troubleshoot + [docker-desktop /]# psconfig remote add URL # replace URL with your pSConfig JSON file URL + [docker-desktop /]# exit + +You can stop your container at any time with the following:: + + # docker-compose -f docker-compose.systemd.yml down + +If you bring the container back-up you should be able to see your pSConfig changes still:: + + # docker-compose -f docker-compose.systemd.yml up -d + # docker-compose -f docker-compose.systemd.yml exec testpoint psconfig remote list \ No newline at end of file