Search

Chapter 2. Before You Begin

download PDF

2.1. Update the target server

The target server contains the JBoss EAP Migration Tool and includes the latest bug fixes for the tool. You can use the JBoss EAP Migration Tool to migrate from one minor release of JBoss EAP to another minor release.

Before the migration process, you must ensure the JBoss EAP Migration Tool receives the latest JBoss EAP updates to prevent re-introducing bugs that might already be fixed for the tool. You can update the tool by applying the latest JBoss EAP updates to the target server.

For example, if you want to migrate your existing source server configuration from JBoss EAP 6.4 to JBoss EAP 7.4 then you must apply the latest JBoss EAP Migration Tool updates to JBoss EAP 7.4 before you can run the tool. Otherwise, after you migrate from JBoss EAP 6.4 to JBoss EAP 7.4, you might introduce issues to the new source server configuration.

Note

Releases before JBoss EAP 6.4 do not support the JBoss EAP Migration Tool. If you want to use the tool with JBoss EAP 6.4 then you must upgrade to JBoss EAP 6.4. Further, you must copy the source configuration files from JBoss EAP 6.0 to JBoss EAP 6.4.

Additional resources

2.2. Run With a Clean Target Server Installation

Because the JBoss Server Migration Tool creates the configuration files based on the configuration of a previous release, it is intended to be run on a clean and unconfigured target server installation. The JBoss Server Migration Tool creates a backup of the target server’s configuration files by appending .beforeMigration to the file names. It then creates totally new configuration files for the target server using the source server’s configuration files, and migrates the configuration to run in target server configuration.

Warning

When you run the JBoss Server Migration Tool, all changes on the target server made between installation and running the migrate tool are lost.

Also, be aware that if you run the tool against the target server directory more than once, the subsequent runs will overwrite the original target configuration files that were backed up on the first run of the tool. This is because each run of the tool backs up the configuration files by appending .beforeMigration, resulting in the loss of any existing backed up configuration files.

2.3. Customize the Migration

The JBoss Server Migration Tool provides the ability to configure logging, reporting, and the execution of migration tasks. By default, when you run the JBoss Server Migration Tool in non-interactive mode, it migrates the entire server configuration. You can configure the JBoss Server Migration Tool to customize logging and reporting output. You can also configure it to skip any part of the configuration that you do not want to migrate.

For instructions on how to configure properties to control the migration process, see Configuring the JBoss Server Migration Tool.

Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.