DICOM GRID DG Gateway, User Manual

Page 1: ...1 DG Gateway User Manual July 2014 ...

Page 2: ...2 Table of Contents Introduction 3 Installation and Sizing 4 Gateway Configurations 5 Component Implementation 17 DICOM Services 21 ...

Page 3: ... When studies are sent to DICOM Grid base DG Gateway functionality is used the storage folder or the Dropbox functionality is used When studies are sent from DICOM Grid to a DICOM destination base DG Gateway functionality is used the storage folder In order to send to a DICOM device the DICOM device must be configured as a destination port ae title and ip in the DG application Also in the receivin...

Page 4: ...tudies per day High Use Over 80GB 800 100MB studies per day Mid Use 6 to 80GB 60 to 800 100MB studies per day i3 4010U processor 8GB DDR3 RAM 120GB SSD Gigabit ethernet Displayport and HDMI out Windows 7 Professional 64 Bit OEM Onsite NBD Warranty with 8 5 support 3 years 4 12 Threads 8GB 16GB of RAM 100GB OS thick Provisioned 500GB thin provisioned for the Gateway drive Medium IOP requirement 1u ...

Page 5: ...from a client Default is 10 minutes create_phantoms A true false value that determines whether the gateway should create a phantom for the study before the upload Default is false custom_queue_max_attempts JSON array of key value pairs where the key s are queuename_max_attempts The integer value for each key sets the maximum number of attempts that queue will try to process a given queue item Defa...

Page 6: ...f the destination port Port of the destination aetitle AE Title of the destination automated_study_push_cutoff_in_minutes For automated via routing rules study pushes to this destination this is the decimal cutoff time in minutes after the initial study push determining whether the automated_before_cutoff or the automated_after_cutoff behavior should be enforced for subsequent pushes of the same s...

Page 7: ...toff NEVER_REPUSH_STUDY user_requested_after_cutoff REPUSH_ALL address 127 0 0 1 port 1044 aetitle CCW automated_study_push_cutoff_in_minutes 10 user_requested_study_push_cutoff_in_minutes 3 automated_before_cutoff REPUSH_ALL automated_after_cutoff REPUSH_UPDATES_ONLY user_requested_before_cutoff REPUSH_ALL user_requested_after_cutoff REPUSH_ALL dicom_buffer_size Obsolete disk_management JSON arra...

Page 8: ... to be processed by the Dropbox per execution as defined by the dropbox_search_interval configuration dropbox_disabled_times Used to set the peak time windows for each day of the week during which the Dropbox is disabled Setting the time to the same value ie 0 0 means this is no peak time for that day Setting the time to 0 2400 means it is always peak time for that day Sample SU 0 0 MO 930 1630 TU...

Page 9: ...ion_version_name The DICOM implementation version name for the gateway Should never be changed Set to 1 2 840 10008 052007 0 7 1 3 implementation_version_uid The DICOM implementation version UID for the gateway Should never be changed Set to DGSTORESCPV3 ingress_filter A JSON hash of all custom settings to define which images received by the gateway should be filtered out ie not processed or uploa...

Page 10: ...els as follows root INFO DICOMlogger WARN rabbitlogger DEBUG healthlogger INFO or INFO without quotes will set log levels as follows root INFO DICOMlogger INFO rabbitlogger INFO healthlogger INFO max_clients Obsolete max_pdu_size Sets the maximum PDU size in the DICOM associations Rarely changed Default is 65536 max_records_per_ping Services value Not used by the gateway but limits the number of d...

Page 11: ... a large timespan are broken down into individual queries of this max timespan to avoid truncating results qr_max_concurrent_retrieves Maximum number of studies that will be concurrently retrieved from the PACS qr_retrieve_timeout_minutes Timeout in minutes after which a retrieve will be considered to have failed qr_scheduler_dest_ae PACS AE title qr_scheduler_dest_address PACS IP address qr_sched...

