Perennity Dicom v2.50 Quick Installation Guide

15
Flexible Solutions for Electronic Archiving Perennity Dicom Edition Quick Installation guide Version 2.50 Document revision 2.1

Transcript of Perennity Dicom v2.50 Quick Installation Guide

Page 1: Perennity Dicom v2.50 Quick Installation Guide

Flexible

Solutions

for

Electronic

Archiving

Perennity

Dicom Edition

Quick Installation guide

Version 2.50

Document revision 2.1

Page 2: Perennity Dicom v2.50 Quick Installation Guide

Quick installation guide 2 Perennity Dicom edition v2.50

INTRODUCTION

Welcome in this Perennity Dicom quick configuration guide.

This quick guide doesn’t replace the manuals, but lets you configure effortless the

Perennity programs. For a demo purpose and for more explanations, always refer to

the manuals.

Fig. 1 - Perennity Dicom workflow

The Perennity Dicom solution consists of the following components:

� A CD/DVD autoloader, such as Rimage or Epson PP-100, composed of a

robot, one or more CD/DVD recorders and a printer to label the discs.

� The Perennity Dicom Server, also running as a Windows service, acts as a

real Dicom server. It listens to Dicom clients, such as modalities and PACS

applications, to collect and store Dicom images that must be recorded on

CD/DVD. It also extracts the metadata (patient name, study ID, …) from

the Dicom images and generates JPEG thumbnails to preview the images.

Page 3: Perennity Dicom v2.50 Quick Installation Guide

Quick installation guide 3 Perennity Dicom edition v2.50

The Perennity Dicom Server also acts as Dicom SCP server. As result, it is

possible to Query and Retrieve images from Perennity from any Dicom SCU

client (e.g. Dicom Workstation).

� The Perennity Dicom Burner is the main user interface for querying and

selecting the series/studies of Dicom images to be recorded to CD/DVD

(attended mode). The Dicom Burner can be used in “Unattended mode”

meaning that Dicom images are automatically submitted for recording once

series or studies are completed. Last but not least, it is possible to query

and retrieve images stored in the Perennity or from any third party Dicom

server (e.g. a PACS).

� The Perennity Autoloader, running as a Windows service, that interfaces

the CD/DVD autoloader.

� The database - MySQL or MS SQL Server - that will keep track of all

operations. It will also store all metadata (patient name, study ID, …)

extracted from the Dicom images.

VERSIONS

The last versions of the different components used by Perennity Dicom are:

� JAVA Virtual Machine Version 6 update 10 (download)

� MySQL 5.1.31 (download)

� Perennity Dicom 2.50 build 281 (download)

� Perennity Dicom Sender 2.1 (download)

A complete installation CD containing all above tools and application is also available

(download).

INSTALLATION

It is required to strictly follow the installation procedure described below. We

recommend checking the boxes located in the left margin every time one step has

been performed.

Prerequisites : Java 1.6.10 or higher version is supposed to be already install and

running. The installation can be downloaded from our web site (download).

We recommend to deactivate to automatic update of Java. To do so, open the Control

Panel and click on the ‘Java” icon. Go to the ‘Update’ tab and disable the ‘Check for

Updates Automatically’ option.

Install MySQL

� Version 5.1.31 of MySQL is available in the Perennity installation package (CD or zip file). Go to the Tools > MYSQL > MySQL 5.1 Server v5.1.31 folder. It can also be

downloaded from our web site (download).

� Run the mysql-essential-5.1.31-win32.exe program. We do not recommend using any

other version of MySQL with Perennity. All MySQL programs, utilities and databases will

be grouped in the same installation sub-directory (C:\Program Files\MySQL by default).

Page 4: Perennity Dicom v2.50 Quick Installation Guide

Quick installation guide 4 Perennity Dicom edition v2.50

� Apply strictly the following procedure:

1. Setup Type: Typical. Click on ‘Next’.

2. Click on ‘Install’.

3. Advertising: click twice ‘Next’.

4. Setup wizard: enable the ‘Configure the MySQL Server now’ and click on ‘Finish’.

5. Welcome screen: click on ‘Next’.

6. Configuration type: select ‘Detailed configuration’ and click on ‘Next’.

7. Server type: select ‘Server Machine’ and click on ‘Next’.

8. Database usage: select ‘Multifunctional Database’ and click on ‘Next’.

9. InnoDB datafile: keep default settings (C: - Installation Path) and click on ‘Next’.

10. Number of concurrent connections: select ‘Decision Support’ and click on ‘Next’.

11. Networking options: select ‘Enable TCP/IP Networking’, port 3306 and enable the ‘Add firewall exception for this port’ option. Also enable the ‘Enable Strict Mode’

option and click on ‘Next’.

12. Character set: select the ‘Standard Character Set’ option and click on ‘Next’. It may

be required to select the ‘Best Support for Multilingualism’ option depending on the

language you are using.

13. Windows options: enable the ‘Install As Windows Service’. Keep the default ‘MySQL’

as Service Name. Enable also the ‘Launch the MySQL Server automatically’ and

