SANTESOFT - SANTE DICOM VIEWER PRO

Sante DICOM Viewer Pro

Network configuration guide
Copyright © 2023 Santesoft LTD, all rights reserved

Table of Contents
Definitions ......................................................................................................................................................................................................... 2
DICOM Services ............................................................................................................................................................................................. 2
Store Service (C-STORE) ................................................................................................................................................................................. 2
Query/Retrieve Service (C-FIND/C-MOVE) .................................................................................................................................................... 2
Echo Service (C-ECHO) ................................................................................................................................................................................... 2
DICOM communication protocol ................................................................................................................................................................... 2
Communication between DICOM nodes ....................................................................................................................................................... 2
AE Title ........................................................................................................................................................................................................... 2
IP Address ...................................................................................................................................................................................................... 2
Hostname ...................................................................................................................................................................................................... 2
Port ................................................................................................................................................................................................................ 2
Firewall .......................................................................................................................................................................................................... 3
Configuration .................................................................................................................................................................................................... 4
Configure the Sante DICOM Viewer Pro ........................................................................................................................................................ 4
Configure your PACS server .............................................................................................................................................................................. 6
The Sante PACS Server PG , Sante PACS Server and Sante Free PACS Serverconfiguration.......................................................................... 6
The ConQuest configuration ......................................................................................................................................................................... 7
Send files/series to a PACS server (C-STORE service)........................................................................................................................................ 8
Send files opened in the program ................................................................................................................................................................. 8
Send files stored in the database .................................................................................................................................................................. 8
Query and retrieve (C-FIND/C-MOVE services) ................................................................................................................................................. 9
Network Report .............................................................................................................................................................................................. 11
Troubleshooting .............................................................................................................................................................................................. 12
Check the IP port of the program ................................................................................................................................................................ 13
 SANTESOFT - SANTE DICOM VIEWER PRO

Definitions

DICOM Services
The DICOM protocol consists of many different services, most of which involve transmission of data over a network. The program supports
the store, query/retrieve and echo services (C-STORE/C-FIND/C-MOVE/C-ECHO SCU).

Store Service (C-STORE)

The DICOM Store service is used to send images or other persistent objects to a PACS or workstation.

Query/Retrieve Service (C-FIND/C-MOVE)

This service enables a workstation to find lists of images or other objects and then retrieve them from a PACS system.

Echo Service (C-ECHO)

This service enables a workstation to verify the connection and the communication with another workstation or a PACS system.

DICOM communication protocol

The communication protocol is an application protocol that uses TCP/IP to communicate between systems. DICOM files can be exchanged
between two entities that are capable of receiving image and patient data in DICOM format.

Communication between DICOM nodes

Two DICOM nodes (workstations, PACS systems) can communicate if they know each other. That means, each system must know the AE
Title, the IP address or hostname and the IP port of the other system.

AE Title
AE Title or AET is an abbreviation for Application Entity Title. An AE Title is used by an Application Entity (AE) to identify itself. AE Titles
need to be locally unique and are typically managed by a system administrator. They are case-sensitive and 16 bytes long. They are to be
configured prior to initializing a DICOM connection.

IP Address
An Internet Protocol (IP) address is a numerical identification (logical address) that is assigned to devices participating in a computer
network utilizing the Internet Protocol for communication between its nodes. Although IP addresses are stored as binary numbers, they
are often displayed in more human-readable notations, such as 192.168.100.1. Usually, they can be translated into a hostname via the
local hosts file, or the Domain Name System (DNS) resolver, and can be used instead of the hostname.

Hostname
A hostname is a domain name assigned to a host computer and is translated into an IP Address via the local hosts file, or the Domain Name
System (DNS) resolver. It can be used instead of an IP Address.

Port
TCP/IP protocol uses the notion of port numbers to identify sending and receiving application endpoints on a host. Each side of a TCP
connection has an associated 16-bit unsigned port number (1-65535) reserved by the sending or receiving application. Arriving TCP data
packets are identified as belonging to a specific TCP connection by its sockets, that is, the combination of source host address, source port,
destination host address, and destination port. Ports need to be locally unique and are typically managed by a system administrator. The
numbers 104 and 11112 are usually used as IP Ports in DICOM networking, but any number between 1 and 65535 can be used, but it must
be unique for the host (node/PC), and it must not be used from any other application.
 SANTESOFT - SANTE DICOM VIEWER PRO