Page 12: ...011 20 00 00 1 0 00 0 1 1 2050 7 0 00 0 1 5 27 2011 22 00 00 7 0 00 0 1 1 2050 28 0 00 0 1 queue_recovery_interval The amount of time in milliseconds between attempts by the gateway to recover HL7 messages that failed to process and DICOM images that failed to upload Default is 600000 10 minutes If value is not set or value is invalid default is 3600000 1 hour remote_logging Not yet implemented se...

Page 13: ...fore uploading the images to the cloud and a download section for defining transcoding rules after downloading images from the cloud Not set by default and therefore disabled All possible settings for each defined transcoding rule Only input_tsn and output_tsn are required for each rule However if a conditions field is declared for an input output combo then that conditions array must contain para...

Page 14: ...act transfer syntax combination to get transcoded Transcoding downloaded DICOM wrapped mp4 is configured with a download transcode rule with input_tsn set to 1 2 840 10008 5 1 4 1 1 3 1 1 2 840 10008 1 2 1 the default abstract and transfer syntaxes for DICOM wrapped mp4 files and the output_tsn set to dcm mp4 Note this is somewhat inconsistent with the normal format since the final abstract transf...

Page 15: ...2 840 10008 1 2 4 70 conditions parameter destinationae evaluation value CCW input_tsn 1 2 840 10008 1 2 4 91 output_tsn 1 2 840 10008 1 2 4 70 conditions parameter destinationae evaluation value CCW input_tsn 1 2 840 10008 1 2 4 70 output_tsn 1 2 840 10008 1 2 1 conditions parameter 0008 0090 evaluation value TEST VALUE parameter 0002 0010 evaluation value 1 2 840 10008 1 2 4 70 input_tsn 1 2 840...

Page 16: ...e the upload component entirely and block the normal flow of data through the gateway use_all_transfer_syntaxes Enables the gateway to use an extended set of DICOM transfer syntaxes when pushing images to DICOM destinations This maximizes the chances of finding an acceptable abstract transfer syntax combo to the destination but should only be enabled where needed since it adds significant overhead...

Page 17: ...cription IPAddress Port and AETitle are required fields In order to prevent unintended excessive study retrievals the record must contain at least one of the following fields StudyUid AccessionNumber PatientId PatientName ReferringPhysician All fields are exact matches only no wildcards Validation is performed on some of the fields All study results from each query are queued up for automatic retr...

Page 18: ... a desired transfer syntax prior to uploading the image to the grid The UploadTranscode queue is always utilized before the Upload queue but only acts upon the DICOM images when it has been properly configured in the gateway configuration transcode tsns see DownloadTranscode below for sample configuration value The maximum number of concurrent upload transcoding threads can be set with the gateway...

Page 19: ... customer site The Query Retrieve Scheduler determines individual queries that need to be made and enqueues them onto the QueryClient and then uses the RetrieveClient queue to retrieve them as needed The Query Retrieve Scheduler performs the following main tasks breaks configuration defined query processes into smaller individual queries to avoid truncation of results by the PACS and enqueues them...

Page 20: ...ested studies and automated requests and whether the pending push job comes before or after the cutoff time defined for the request type See the configuration section for a sample destination_ push_rules configuration in json format The Move Client can also be configured to send studies via the Gateway to a directory rather than a DICOM device To enable create a destination with the following sett...

Page 21: ...lds of the HL7 order messages are mapped to the Modality Worklist fields on a customer specific basis please contact DICOM Grid support to begin implementation of this feature Service Listener The ServiceListener manages the listener thread for incoming DICOM connections Connections are handled asyncronously and invoke the StoreService for the actual saving of DICOM files to disk At the end of the...

Page 22: ...ices FindService is the handler for the query portion of query retrieve The primary function of this component is to transform and broker search requests back to the DICOMGrid storage cloud When a request is relieved we break out the search fields and build a JSON request to be handled by the cloud Once the JSON response is receieved by the Find Service The service breaks each item in the study re...

Page 23: ...custom_ queue_max_attempts These configurations take JSON strings as input to describe the appropriate values for any number of queue components The following queue components can be adjusted hl7upload upload moveclient queryclient retrieveclient download delete For example setting custom_queue_retry_coefficient to the following JSON value will set the retry coefficients to 10 5 and 20 for the hl7...