Development Environment Installation (Ubuntu)
This is a confidential document and property of Radical Imaging LLC. It shall not be transmitted, copied or sent to anyone without prior authorization.
|Acronyms and definitions|
|Doc No||Doc Title|
|DOC00001||Radical Imaging Official Documents Template|
The purpose of this document is to describe the development environment installation of OHIF viewer/Lesion Tracker on Linux Ubuntu.
Docker is an open source software platform to create, deploy and manage virtualized application containers on common operating systems, with several allied tools.
To install Docker, follow the instructions below:
- Open a terminal, and update the apt package index, by running the following command:
sudo apt-get update
- Install packages to allow apt to use a repository over HTTPS, by running the following command:
sudo apt-get install apt-transport-https ca-certificates curl software-properties-common
- Add Docker’s official GPG key, by running the following command:
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
- Verify that you now have the key with the fingerprint 9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88, by searching for the last 8 characters of the fingerprint after running the following command:
sudo apt-key fingerprint 0EBFCD88
- Use the following command to set up the stable repository.
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
- Install the latest version of Docker CE, by running the following command:
sudo apt-get install docker-ce
- Verify that Docker CE is installed correctly by running the hello-world image:
sudo docker run hello-world
Note: Additional information about Docker installation on Linux Ubuntu OS can be foud at https://docs.docker.com/install/linux/docker-ce/ubuntu/.
Dcm4che (https://www.dcm4che.org/) is a collection of open source applications and utilities for healthcare.
To install Dcm4che, follow the instructions below:
- Before start, you need to create the following folders on your Home directory:
- Create the following files on the DCM4CHEE folder, with the correspondent contents:
version: "3"services:ldap:image: dcm4che/slapd-dcm4chee:2.4.44-14.1logging:driver: json-fileoptions:max-size: "10m"ports:- "389:389"env_file: docker-compose.envvolumes:- /etc/localtime:/etc/localtime:ro- /etc/timezone:/etc/timezone:ro- ~/dcm4chee-arc/ldap:/var/lib/ldap- ~/dcm4chee-arc/slapd.d:/etc/ldap/slapd.ddb:image: dcm4che/postgres-dcm4chee:10.4-14logging:driver: json-fileoptions:max-size: "10m"ports:- "5432:5432"env_file: docker-compose.envvolumes:- /etc/localtime:/etc/localtime:ro- /etc/timezone:/etc/timezone:ro- ~/dcm4chee-arc/db:/var/lib/postgresql/dataarc:image: dcm4che/dcm4chee-arc-psql:5.14.1logging:driver: json-fileoptions:max-size: "10m"ports:- "8080:8080"- "8443:8443"- "9990:9990"- "11112:11112"- "2575:2575"env_file: docker-compose.envenvironment:WILDFLY_CHOWN: /opt/wildfly/standalone /storageWILDFLY_WAIT_FOR: ldap:389 db:5432depends_on:- ldap- dbvolumes:- /etc/localtime:/etc/localtime:ro- /etc/timezone:/etc/timezone:ro- ~/dcm4chee-arc/wildfly:/opt/wildfly/standalone- ~/dcm4chee-arc/storage:/storage</td>
Files/Folder will become like the image above:
- Open a terminal inside DCM4CHE folder, and run the following command:
sudo snap install docker
- Still inside the DCM4CHE folder, run the following command:
sudo docker-compose -p dcm4chee up -d
- The following commands can be used to control DCM4CHE:
Stop all 3 containers: docker-compose -p dcm4chee stop
Start all 3 containers again: docker-compose -p dcm4chee start
Stop and delete all 3 containers: docker-compose -p dcm4chee down
- Now it is necessary to import some DICOM studies to DCM4CHE. Before importing these studies, you will need to download them. To do so, access the address http://126.96.36.199:3000/studylist, right click one or more studies, and select the option Export:
- Confirm the study export on the modal window that will appear:
- The study(ies) export will begin. You can follow the exporting progress:
- After the exporting progress, the study(ies) will be downloaded in a file called "studies.zip". Create a folder named “Studies” on your Home folder, and extract this and any other studies you download in this folder:
- Open the terminal, go to the DCM4CHE folder, and run the following command in order to send the studies to DCM4CHE:
docker run -v ~/Studies/:/tmp --rm --network=dcm4chee_default dcm4che/dcm4che-tools:5.14.0 storescu -cDCM4CHEE@arc:11112 /tmp
- Now, go to your browser and access the URL http://localhost:8080/dcm4chee-arc/ui2/. Once opened, click on the refresh icon on the most right:
- The studies received by DCM4CHE will be shown:
- Open the terminal, go to your Home folder, and run the following command in order to clone viewers repository to your local:
git clone https://github.com/OHIF/Viewers.git
- Then, enter the Viewers folder, and run the following command in order to make sure that you are in master branch:
git checkout master
- Now go to OHIFViewer folder and run the following command:
meteor npm install
- Still on the OHIFViewer folder, run the following command:
- Now, go to your browser and access the URL http://localhost:3000. Once opened, change the Study Date filter to start on the year 2000:
- The imported studies will be show. Double click a study to open it:
To install Meteor, follow the instructions below:
Remark*: This guide covers the Linux Ubuntu version. Installation instructions can be different on other operating systems.*
- Open a terminal, and run the following command:
curl https://install.meteor.com/ | sh
These are the steps to run OHIFVIewer after system restart:.
Access the DCM4CHEE folder, on your Home folder
Run the following command in order to start docker containers:
docker-compose -p dcm4chee start
Access the Viewers/OHIFViewer folder, on your Home folder
Run the following command in order to run OHIF Viewer:
- Access the address http://localhost:3000