Более старые релизы — здесь
Содержание - Обновление схемы базы данных - H2 - PostgreSQL - MySQL и MariaDB - Firebird - DB2 - Oracle - MS SQL Server - Обновление схемы LDAP - OpenLDAP - OpenLDAP с конфигурационным файлом slapd.conf - OpenLDAP с динамической конфигурацией времени выполнения - OpenDJ - Apache DS 2.0.0 - Обновление развёртывания WildFly
SQL-скрипты для обновления схемы базы данных с предыдущих версий находятся в каталоге
$DCM4CHEE_ARC/sql. Изменение схемы БД отражается в увеличении второго компонента
номера версии (напр., с 5.33.x до 5.34.y). Таким образом, не нужно обновлять схему базы данных
при обновлении с версии, которая отличается только третьим компонентом номера версии
(напр., с 5.34.0 до 5.34.3). При обновлении с более старой версии, у которой второй компонент номера версии
не является предыдущим, нужно сначала обновить схему базы данных до предыдущей
версии — применив скрипты обновления для предыдущих версий в правильном порядке — перед применением
скрипта обновления для текущей версии.
Необходимо запустить Wildfly перед обновлением таблиц с использованием консоли H2. Откройте консоль по адресу http://localhost:8080/h2console, войдите и обновите схему базы данных:
RUNSCRIPT FROM '$DCM4CHEE_ARC/sql/h2/update-5.34-h2.sql'
> psql -h localhost <database-name> <user-name> < $DCM4CHEE_ARC/sql/psql/update-5.34-psql.sql
> mysql -u <user-name> -p<user-password> <database-name> < $DCM4CHEE_ARC/sql/mysql/update-5.34-mysql.sql
> isql-fb
Use CONNECT or CREATE DATABASE to specify a database
SQL> connect 'localhost:<database-name>'
CON> user '<user-name>' password '<user-password>';
SQL> in DCM4CHEE_ARC/sql/firebird/update-5.34-firebird.sql;
SQL> exit;
> su <user-name>
Password: <user-password>
> db2 connect to <database-name>
> db2 -t < $DCM4CHEE_ARC/sql/db2/update-5.34-db2.sql
> db2 terminate
$ sqlplus <user-name>/<user-password>
SQL> @$DCM4CHEE_ARC/sql/oracle/update-5.34-oracle.sql
Ещё не тестировалось
Замените предыдущие файлы схемы в конфигурационном каталоге схемы OpenLDAP новыми версиями из дистрибутива DCM4CHEE Archive:
> cp $DCM4CHEE_ARC/ldap/schema/* /etc/openldap/schema/ [UNIX]
> copy %DCM4CHEE_ARC%\ldap\schema\* \Program Files\OpenLDAP\schema\ [Windows]
Перезапустите slapd:
> sudo service slapd restart [UNIX]
Обновите схемы LDAP в конфигурации времени выполнения OpenLDAP, применив предоставленные LDIF-файлы с помощью утилиты OpenLDAP CLI ldapmodify:
> sudo ldapmodify -Y EXTERNAL -H ldapi:/// -f $DCM4CHEE_ARC/ldap/slapd/dcm4che-modify.ldif
> sudo ldapmodify -Y EXTERNAL -H ldapi:/// -f $DCM4CHEE_ARC/ldap/slapd/dcm4chee-archive-modify.ldif
> sudo ldapmodify -Y EXTERNAL -H ldapi:/// -f $DCM4CHEE_ARC/ldap/slapd/dcm4chee-archive-ui-modify.ldif
Замените предыдущие файлы схемы в конфигурационном каталоге схемы OpenDJ новыми версиями из дистрибутива DCM4CHEE Archive:
> cp $DCM4CHEE_ARC/ldap/opendj/* $OPENDJ_HOME/config/schema/ [UNIX]
> copy %DCM4CHEE_ARC%\ldap\opendj\* %OPENDJ_HOME%\config\schema\ [Windows]
Перезапустите OpenDJ:
> $OPENDJ_HOME/bin/stop-ds
> $OPENDJ_HOME/bin/start-ds
Удалите дочерний элемент ou=objectclasses из элементов схемы
ou=schema
+ cn=dcm4chee-archive-ui
+ ou=objectclasses
+ cn=dcm4chee-archive
+ ou=objectclasses
+ cn=dcm4che
+ ou=objectclasses
перед удалением самих элементов схемы, используя функцию Delete Entry Apache Directory Studio LDAP Browser.
Импортируйте новые файлы схемы LDAP для Apache DS:
$DCM4CHEE_ARC/ldap/apacheds/dcm4che.ldif
$DCM4CHEE_ARC/ldap/apacheds/dcm4chee-archive.ldif
$DCM4CHEE_ARC/ldap/apacheds/dcm4chee-archive-ui.ldif
используя функцию импорта LDIF Apache Directory Studio LDAP Browser.
Если в предоставленную конфигурацию по умолчанию внесены структурные изменения — напр., путём добавления/удаления сетевых прикладных сущностей (Network Application Entities) или настройки нескольких
устройств Архива — необходимо скорректировать предоставленные файлы update-config-VERSION.ldif
в $DCM4CHEE_ARC/ldap в соответствии с вашими изменениями перед их применением, используя функцию импорта LDIF
Apache Directory Studio LDAP Browser или утилиту LDAP CLI ldapmodify из OpenLDAP. Начиная с версии 5.23.0
предоставляются отдельные ldif-файлы для обновления конфигурации устройства и AE.
Для обновления с версии старше, чем самая последняя предыдущая версия, напр. с 5.33.0 до 5.34.3, необходимо применить
скрипты обновления для предыдущих версий, напр.:
> $ cd $DCM4CHEE_ARC/ldap
> $ ldapmodify -xW -Dcn=admin,dc=dcm4che,dc=org -f 5.33.1/update-AS_RECEIVED-5.33.1.ldif
> $ ldapmodify -xW -Dcn=admin,dc=dcm4che,dc=org -f 5.33.1/update-DCM4CHEE-5.33.1.ldif
> $ ldapmodify -xW -Dcn=admin,dc=dcm4che,dc=org -f 5.33.1/update-dev-5.33.1.ldif
> $ ldapmodify -xW -Dcn=admin,dc=dcm4che,dc=org -f 5.33.1/update-IOCM_REGULAR_USE-5.33.1.ldif
> $ ldapmodify -xW -Dcn=admin,dc=dcm4che,dc=org -f 5.33.1/update-storescp-5.33.1.ldif
> $ ldapmodify -xW -Dcn=admin,dc=dcm4che,dc=org -f 5.34.0/update-AS_RECEIVED-5.34.0.ldif
> $ ldapmodify -xW -Dcn=admin,dc=dcm4che,dc=org -f 5.34.0/update-DCM4CHEE-5.34.0.ldif
> $ ldapmodify -xW -Dcn=admin,dc=dcm4che,dc=org -f 5.34.0/update-dev-5.34.0.ldif
> $ ldapmodify -xW -Dcn=admin,dc=dcm4che,dc=org -f 5.34.0/update-IOCM_REGULAR_USE-5.34.0.ldif
> $ ldapmodify -xW -Dcn=admin,dc=dcm4che,dc=org -f 5.34.0/update-storescp-5.34.0.ldif
> $ ldapmodify -xW -Dcn=admin,dc=dcm4che,dc=org -f 5.34.1/update-dev-5.34.1.ldif
> $ ldapmodify -xW -Dcn=admin,dc=dcm4che,dc=org -f 5.34.2/update-AS_RECEIVED-5.34.2.ldif
> $ ldapmodify -xW -Dcn=admin,dc=dcm4che,dc=org -f 5.34.2/update-DCM4CHEE-5.34.2.ldif
> $ ldapmodify -xW -Dcn=admin,dc=dcm4che,dc=org -f 5.34.2/update-dev-5.34.2.ldif
> $ ldapmodify -xW -Dcn=admin,dc=dcm4che,dc=org -f 5.34.2/update-IOCM_REGULAR_USE-5.34.2.ldif
> $ ldapmodify -xW -Dcn=admin,dc=dcm4che,dc=org -f 5.34.2/update-storescp-5.34.2.ldif
после чего можно обновить конфигурацию LDAP для текущей версии:
> $ ldapmodify -xW -Dcn=admin,dc=dcm4che,dc=org -f 5.34.3/update-dev-5.34.3.ldif
> $ ldapmodify -xW -Dcn=admin,dc=dcm4che,dc=org -f 5.34.3/update-ui-config-5.34.3.ldif
Enter LDAP Password:
modifying entry "dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org"
:
Обновите Данные вендора
$WILDFLY_HOME/standalone/configuration/keystores есть файлы key.p12 и cacerts.p12.
Скопируйте эти конфигурационные файлы в установку WildFly, если они ещё не присутствуют:> cp $DCM4CHEE_ARC/configuration/keystores/key.p12 $WILDFLY_HOME/standalone/configuration/keystores [UNIX]
> cp $DCM4CHEE_ARC/configuration/keystores/cacerts.p12 $WILDFLY_HOME/standalone/configuration/keystores [UNIX]
> xcopy %DCM4CHEE_ARC%\configuration\keystores\key.p12 %WILDFLY_HOME%\standalone\configuration\keystores [Windows]
> xcopy %DCM4CHEE_ARC%\configuration\keystores\cacerts.p12 %WILDFLY_HOME%\standalone\configuration\keystores [Windows]
(Select D = directory)
Примечание: Приватный ключ keystores/key.p12 и доверенный сертификат CA keystores/cacerts.p12, используемые в TLS-соединениях,
не хранятся в LDAP.
При обновлении с версии старше 5.16.1 требуется полная новая настройка Wildfly (версия 14+).
Обновите библиотеки DCM4CHE dcm4chee-arc-light как модули JBoss.
> cd $WILDFLY_HOME
> rm -r modules/org/dcm4che
> unzip $DCM4CHEE_ARC/jboss-modules/dcm4che-jboss-modules-dcm4chee-arc-light-5.34.3.zip
Обновите библиотеки JClouds как модули JBoss:
> cd $WILDFLY_HOME
> rm -r modules/org/apache/jclouds
> unzip $DCM4CHEE_ARC/jboss-modules/jclouds-jboss-modules-2.6.0.zip
(Пере)запустите WildFly в автономном режиме (standalone) с корректным конфигурационным файлом:
> $WILDFLY_HOME/bin/standalone.sh -c dcm4chee-arc.xml [UNIX]
> %WILDFLY_HOME%\bin\standalone.bat -c dcm4chee-arc.xml [Windows]
Снимите с развёртывания старые DCM4CHEE Archive Backend и UI с помощью JBoss CLI, напр.:
> $WILDFLY_HOME/bin/jboss-cli.sh -c [UNIX]
> %WILDFLY_HOME%\bin\jboss-cli.bat -c [Windows]
[standalone@localhost:9990 /] undeploy dcm4chee-arc-ear-5.34.2-psql.ear
[standalone@localhost:9990 /] undeploy dcm4chee-arc-ui2-5.34.2.war
Разверните новые DCM4CHEE Archive Backend и UI с помощью JBoss CLI, напр.:
[standalone@localhost:9990 /] deploy $DCM4CHEE_ARC/deploy/dcm4chee-arc-ear-5.34.3-psql.ear
[standalone@localhost:9990 /] deploy $DCM4CHEE_ARC/deploy/dcm4chee-arc-ui2-5.34.3.war
При обновлении защищённой версии архива также см. Обновление Wildfly для защищённого архива
Если лог сервера архива содержит множество вхождений INFO-сообщений от нижележащего менеджера соединений Wildfly cached connection
14:09:59,341 INFO [org.jboss.jca.core.connectionmanager.listener.TxConnectionListener] (default task-4) IJ000311: Throwable from unregister connection: java.lang.IllegalStateException: IJ000152: Trying to return an unknown connection: org.jboss.jca.adapters.jdbc.jdk8.WrappedConnectionJDK8@617cc86c
at org.jboss.ironjacamar.impl@3.0.3.Final//org.jboss.jca.core.connectionmanager.ccm.CachedConnectionManagerImpl.unregisterConnection(CachedConnectionManagerImpl.java:408)
at org.jboss.ironjacamar.impl@3.0.3.Final//org.jboss.jca.core.connectionmanager.listener.TxConnectionListener.connectionClosed(TxConnectionListener.java:645)
.........
По желанию отключите их:
[standalone@localhost:9990 /] /subsystem=datasources/data-source=pacsds:write-attribute(name=use-ccm,value=false)
См. Обновление защищённого архива, для : - Использования / тестирования защищённых сервисов DICOM Upper Layer, опционально с помощью инструментов dcm4che. - Обновления защищённой версии архива.