StoreSCP Installation and Setup

Montreal

1. Make sure to have cloned the unf stack repository and switched to the montreal branch and switch to the stack repository. If you have not already, you can also go ahead and git clone ssh://git@gitlab.unf-montreal.ca:222/ni-dataops/containers.git to get the containers.

2. Create a dicom data endpoint directory on the manager node (server-1):

   mkdir -p /data/dicom_endpoint
   

Calgary

Docker Swarm Installation

1. Clone the unf stack repository.

2. Move into the proper folder of the repository.

   cd stack/storage_server
   

3. If you are using self signed certificates, switch into the selfsigned-certs branch and make sure that the storescp image was built including the selfsigned certificates.

4. Create the required secrets.

   sudo docker secrets create name-of-secret secret-file
   # secret-file can be any text file containing the needed information.
   # OR
   echo "xxxxxxxxxx" | docker secret create name-of-secret -
   # make sure to remove the entry from the server's history
   

Important

Make sure that the docker-compose file is pointing to those secrets for their use inside the container.

Important

Make sure that the docker-compose file point the service deployment to the manager node using the constraints.

deploy:
placement:
      constraints:
      - node.hostname == manager-node.ca

1. Run the docker command

   docker stack deploy --compose-file docker-compose.dicom-rcv.yml cpip
   

   Important

   In docker swarm in order to mount a volume to a container, such volume must exist. This is not necessary using docker compose where directories are created if missing.

2. More documentation on how to automatically and securely deploy the storescp enviromental varibles using docker secrets to come.

3. Debbugging

   Note

   Check this post for debbugging.

   Important

   In docker swarm, in order to mount a volume to a container, such volume must exist. This is not necessary using docker compose where directories are created if missing.

Docker Compose Installation

StoreSCP stands for "Store Service Class Provider". In the DICOM network communication model, a Service Class Provider (SCP) is an entity that provides services to a Service Class User (SCU). In this case, storescp acts as a receiver (server) in a network exchange where it accepts DICOM images or data sent over the network from a sender (client), which is typically a SCU like a PACS system, MRI or CT scanner, or another workstation.

The C-PIP pipeline will have a StoreSCP container listening for DICOMS sessions being pushed from the MRI. StoreSCP deployment is simple since it relies on docker and all the configuration/code is already in a GitHub repository.

1. First, make sure you have docker and docker compose installed.

2. Then clone the GitHub repository https://gitlab.com/cal_cpip/calgary-servers.git which will contain the requied configurations, dockerfiles, and docker compose files.

   Note

   Some modifications have been made to this repository in order to function using self-signed certificates.

3. In the sequoia folder of the repository you will find the docker compose file docker-compose_storescp_dev.yml.

4. Check the following configuration files inside the calgary-servers/sequoia/storescp/ folder:

   • storescp/exect_on_study_received.py

   • storescp/start.sh

   • storescp/unf_**.py

   • storescp/_vars.env

5. Finally, all you need to do is run the following command to spin up this container.

sudo docker compose -f calgary-servers/sequoia/docker-compose_storescp_dev.yml up