jboss-eap-7.4.0.zip

JBoss Server Migration Tool ================= The JBoss Server Migration Tool is a tool that migrates JBoss Application Servers. It reads the server configurations files for a previous release of WildFly or JBoss EAP, referred to as the source server, and migrates them to this (target) server. Besides the configurations, the tool is also capable of migrating modules, deployments and other resources found in the source server. System Requirements ------------ * [Java 8.0 (Java SDK 1.8)](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) or later Run the Server Migration Tool ------------ 1. Open a terminal and navigate to the `../bin/` directory. 2. Run the following command. For Linux|Mac: ./jboss-server-migration.sh --source SOURCE_SERVER_PATH For Windows: jboss-server-migration.bat --source SOURCE_SERVER_PATH Replace `SOURCE_SERVER_PATH` with the path to previous version of the server installation that you want to migrate from, for example: `${user.home}/jboss-eap-6.4/` 3. When you execute the command, the tool displays a list of the files to be migrated and then prompts you whether you want to continue. ---------------------------------------- ---- JBoss Server Migration Tool ----- ---------------------------------------- Retrieving servers... [org.jboss.migration.core.logger] (main) SOURCE server name: EAP, version: 6.4.0.GA. [org.jboss.migration.core.logger] (main) TARGET server name: JBoss EAP, version: 7.1.0.GA. ---------------------------------------------------------- ---------------------------------------------------------- Server migration starting... Migrate the source's standalone server? yes/no? Type `y` or `yes` to continue with the migration. 4. You are presented with information and prompts similar to the following. [org.jboss.migration.core.task.ServerMigrationTask#3] (main) Standalone server migration starting... [org.jboss.migration.core.task.ServerMigrationTask#5] (main) Retrieving source's standalone configurations... [org.jboss.migration.core.task.ServerMigrationTask#5] (main) /path_to_source_server/standalone/configuration/standalone-full-ha.xml [org.jboss.migration.core.task.ServerMigrationTask#5] (main) /path_to_source_server/standalone/standalone-full.xml [org.jboss.migration.core.task.ServerMigrationTask#5] (main) /path_to_source_server/standalone/standalone-ha.xml [org.jboss.migration.core.task.ServerMigrationTask#5] (main) /path_to_source_server/standalone/standalone-osgi.xml [org.jboss.migration.core.task.ServerMigrationTask#5] (main) /path_to_source_server/standalone/standalone.xml Migrate all configurations? yes/no? Type `y` or `yes` to continue with the migration of all of the standalone server configuration files. Type `n` or `no` to choose the select the files individually. 5. You are presented with a long list of tasks that were completed for the standalone server migration, and the following prompt. INFO [org.jboss.migration.core.task.ServerMigrationTask#3] (main) Standalone server migration done. Migrate the source's managed domain? yes/no? Type `y` or `yes` to continue with the migration of the managed domain configuration files. 6. You are presented with the list of available domain configuration files. INFO [org.jboss.migration.core.task.ServerMigrationTask#323] (main) Domain migration starting... INFO [org.jboss.migration.core.task.ServerMigrationTask#325] (main) Retrieving source's domain configurations... INFO [org.jboss.migration.core.task.ServerMigrationTask#325] (main) .../configuration/domain.xml Migrate all configurations? yes/no? Type `y` or `yes` to continue with the migration of all of the managed domain configuration files. Type `n` or `no` to choose the select the files individually. 7. You are presented with a long list of tasks that were completed for the managed domain migration, and the following prompt. INFO [org.jboss.migration.core.task.ServerMigrationTask#475] (main) Retrieving source's host configurations... INFO [org.jboss.migration.core.task.ServerMigrationTask#475] (main) .../domain/configuration/host-master.xml INFO [org.jboss.migration.core.task.ServerMigrationTask#475] (main) .../configuration/host-slave.xml INFO [org.jboss.migration.core.task.ServerMigrationTask#475] (main) .../configuration/host.xml Migrate all configurations? yes/no? Type `y` or `yes` to continue with the migration of all of the displayed configuration files. Type `n` or `no` to choose the select the files individually. 8. The messages are followed by a `Task Summary` report that summarizes the result of the migration of each task. --------------------------------------------------------------------------------------------------- Task Summary --------------------------------------------------------------------------------------------------- server ................................................................................... SUCCESS standalone .............................................................................. SUCCESS standalone-configurations .............................................................. SUCCESS standalone-configuration(source=.../standalone/configuration/standalone-full-ha.xml) .. SUCCESS standalone-configuration(source=.../standalone/configuration/standalone-full.xml) ..... SUCCESS standalone-configuration(source=.../standalone/configuration/standalone-ha.xml) ....... SUCCESS standalone-configuration(source=.../standalone/configuration/standalone-osgi.xml) ..... SUCCESS standalone-configuration(source=.../standalone/configuration/standalone.xml) .......... SUCCESS domain .................................................................................. SUCCESS domain-configurations .................................................................. SUCCESS domain-configuration(source=.../domain/configuration/domain.xml) ...................... SUCCESS host-configurations .................................................................... SUCCESS host-configuration(source=.../domain/configuration/host-master.xml) ................... SUCCESS host-configuration(source=.../domain/configuration/host-slave.xml) .................... SUCCESS host-configuration(source=.../domain/configuration/host.xml) .......................... SUCCESS 9. You should see the following message when it completes. ------------------------- Migration Result: SUCCESS ------------------------- 10. Review the information in the `reports/` directory. * `migration-report.html`: The HTML report is a nicely formatted report showing the detailed results of the migration. For more information, see [Review the Migration Report](#review-the-migration-report). * `migration-report.xml`: The XML file is used to format the HTML report. For more information, see [Review the Migration XML File](#review-the-migration-xml-file). 11. Review the information in the `logs/` directory. * `migration.log`: The log contains detailed information about the modified configuration files and subsystems. For more information, see [Review the Migration Log](#review-the-migration-log). 12. Review the updated files in target server installation directory. Note the original configuration and properties files are backed up and now have the suffix `.beforeMigration`. <a name="review-the-migration-report"/> Review the Migration Report -----