‘Include Bin Directory in Windows PATH’ options. Then click on ‘Next’.

14. Security options: FIRST enable the ‘Create An Anonymous Account’ option. THEN

disable the ‘Modify Security Settings’ option and click on ‘Next’.

15. Click on ‘Execute’

16. Make sure that the ‘Prepare configuration’, ‘Write configuration file’ and the ‘Start

service’ steps have been processed. Click on ‘Finish’.

� Check if the MySQL service is well started.

Page 5: Perennity Dicom v2.50 Quick Installation Guide

Quick installation guide 5 Perennity Dicom edition v2.50

Create input/output folders

Perennity will need two different folders:

� The first one is used by the Perennity Dicom Server to store all the Dicom

images it has received. Depending on how long you want to keep these

images (e.g. for archiving purpose), you may require a large storage

capacity definitely if you configure the Dicom Server to keep the images

for ever. Keep the path to this folder as short as possible (e.g.

C:\Dicom\Received Images) as we will use the Study UID, Series UID and

Image UID as folder and file names. These UID are always very long.

� The second is for the Perennity Dicom Burner. It is a temporary folder

where Dicom images to be output to CD/DVD will be copied. Once the disc

has been recorded, the images will automatically be deleted (e.g.

C:\Dicom\To Burn).

Install Perennity Dicom

Before installing Perennity Dicom, make sure that the Rimage CD/DVD autoloader is

fully functional.

It is recommended to install Perennity Dicom on the same computer running the

Rimage software suite. This will avoid useless network traffic.

If you own a Rimage 360i or a 2000i, make sure to have a complete networkable

Rimage OfficeNet software suite.

� The Rimage CD/DVD autoloader is up and running.

The three Perennity Dicom components (Dicom Burner, Dicom Server and Dicom

Autoloader) are contained in one installation package named

‘PerennityDicom_vxxx_byyy.exe’. xxx represents the version of Perennity Dicom

while yyy is the number of the build.

� Simply run this executable to start its installation. Select the “Complete” setup then

click on “Next”. Keep the default location (c:\Program Files\Perennity\Perennity

Dicom). Click on “Next” until all components are installed.

Configuring the Perennity Dicom Server

Launch the Perennity Dicom Server using the icon located on your desktop or in the

‘Start’ menu. The first time, you will be asked to enter the parameters.

If you have installed MySQL in an other subfolder than the default one (C:\Program

Files\MySQL\MySQL Server 5.1), you will be prompted to select the path where it has

been installed. Be sure to select the right folder. Anyway, it must end with ..\MySQL

Server 5.1\.

Page 6: Perennity Dicom v2.50 Quick Installation Guide

Quick installation guide 6 Perennity Dicom edition v2.50

Fig. 2 - Perennity Dicom service parameters

Configure the “General settings”

� The language for the user interface (please do close and restart the

Dicom Server after having changed the language)

� The Storage path where Dicom images will be stored.

� The local AE Title

� The IP port (104 by default).

� Generate thumbnails (JPEGs) from the native Dicom images or not.

� Database settings.

Refer to the Administration Guide for more information about managing local and

remote AETs, forwarding, transfer syntax, bypass, etc. Click on “Ok”.

Click on “Start” to launch the Perennity Dicom Server (Windows service).

Page 7: Perennity Dicom v2.50 Quick Installation Guide

Quick installation guide 7 Perennity Dicom edition v2.50

Fig. 3 - The Perennity Dicom Server is now up and running.

Click on the ‘License’ button.

Fig. 4 - The Perennity licensing window.

Copy/Paste the activation key and click on ‘Update’. The serial number and the

different options will be displayed according the activation key that you have

received. Activation keys are based on the MAC address of he PC where on Perennity

has been installed and a six digits serial number (printed on the installation CD or

delivered by email). The key can be requested by sending an email to

[email protected]. Allow 24h before getting an activation key.

� The Perennity Dicom Server is up and running.

Page 8: Perennity Dicom v2.50 Quick Installation Guide

Quick installation guide 8 Perennity Dicom edition v2.50

The Perennity Autoloader service

Prior to configure the Perennity Dicom Burner, verify that the Perennity Autoloader

windows service is started. Therefore, right click on “My Computer” and select the

“Manage” option. Select “Services” and scroll down until reaching the “Perennity –

Autoloader Server” service. Check if the status of that service is ‘Started’.

Fig. 5 - Start the Perennity Autoloader Server.

As this service is set as automatic startup, it will start automatically every time you

boot your computer.

� The Perennity Autoloader service is started.

Page 9: Perennity Dicom v2.50 Quick Installation Guide

Quick installation guide 9 Perennity Dicom edition v2.50

Configuring the Perennity Dicom Burner

Launch the Perennity Dicom Burner using the icon located on your desktop or in the

‘Start’ menu. The first time, you will be asked to enter the parameters.

Fig. 6 - General settings of the Perennity Dicom Burner.

Set the following settings:

� Language of the user interface ( please do close and restart the Burner

after having selected the language )

� The type of CD/DVD printer ( please do refer to your manual to know

which printer is install on your system )

