21.4. 配置已部署的资源适配器
JBoss 管理员可以用管理 CLI 工具、基于 Web 的管理控制台或手动编辑配置文件的方式来配置资源适配器。
关于所支持的属性和其他细节,请参考资源适配器的相关文档。
注意
在下面的过程里,请在
[standalone@localhost:9999 /]
提示符后输入命令行。请不要输入花括号里的内容。这是命令执行的结果,例如 {"outcome" => "success"}
。
过程 21.5. 用管理 CLI 配置资源适配器
- 在你的操作系统里打开一个命令行提示窗口。
- 连接至管理 CLI。
- 对于 Linux,输入下列命令:
EAP_HOME/bin/jboss-cli.sh --connect
$ EAP_HOME/bin/jboss-cli.sh --connect
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 您应该看到下列输出结果:Connected to standalone controller at localhost:9999
$ Connected to standalone controller at localhost:9999
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 对于 Windows,输入下列命令:
C:\>EAP_HOME\bin\jboss-cli.bat --connect
C:\>EAP_HOME\bin\jboss-cli.bat --connect
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 您应该看到下列输出结果:Connected to standalone controller at localhost:9999
C:\> Connected to standalone controller at localhost:9999
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
- 添加资源适配器配置。
[standalone@localhost:9999 /] /subsystem=resource-adapters/resource-adapter=eis.rar:add(archive=eis.rar, transaction-support=XATransaction) {"outcome" => "success"}
[standalone@localhost:9999 /] /subsystem=resource-adapters/resource-adapter=eis.rar:add(archive=eis.rar, transaction-support=XATransaction) {"outcome" => "success"}
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 配置
server
资源适配器级别 <config-property>。[standalone@localhost:9999 /] /subsystem=resource-adapters/resource-adapter=eis.rar/config-properties=server/:add(value=localhost) {"outcome" => "success"}
[standalone@localhost:9999 /] /subsystem=resource-adapters/resource-adapter=eis.rar/config-properties=server/:add(value=localhost) {"outcome" => "success"}
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 配置
port
资源适配器级别 <config-property>。[standalone@localhost:9999 /] /subsystem=resource-adapters/resource-adapter=eis.rar/config-properties=port/:add(value=9000) {"outcome" => "success"}
[standalone@localhost:9999 /] /subsystem=resource-adapters/resource-adapter=eis.rar/config-properties=port/:add(value=9000) {"outcome" => "success"}
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 为受管连接工厂添加连接定义。
[standalone@localhost:9999 /] /subsystem=resource-adapters/resource-adapter=eis.rar/connection-definitions=cfName:add(class-name=com.acme.eis.ra.EISManagedConnectionFactory, jndi-name=java:/eis/AcmeConnectionFactory) {"outcome" => "success"}
[standalone@localhost:9999 /] /subsystem=resource-adapters/resource-adapter=eis.rar/connection-definitions=cfName:add(class-name=com.acme.eis.ra.EISManagedConnectionFactory, jndi-name=java:/eis/AcmeConnectionFactory) {"outcome" => "success"}
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 配置
name
受管连接工厂级别的 <config-property>。[standalone@localhost:9999 /] /subsystem=resource-adapters/resource-adapter=eis.rar/connection-definitions=cfName/config-properties=name/:add(value=Acme Inc) {"outcome" => "success"}
[standalone@localhost:9999 /] /subsystem=resource-adapters/resource-adapter=eis.rar/connection-definitions=cfName/config-properties=name/:add(value=Acme Inc) {"outcome" => "success"}
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 添加 admin 对象。
[standalone@localhost:9999 /] /subsystem=resource-adapters/resource-adapter=eis.rar/admin-objects=aoName:add(class-name=com.acme.eis.ra.EISAdminObjectImpl, jndi-name=java:/eis/AcmeAdminObject) {"outcome" => "success"}
[standalone@localhost:9999 /] /subsystem=resource-adapters/resource-adapter=eis.rar/admin-objects=aoName:add(class-name=com.acme.eis.ra.EISAdminObjectImpl, jndi-name=java:/eis/AcmeAdminObject) {"outcome" => "success"}
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 配置 Admin 对象的
threshold
属性。[standalone@localhost:9999 /] /subsystem=resource-adapters/resource-adapter=eis.rar/admin-objects=aoName/config-properties=threshold/:add(value=10) {"outcome" => "success"}
[standalone@localhost:9999 /] /subsystem=resource-adapters/resource-adapter=eis.rar/admin-objects=aoName/config-properties=threshold/:add(value=10) {"outcome" => "success"}
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 激活资源适配器。
[standalone@localhost:9999 /] /subsystem=resource-adapters/resource-adapter=eis.rar:activate {"outcome" => "success"}
[standalone@localhost:9999 /] /subsystem=resource-adapters/resource-adapter=eis.rar:activate {"outcome" => "success"}
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 查看最新配置和激活的资源适配器。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
过程 21.6. 用基于 Web 的管理控制台配置资源适配器
- 启动 JBoss EAP 6 服务器。
- 如果您还没有添加管理用户,请现在就添加。详情请参考《JBoss EAP 6 安装指南》里的『Getting Started』章节。
- 打开 Web 浏览器并导航至管理控制台。默认的位置是 http://localhost:9990/console/。关于管理控制台的更多信息,请参考 第 3.4.2 节 “登录到管理控制台”。
- 点击 Profile 链接切换至 Profile 视图。在导航面板里选择 Resource Adapters,然后点击 。
- 输入归档名称并从 TX: 下拉框里选择事务类型
XATransaction
。然后点击 。 - 选择 Properties 标签页,然后点击 来添加资源适配器属性。
- 在 Name 和主机名里输入
server
,例如在 里输入localhost
。然后点击 保存属性。 - 在 Name 和主机名里输入
port
,例如在 里输入9000
。然后点击 保存属性。 server
和port
属性现在出现在 Properties 面板里。点击列出的资源适配器的 Option 列下的 View 链接来查看 Connection Definitions。- 点击页面右上角的 Add 按钮来添加连接定义。
- 输入 Connection Class 的 JNDI Name 和全限定类名。然后点击 。
- 点击 Key 和 Value 数据。后输入这个连接定义的
- 点击 Key 栏目下的
name
字段来启用数据输入。输入属性名称并在完成后按 Enter。点击 Value 栏目下的value
字段来启用数据输入。输入属性名称并在完成后按 Enter。然后点击 保存属性。 - 连接定义已完成,但却是禁用的。请点击启用它。
- "Really modify Connection Definition?" 对话框会出现询问是否进行修改。请点击。连接定义现在应该显示为
Enabled
。 - 点击页面正上方的 Admin Objects 标签来创建和配置 admin 对象。然后点击 按钮。
- 输入 admin 对象的 JNDI Name 和全限定的 Class Name。然后点击 。
- 选择 Properties 标签页,然后点击 来添加 admin 对象的属性。
- 在 Name 字段里输入一个 admin 对象配置属性,例如
threshold
。在 Value 字段里输入属性值,如10
。然后点击 保存属性。 - admin 对象已完成,但却是禁用的。请点击启用它。
- "Really modify Admin Ojbect?" 对话框会出现询问是否进行修改。请点击。admin 对象现在应该显示为
Enabled
。 - 您必需重载服务器配置来完成这个过程。点击 Runtime 视图上的 Runtime 链接,然后选择左侧导航面板上的 Configuration,并点击 。
- "Do you want to reload the server configuration?" 对话框会出现询问是否进行重载。请点击。服务器配置现在是最新版本了。
过程 21.7. 手动配置资源适配器
- 停止 JBoss EAP 6 服务器。
重要
要使修改在服务器重启后仍然生效,你必须在编辑服务器配置文件前停止服务器。 - 打开服务器配置文件进行编辑。
- 对于独立服务器,这个文件是
EAP_HOME/standalone/configuration/standalone.xml
。 - 对于受管域,这个文件是
EAP_HOME/domain/configuration/domain.xml
。
- 在配置文件里找到
urn:jboss:domain:resource-adapters
子系统。 - 如果没有为这个子系统定义资源适配器,请首先替换:使用下列内容:
<subsystem xmlns="urn:jboss:domain:resource-adapters:1.1"/>
<subsystem xmlns="urn:jboss:domain:resource-adapters:1.1"/>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 用您的资源适配器的 XML 定义替换
<!-- <resource-adapter> configuration listed below -->
。下面是用管理 CLI 和基于 Web 的管理控制台创建的资源适配器配置的 XML 片段。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 启动服务器
重新启动 JBoss EAP 6 服务器以使用新的配置运行。