User Manual Charruapacs - Advanced Edition: Charruasoft S.A
User Manual Charruapacs - Advanced Edition: Charruasoft S.A
User Manual Charruapacs - Advanced Edition: Charruasoft S.A
User Manual
CharruaPACS – User Manual_en
Page 1 of 42
Version: 6.2 Reviewed by: Rafael Sanguinetti Approved by: Rafael Sanguinetti
Date: 02/3/02017 Date: 02/3/2017
User Manual
Developed by:
CharruaSoft
http://www.charruasoft.com
Table of Content
1. Introduction.........................................................................................................3
2. Computer Platform..............................................................................................3
3. Software Specifications......................................................................................4
4. Software installation............................................................................................4
Software installation:...........................................................................................4
5. Admin configuration............................................................................................7
5.1 Main Tab.......................................................................................................7
5.2 Backup Tab...................................................................................................9
5.3 Restore Tab.................................................................................................11
7. WEB Server......................................................................................................13
7.1 Main WEB Page..........................................................................................13
7.2 Manage Users.............................................................................................14
7.3 Server Setup...............................................................................................16
7.4 Routing Queue Status.................................................................................20
7.5 Query Studies.............................................................................................21
7.6 Download HTTP Client................................................................................24
7.7 Query Worklist.............................................................................................27
7.8 Add to Worklist............................................................................................28
1. Introduction
CharruaPACS is a simple to install and maintain PACS server. It supports
DICOM C-STORE SCP for most used SOP classes, with uncompressed Transfer
Syntax and JPEG lossless, JPEG lossy and JPEG 2000 Transfer Syntaxes, C-
FIND and C-MOVE SCP Study Root model and C-ECHO Verification as SCP.
The code used in CharruaPACS is derived from the UCDMC DICOM library by
Mark Oskin. It also uses the Independent JPEG group library for JPEG
compression/decompression and the OpenJPEG group library for JPEG 2000
compression/decompression. The advanced version uses PostgreSQL as
database. WebServer is based on Indy Project TIdHTTPServer.
2. Computer Platform
The minimum configuration is a personal computer with:
3. Software Specifications
The software has the following characteristics:
4. Software installation
Software installation:
6. When the installation is about to finish, the Wizard closes and the
Admin CharruaPACS windows opens. Click in Create dB to generate the
tables installed in step 3.
7. Close the application Admin CharruaPACS to finish the installation
process.
8. Access to the browser to check that the application is correctly installed
(See Chapter 7). For logging in the WEB interface: user:admin,
pass:admin.
5. Admin configuration
Double clicking on the Program (CharruaPACS/admin), you will see the following
screen.
In the “Database” section, you can create or regenerate a database and obtain
information of CharruaPACS software.
In the section of “Server Configuration” you can set the DICOM Application
Entity Title and the Port Number for the server. You also can chose different LOG
levels for debugging.
The section of “HL7 Listener” is for receiving ORM messages from HIS/RIS
systems. Configuration includes the Port and also the HL7 to DICOM conversion
table.
Admin will create a “cp_register.txt” file with the registration information. User will
have to send us this file in order to create the license key.
- Manual Backup:
The options on this tab allow to backup any month from the archive.
First select the month (month and year) to backup, then choose the destination
folder and then clicking on Copy, it will make a copy for all objects in the selected
month.
Choosing Move, it will copy and then delete the selected month.
With the Stop button the operation can be aborted at any time. There will be no
changes in the archive.
The “Backup User Table” button saves all users configuration to the destination
folder.
- Automatic Backup:
The Automatic Backup is only available for CharruaPACS Advanced in REAL
mode.
The Automatic Backup tab enables automatic backup, selecting from an external
drive for backup, and testing the available space.
Restoring the backup is as simple as selecting the origin folder, clicking on the
“Load List” button and then selecting the desired studies (you can select all the
studies, clicking on “Select All”).
Clicking on the “Start” button, the system will start loading the images into the
PACS archive.
The process can be stopped at any time with the “Stop” button.
Clicking the “Start” button without selection it will load all the images in the folder
and sub-folders. This procedure is faster than selecting the studies.
The “Restore User Table” button will read the backed up users configuration from
the source folder.
In case of any errors in the operation of CharruaPACS, please send the log file to
info@charruasoft.com.
7. WEB Server
The WEB Server operates as the User Interface for CharruaPACS, it uses port
80 by default, and is accessible by using http://localhost/index.htm on the local
machine, or if accessing from a remote machine with the IP address of the server
machine.
The WEB Server runs as a Windows Service, configuration and operation are
controlled by the Admin Application.
Query Worklist: query page for viewing the DICOM worklist entries.
This page is only available to the Admin user. Here new users can be created, or
existing users can be modified.
The Transfer syntax set here is used for the HTTP Client application. The JPEG
Lossy tiled option shows multiple images per page in the web browser.
The Query Filter is a string that has to match with a part of the Study Description
tag. This way studies can be filtered for different users. The same applies for
Modality, Institution Name and Referring Physician filters.
Only the Admin and the Radiologist users can do DICOM/Windows printing and
CD/DVD burning in the HTTP Client. Printer AET selects the DICOM Film Laser
printer were the user prints to.
The required parameters for adding a new Remote Server are: DICOM
Application Entity Title, IP Address, Port Number and Timeout.
For deleting any Remote Server check the right box and click the “Delete” button.
For deleting any rule, check the right box and click on the “Delete” button.
The JPEG server is a destination for converting DICOM images into JPEG
files. Files are saved on the jpeg folder under a Modality/Patient
Name_Patient_ID subfolder.
Any field can be used for the Query studies, even partial matches are accepted.
Today button will bring all studies for the day, filtered by the filled fields.
Yesterday button will bring all studies for the day before, filtered by the filled
fields.
The same happens with Last Week.
When the query is done it will show a list of studies that match it, selecting one of
them will take to the series list, and after selecting one, it will show the images:
Also selected studies can be sent to a Remote Server using the web interface.
Select any studies, select preferred Transfer Syntax and Destination AET.
Tools:
1. WW/WC – Change Window Width/Window Center, moving the mouse with left
button pressed.
2. Invert – Inverts the image.
3. Zoom – moving the mouse with left button pressed changes image zoom.
4. Pan – move image with mouse when left button is pressed.
5. Scrolls through the image stack.
6. Linear Measurements.
7. Angle Measurements.
8. Elliptical ROI. (Region of Interest).
9. Rectangle ROI (Region of Interest).
10. Cine Display.
11. Stop Clip.
12. Reset display.
13. Modify display grid.
By downloading the HTTP Client you can have a complete DICOM Viewing
application that communicates with the WebServer using the HTTP protocol. It
can be used throught the port 80 for enabling the communication even when
firewalls are set. Using a VPNconnection it can be deployed on remote location
for accessing the PACS throught the internet.
The Query button will bring the first twenty studies that match the selected filter.
Burn CD/DVD will create a CD/DVD with the selected studies and include a ligth
viewer in the media.
Download will download the selected studies from the server to the local cache.
Allows adding DICOM Worklist entries, that it can be consulted at the “Query Worklist”.
http://www.postgresql.org/download/windows
Select to download the Windows Binary package (in the latest version, 9.3.3 or superior) and run
the installation procedure.
After the database server is installed run the Admin application for creating the database
tables.
Appendix 2. CharruaPACS.ini
The configuration file charruapacs.ini has 2 different sections corresponding to
different modules.
Windows Service can’t access mapped network drives. The reason is that the
Windows Service starts before any user is logged in, and the mapped network
drives depend on the logged user
Actions to be taken:
1. Open folder CharruaSoft\CP_Advanced and double click Configuration file
“charruapacs.ini”
2. Change AutomaticBkp=0 to AutomaticBkp=1
3. Change BkpFolder= into BkpFolder=\\Server\share\path\, or the corresponding
UNC path of your networked hdd.
4. Close the Notepad window and save the changes.
5. Go to Windows Start and select Control Panel, then select Administrative tools
and a new window opens. Double click on “Services” which will open the list of
(local) services.
6. Select “CharruaPACS_ADVANCED” and right mouse click this (blue) line.
7. Select “Properties” from the menu list
8. A new window opens. Select the tab “Log On”
9. Select “This account”, click “Browse” and click “Advanced”
10. Click “Find Now”
11. From the list that shows up, pick the second line. This MUST be the user
account of the PACS computer which shows up at start.
12. Click “OK” and again “OK”
13. You will see at “This account” the user account displayed with .\ in front
14. Replace the black dots in the password fields with the password that you
wrote down initially.
15. Click “Apply” and “OK”
16. Now repeat line 6 to and including 15 for service
“CharruaWEB_ADVANCED”.
17. Close the open window.
18. Switch off the computer and wait 10 seconds, then switch on again
19. Wait for 5 minutes to let the Charrua services start up
20. Open Windows explorer
21. Go to folder CharruaSoft (on drive J, K or I) and open this folder
22. Open folder CP_Advanced and then open folder “logs”
23. Go to the last file in the list, type _server and double click to open the file in
Notepad.
24. Go to the bottom of the file where the last six lines should show:
4:01:53 PM, INFO, **** CharruaPACS V6.27.1 is starting ****
Calling it without parameters brings all available studies in JSON or XML format,
depending on the Request Accept HTTP Header. “application/json” for JSON
format, or “multipart/related; type=application/dicom+xml” for XML format. The
result limit is the same as the DICOM Query.
The call returns the DICOM object, if it is an image it can be in DICOM or JPEG
format according to the “contenttype” parameter.
4.1 RetrieveStudy.
Get a whole study with StudyInstanceUID and the following URL:
http://Server_IP_Address::Server_Port_Number/wado-rs/studies/
{StudyInstanceUID}
4.2 RetrieveSeries.
4.2 RetrieveInstance.
Get a single DICOM object with this URL:
http://Server_IP_Address::Server_Port_Number/wado-rs/studies/
{StudyInstanceUID}/series/{SeriesInstanceUID}/instances/{SOPInstanceUID}
For creating your own self-signed certificate and private key you can use the
following openssl command:
openssl req -x509 -newkey rsa:4096 -nodes -keyout privatekey.pem -out
certificate.pem -days 365
HTTPS Encryption.
The standard secure port used is 443. The transmitted data is encrypted.