一.进入网址:
https://github.com/dcm4che/dcm4chee-arc-light/wiki/Installation
这个是GitHub上面给的步骤,可能会比较难理解,按照所给的步骤做,可能会出现各种问题,在此将笔者遇见的问题列举出来,并给出解决方案。
二.安装所需环境:
1、JDK 1.8.0_91
2、wildfly-10.0.0.Final
3、mysql-5.7.12
4、Apache DS 2.0.0-M20
5、 Apache Directory Studio 2.0.0-M9
上述所需工具下载及环境配置在此不多赘述,如需了解详情请到相应官网查阅。
三.所需资源
binaries下载地址:
https://sourceforge.net/projects/dcm4che/files/
笔者所用的是dcm4chee-arc-5.4.1-mysql这个版本,当然你可以使用其它数据库版本,如果使用其它数据库,第二个步骤中的数据库也要相应的改变。
四.建立数据库
我们选择Mysql数据库:
1、 创建数据库并授权用户
> mysql -u root -p<root-password>
mysql> create database <database-name>;
mysql> grant all on <database-name>.* to '<user-name>' identified by '<user-password>';
mysql> quit
2、 导入表到此数据库
mysql -u <user-name> -p<user-password> <database-name> < $DCM4CHEE_ARC/sql/create-mysql.sql
五.设置 LDAP 服务器
我们选择 Apache DS 2.0.0 服务器。
5.1 安装 Apache DS 2.0.0-M20 并启动服务
5.2 安装 Apache Directory Studio 2.0.0-M9 并创建一个 LDAP 连接:
Network Parameter:
Hostname: localhost
Port: 10389
Authentication Parameter:
Bind DN or user: uid=admin,ou=system
Bind password: secret
5.3 将 LDAP模式的文件导入到 Apache DS 中:
5.3.1 导入apacheds下的LDIF文件
$DCM4CHEE_ARC/ldap/apacheds/dicom.ldif
$DCM4CHEE_ARC/ldap/apacheds/dcm4che.ldif
$DCM4CHEE_ARC/ldap/apacheds/dcm4chee-archive.ldif
导入步骤为:在此连接右键importLDIF import,选择要导入的文件。
注意:要严格按照上述所给文件先后顺序导入。
5.3.2 新建分区dc=dcm4che,dc=org
如果不新建这个分区,按照GitHub上的步骤连接dc=dcm4che,dc=org会出现找不到分区的问题,此时,我们应该首先在uid=admin,ou=system 这个连接下
新建一个分区,步骤为:
(1) 在此连接右键open configuration,切换到Partitions选项,添加一个ID为dcm4che,Suffix为dc=dcm4che,dc=org的分区
(2) 重启ApacheDS服务才会出现此分区。这个时候如果再建立一个新的连接,来连接此分区;Bind DN填写dc=dcm4che,dc=org,密码:secret,会出现验证失败的问题,因为dcm4che,dc=org的密码不是secret,这个时候我们需要添加这个分区的用户密码,添加步骤:
①找到$DCM4CHEE_ARC/ldap/init-baseDN.ldif,在此文件末尾加上一个属性userpassword: secret
②导入此ldif文件,会出现entry已存在的问题,这个时候需要删除dc=dcm4che,dc=org 这个entry,删除之后再导入,就会成功。
5.3.3 导入ldap下面的ldif文件
$DCM4CHEE_ARC/ldap/init-config.ldif
$DCM4CHEE_ARC/ldap/default-config.ldif
$DCM4CHEE_ARC/ldap/add-vendor-data.ldif
$DCM4CHEE_ARC/ldap/sample-config.ldif
导入方法和5.3.1一样。
六.将dcm4chee-arc-light中的默认配置导入到 LDAP 服务器上
6.1 创建一个新LDAP连接:
Network Parameter:
Hostname: localhost
Port: 10389
Authentication Parameter:
Bind DN or user: dc=dcm4che,dc=org
Bind password: secret
Browser Options:
Base DN: dc=dcm4che,dc=org
当然,端口号也可以使用GitHub 所给的389,这需要你创建一个 LDAP server,在 LDAP Servers 视图下右键NewNew Server,选择 ApacheDS 2.0.0 点击 finish,打开配置视图,选择Overview 选项卡,更改端口号为 389,306,启动此server。
6.3 导入ldap下面的ldif文件
$DCM4CHEE_ARC/ldap/init-config.ldif
$DCM4CHEE_ARC/ldap/sample-config.ldif
$DCM4CHEE_ARC/ldap/default-config.ldif
$DCM4CHEE_ARC/ldap/add-vendor-data.ldif
若5.3.3已经导入,这里就不需要导入了。导入方法和5.3.1一样。
6.4 配置 Archive 的AE Title(s)
6.4.1 可以参考这个文章:change the default AE Title(s) of the Archive
我们在这里选择第一种方法:
创建一个 LDIF 文件 命名AETitle.ldif, 文件内容如下:
version: 1
# LDIF for modifying the AE Title of the Archive
# Adjust Base DN (dc=dc=dcm4che,dc=org), Device name (dcm4chee-arc), previous AE Title (DCM4CHEE),
# new AE Title (MY_AE) before import it into the LDAP server
dn: dicomAETitle=DCM4CHEE,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
changetype: moddn
newrdn: dicomAETitle=MY_AE
deleteoldrdn: 1
newsuperior: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
将此文件导入,导入方法和5.3.1一样。
6.5 改变默认的存储路径
6.5.1 可以参考这个文章: change the default Storage Directory:
我们选择第二种方法:
创建一个 LDIF 文件,命名 storage-directory.ldif,文件内容如下:
version: 1
dn: dcmStorageID=fs1,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
changetype: modify
replace: dcmURI
dcmURI: file:///D:/dcm4chee-arc/fs1/
笔者选择的是D盘,如果想使用其它盘可以更改为相应的盘符,当然,路径也可以自定义。
6.6 配置外部 DICOM 应用程序 AE Title(s) 来确定哪一个 Archive 允许被连接
6.6.1可以参考这个文章:configure AE Title(s) of external DICOM Applications
调整$DCM4CHEE_ARC/ldap/sample-device.ldif文件可以配置。此文件内容为:
version: 1
# LDIF for adding a Device providing one Application Entity available on one Network connection
# Adjust Base DN (dc=dcm4che,dc=org), Device name (SAMPLE_DEVICE), AE Title (SAMPLE_AET),
# Hostname (sample.host.name) and Port number before import it into the LDAP server
# Unique AE Title
# (will fail if there is already an object for the same AE Title)
dn: dicomAETitle=SAMPLE_AET,cn=Unique AE Titles Registry,cn=DICOM Configuration,dc=dcm4che,dc=org
objectClass: dicomUniqueAETitle
dicomAETitle: SAMPLE_AET
# Device
dn: dicomDeviceName=SAMPLE_DEVICE,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
objectClass: dicomDevice
dicomDeviceName: SAMPLE_DEVICE
dicomInstalled: TRUE
# Network Connection
dn: cn=dicom,dicomDeviceName=SAMPLE_DEVICE,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
objectClass: dicomNetworkConnection
cn: dicom
dicomHostname: sample.host.name
dicomPort: 12345
# Network Connection (secure)
# dn: cn=dicom-tls,dicomDeviceName=SAMPLE_DEVICE,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
# cn: dicom-tls
# objectClass: dicomNetworkConnection
# dicomHostname: sample.host.name
# dicomPort: 23456
# dicomTLSCipherSuite: TLS_RSA_WITH_AES_128_CBC_SHA
# dicomTLSCipherSuite: SSL_RSA_WITH_3DES_EDE_CBC_SHA
# Network Application Entity
dn: dicomAETitle=SAMPLE_AET,dicomDeviceName=SAMPLE_DEVICE,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
objectClass: dicomNetworkAE
dicomAETitle: SAMPLE_AET
dicomNetworkConnectionReference: cn=dicom,dicomDeviceName=SAMPLE_DEVICE,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
# dicomNetworkConnectionReference: cn=dicom-tls,dicomDeviceName=SAMPLE_DEVICE,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
dicomAssociationInitiator: TRUE
dicomAssociationAcceptor: TRUE
七.设置WildFly 服务器
7.1 将配置文件拷贝到WildFly 安装路径中:
> cp -r $DCM4CHEE_ARC/configuration/dcm4chee-arc $WILDFLY_HOME/standalone/configuration [UNIX]
> xcopy %DCM4CHEE_ARC%\configuration\dcm4chee-arc %WILDFLY_HOME%\standalone\configuration [Windows]
这个时候需要修改 ldap.properties 文件
将java.naming.security.principal=cn=admin,dc=dcm4che,dc=org改为:
java.naming.security.principal=dc=dcm4che,dc=org
如果你上面建立的连接端口号是10389,需要将java.naming.provider.url的端口号改为10389
7.2 添加dcm4chee-arc 配置文件
> cd $WILDFLY_HOME/standalone/configuration/
> cp standalone-full.xml dcm4chee-arc.xml
可以手动复制
7.3 安装dcm4chee-arc-light 库作为 JBOSS 组件
> cd $WILDFLY_HOME
> unzip $DCM4CHEE_ARC/jboss-module/dcm4che-jboss-modules-5.x-dcm4chee-arc-light.zip
解压$DCM4CHEE_ARC/jboss-module/dcm4che-jboss-modules-5.x-dcm4chee-arc-light.zip到 WildFly根目录。
也可以先解压好,将modules/org下面的dcm4che复制到%WILDFLY_HOME%\modules\org下面
7.4 安装JAI Image IO 1.2 库作为JBOSS组件
> cd $WILDFLY_HOME
> unzip $DCM4CHEE_ARC/jboss-module/jai_imageio-jboss-modules-1.2-pre-dr-b04.zip
也可以自己手动解压复制到相应路径
7.5 安装 QueryDSL 3.2.3 库作为JBOSS 组件
> cd $WILDFLY_HOME
> unzip $DCM4CHEE_ARC/jboss-module/querydsl-jboss-modules-4.0.3-noguava.zip
也可以手动解压复制到相应路径
7.6 安装jclouds 1.8.1 库作为JBOSS 组件
> cd $WILDFLY_HOME
> unzip $DCM4CHEE_ARC/jboss-module/jclouds-jboss-modules-1.9.1-noguava.zip
也可以手动解压复制到相应路径
7.7 根据你选择的数据库下载相应的JDBC 驱动
7.7.1 选择合适的驱动
笔者使用的是Mysql,jdbc-jboss-modules-1.0.0-mysql.zip下的module.xml配置文件使用的是5.1.36版本,笔者使用的是5.1.39,在http://dev.mysql.com/downloads/connector/j/ 下载mysql-connector-java-5.1.39-bin.jar文件。你也可以下载其它版本,打开网址: https://downloads.mysql.com/archives/c-j/ 选择其它版本。有可能会出现版本不兼容问题,请依据实际情况作出相应的调整。
7.7.2 安装JDBC 驱动
有两种安装方式:部署和核心组件。
See 这个有两种方式的安装步骤,我们这里选择作为核心组件这种方式。
7.7.2.1在 JBOSS_HOME/modules下创建一个目录结构
(1) 目录结构为JBOSS_HOME/modules/com/mysql/main
(2)在main目录下,新建一个 module.xml 文件:
<?xml version="1.0" encoding="UTF-8"?>
<module xmlns="urn:jboss:module:1.1" name="com.mysql">
<resources>
<resource-root path="mysql-connector-java-5.1.39-bin.jar"/>
<!-- <resource-root path="mysql-license.jar"/> -->
</resources>
<dependencies>
<module name="javax.api"/>
<module name="javax.transaction.api"/>
</dependencies>
</module>
当然你也可以将$dcm4che-arc\jboss—modules\jdbc-jboss-modules-1.0.0-mysql.zip解压出来的module.xml文件复制到此路径下
(3)将下载的JDBC驱动
mysql-connector-java-5.1.39-bin.jar复制到JBOSS_HOME/modules/com/mysql/main下面
(4)核实一下JDBC驱动文件名和module.xml中path(s)下是否一致,要保持一致。
Resource-root 属性可以有多个。
7.8 使用合适的配置文件以独立模式启动 WildFly.
> $WILDFLY_HOME/bin/standalone.sh -c dcm4chee-arc.xml [UNIX]
> %WILDFLY_HOME%\bin\standalone.bat -c dcm4chee-arc.xml [Windows]
Verify, that JBoss started successfully, e.g.:
=======================================================================
JBoss Bootstrap Environment
JBOSS_HOME: "C:\wildfly-10.0.0.Final"
JAVA: "C:\Program Files\Java\jdk1.8.0_91\bin\java"
JAVA_OPTS: "-Dprogram.name=standalone.bat -Xms64M -Xmx512M -XX:MetaspaceSize=96M -XX:MaxMetaspaceSize=256m - Djava.net.preferIPv4Stack=true -Djboss.modules.system.pkgs=org.jboss.byteman -agentlib:jdwp=transport=dt_socket,address=8787,server=y,suspend=n"
=======================================================================
09:22:51,531 INFO [org.jboss.modules] (main) JBoss Modules version 1.5.1.Final
09:22:51,704 INFO [org.jboss.msc] (main) JBoss MSC version 1.2.6.Final
09:22:51,767 INFO [org.jboss.as] (MSC service thread 1-6) WFLYSRV0049: WildFly Full 10.0.0.Final (WildFly Core 2.0.10.Final) starting
:
09:22:54,094 INFO [org.jboss.as] (Controller Boot Thread) WFLYSRV0025: WildFly Full 10.0.0.Final (WildFly Core 2.0.10.Final) started in 28397ms - Started 1839 of 2270 services (683 services are lazy, passive or on-demand)
在域模式下运行的JBoss应该可以正常工作,但是还没有测试。
7.9 打开一个新的控制台窗口,使用JBoss CLI 将 JDBC 驱动添加到服务器配置
> $WILDFLY_HOME/bin/jboss-cli.sh -c [UNIX]
> %WILDFLY_HOME%\bin\jboss-cli.bat -c [Windows]
[standalone@localhost:9999 /] /subsystem=datasources/jdbc-driver=<driver-name>:add(driver-name=<driver-name>,driver-module-name=<module-name>)
对于JDBC 驱动名字,<driver-name>可以任意,<module-name>必须和JDBC驱动组件的定义文件 module.xml中定义的名字一致,我们定义的是“com.mysql”所以:
[standalone@localhost:9999 /] /subsystem=datasources/jdbc-driver=mysql:add(driver-name=mysql,driver-module-name=com.mysql)
7.10 使用JBoss CLI 创建一个新的数据源绑定到 java:/PacsDS JNDI
[standalone@localhost:9999 /] data-source add --name=PacsDS \
> --driver-name=<driver-name> \
> --connection-url= jdbc:mysql://<host>:3306/pacsdb \
> --jndi-name=java:/PacsDS \
> --user-name=pacsdb \
> --password=pacsdb
[standalone@localhost:9999 /] data-source enable --name=PacsDS
The format of <jdbc-url> is JDBC Driver specific, e.g.:
• H2: jdbc:h2:<directory-path>/<database-name>
• MySQL: jdbc:mysql://<host>:3306/<database-name>
• PostgreSQL: jdbc:postgresql://<host>:5432/<database-name>
• Firebird: jdbc:firebirdsql:<host>/3050:<database-name>
• DB2: jdbc:db2://<host>:50000/<database-name>
• Oracle: jdbc:oracle:thin:@<host>:1521:<database-name>
• Microsoft SQL Server: jdbc:sqlserver://<host>:1433;databaseName=<database-name>
也可以使用CLI脚本$DCM4CHEE_ARC/cli/add-data-source-<db>.cli,这个文件中有两个命令,一个是添加 JDBC driver,一个是创建数据源。在执行之前我们必须用实际值(也就是步骤四所建立的数据库)取代
<host>, <database-name>, <user-name> and <user-password> 这些值。执行:
> $WILDFLY_HOME/bin/jboss-cli.sh -c -f $DCM4CHEE_ARC/cli/add-data-source-<db>.cli
7.11 使用JBoss CLI 创建 JMS 队列:
[standalone@localhost:9990 /] jms-queue add --queue-address=StgCmtSCP --entries=java:/jms/queue/StgCmtSCP
[standalone@localhost:9990 /] jms-queue add --queue-address=MPPSSCU --entries=java:/jms/queue/MPPSSCU
[standalone@localhost:9990 /] jms-queue add --queue-address=IANSCU --entries=java:/jms/queue/IANSCU
[standalone@localhost:9990 /] jms-queue add --queue-address=Export1 --entries=java:/jms/queue/Export1
[standalone@localhost:9990 /] jms-queue add --queue-address=Export2 --entries=java:/jms/queue/Export2
[standalone@localhost:9990 /] jms-queue add --queue-address=Export3 --entries=java:/jms/queue/Export3
这个也有CLI 脚本 $DCM4CHEE_ARC/cli/add-jms-queues.cli 提供,里面含有命令行,
我们只需执行:
> $WILDFLY_HOME/bin/jboss-cli.sh -c -f DCM4CHEE_ARC/cli/add-jms-queues.cli
7.12 使用JBoss CLI 调整 managed-executor-services 配置
[standalone@localhost:9990 /] /subsystem=ee/managed-executor-service=default:undefine-attribute(name=hung-task-threshold)
[standalone@localhost:9990 /] /subsystem=ee/managed-executor-service=default:write-attribute(name=long-running-tasks,value=true)
[standalone@localhost:9990 /] /subsystem=ee/managed-executor-service=default:write-attribute(name=core-threads,value=2)
[standalone@localhost:9990 /] /subsystem=ee/managed-executor-service=default:write-attribute(name=max-threads,value=100)
[standalone@localhost:9990 /] /subsystem=ee/managed-executor-service=default:write-attribute(name=queue-length,value=0)
7.13 使用 JBoss CLI 通过system property 指定一个不同的 Device Name
DCM4CHEE Archive 5.x 默认的Device Name是dcm4chee-arc,在LDAP Server中有配置,可以通过system property指定一个不同的Device Name(此步骤也可以不执行)
[standalone@localhost:9999 /] /system-property=dcm4chee-arc.DeviceName:add(value=<device-name>)
7.14 使用JBoss CLI 部署 DCM4CHEE Archive 5.x
7.14.1 部署
[standalone@localhost:9999 /] deploy $DCM4CHEE_ARC/deploy/dcm4chee-arc-ear-5.x-psql.ear
Verify that DCM4CHEE Archive was deployed and started successfully, e.g.:
11:00:38,511 INFO [org.jboss.as.server.deployment] (MSC service thread 1-2) WFLYSRV0027: Starting deployment of "dcm4chee-arc-ear-5.x-psql.ear" (runtime-name: "dcm4chee-arc-ear-5.x-psql.ear")
:
11:00:42,742 INFO [org.dcm4che3.net.Connection] (EE-ManagedExecutorService-default-Thread-1) Start TCP Listener on /0.0.0.0:11112
11:00:42,811 INFO [org.dcm4che3.net.Connection] (EE-ManagedExecutorService-default-Thread-2) Start TCP Listener on /0.0.0.0:2762
11:00:42,811 INFO [org.dcm4che3.net.Connection] (EE-ManagedExecutorService-default-Thread-3) Start TCP Listener on /0.0.0.0:2575
11:00:42,813 INFO [org.dcm4che3.net.Connection] (EE-ManagedExecutorService-default-Thread-4) Start TCP Listener on /0.0.0.0:12575
11:00:43,095 INFO [org.wildfly.extension.undertow] (ServerService Thread Pool -- 20) WFLYUT0021: Registered web context: /dcm4chee-arc
11:00:43,095 INFO [org.wildfly.extension.undertow] (ServerService Thread Pool -- 23) WFLYUT0021: Registered web context: /dcm4chee-arc/ui
11:00:43,157 INFO [org.jboss.as.server] (management-handler-thread - 3) WFLYSRV0010: Deployed "dcm4chee-arc-ear-5.x-SNAPSHOT-psql.ear" (runtime-name : "dcm4chee-arc-ear-5.x-SNAPSHOT-psql.ear")
7.14.2 Verify that the Web UI is accessible at
http://localhost:8080/dcm4chee-arc/ui.
7.14.3 You may undeploy DCM4CHEE Archive at any time using JBoss CLI, e.g.:
[standalone@localhost:9999 /] undeploy dcm4chee-arc-ear-5.x-psql.ear
11:05:23,905 INFO [org.wildfly.extension.undertow] (ServerService Thread Pool -- 75) WFLYUT0022: Unregistered web context: /dcm4chee-arc
11:05:23,906 INFO [org.wildfly.extension.undertow] (ServerService Thread Pool -- 80) WFLYUT0022: Unregistered web context: /dcm4chee-arc/ui
11:05:23,912 INFO [org.dcm4che3.net.Connection] (EE-ManagedExecutorService-default-Thread-1) Stop TCP Listener on /0.0.0.0:11112
11:05:23,912 INFO [org.dcm4che3.net.Connection] (EE-ManagedExecutorService-default-Thread-2) Stop TCP Listener on /0.0.0.0:2762
11:05:23,915 INFO [org.dcm4che3.net.Connection] (EE-ManagedExecutorService-default-Thread-4) Stop TCP Listener on /0.0.0.0:12575
11:05:23,915 INFO [org.dcm4che3.net.Connection] (EE-ManagedExecutorService-default-Thread-3) Stop TCP Listener on /0.0.0.0:2575
:
11:05:24,023 INFO [org.jboss.as.server] (management-handler-thread - 8) WFLYSRV0009: Undeployed "dcm4chee-arc-ear-5.x-psql.ear" (runtime-name: "dcm4chee-arc-ear-5.x-psql.ear")
到这里 dcm4chee-arc-light-5.4.1 安装完成!