Upgrade could be complex task, depending on changes in configuration files of basic dcm4chee installation.
Tip |
---|
|
There is root folder name change between versions 2.14.7 and 2.14.8 - it was dcm4chee-xxx-2.yy.y and now it is dcm4chee-2.yy.y-xxx . |
Tip |
---|
|
Starting with 2.14.8, case sensitivity of query keys is configured in dcm4chee-2.yy.y-xxx/server/default/conf/dcm4chee-attribute-filter.xml by an additional boolean XML attribute case-sensitive of XML elements attr , with case-sensitive="true" as default (s. DCMEE-1359@Jira). Therefore you have to adjust entries for query keys with hard coded case insensitive matching before 2.14.8 in your customized dcm4chee-2.yy.y-xxx/server/default/conf/dcm4chee-attribute-filter.xml : Code Block |
---|
|
<attr tag="00100010" case-sensitive="false"/> <!-- Patient's Name -->
<attr tag="00080090" case-sensitive="false"/> <!-- Referring Physician Name -->
<attr tag="00081030" case-sensitive="false"/> <!-- Study Description -->
<attr tag="00080080" case-sensitive="false"/> <!-- Institution Name -->
<attr tag="00081010" case-sensitive="false"/> <!-- Station Name -->
<attr tag="0008103E" case-sensitive="false"/> <!-- Series Description -->
<attr tag="00081040" case-sensitive="false"/> <!-- Institutional Department Name -->
<attr tag="00081050" case-sensitive="false"/> <!-- Performing Physician Name -->
<attr seq="00400275" tag="00321032" case-sensitive="false"/> <!-- Requesting Physician -->
<attr seq="0040A073" tag="0040A075" case-sensitive="false"/> <!-- Verifying Observer Name -->
|
to preserve the case insensitivity of that matching keys when upgrading to 2.14.8. |
Upgrade Procedure:
- Shutdown dcm4chee
- Extract the new version to a different folder
dcm4chee-xxx-2.yy.y-xxx
- Copy files from JBoss to dcm4chee (see points 2. and 3. of Instalation Instructions)
- If you have installed Audit Record Repository, then install it (see point 5. of Instalation Instructions)
- Execute every upgrade script in the
dcm4chee-xxx-2.yy.y/sql
directory higher then your current version (means if you have 2.11.x execute update-2.12.xxsql
and update-2.13.xxsql
upgrade script) - Copy all following directories/files from old to new installation directory:
dcm4chee-xxx-2.xxyy.xy-xxx/server/default/archive
(if there are your DICOM archive files)dcm4chee-xxx-2.xxyy.xy-xxx/server/default/data/xmbean-attrs
(there are MBean settings)dcm4chee-xxx-2.xxyy.xy-xxx/server/default/deploy/pacs-*-ds.xml
(if you have older version, its name may be *-ds.xml
- then rename it)- if you have installed Audit Record Repository, then copy
dcm4chee-xxx-2.xxyy.xy-xxx/server/default/deploy/arr-xxx-ds.xml
- if you replaced JAI Image IO files in
dcm4chee-xxx-2.13yy.xy-xxx/bin/native
then copy them - if you changed or added any other files manually, then you should merge them to their new dcm4chee versions (it may be complex task), i.e.
run.bat
, run.conf
(changing heap memory), JavaService.exe
, dcm4chee-xxx-2.13yy.xy-xxx/server/default/conf/*
- Execute every upgrade script in the
dcm4chee-2.yy.y-xxx/sql
directory higher then your current version (means if you have 2.11.x execute update-2.12.xxsql
, update-2.13.xxsql
and update-2.14.xxsql
upgrade scripts) - Start dcm4chee