DCM4CHEE 2.

...

16.

...

2 Installation Instructions

Version 2.1516.0 2 is the latest version of the archive. It is recommended that you install this version and not an older version because of improvements and bug fixes.

...

• For image compression/decompression, dcm4chee utilizes Sun's Java Advanced Imaging Image I/O Tools 1.1. The binary distribution packages of dcm4chee already includes necessary JARs and native libraries for Windows and Linux i586. For Linux-amd64, and Solaris, you have to download the SW package from Sun here yourself and replace the Linux version of libclib_jiio.so in dcm4chee-2.1516.02-xxx/bin/native from the JAI Image IO package for Linux-amd64 or Solaris.

...

Download the latest version of dcm4chee that is relevant to the database of your choice from the dcm4che Sourceforge site . Extract the package (e.g. dcm4chee-2.1516.02-psql.zip for the PostgreSQL version). When extracting, avoid using a directory that has a name that contains spaces in order to avoid issues with running command line applications with spaces in the path name.

...

Dcm4chee consists of components that run within the JBoss application server platform. This step will copy the JBoss runtime files to the dcm4chee directory.

Go to the dcm4chee-2.1516.02-xxx/bin directory and execute the install_jboss.bat or install_jboss.sh script, as appropriate for your operating system, with the path of your JBoss AS installation directory as a parameter.

...

C:\apps\dcm4chee-2.1516.02-psql\bin>install_jboss.bat c:\apps\jboss-4.2.3.GA

...

1. Download the dcm4chee Audit Record Repository 3.0.10 (dcm4chee-arr-3.0.10) available at
   http://sourceforge.net/projects/dcm4che/files/dcm4chee-arr/3.0.10/. Be sure to download the distribution package of dcm4chee-arr-3.0.10 for the database of your choice (likely the same database that you are using for the archive, but it could differ if you wish to store audit records in a completely different database).
2. Go to the dcm4chee-2.1516.02-xxx/bin directory and execute the install_arr.bat or install_arr.sh script, as appropriate for your operating system, with the path of the dcm4chee-arr-3.0.10 installation directory as
   parameter.
   • Because of the growth factor of the audit database, it is recommended to store the records in it's own database. Create the audit record repository database instance: arrdb, and grant sufficient privileges to the DB user (see the datasource descriptor deploy/arr-xxx-ds.xml for user information, typically arr with pw of arr). Also see above links to DB-specific pages for tips.

...

For example, in Windows see the file dcm4chee-2.1516.02-xxx/bin/run.bat:

rem Sun JVM memory allocation pool parameters. Modify as appropriate.
set JAVA_OPTS=%JAVA_OPTS% -Xms128m -Xmx512m

Linux/Unix/OSX: dcm4chee-2.1516.02-xxx/bin/run.conf

# Specify options to pass to the Java VM.
if [ "x$JAVA_OPTS" = "x" ]; then
JAVA_OPTS="-Xms128m -Xmx512m ..
fi

...

To test your installation, go to the dcm4chee-2.1516.02-xxx/bin directory and execute the run.bat or run.sh script, as appropriate for your operating system. Your output should look like the following and contain no error or exception messages:

=========================================================================

JBoss Bootstrap Environment

JBOSS_HOME: /home/gunter/dcm4chee-2.1516.02-psql

JAVA: /usr/lib/j2sdk1.5-sun/bin/java

JAVA_OPTS: -Dprogram.name=run.sh -server -Xms128m -Xmx512m
-Dsun.rmi.dgc.client.gcInterval=3600000
-Dsun.rmi.dgc.server.gcInterval=3600000 -Djava.awt.headless=true
-Dapp.name=dcm4chee -Djava.net.preferIPv4Stack=true
-Djava.library.path=/home/gunter/dcm4chee-2.1516.02-psql/bin/native

CLASSPATH: /home/gunter/dcm4chee-2.1516.02-psql/bin/run.jar:
/usr/lib/j2sdk1.5-sun/lib/tools.jar

=========================================================================

23:17:52,373 INFO [Server] Starting JBoss (MX MicroKernel)...
23:17:52,374 INFO [Server] Release ID: JBoss [Trinity] 4.2.3.GA (build:
SVNTag=JBoss_4_2_3_GA date=200807181439)
:
23:19:49,580 INFO [AjpProtocol] Starting Coyote AJP/1.3 on ajp-127.0.0.1-8009
23:19:49,632 INFO [Server] JBoss (MX MicroKernel) [4.2.3.GA (build:
SVNTag=JBoss_4_2_3_GA date=200807181439)] Started in 1m:57s:103ms

...

If no Storage File System is configured, the archive will auto-configure dcm4chee-2.1516.02-xxx/server/default/archive as Storage File System, when receiving the first object/image.

...

The directories used for caching generated JPEG representations of archived images requested by Web Access to DICOM Persistent Objects (WADO) can be specified by attributes "CacheDataRootDirectory" and "CacheJournalRootDirectory" in the configuration page for the WADO Service (service=WADOService).
Defaults: dcm4chee-2.1516.02-xxx/server/default/wadocachedata and dcm4chee-2.1516.02-xxx/server/default/wadocachejournal.

...