Imaging:DCM4CHEEInstallation

CVRG DCM4CHEE Overview

Below you will find a list of technologies used by the CVRG to instantiate a DCM4CHEE open-source PACS. These technologies have all been deployed/tested in CentOS 5.2(RHEL) running in VMWare Server:

System Requirements

Installing DCM4CHEE

• NOTE: These instructions were followed for the CVRG installation of DCM4CHEE. Basic DCM4CHEE instructions are found at the DCM4CHEE installation page.

1. Install JDK 1.5.0_x to /opt/java
   
   
2. Create a directory under /opt for the databases (e.g., /opt/databases)
   
   
3. Download and extract the binary distribution package of dcm4chee:
   1. Connect to the dcm4chee Sourceforge site
   2. Select the dcm4chee-mysql-2.14.2.zip package
   3. Download that file to the temp directory (i.e., /tmp)
   4. Extract DCM4CHEE to the databases directory (i.e., "gunzip -d /tmp/dcm4chee-mysql-2.14.2.zip /opt/databases")
      
      
4. Download the binary distribution package of JBoss Application Server 4.2.2.GA:
   1. Connect to the JBoss download site
   2. Select the 4.2.2.GA package
   3. Download the binary distribution of jboss-4.2.2.GA.zip to the temp directory (i.e., /tmp)
   4. Extract JBoss Application Server 4.2.2.GA to the databases directory (i.e., "gunzip -d /tmp/jboss-4.2.2.GA.zip /opt/databases")
      
      
5. Copy files from JBoss to dcm4chee:
   1. Move to the dcm4chee-xxx-2.14.2/bin directory (i.e., "cd /opt/databases/dcm4chee-mysql-2.14.2/bin")
   2. Execute the install_jboss.sh script with the path of your JBoss AS installation directory as a parameter (i.e., "install_jboss.sh /opt/databases/jboss-4.2.2.GA")
      
      
6. Install the Database Software and create the DCM4CHEE Database:
   1. If you do not already have database software running, install it now.
   2. Initiate the pacsdb database instance using the DDL in dcm4chee-mysql-2.14.2/sql/create.mysql.
      1. mysql -u root
         1. mysql> create database pacsdb;
         2. mysql> grant all on pacsdb.* to 'pacs'@'localhost' identified by 'pacs';
         3. mysql> \q
      2. mysql -upacs -ppacs pacsdb < /opt/databases/dcm4chee-mysql-2.14.2/sql/create.mysql
   3. The database configuration information is contained within dcm4chee-mysql-2.14.2/server/default/deploy/pacs-mysql-ds.xml.
      1. If you're using a different database name, user name, etc., you'll need to update this file.
         
         
7. Set environment variable JAVA_HOME to JDK location.
   1. The dcm4chee startup/shutdown scripts depend on the JAVA_HOME environment variable in order to find the Java executables and libraries.
      
      
8. Adjust maximum allocation of heap memory:
   1. Edit the dcm4chee run.conf (i.e., "vi /opt/databases/dcm4chee-mysql-2.14.2/bin/run.conf")
      1. Specify options to pass to the Java VM.
         1. if [ "x$JAVA_OPTS" = "x" ]; then
         2. JAVA_OPTS="-Xms128m -Xmx512m ..
         3. fi
   2. Save the edits (i.e., ":wq!")
      
      
9. Test the installation:
   1. Move to the dcm4chee-xxx-2.14.2/bin directory (i.e., "cd /opt/databases/dcm4chee-mysql-2.14.2/bin")
   2. Execute the run.sh script
      
      
10. Login into web interface:
    1. Connect to the Web Interface at http://localhost:8080/dcm4chee-web/ of the archive using any Web Browser
    2. Login in using default Administrator account 'admin', with password 'admin'
    3. You should change the admin password once you log in
       
       
11. Setting the Storage File System location & Changing the default AE title:
    1. Connect to JBoss's JMX Console at http://localhost:8080/jmx-console/
    2. Login using also the Administrator account 'admin', with password 'admin'. (may need to be updated if change in web interface affects this)
    3. Setting the Storage File System location:
       1. Follow the link "service=FileSystemMgt" to the configuration page for File System Management service under the "dcm4chee.archive" heading.
       2. Invoke the operation addOnlineFileSystem(), with argument dirPath specifying the directory, where the archive shall store received objects/images.
       3. If no Storage File System is configured, the archive will auto-configure dcm4chee-xxx-2.14.x/server/default/archive as Storage File System, when receiving the first object/image.
    4. Changing the default AE title:
       1. Follow the link "service=AE" to the configuration page for AE (Application Entity - a DICOM term for a DICOM node on the network) service under the "dcm4chee.archive" heading.
       2. Invoke the operation updateAETitle with the old AE Title (DCM4CHEE if unchanged from the default), and new AE Title as parameters
          
          
12. Test DICOM storage:
    1. Connect to the dcm4che 2.0 Sourceforge site
    2. Select the dcm4che-2.0.17-bin.zip package
    3. Download that file to the temp directory (i.e., /tmp)
    4. Extract DCM4CHE 2.0 toolkit to the databases directory (i.e., "gunzip -d /tmp/dcm4che-2.0.17-bin.zip /opt/databases")
    5. Send some object/images to the archive's Storage SCP, by using the send utility of the dcm4che 2.0 core package (i.e., "/opt/databases/dcm4che-2.0.17/bin/dcmsnd DCM4CHEE@localhost:11112 ~/mesa/storage/modality/MR")
    6. Refresh the Web Interface (http://localhost:8080/dcm4chee-web/) and click the 'binocular' icon, if necessary, to initiate a search
       1. Expand one study row to show contained series
       2. Expand one of these series to show contained instances
       3. In the case of images, you can follow the image icon on the right, to invoke a http WADO request for a JPEG presentation of this image, which will be displayed in a separate browser window
          
          
13. Test object retrieval:
    1. Create external Storage SCP acting as Move Destination, by using the receiver utility of the dcm4che 2.0 DICOM toolkit (i.e., "/opt/databases/dcm4che-2.0.17/bin/dcmrcv 11113")
    2. Configure an additional Application Entity Title identifying this Move Destination within the "AE Management" tab within the Web user interface (http://localhost:8080/dcm4chee-web/).
       1. Set AE Title to "DCMRCV"
       2. Set Hostname to "localhost"
       3. Set Port to "11113"
    3. Switch back to the Study List ("Folder")
    4. Mark studies to retrieve using the check box on the right
    5. Select "DCMRCV" as send destination in the combo box above
    6. Click on the send button left from it
       
       
14. Install as a service:
    1. Close any web browser that is open
    2. Stop the archive by pressing "Ctrl-C" in the console window where the archive was started
    3. Copy the init script dcm4chee_init_redhat.sh to /etc/init.d/ and adjust it according your installation location of the archive and the JDK and under which user the archive application shall run