4.4. 消息传递服务器配置更改

流程

1. 打开一个终端，前往 JBoss EAP 7.x 安装目录，然后以 admin-only 模式启动服务器。

   $ EAP_HOME/bin/standalone.sh -c standalone-full.xml --start-mode=admin-only

2. 打开一个新终端，前往 JBoss EAP 7.x 安装目录，再连接管理 CLI。

   $ EAP_HOME/bin/jboss-cli.sh --connect

3. 使用以下管理 CLI 命令导出消息传递日志数据：

   /subsystem=messaging-activemq/server=default:export-journal()

流程

1. 以正常模式启动 JBoss EAP 8.1 服务器，且未 连接 Jakarta 消息传递客户端。

   重要

   您在没有连接 Jakarta 消息传递客户端的情况下启动服务器非常重要。这是因为，import-journal 操作的行为类似于 Jakarta 消息传递制作者。操作过程中，消息会立即可用。如果此操作在导入期间失败，并且连接了 Jakarta 消息传递客户端，则无法恢复，因为 Jakarta 消息传递客户端可能已经消耗了一些消息。

2. 打开一个新终端，前往 JBoss EAP 8.1 安装目录，再连接管理 CLI。

   $ EAP_HOME/bin/jboss-cli.sh --connect

3. 使用以下管理 CLI 命令导入消息传递数据：

   /subsystem=messaging-activemq/server=default:import-journal(file=OUTPUT_DIRECTORY/OldMessagingData.xml)

   重要

   不要多次运行此命令，因为这样做会导致重复的消息。

流程

1. 关闭 JBoss EAP 8.1 服务器。
2. 删除所有消息传递日志文件夹。请参阅管理 CLI 命令备份消息传递文件夹数据，以确定消息传递日志文件夹的正确目录位置。
3. 如果您在导入前备份了目标服务器消息传递数据，请将消息传递文件夹从备份位置复制到在上一步中确定的消息传递日志目录。
4. 重复上述步骤 ，以导入 XML 格式的消息传递数据。

流程

1. 在 JBoss EAP 8.1 服务器的 messaging-activemq 子系统中为默认服务器创建以下 jms-queue 配置。

   jms-queue add --queue-address=MigratedMessagesQueue --entries=[jms/queue/MigratedMessagesQueue java:jboss/exported/jms/queue/MigratedMessagesQueue]

2. 确保 messaging-activemq 子系统 默认服务器 包含 InVmConnectionFactory connection-factory 的配置，如下所示：

   <connection-factory name="InVmConnectionFactory" factory-type="XA_GENERIC" entries="java:/ConnectionFactory" connectors="in-vm"/>

   如果没有包含该条目，请使用以下管理 CLI 命令创建一个：

   /subsystem=messaging-activemq/server=default/connection-factory=InVmConnectionFactory:add(factory-type=XA_GENERIC, connectors=[in-vm], entries=[java:/ConnectionFactory])

3. 创建和部署 Jakarta Messaging 网桥，从 InQueue JMS 队列读取消息，并将它们传送到 JBoss EAP 7.x 服务器上配置的 MigratedMessagesQueue。

   /subsystem=messaging-activemq/jms-bridge=myBridge:add(add-messageID-in-header=true,max-batch-time=100,max-batch-size=10,max-retries=-1,failure-retry-interval=1000,quality-of-service=AT_MOST_ONCE,module=org.hornetq,source-destination=jms/queue/InQueue,source-connection-factory=jms/RemoteConnectionFactory,source-context=[("java.naming.factory.initial"=>"org.wildfly.naming.client.WildFlyInitialContextFactory"),("java.naming.provider.url"=>"http-remoting://legacy-host:8080")],target-destination=jms/queue/MigratedMessagesQueue,target-connection-factory=java:/ConnectionFactory)

   这会在 JBoss EAP 8.1 服务器的 messaging-activemq 子系统中创建以下 jms-bridge 配置。

   <jms-bridge name="myBridge" add-messageID-in-header="true" max-batch-time="100" max-batch-size="10" max-retries="-1" failure-retry-interval="1000" quality-of-service="AT_MOST_ONCE">
       <source destination="jms/queue/InQueue" connection-factory="jms/RemoteConnectionFactory">
           <source-context>
               <property name="java.naming.factory.initial" value="org.wildfly.naming.client.WildFlyInitialContextFactory"/>
               <property name="java.naming.provider.url" value="http-remoting://legacy-host:8080"/>
           </source-context>
       </source>
       <target destination="jms/queue/MigratedMessagesQueue" connection-factory="java:/ConnectionFactory"/>
   </jms-bridge>

流程

1. 验证您为以下配置提供的信息是否正确。

   • 任何队列和主题名称。
   • java.naming.provider.url 用于 Java 命名和目录接口查找。
2. 确保您已将目标 Jakarta Messaging 目的地部署到 JBoss EAP 8.1 服务器。
3. 启动 JBoss EAP 8.1 服务器，包括迁移过程中涉及的 JBoss EAP 8 服务器。