Firewall
A firewall is a dedicated software, which inspects network traffic passing through it, and denies or permits passage based on a set of rules.
If there is a firewall in your computer, you have to unblock the application.
 SANTESOFT - SANTE DICOM VIEWER PRO

Configuration

Configure the Sante DICOM Viewer Pro

Select the menu command "Options Network Setup". A dialog box appears and allows you to insert the AE Title and the IP Port of Sante
DICOM Editor. Furthermore, it allows you to insert the AE Title, IP address and port of other nodes in your network like a PACS system or
medical scanners.

The IP Address of the program

Usually, a system has only one IP address and that address is displayed in this dialog box. If there are more than one network adapters and
IP addresses, the program opens its ports in all the IP addresses, though it displays only the first one.

The ports of the program

The program opens three ports, two for DICOM connections and one for use from the built-in OHIF viewer. The first port must only be used
by remote DICOM nodes that are not TLS enabled and the second port must be used only for remote DICOM nodes that support TLS. A
mixed-up situation is not possible. The port of the OHIF viewer is also TLS enabled.
 SANTESOFT - SANTE DICOM VIEWER PRO

Insert/Edit a PACS system

Press the "Insert" or "Edit" buttons of the above dialog box. A new dialog box appears and allows you to insert the information of your
PACS system.

Other Options
Open transferred studies/series when received
When the program receives studies and/or series it inserts them in the database. If you wish to open them immediately after they have
been received, check the checkbox "Open transferred studies/series when received".

Maximum Network Connections option

When the program acts as a client and the user searches and retrieves studies/series from other servers, this option determines the
maximum number of outgoing connections. The program starts transferring as many studies/series as the maximum connections number
indicates and the rest of them are put in a queue. The program waits for a transfer to finish and then opens another until the queue is
empty. When the program acts as a server the number of incoming connections is unlimited. That means, any number of remote clients
can connect with the program and transfer files, without any limitation.

Service time-out option

This option determines how long the program waits for a response from the peer. If this time passes the program interrupts the connection.

Program's security
For maximum security, the user must replace the cert.pem and key.pem files provided by the program with others that have been created
by the user.

How to create the cert.pem and key.pem files

(all paths are the default paths of the programs)
• Download and install the OpenSSL utility
https://slproweb.com/products/Win32OpenSSL.html
• Download the default configuration file
https://github.com/openssl/openssl/blob/master/apps/openssl.cnf
and put it in the bin folder of the OpenSSL library ("C:\Program Files\OpenSSL-Win64\bin")
• Add the path of the binaries of the OpenSSL utility to PATH system variable.
• In the command prompt run the command:
SET PATH=%PATH%;C:\Program Files\OpenSSL-Win64\bin
• In the command prompt run the command:
openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -sha256 -days 36500 -nodes
• Replace the files in the "C:\Sante DBase\.Configuration Files\TLS" folder with the newly generated ones.
 SANTESOFT - SANTE DICOM VIEWER PRO

Configure your PACS server

The Sante DICOM Viewer Pro is compatible with most DICOM PACS providers. Please advise your PACS software help file about AE
configuration of your PACS server. Below are examples of the configuration of Sante PACS Server PG, Sante PACS Server, Sante Free PACS
Server and one of the most popular free PACS servers, the Conquest server. All PACS servers have similar configuration with these ones.

The Sante PACS Server PG, Sante PACS Server and Sante Free PACS Server configuration
Select the menu command "Network Network Peer Setup" of Sante PACS Server PG, Sante PACS Server or Sante Free PACS Server, and
the network peer setup dialog box appears.

Insert Sante DICOM Viewer Pro as a network peer

Press the "Insert" button of the above dialog box. A new dialog box appears and lets you insert the AE Title and the IP Address and port
of Sante DICOM Viewer Pro.
 SANTESOFT - SANTE DICOM VIEWER PRO

The Conquest configuration

Select the "Known DICOM providers" tab and insert the AE Title, IP Address and IP Port of Sante DICOM Viewer Pro. Press the "Save this
list" button.
 SANTESOFT - SANTE DICOM VIEWER PRO

Send files/series to a PACS server (C-STORE service)

Send files opened in the program

