Upgrade
Upgrade could be complex task, depending on changes in configuration files of basic dcm4chee installation.
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
.
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
:
<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-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)
- Copy all following directories/files from old to new installation directory:
dcm4chee-2.yy.y-xxx/server/default/archive
(if there are your DICOM archive files)dcm4chee-2.yy.y-xxx/server/default/data/xmbean-attrs
(there are MBean settings)dcm4chee-2.yy.y-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-2.yy.y-xxx/server/default/deploy/arr-xxx-ds.xml
- if you replaced JAI Image IO files in
dcm4chee-2.yy.y-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-2.yy.y-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 executeupdate-2.12.xxsql
,update-2.13.xxsql
andupdate-2.14.xxsql
upgrade scripts) - Start dcm4chee