HTML 5 ZERO-FOOTPRINT DICOM VIEWER

QUICK START GUIDE

Windows x64 Orthanc PACS
Document version 1.00

This guide describes the basics of installing and configuring web-based DICOM Viewer for PACS server.
More information is provided in the full Install Manual, download its latest version: Install Manual.
 ABOUT SOFTWARE

This guide describes MedDream DICOM Viewer deployment on Windows x64 and configuration when studies are
stored in the Orthanc PACS server.
MedDream DICOM Viewer can be integrated into any PACS archive, HIS/RIS/EHR/EMR, Telemedicine, Patient
Portals, National Systems, CAD and AI algorithms. MedDream Universal Enterprise Viewer can be installed on
premises, in any virtual environment or on cloud.
MedDream is designed to aid medical professionals in day-to-day decision-making process. MedDream is a cost
effective certified solution perfect for software vendors, integrators, OEM‘s and national system providers.

PREREQUISITES

The Operating system is Windows 10 (x64) or one of the Windows Server (x64) versions: 2012, 2012 R2,
2016, 2019.

Orthanc PACS server is installed. If Orthanc PACS is not installed on the server, you can download it here:
https://www.orthanc-server.com/download.php

Make sure the server has at least 3 GHz CPU with 2 cores, 3 GB of RAM, 20 GB of available hard disk
space. Network bandwidth is not less than 4 Mbit/s.

INSTALLATION FOR THE FIRST TIME

Install MedDream DICOM Viewer:

• Download the latest Windows version of MedDream from the Softneta website:
https://www.softneta.com/files/meddreamviewer/NEWEST/MedDream-DICOM-Viewer-Setup.exe
• MedDream-DICOM-Viewer-Setup.exe.

© Softneta. Document version 1.00 1 Page

 • Remember default MedDream Viewer login credentials and click Next > button:

• Choose C:\MDPACK and click Next > button:

© Softneta. Document version 1.00 2 Page

 • Choose Custom configuration and click Next > button:

• Choose Orthanc configuration and click Next > button:

© Softneta. Document version 1.00 3 Page

 • Click Install button:

• A progress bar will be displayed during the MedDream Viewer installation process:

© Softneta. Document version 1.00 4 Page

 • Well done, you have completed the installation. Click Finish button.

CONFIGURATION

Change the basic MedDream Viewer settings for the first launch. Open application.properties file.
You can find it in the C:\MDPACK\MedDream\application.properties. Do the following steps:
• Change username from {Username} to, for example, “orthanc”:
com.softneta.meddream.pacs.configurations[0].username=orthanc
• Change password from {Password} to, for example, “orthanc”:
com.softneta.meddream.pacs.configurations[0].password=orthanc
• Change dicomCacheDirectory from ${com.softneta.meddream.tempDir}/dcm/OrthancLocal
to, for example, file:///c:/Orthanc:
com.softneta.meddream.pacs.configurations[0].dicomCacheDirectory=file:///c:/Ort
hanc
• Enter AE title, IP address, port of PACS, if you want to enable the ability to save annotations and
other additional information in the MedDream Viewer:
com.softneta.meddream.pacs.configurations[0].storeScpAet=ORTHANC
com.softneta.meddream.pacs.configurations[0].storeScpIp=127.0.0.1
com.softneta.meddream.pacs.configurations[0].storeScpPort=4242

© Softneta. Document version 1.00 5 Page

 Change the other MedDream Viewer settings. You can add additional MedDream settings or change
existing ones in the C:\MDPACK\MedDream\application.properties file. The minimum MedDream DICOM
Viewer configuration for opening studies stored on the Orthanc PACS server is given below:

server.port=80
server.servlet.session.timeout=60
server.compression.enabled=true
server.compression.mime-types=application/octet-stream

authentication.manager.username=admin
authentication.manager.password=

spring.profiles.include=auth-inmemory
authentication.inmemory.users[0].userName=demo
authentication.inmemory.users[0].password=demo
authorization.users[0].userName=demo
authorization.users[0].role=ADMIN,VIEW_PRIVATE,SEARCH,PATIENT_HISTORY,
UPLOAD_DICOM_LIBRARY,EXPORT_ISO,EXPORT_ARCH,FORWARD,REPORT_UPLOAD,
3D_RENDERING,DOCUMENT_VIEW

logging.level.ROOT=ERROR
#logging.level.com.softneta=INFO
#logging.level.sun.net.www.protocol.http=DEBUG
logging.file.name=meddream

com.softneta.dicom.library.upload.anonymized=true
com.softneta.preparation.multiFrameThreadTimeoutSeconds=300

com.softneta.audit.useTls=false
com.softneta.audit.trustStore=file:///c:/tmp/nxlog/client/cacerts.jks
com.softneta.audit.trustStorePassword={password}
com.softneta.audit.keyStore=file:///c:/tmp/nxlog/client/cacerts.jks
com.softneta.audit.keyStorePassword={password}