Use the menu command "File Send Send To C-STORE SCP" to send the active DICOM file or DICOM series to a C-STORE SCP server. This
command is enabled when you have opened one or more DICOM files and/or series, and you have configured the DICOM networking.

AE Title combo box

Selects a C-STORE SCP server.

Echo button
Tests the connection with the selected C-STORE SCP server.

OK button
Sends the selected entries to the selected C-STORE SCP server and closes the dialog box.

Cancel button
Interrupts the procedure and closes the dialog box.

Send files stored in the database

From the interface of the database select the button “Send to C-STORE”. This button is enabled when the user has selected at least one
patient/study from the query results.
 SANTESOFT - SANTE DICOM VIEWER PRO

Query and retrieve (C-FIND/C-MOVE services)

Select the "Network" tab from the mode selection control, in the lower left corner of the main window.

The "C-STORE SCP" tool in the upper left corner of the Network window allows the user to select the server from which the series/studies
will be retrieved. The user must have already configured the known DICOM servers as described in the section Configuration.

The combo box "AE Title" contains all the known DICOM servers, and the user can select from this combo box the desired series/study
source. The button "Refresh AE Titles" allows the user to refresh the contents of the combo box "AE Title" if he has just added new servers
with the Configuration procedure. The button "Echo" allows the user to determine if a server is alive and it can answer find/retrieve
queries. The button "Settings" allows the user to configure the network.

The program has four buttons that allow the user to query the selected server.

The "Today" button asks the server for the series/studies of the current date.
The "Yesterday" button asks the server for the series/studies of the previous of the current date.
The "Last 7 Days" button asks the server for the series/studies of the last seven days.
The "Search All" button asks the server for all the series/studies.
The "Search Dates” button asks the server for all the series/studies of a specific range of date.
 SANTESOFT - SANTE DICOM VIEWER PRO

The user can fine tune the query by adding more information about the desired results, like the patient’s name, the patient ID etc.

The results of the queries are displayed in the Study and Series lists. The user can retrieve the desired series/studies by selecting them in
the list and pressing the corresponding "Retrieve" button.

If the user wishes the program to load automatically in the main window the just arrived series/studies, he must have the option "Open
study/series when retrieved" enabled.
 SANTESOFT - SANTE DICOM VIEWER PRO

Network Report
Use the menu command "View View Network Report" to view all the network logs. The program keeps a log for every network activity
and displays them in the Network Report dialog box.

To view the details of the log of an activity, select its row and press the “Details…” button or double click the row of this activity.
 SANTESOFT - SANTE DICOM VIEWER PRO

Troubleshooting
• Ensure that the port of the program is not used by any other program.
• Ensure that the port of the program is not blocked from a firewall or an antivirus.
• When the program starts it asks for to be added in firewall exception list. If you answered no, you must add it manually.

• If the two nodes (server and client) belong to different subnetworks, ensure that the port of the program is forwarded by the router.
• If the program can "ECHO" the other node (client/server) but it cannot transfer files: Both machines (server and client) must know
each other. You must insert the AE Title, IP address and port of the application into “Known DICOM Nodes” list of the other node
(client/server). Without this information the client/server does not know where to send the files.
• If the PC has more than one network card (physical, logical or virtual network cards) and thus more than one IP address, ensure that
the client and server use an IP address of the same sub-network. E.g., If the server has two IP addresses, the addresses 192.168.1.1
and 172.91.1.1 and the client has the IP address 192.168.1.* the client must use the address 192.168.1.1 as the IP address of the
server. If the client has the IP address 172.91.1.* it must use the address 172.91.1.1 as the IP address of the server. That means that
the server and client must belong to the same sub-network. In case that the PC has more than one IP address, the program displays
only one IP address, the first one, although it opens its IP ports in all the available network interfaces and not only in the indicated IP
address. Use the command ipconfig in the command prompt to get a list of all the IP addresses of the PC.
 SANTESOFT - SANTE DICOM VIEWER PRO

Check the IP port of the program

You can use the netstat utility in the command prompt to check if the port of the program is opened and at which IP address.

In the command prompt, use the command:

C:\>netstat -ano -p tcp |find "11112"
to check if the port 11112 of the program is opened and at which IP Address. The last number that the program prints is the PID of the
application that has opened the port.

In the command prompt, use the command:

C:\>tasklist |find "16832"
to find which is this application.