Skip to content

From zero to deploy

Jump to bottom
a5566qq123 edited this page May 7, 2023 · 7 revisions

Step by Step guideline of installing - Windows

Download Raccoon

Use git

git clone https://github.com/Chinlinlee/raccoon-dicom.git

Download ZIP

image

⚠️ Please unzip by yourself

Install Environment Requirements

Environment Requirements

The following is a list of requirements, we will install each software next.

Install Node.js 16

image

  • Click Next

image

  • Check I accept the terms in the License Agreement and click Next

image

  • Select Install Destination and click Next

image

  • Click Next

image

  • Click Next

image

  • Click Install

image

Verify Node.js has been installed successfully

Open cmd and type node -v. If present v16.20.0, congratulations install successfully.

image

Install MongoDB

image

  • Open mongodb-windows-x86_64-4.4.21-signed.msi that you downloaded

image

  • Click Next

image

  • Check I accept the terms in the License Agreement

image

  • Select Complete

image

  • Set Data Directory and Log Directory and then click Next

image

  • Install MongoDB Compass

image

  • Click Install

image

  • Installation Completed!

image

Create User in MongoDB

Since the MongoDB connection with Raccoon-DICOM requires username and password. You need to create a user in the MongoDB to use Raccoon-DICOM.

  • Open MongoDB Compass
  • Enter the following connection string in New Connection and click Connect.
mongodb://localhost:27017

image

  • Click >_MONGOSH below.

image

  • Enter the following command to switch to admin database
use admin;

image

  • Enter the following command to create root user

Warning ⚠️Please change the username and password to a secure one by yourself!

db.createUser({
    user : "root",
    pwd : "root" ,
    roles : [{role : "root" , db:"admin"}]
});

If present { ok: 1 }, it means the creation was successful!

Install ImageMagick

image

  • Click ImageMagick-7.1.0-27-Q16-HDRI-x64-dll.exe to download

image

  • Open ImageMagick-7.1.0-27-Q16-HDRI-x64-dll that you downloaded

image

  • Check I accept the agreement and click Next

image

  • Click Next

image

  • Select install destination and click Next

image

  • Click Next

image

  • Click Next

image

  • Click Install

image

  • Click Next, and uncheck View Index.html, and click Finish

image image

Verify installation is complete

Open cmd (command prompt) and enter "magick -version". If you see the following message, the installation is successful!

image

Install JAVA JDK

image

  • Open OpenJDK11U-jdk_x64_windows_hotspot_11.0.19_7 that you downloaded one

image

  • Click Next

image

  • Select install destination and click Next

image

  • Click Install

image

  • Completed!

image

⚠️Please reboot after installation

Verify JAVA is installed successfully

  • Open the command prompt and enter javac --version
  • If present version info on cmd, congrats!

image

Raccoon-DICOM Installation

The required software has been installed, and you can now proceed with setting up Raccoon! ⚠️ Note: Before the following steps, please navigate to the Raccoon project directory.

Install Node.js Packages

Open the command prompt and navigate to the Raccoon project directory, then execute the following command:

npm i --only=production

Note --only=production means only install dependencies in the dependencies block of package.json file

Configure dotenv .env file

  • Copy .env.template in the project root and rename it to .env

image

  • Modify .env 
# MongoDB
MONGODB_NAME="raccoon-dicom"
MONGODB_HOSTS=["mongodb"]
MONGODB_PORTS=[27017]
MONGODB_USER="root"
MONGODB_PASSWORD="root"
MONGODB_AUTH_SOURCE="admin"
MONGODB_OPTIONS=""
MONGODB_IS_SHARDING_MODE=false

# Server
SERVER_PORT=8081
SERVER_SESSION_SECRET_KEY="secret-key"

# DICOM Web
DICOM_STORE_ROOTPATH="/dicomFiles"
DICOMWEB_HOST="{host}"
DICOMWEB_PORT=8081
DICOMWEB_API="dicom-web"

# DICOM DIMSE
ENABLE_DIMSE=true
DCM4CHE_QRSCP_COMMAND=`[
    "-b",
    "[email protected]:11112",
    "--dicomdir",
    "{project}/config/DICOMDIR",
    "--ae-config",
    "{project}/config/ae.properties",
    "--all-storage",
    "--filepath",
    "DICOM/{0020000D,hash}/{0020000E,hash}/{00080018,hash}.dcm",
    "--raccoon",
    "{project}/config/raccoon-dimse-app.example.json"
]`

# FHIR
SYCN_TO_FHIR_SERVER=false
FHIRSERVER_BASE_URL="http://localhost:8088/fhir"

Deploy Raccoon-DICOM

  • Open command prompt and enter Raccoon project directory, then execute following command
node server.js

Test Raccoon-DICOM features

Upload DICOM Instance (STOW-RS)

  • The following steps will use the file test/dicomFiles/jpeg2000/example-jpeg-2000.dcm for uploading test
  • Use curl for uploading
curl --location --request POST "http://localhost:8081/dicom-web/studies" ^
--header "Accept: application/dicom+json" ^
--header "Content-Type: multipart/related; type=\"application/dicom\"" ^
--form "[email protected]; type=application/dicom"
  • If present message following, congrats upload successful!!
{"00081190":{"vr":"UT","Value":["http://localhost:8081/dicom-web/studies/1.3.46.670589.45.1.1.4993912214784.1.5436.1538560373543"]},"00081198":{"vr":"SQ","Value":[]},"00081199":{"vr":"SQ","Value":[{"00081150":{"vr":"UI","Value":["1.2.840.10008.5.1.4.1.1.77.1.6"]},"00081155":{"vr":"UI","Value":["1.3.6.1.4.1.5962.99.1.3002151337.1017604488.1540600476073.6.0"]},"00081190":{"vr":"UT","Value":["http://localhost:8081/dicom-web/studies/1.3.46.670589.45.1.1.4993912214784.1.5436.1538560373543/series/1.3.46.670589.45.1.1.4993912214784.1.5436.1538560606509.3/instances/1.3.6.1.4.1.5962.99.1.3002151337.1017604488.1540600476073.6.0"]}}]}}

Get Image info (QIDO-RS)

Retrieve Image (WADO-RS)

image

image

en-US zh-TW

Base

Developer

Plugin

Clone this wiki locally