How to migrate custom instances of JBoss EAP?

Solution Verified - Updated

Environment

  • Red Hat JBoss Enterprise Application Platform (EAP)
    • 6.x
    • 7.x

Issue

  • Need to migrate only the configuration of the JBoss EAP instance.
  • Need to migrate custom instances of the domain in JBoss EAP.

Resolution

See the main solution How to use JBoss Server Migration Tool to upgrade from one version of JBoss EAP 7.x to another version of JBoss EAP 7.x for migration details and troubleshooting.

Server Configuration Migration using Environment Properties

  • For Standalone Mode,

As per JBoss EAP 7.3 documentation, One can configure the JBoss Server Migration Tool to skip the migration of a standalone server entirely.

$ ./jboss-server-migration.sh --source /home/jboss-eap-7.3.0/jboss-eap-7.3                                       
-Djboss.server.migration.server.target.standalone.serverDir=../standalone1
-Djboss.server.migration.server.target.standalone.configDir=../standalone1/configuration 
-Djboss.server.migration.server.source.standalone.configDir=/home/jboss-eap-7.3.0/jboss-eap-7.3/standalone1/configuration -Djboss.server.migration.server.source.standalone.serverDir=/home/jboss-eap-7.3.0/jboss-eap-7.3/standalone1

----------------------------------------------------------
----  JBoss Server Migration Tool  -----------------------
----------------------------------------------------------

Retrieving servers...
01:39:43,169 INFO  [logger] SOURCE server name: JBoss EAP, version: 7.3.0.GA.
01:39:43,176 INFO  [logger] TARGET server name: JBoss EAP, version: 7.4.2.GA.

----------------------------------------------------------
----------------------------------------------------------

Server migration starting...
  • For Domain Mode,
$ ./jboss-server-migration.sh --source /home/jboss-eap-7.3.0/jboss-eap-7.3 
-Djboss.server.migration.server.target.domain.serverDir=../domain1
-Djboss.server.migration.server.target.domain.configDir=../domain1/configuration 
-Djboss.server.migration.server.source.domain.configDir=/home/jboss-eap-7.3.0/jboss-eap-7.3/domain1/configuration -Djboss.server.migration.server.source.domain.serverDir=/home/jboss-eap-7.3.0/jboss-eap-7.3/domain1

Diagnostic Steps

  • Verify the migration.log in $JBOSS_HOME/migration/logs
SBR
Product(s)
Components
Category
Tags

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.