spring.batch.job.maxFailedJobRestarts=10

© Softneta. Document version 1.00 6 Page

 com.softneta.meddream.pacs.configurations[0].type=Orthanc
com.softneta.meddream.pacs.configurations[0].id=OrthancLocal
com.softneta.meddream.pacs.configurations[0].baseUrl=http://127.0.0.1:8042
com.softneta.meddream.pacs.configurations[0].username={Username}
com.softneta.meddream.pacs.configurations[0].password={Password}
#com.softneta.meddream.pacs.configurations[0].dicomCacheDirectory=
${com.softneta.meddream.tempDir}/dcm/OrthancLocal
com.softneta.meddream.pacs.configurations[0].storeScpAet=ORTHANC
com.softneta.meddream.pacs.configurations[0].storeScpIp=127.0.0.1
com.softneta.meddream.pacs.configurations[0].storeScpPort=4242

Restart MedDream service. After making any changes to the application.properties file, the MedDream
service must be restarted.
• Open Windows Services by pressing <Win⊞ > + R and type services.msc. Click OK button:

• Find the MedDream service and restart it:

© Softneta. Document version 1.00 7 Page

 NOTE: In the C:\MDPACK\MedDream\ApTemplates you can find examples of MedDream Viewer configurations
with explanations. All MedDream settings are stored in the application.SAMPLE.properties file.

VERIFICATION

Open a browser and enter the MedDream URL http://127.0.0.1/ in the address bar.

In the login window, enter the username demo and password demo. Press Log in button:

TIP: If you can't connect, restart Windows services (run in cmd line: services.msc and restart MedDream
service).

MedDream Viewer shows an empty list of studies:

© Softneta. Document version 1.00 8 Page

 Upload studies to the Orthanc PACS server, follow these steps:
• Open a browser and enter the Orthanc PACS URL http://127.0.0.1:8042/ and click the Upload
button at the top right of the page:

• Click “Select files to upload”, select the DICOM files you want to upload and click Open button:

© Softneta. Document version 1.00 9 Page

 • In the "Drag and drop DICOM files here" section you can see the selected files. Click the "Start
the upload" button to upload the files to the repository:

• When the DICOM files are uploaded to the repository, the system displays a “Done” success
message.

TIP: Samples of anonymized studies can be downloaded from https://demo.softneta.com/ (Login –> Open
the selected study –> Click Export –> Select the DICOM format and click Export again –> Press the
Download link).

© Softneta. Document version 1.00 10 Page

 Review uploaded studies in the MedDream Viewer:
• Type http://127.0.0.1/ into your browser's address bar again. Login with user demo, password
demo and change the date range selection by pressing <Any> button. Now you can see your
studies in the list:

• Click once on the study with the left mouse button. MedDream Viewer opens the study in a new
browser tab:

Now you can try and see how powerful and useful this tool is.

© Softneta. Document version 1.00 11 Page

 TROUBLESHOOTING

You must restart the MedDream service each time after changes to the application.properties file or if
something went wrong. You can restart the service by running in cmd line: services.msc -> then selecting
MedDream service and clicking Restart on the left.

If you can't open the studies, clearing your browser's cache may help. Open a browser and press
CTRL+SHIFT+DEL. Then select which old data you want to delete and click Clear data.

MedDream DICOM Viewer logs are stored in the C:\MDPACK\MedDream\meddream.main.log. The

standard logging level in the application.properties file is set to INFO. If the log contains too little information,
you can change the logging level to DEBUG by changing the value of the logging.level.com.softneta
parameter.

LICENSE

MedDream DICOM Viewer licensed under the Commercial License. Please contact info@softneta.com to get
TRIAL or Commercial license. If you have a License Serial number, follow these instructions:

Press Register button. The system opens a license registration window:

Enter the name of the organization and the license Serial number you received.

Click on the link EULA and read Software License Agreement. After reading, close the window by
clicking the <Close> button.

Check the box □ to confirm that you accept license agreement.

Press Register button. The license will be successfully registered.

© Softneta. Document version 1.00 12 Page

 NOTE: If you have any questions about MedDream licenses and prices, please contact our SALES team by e-
mail info@softneta.com or by phone +370 670 15991.

HELP AND RESOURCES

Detailed MedDream installation and configuration instructions are provided in the install manual. You can
download it from here: https://www.softneta.com/files/meddreamviewer/doc/MedDream-DICOM-Viewer-
Install-Manual.pdf

We are constantly improving this product. Get the most out of your MedDream Viewer with updated features
and performance.

Download the User manual from https://www.softneta.com/files/meddreamviewer/doc/MedDream-DICOM-

Viewer-User-Manual.pdf and get more information about this device.

Read short instructions and watch tutorial videos here: https://www.softneta.com/documentation/user-

guide/user-introduction/

Our great SUPPORT team is always ready to help you. If you have any questions, please write an email to
support@softneta.com or call +370 645 06960.

© Softneta. Document version 1.00 13 Page