View source for EAP 6 to EAP 7 Migration

=External=

* https://access.redhat.com/documentation/en-us/red_hat_jboss_enterprise_application_platform/7.0/html-single/migration_guide/

=Internal=

* [[EAP 7#Subjects|EAP7]]

=Overview=

Incompatible subsystems, such as messaging or web can be migrate to their counterparts messaging-activemq or undertow on a subsystem per subsystem basis, as described below.

=Procedure=

Get a copy of the EAP 6 configuration file in the same "configuration" directory its EAP 7 counterpart exists. The migration procedure works for both standalone-*.xml or domain.xml. In case of domain mode, we will need to navigate in CLI to the required profile, as shown below.

Name the configuration file suggestively, something like "domain-eap6-to-migrate.xml".

Start the EAP 7 instance in admin mode, in top of the file to be migrated.

<pre>
cd $JBOSS_HOME/bin
./domain.sh --admin-only --domain-config=domain-eap6-to-migrate.xml
</pre>

Connect with CLI:

<pre>
cd $JBOSS_HOME/bin
./jboss-cli.sh -c
</pre>

Navigate to the subsystem in question. This is done differently in standalone and domain mode.

<pre>
/profile=full-ha
./subsystem=messaging:describe-migration
</pre>

Perform the migration:

<pre>
./subsystem=messaging:migrate
</pre>

The result should be similar to:

<pre>
{
    "outcome" => "success",
    "result" => {"migration-warnings" => []},
    "server-groups" => undefined
}
</pre>

Shut down the server.

The domain-eap6-to-migrate.xml will contain the migrated configuration.