红帽全球峰会此内容没有您所选择的语言版本。
Chapter 3. Running the JBoss Server Migration Tool
You can run the JBoss Server Migration Tool in either of the following ways.
- Interactive mode: This mode, which is the default, allows you to choose exactly which configurations you want to migrate.
- Non-interactive mode: This mode allows you to run the tool without prompts.
You must stop both the source and the target JBoss EAP servers before you run the JBoss Server Migration Tool.
By default, the JBoss Server Migration Tool runs interactively. This mode allows you to choose exactly which server configurations you want to migrate.
Interactive mode does not allow you to choose which subsystems to migrate. For information on how to configure the tool at the subsystem or task level, see Configure the Migration Tasks Performed by the JBoss Server Migration Tool.
The following are the basic steps that are performed for a minimal migration. If the server from which you are migrating includes custom configurations, for example deployments, or if it is missing default resources, the tool provides additional prompts.
To run the tool in interactive mode, navigate to the target server installation directory and run the following command, providing the
sourceargument as the path to the source server installation.EAP_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME
$ EAP_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOMECopy to Clipboard Copied! Toggle word wrap Toggle overflow You are prompted to determine if you want to migrate the source server’s standalone configurations, which are located in the
EAP_PREVIOUS_HOME/standalone/configuration/directory, to the target server’s standalone configurations, which are located in theEAP_HOME/standalone/configuration/directory.Migrate the source's standalone server? yes/no? yes
Migrate the source's standalone server? yes/no? yesCopy to Clipboard Copied! Toggle word wrap Toggle overflow If you respond with
no, standalone server migration is skipped and no standalone server configuration files are migrated.If you respond with
yes, you see the following prompt.Migrate all configurations? yes/no? yes
Migrate all configurations? yes/no? yesCopy to Clipboard Copied! Toggle word wrap Toggle overflow Respond with
yesto migrate all of the source server’s standalone server configuration files.Respond with
noto receive a prompt for each individualstandalone*.xmlconfiguration file.Next, you are prompted to determine if you want to migrate the source server’s managed domain configurations, which are located in the
EAP_PREVIOUS_HOME/domain/configuration/directory, to the target server’s managed domain configurations, which are located in theEAP_HOME/domain/configuration/directory.Migrate the source's managed domain? yes/no? yes
Migrate the source's managed domain? yes/no? yesCopy to Clipboard Copied! Toggle word wrap Toggle overflow If you respond with
no, managed domain migration is skipped and no managed domain configuration files are migrated.If you respond with
yes, the tool begins migrating the managed domain content of the source server. A ciphered repository is used to store data, such as deployments and deployment overlays, that are referenced by the source server’s managed domain and host configurations. Because the source and target servers use a similar content repository, the tool simply copies the data from the source server to the target server and prints the results to the console and the server log.INFO [ServerMigrationTask#397] Migrating domain content found: [22/caa450a9ba3b84eaf5a15b6da418b92ce6c98e/content, 23/b62a37ba8a4830622bfcdb960280577cc6796e/content] INFO [ServerMigrationTask#398] Resource with path /EAP_HOME/domain/data/content/22/caa450a9ba3b84eaf5a15b6da418b92ce6c98e/content migrated. INFO [ServerMigrationTask#399] Resource with path /EAP_HOME/domain/data/content/23/b62a37ba8a4830622bfcdb960280577cc6796e/content migrated.
INFO [ServerMigrationTask#397] Migrating domain content found: [22/caa450a9ba3b84eaf5a15b6da418b92ce6c98e/content, 23/b62a37ba8a4830622bfcdb960280577cc6796e/content] INFO [ServerMigrationTask#398] Resource with path /EAP_HOME/domain/data/content/22/caa450a9ba3b84eaf5a15b6da418b92ce6c98e/content migrated. INFO [ServerMigrationTask#399] Resource with path /EAP_HOME/domain/data/content/23/b62a37ba8a4830622bfcdb960280577cc6796e/content migrated.Copy to Clipboard Copied! Toggle word wrap Toggle overflow Next, the migration tool scans the source server for managed domain configuration files, prints the results to the console, and provides the following prompt.
Migrate all configurations? yes/no? yes
Migrate all configurations? yes/no? yesCopy to Clipboard Copied! Toggle word wrap Toggle overflow Respond with
yesto migrate all of the source server’s managed domain configuration files.Respond with
noto receive a prompt for each individual managed domain configuration file.Next, the migration tool scans the source server for host configurations files, prints the results to the console, and provides the following prompt.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Respond with
yesto migrate all of the source server’s host configuration files.Respond with
noto receive a prompt for each individual host configuration file.Upon completion, you should see the following message in the server console.
Migration Result: SUCCESS
Migration Result: SUCCESSCopy to Clipboard Copied! Toggle word wrap Toggle overflow
You can run the JBoss Server Migration Tool in non-interactive mode. This mode allows it to run without prompts.
The JBoss Server Migration Tool automatically migrates all subsystem configurations for all server configuration files. For information on how to configure the tool at the subsystem or task level, see Configure the Migration Tasks Performed by the JBoss Server Migration Tool.
To run the tool in non-interactive mode, navigate to the target server installation directory and run the following command, providing the
sourceargument as the path to the source server installation and setting the--interactiveor-iargument tofalse.EAP_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME --interactive false
$ EAP_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME --interactive falseCopy to Clipboard Copied! Toggle word wrap Toggle overflow By default, the tool automatically migrates all of the source server’s standalone and managed domain configuration files. However, you can configure the tool’s properties to skip migration of specific configurations. Upon completion, you should see the following message in the server console.
Migration Result: SUCCESS
Migration Result: SUCCESSCopy to Clipboard Copied! Toggle word wrap Toggle overflow
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}