� The Target device. Click on ‘Manage’ then on ‘Add’. Select the type of

target device: a Rimage or Epson robot or a Virtual Autoloader. When

choosing the Rimage robot, first select the version of the Rimage software

suite you are currently using: 6.X/7.X or 8.X. Check carefully the version

using the Rimage System Manager. Selecting a wrong version may cause

the Perennity Dicom Burner to hang. Then input a name, the IP address

and port. By default the IP port is 4664 when using Rimage software suite

8. When using version 6 or 7, the default IP port is 2506. Click on ‘Test

connection’ to verify the communication with your Rimage system. You

may also create a Virtual Autoloader as target device. In this case, the

Dicom images will be output to different subfolders (one by CD/DVD).

Page 10: Perennity Dicom v2.50 Quick Installation Guide

Quick installation guide 10 Perennity Dicom edition v2.50

Fig. 7 - The Rimage configuration window.

Fig. 8 - The Virtual Autoloader configuration window.

Page 11: Perennity Dicom v2.50 Quick Installation Guide

Quick installation guide 11 Perennity Dicom edition v2.50

When using an Epson PP-100 autoloader, make sure that the Epson TD Bridge

software (download) is installed. TD Bridge is using a folder as buffer. This same

folder must be set as ‘Working folder” in the Target settings.

Fig. 7 - The Epson configuration window.

Click on ‘Ok’. Select the target device that you just created and click again on ‘Ok’.

Page 12: Perennity Dicom v2.50 Quick Installation Guide

Quick installation guide 12 Perennity Dicom edition v2.50

Fig. 9 - The configuration of the Perennity Dicom Burner.

� The ‘Buffer path’ where the series of Dicom images to be processed will

be copied to be output to CD or DVD.

� Select the Dicom viewer you want to add to every CD or DVD.

� Set the volume name. The volume name is composed of three parts. You

can blank the prefix and/or suffix of the name. You can also give them a

constant value.

� Select the media type you use : CD-R or DVD-R or even Auto Select.

When selecting the Autoselect option in the menu, Perennity Dicom Burner

will use CD-R for a selection of studies not larger than 600MB. Above

600MB, DVD-R will be used.

� JPEG copies of Dicom images can be added to the media.

� Keep the Dicom images for archiving purposes after they have been

processed and set the number of days the images are kept for archiving

purposes. Set it to 0 to keep the images forever.

� Keep the job history even if the images have been deleted. This is a

convenient option for tracking purpose.

Click on ‘Save’.

Page 13: Perennity Dicom v2.50 Quick Installation Guide

Quick installation guide 13 Perennity Dicom edition v2.50

Fig. 10 - Perennity Dicom Burner user interface.

� The Perennity Dicom Burner is up and running.

TESTING PERENNITY DICOM

The Perennity Dicom Sender is a very convenient and friendly tool that can be used to

test your installation. It emulates a modality sending images to Perennity. The

installation package includes three sample studies (download).

Run the installation package and click on ‘Next’. Keep the default installation path and

click on ‘Next’. Once the installation completed, click on ‘Finish’.

Launch the Perennity Dicom Sender from the Start menu.

Page 14: Perennity Dicom v2.50 Quick Installation Guide

Quick installation guide 14 Perennity Dicom edition v2.50

Fig. 11 - The Perennity Dicom Sender interface.

The Source file is the folder containing the sample studies. Click on ‘Echo’ to check

the connection with the Perennity Dicom Server.

Fig. 12 - The Echo is successful.

If you get an error message, check if the Perennity Dicom Server is started.

Click on ‘Send’. This will send the three studies to Perennity. Launch the Perennity

Dicom Burner and click on ‘Refresh’. The three studies must be listed.

Page 15: Perennity Dicom v2.50 Quick Installation Guide

Quick installation guide 15 Perennity Dicom edition v2.50

Appendix 1 – Print fields

The table below lists all the fields that can be printed on the labels. Refer to the

administration for more details about how to customize print templates.

Merge field Description

PatientIdentifier Patient ID

PatientName Complete name of the patient

Sex Sex of the patient

BirthDate Birth date of the patient

StudyDate Date of the study

StudyIdentifier Study ID

StudyDescription Description of the study

AccessionNumbers Accession number(s)

Modalities Type of modalitie(s)

RefPhysician Referral physician

Institution Name of the institution

IndiceJobGroup ID of the disc in a set

NbTotalInJobGroup Total number of discs in a set

jobComment1 First comment line

jobComment2 Second comment line

Custom1 Custom field #1 (see below)

Custom2 Custom field #2 (see below)

Custom3 Custom field #3 (see below)

Custom4 Custom field #4 (see below)

patient1 Patient name (Sex) – Accession Number - Patient ID

– Study ID

… …

patient30 Patient name (Sex) – Accession Number - Patient ID

– Study ID

study1 Study ID – Study date - Study description

… …

study30 Study ID – Study date - Study description

Fields ‘patient1’ – ‘patient30’ and ‘study1’ – ‘study30’ can be customized in the Dicom

Burner (‘Multi-Field’ tab).

Print fields in Rimage CD Designer are case sensitive.