Red Hat SummitCe contenu n'est pas disponible dans la langue sélectionnée.
Chapter 7. Migrating JBoss EAP 7.0 Configurations to JBoss EAP 7.1
7.1. Migrating a JBoss EAP 7.0 Standalone Server to JBoss EAP 7.1
By default, the JBoss Server Migration Tool performs the following tasks when migrating a standalone server configuration from JBoss EAP 7.0 to JBoss EAP 7.1.
- Migrate any referenced modules.
- Migrate any referenced paths.
-
Update the
infinispansubsystem. -
Update the
undertowsubsystem. -
Add the
core-managementsubsystem. -
Add the
elytronsubsystem. - Add socket binding multicast address expressions.
- Migrate compatible security realms.
-
Add the default SSL server identity to the
ApplicationRealm. - Migrate deployments.
7.1.1. Remove Unsupported Subsystems
The JBoss Server Migration Tool removes all unsupported subsystem configurations and extensions from migrated server configurations. The tool logs each subsystem and extension to its log file and to the console as it is removed.
- NOTE
- Any subsystem that was not supported in JBoss EAP 7.0, but was added by an administrator to that server, is also not supported in JBoss EAP 7.1 and will be removed.
To skip removal of the unsupported subsystems, set the subsystems.remove-unsupported-subsystems.skip environment property to true.
7.1.2. Migrate Referenced Modules
A configuration that is migrated from a source server to a target server might reference or depend on a module that is not installed on the target server. The JBoss Server Migration Tool detects this and automatically migrates the referenced modules, plus their dependent modules, from the source server to the target server.
A module referenced by a standalone server configuration is migrated using the following process.
- A module referenced by a security realm configuration is migrated as a plug-in module.
-
A module referenced by the
datasourcesubsystem configuration is migrated as a datasource driver module. -
A module referenced by the
eesubsystem configuration is migrated as a global module. -
A module referenced by the
namingsubsystem configuration is migrated as an object factory module. -
A module referenced by the
messagingsubsystem configuration is migrated as a JMS bridge module. - A module referenced by a vault configuration is migrated to the new configuration.
The console logs a message noting the module ID for any module that is migrated. It is possible to exclude the migration of specific modules by specifying the module ID in the modules.excludes environment property. See Configuring the Migration of Modules for more information.
7.1.3. Migrate Referenced Paths
A configuration that is migrated from a source server to a target server might reference or depend on file paths and directories that must also be migrated to the target server. The JBoss Server Migration Tool does not migrate absolute path references. It only migrates files or directories that are configured as relative to the source configuration. The console logs a message noting each path that is migrated.
The JBoss Server Migration Tool automatically migrates the following path references:
- Vault keystore and encrypted file’s directory.
To skip the migration of referenced paths, set the paths.migrate-paths-requested-by-configuration.vault.skip environment property to true.
7.1.4. Update the Infinispan Subsystem
The JBoss Server Migration Tool updates the infinispan subsystem configuration to better align with the new default JBoss EAP 7.1 configurations.
- It adds the EJB cache container, which is present in the JBoss EAP 7.1 default configuration, to configurations where it is not already included.
- It updates the module name in the Hibernate cache container configuration.
The JBoss Server Migration Tool automatically updates the infinispan subsystem configuration and logs the results to its log file and to the console.
You can customize the update of the infinispan system by setting the following environment properties.
| Property Name | Property Description |
|---|---|
| subsystem.infinispan.update.skip |
If set to |
| subsystem.infinispan.update.add-infinispan-ejb-cache.skip |
If set to |
| subsystem.infinispan.update.fix-hibernate-cache-module-name.skip |
If set to |
7.1.5. Update the Undertow Subsystem
In addition to migrating the web subsystem for JBoss EAP 7.1, the JBoss Server Migration Tool updates its replacement undertow subsystem to add the new features it supports.
- It sets the default HTTP listener redirect socket.
- It adds support for Java EE 7 WebSockets.
- It sets the default HTTPS listener.
- It adds support for HTTP2.
-
It sets the default
Serverresponse header. -
It sets the default
X-Powered-Byresponse header. -
It sets the default HTTP
Invoker.
The JBoss Server Migration Tool automatically updates the undertow subsystem configuration and logs the results to its log file and to the console.
You can customize the update of the undertow system by setting the following environment properties.
| Property Name | Property Description |
|---|---|
| subsystem.undertow.update.skip |
If set to |
| subsystem.undertow.update.set-default-http-listener-redirect-socket.skip |
If set to |
| subsystem.undertow.update.add-undertow-websockets.skip |
If set to |
| subsystem.undertow.update.add-undertow-https-listener.skip |
If set to |
| subsystem.undertow.update.enable-http2.skip |
If set to |
| subsystem.undertow.update.add-response-header.server-header.skip |
If set to |
| subsystem.undertow.update.add-response-header.x-powered-by-header.skip |
If set to |
| subsystem.undertow.update.add-http-invoker.skip |
If set to |
7.1.6. Add the Core Management Subsystem
The JBoss EAP 7.1 core-management subsystem provides management-related resources, which were previously configured in the management core service. Examples of these resources include the ability to view a history of configuration changes made to the server and the ability to monitor for server lifecycle events. The JBoss Server Migration Tool automatically adds the default core-management subsystem configuration to the migrated configuration file.
To skip the addition of the core-management subsystem configuration, set the subsystem.core-management.add.skip environment property to true.
7.1.7. Add the Elytron Subsystem
The JBoss EAP 7.1 elytron subsystem provides a single unified security framework that can manage and configure access for both standalone servers and managed domains. It can also be used to configure security access for applications deployed to JBoss EAP servers. The JBoss Server Migration Tool automatically adds the default elytron subsystem configuration to the migrated configuration file.
To skip the addition of the elytron subsystem configuration, set the subsystem.elytron.add.skip environment property to true.
7.1.8. Add Socket Binding Multicast Address Expressions
The JBoss EAP 7.1 default configuration uses value expressions in the multicast-address attribute of mod_cluster socket bindings. The JBoss Server Migration Tool automatically adds these value expressions to the migrated configuration files.
To skip the addition of these expressions, set the socket-bindings.multicast-address.add-expressions.skip environment property to true.
7.1.9. Migrate Compatible Security Realms
Because the JBoss EAP 7.1 security realm configurations are fully compatible with the JBoss EAP 7.0 security realm configurations, they require no update by the JBoss Server Migration Tool. However, if the application-users.properties, application-roles.properties, mgmt-users.properties, and mgmt-groups.properties files are not referenced using an absolute path, the tool copies them to the path expected by the migrated configuration file.
To skip the security realms migration, set the security-realms.migrate-properties.skip environment property to true.
7.1.10. Add the Default SSL Server Identity to the ApplicationRealm
The JBoss EAP 7.1 default configuration includes an SSL server identity for the default ApplicationRealm security realm. The JBoss Server Migration Tool automatically adds this identity to the migrated configuration files.
To skip the addition of this identity, set the security-realm.ApplicationRealm.add-ssl-server-identity.skip environment property to true.
7.1.11. Migrate Deployments
The JBoss Server Migration Tool can migrate the following types of standalone server deployment configurations.
- Deployments it references, also known as persistent deployments.
- Deployments found in directories monitored by its deployment scanners.
- Deployment overlays it references.
The migration of a deployment consists of installing related file resources on the target server, and possibly updating the migrated configuration.
The JBoss Server Migration Tool is preconfigured to skip deployments by default when running in non-interactive mode. To enable migration of deployments, set the deployments.migrate-deployments.skip environment property to false.
Be aware that when you run the JBoss Server Migration Tool in interactive mode and enter invalid input, the resulting behavior depends on the value of the deployments.migrate-deployments environment property.
-
If
deployments.migrate-deployments.skipis set tofalseand you enter invalid input, the tool will try to migrate the deployments. -
If
deployments.migrate-deployments.skipis set totrueand you enter invalid input, the tool will skip the deployments migration.
To enable the migration of specific types of deployments, see the following sections.
The JBoss Server Migration Tool does not determine whether deployed resources are compatible with the target server. This means that applications or resources might not deploy, might not work as expected, or might not work at all. Also be aware that artifacts such as JBoss EAP 6.4 *-jms.xml configuration files are copied without modification and can cause the JBoss EAP server to boot with errors.
Red Hat recommends that you use the Red Hat Application Migration Toolkit to analyze deployments to determine compatibility among different JBoss EAP servers. For more information, see the Red Hat Application Migration Toolkit product documentation.
7.1.11.1. Migrate Persistent Deployments
To enable migration of persistent deployments when running in non-interactive mode, set the deployments.migrate-persistent-deployments.skip environment property to false.
The JBoss Server Migration Tool searches for any persistent deployment references and lists them to the console.
INFO [ServerMigrationTask#67] Persistent deployments found: [cmtool-helloworld3.war, cmtool-helloworld4.war, cmtool-helloworld2.war, cmtool-helloworld1.war]
The processing workflow then depends on whether you are running the tool in interactive mode or in non-interactive mode, as described below.
Migrating Persistent Deployments in Non-interactive Mode
If you run the tool in non-interactive mode, the tool uses the preconfigured properties to determine whether to migrate the persistent deployments. Persistent deployments are migrated only if both the deployments.migrate-deployments.skip and deployments.migrate-persistent-deployments.skip properties are set to false.
Migrating Persistent Deployments in Interactive Mode
If you run the tool in interactive mode, the JBoss Server Migration Tool prompts you for each deployment using the following workflow.
After printing the persistent deployments it finds to the console, you see the following prompt.
This tool is not able to assert if persistent deployments found are compatible with the target server, skip persistent deployments migration? yes/no?
-
Respond with
yesto skip migration of persistent deployments. All deployment references are removed from the migrated configuration and you end this part of the migration process. -
Respond with
noto continue with the migration.
-
Respond with
If you choose to continue, you see the following prompt.
Migrate all persistent deployments found? yes/no?
-
Respond with
yesto automatically migrate all deployments and end this part of the migration process. -
Respond with
noto continue with the migration.
-
Respond with
If you choose to continue, you receive a prompt asking to confirm the migration for each referenced deployment.
Migrate persistent deployment 'helloworld01.war'? yes/no?
-
Respond with
yesto migrate the deployment. Respond with
noto remove the deployment from the migrated configuration.INFO [ServerMigrationTask#68] Removed persistent deployment from configuration /deployment=helloworld01.war
-
Respond with
7.1.11.2. Migrate Deployment Scanner Deployments
Deployment scanners, which are only used in standalone server configurations, monitor a directory for new files and manage their deployment automatically or through special deployment marker files.
To enable migration of deployments that are located in directories watched by a deployment scanner when running in non-interactive mode, set the deployments.migrate-deployment-scanner-deployments.skip environment property to false.
When migrating a standalone server configuration, the JBoss Server Migration Tool first searches for any configured deployment scanners. For each scanner found, it searches its monitored directories for deployments marked as deployed and prints the results to the console.
The processing workflow then depends on whether you are running the tool in interactive mode or in non-interactive mode, as described below.
Migrating Deployment Scanner Deployments in Non-interactive Mode
If you run the tool in non-interactive mode, the tool uses the preconfigured properties to determine whether to migrate the deployment scanner deployments. Deployment scanner deployments are migrated only if both the deployments.migrate-deployments.skip and deployments.migrate-deployment-scanner-deployments.skip properties are set to false.
Migrating Deployment Scanner Deployments in Interactive Mode
If you run the tool in interactive mode, the JBoss Server Migration Tool prompts you for each deployment using the following workflow.
After printing the deployment scanner deployments it finds to the console, you see the following prompt.
This tool is not able to assert if the scanner's deployments found are compatible with the target server, skip scanner's deployments migration? yes/no?
-
Respond with
yesto skip migration of deployment scanner deployments. All deployment references are removed from the migrated configuration and you end this part of the migration process. -
Respond with
noto continue with the migration.
-
Respond with
If you choose to continue, you see the following prompt.
Migrate all scanner's deployments found? yes/no?
-
Respond with
yesto automatically migrate all deployments and end this part of the migration process. -
Respond with
noto continue with the migration.
-
Respond with
If you choose to continue, you receive a prompt asking to confirm the migration for each referenced deployment.
Migrate scanner's deployment 'helloworld02.war'? yes/no?
-
Respond with
yesto migrate the deployment. Respond with
noto remove the deployment from the migrated configuration.INFO [ServerMigrationTask#69] Resource with path EAP_HOME/standalone/deployments/helloworld02.war migrated.
-
Respond with
7.1.11.3. Migrate Deployment Overlays
The migration of deployment overlays is a fully automated process. If you have enabled migration of deployments by setting the deployments.migrate-deployments.skip environment property to false, the JBoss Server Migration Tool searches for deployment overlays referenced in the standalone server configuration that are linked to migrated deployments. It automatically migrates those that are found, removes those that are not referenced, and logs the results to its log file and to the console.
7.2. Migrating a JBoss EAP 7.0 Managed Domain to JBoss EAP 7.1
When you use the JBoss Server Migration Tool to migrate a domain controller to a new release of JBoss EAP, it can cause the hosts that connect to it, but still run on a previous release of the server, to fail to boot. For this reason, you should migrate your hosts before you migrate your domain controller. If you do not want to migrate your hosts, be sure to read the following information before you begin.
Review Configure a JBoss EAP 7.1 Domain Controller to Administer JBoss EAP 7.0 Instances in the Configuration Guide for JBoss EAP. Pay particular attention to the section entitled Prevent the JBoss EAP 7.0 Instances from Receiving JBoss EAP 7.1 Updates.
For additional information, see Managing Multiple JBoss EAP Versions in the Configuration Guide for JBoss EAP.
By default, the JBoss Server Migration Tool performs the following tasks when migrating a managed domain configuration from JBoss EAP 7.0 to JBoss EAP 7.1.
- Migrate any referenced modules.
- Migrate any referenced paths.
-
Update the
infinispansubsystem. -
Update the
undertowsubsystem. -
Add the
core-managementsubsystem. -
Add the
elytronSubsystem. - Add socket binding multicast address expressions.
- Add the load balancer profile.
- Add the host excludes configuration.
- Migrate deployments.
7.2.1. Remove Unsupported Subsystems
The JBoss Server Migration Tool removes all unsupported subsystem configurations and extensions from migrated server configurations. The tool logs each subsystem and extension to its log file and to the console as it is removed.
- NOTE
- Any subsystem that was not supported in JBoss EAP 7.0, but was added by an administrator to that server, is also not supported in JBoss EAP 7.1 and will be removed.
To skip removal of the unsupported subsystems, set the subsystems.remove-unsupported-subsystems.skip environment property to true.
7.2.2. Migrate Referenced Modules
A configuration that is migrated from a source server to a target server might reference or depend on a module that is not installed on the target server. The JBoss Server Migration Tool detects this and automatically migrates the referenced modules, plus their dependent modules, from the source server to the target server.
A module referenced by a managed domain configuration is migrated using the following process.
- A module referenced by a security realm configuration is migrated as a plug-in module.
-
A module referenced by the
datasourcesubsystem configuration is migrated as a datasource driver module. -
A module referenced by the
eesubsystem configuration is migrated as a global module. -
A module referenced by the
namingsubsystem configuration is migrated as an object factory module. -
A module referenced by the
messagingsubsystem configuration is migrated as a JMS bridge module. - A module referenced by a vault configuration is migrated to the new configuration.
The console logs a message noting the module ID for any module that is migrated. It is possible to exclude the migration of specific modules by specifying the module ID in the modules.excludes environment property. See Configuring the Migration of Modules for more information.
7.2.3. Migrate Referenced Paths
A configuration that is migrated from a source server to a target server might reference or depend on file paths and directories that must also be migrated to the target server. The JBoss Server Migration Tool does not migrate absolute path references. It only migrates files or directories that are configured as relative to the source configuration. The console logs a message noting each path that is migrated.
The JBoss Server Migration Tool automatically migrates the following path references:
- Vault keystore and encrypted file’s directory.
To skip the migration of referenced paths, set the paths.migrate-paths-requested-by-configuration.vault.skip environment property to true.
7.2.4. Update the Infinispan Subsystem
The JBoss Server Migration Tool updates the infinispan subsystem configuration to better align with the new default JBoss EAP 7.1 configurations.
- It adds the EJB cache container, which is present in the JBoss EAP 7.1 default configuration, to configurations where it is not already included.
- It updates the module name in the Hibernate cache container configuration.
The JBoss Server Migration Tool automatically updates the infinispan subsystem configuration and logs the results to its log file and to the console.
You can customize the update of the infinispan system by setting the following environment properties.
| Property Name | Property Description |
|---|---|
| subsystem.infinispan.update.skip |
If set to |
| subsystem.infinispan.update.add-infinispan-ejb-cache.skip |
If set to |
| subsystem.infinispan.update.fix-hibernate-cache-module-name.skip |
If set to |
7.2.5. Update the Undertow Subsystem
In addition to migrating the web subsystem for JBoss EAP 7.1, the JBoss Server Migration Tool updates its replacement undertow subsystem to add the new features it supports.
- It sets the default HTTP listener redirect socket.
- It adds support for Java EE 7 WebSockets.
- It sets the default HTTPS listener.
- It adds support for HTTP2.
-
It sets the default
Serverresponse header. -
It sets the default
X-Powered-Byresponse header. -
It sets the default HTTP
Invoker.
The JBoss Server Migration Tool automatically updates the undertow subsystem configuration and logs the results to its log file and to the console.
You can customize the update of the undertow system by setting the following environment properties.
| Property Name | Property Description |
|---|---|
| subsystem.undertow.update.skip |
If set to |
| subsystem.undertow.update.set-default-http-listener-redirect-socket.skip |
If set to |
| subsystem.undertow.update.add-undertow-websockets.skip |
If set to |
| subsystem.undertow.update.add-undertow-https-listener.skip |
If set to |
| subsystem.undertow.update.enable-http2.skip |
If set to |
| subsystem.undertow.update.add-response-header.server-header.skip |
If set to |
| subsystem.undertow.update.add-response-header.x-powered-by-header.skip |
If set to |
| subsystem.undertow.update.add-http-invoker.skip |
If set to |
7.2.6. Add the Core Management Subsystem
The JBoss EAP 7.1 core-management subsystem provides management-related resources, which were previously configured in the management core service. Examples of these resources include the ability to view a history of configuration changes made to the server and the ability to monitor for server lifecycle events. The JBoss Server Migration Tool automatically adds the default core-management subsystem configuration to the migrated configuration file.
To skip the addition of the core-management subsystem configuration, set the subsystem.core-management.add.skip environment property to true.
7.2.7. Add the Elytron Subsystem
The JBoss EAP 7.1 elytron subsystem provides a single unified security framework that can manage and configure access for both standalone servers and managed domains. It can also be used to configure security access for applications deployed to JBoss EAP servers. The JBoss Server Migration Tool automatically adds the default elytron subsystem configuration to the migrated configuration file.
To skip the addition of the elytron subsystem configuration, set the subsystem.elytron.add.skip environment property to true.
7.2.8. Add Socket Binding Multicast Address Expressions
The JBoss EAP 7.1 default configuration uses value expressions in the multicast-address attribute of mod_cluster socket bindings. The JBoss Server Migration Tool automatically adds these value expressions to the migrated configuration files.
To skip the addition of these expressions, set the socket-bindings.multicast-address.add-expressions.skip environment property to true.
7.2.9. Add the Load Balancer Profile
The JBoss EAP 7.1 includes a new default profile specifically tailored for hosts that serve as load balancers. The JBoss Server Migration Tool automatically adds and configures this profile to all migrated managed domain configurations.
To skip the addition of this profile, set the profile.load-balancer.add.skip environment property to true.
7.2.10. Add Host Excludes
The JBoss EAP 7.1 domain controller can potentially include functionality that is not supported by hosts running on older versions of the server. The host-exclude configuration specifies the resources that should be hidden from those older versions.
When migrating a domain controller configuration, the JBoss Server Migration Tool adds to or replaces the source server’s host-exclude configuration with the configuration of the target JBoss EAP 7.1 server.
The JBoss Server Migration Tool automatically updates the host-exclude configuration and logs the results to its log file and to the console.
INFO Host-excludes configuration added.
7.2.11. Migrate Deployments
The JBoss Server Migration Tool can migrate the following types of managed domain deployment configurations.
- Deployments it references, also known as persistent deployments.
- Deployment overlays it references.
The migration of a deployment consists of installing related file resources on the target server, and possibly updating the migrated configuration.
The JBoss Server Migration Tool is preconfigured to skip deployments by default when running in non-interactive mode. To enable migration of deployments, set the deployments.migrate-deployments.skip environment property to false.
Be aware that when you run the JBoss Server Migration Tool in interactive mode and enter invalid input, the resulting behavior depends on the value of the deployments.migrate-deployments environment property.
-
If
deployments.migrate-deployments.skipis set tofalseand you enter invalid input, the tool will try to migrate the deployments. -
If
deployments.migrate-deployments.skipis set totrueand you enter invalid input, the tool will skip the deployments migration.
To enable the migration of specific types of deployments, see the following sections.
The JBoss Server Migration Tool does not determine whether deployed resources are compatible with the target server. This means that applications or resources might not deploy, might not work as expected, or might not work at all. Also be aware that artifacts such as JBoss EAP 6.4 *-jms.xml configuration files are copied without modification and can cause the JBoss EAP server to boot with errors.
Red Hat recommends that you use the Red Hat Application Migration Toolkit to analyze deployments to determine compatibility among different JBoss EAP servers. For more information, see the Red Hat Application Migration Toolkit product documentation.
7.2.11.1. Migrate Persistent Deployments
To enable migration of persistent deployments when running in non-interactive mode, set the deployments.migrate-persistent-deployments.skip environment property to false.
The JBoss Server Migration Tool searches for any persistent deployment references and lists them to the console.
INFO [ServerMigrationTask#67] Persistent deployments found: [cmtool-helloworld3.war, cmtool-helloworld4.war, cmtool-helloworld2.war, cmtool-helloworld1.war]
The processing workflow then depends on whether you are running the tool in interactive mode or in non-interactive mode, as described below.
Migrating Persistent Deployments in Non-interactive Mode
If you run the tool in non-interactive mode, the tool uses the preconfigured properties to determine whether to migrate the persistent deployments. Persistent deployments are migrated only if both the deployments.migrate-deployments.skip and deployments.migrate-persistent-deployments.skip properties are set to false.
Migrating Persistent Deployments in Interactive Mode
If you run the tool in interactive mode, the JBoss Server Migration Tool prompts you for each deployment using the following workflow.
After printing the persistent deployments it finds to the console, you see the following prompt.
This tool is not able to assert if persistent deployments found are compatible with the target server, skip persistent deployments migration? yes/no?
-
Respond with
yesto skip migration of persistent deployments. All deployment references are removed from the migrated configuration and you end this part of the migration process. -
Respond with
noto continue with the migration.
-
Respond with
If you choose to continue, you see the following prompt.
Migrate all persistent deployments found? yes/no?
-
Respond with
yesto automatically migrate all deployments and end this part of the migration process. -
Respond with
noto continue with the migration.
-
Respond with
If you choose to continue, you receive a prompt asking to confirm the migration for each referenced deployment.
Migrate persistent deployment 'helloworld01.war'? yes/no?
-
Respond with
yesto migrate the deployment. Respond with
noto remove the deployment from the migrated configuration.INFO [ServerMigrationTask#68] Removed persistent deployment from configuration /deployment=helloworld01.war
-
Respond with
7.2.11.2. Migrate Deployment Overlays
The migration of deployment overlays is a fully automated process. If you have enabled migration of deployments by setting the deployments.migrate-deployments.skip environment property to false, the JBoss Server Migration Tool searches for deployment overlays referenced in the standalone server configuration that are linked to migrated deployments. It automatically migrates those that are found, removes those that are not referenced, and logs the results to its log file and to the console.
7.3. Migrating a JBoss EAP 7.0 Host Configuration to JBoss EAP 7.1
By default, the JBoss Server Migration Tool performs the following tasks when migrating a host server configuration from JBoss EAP 7.0 to JBoss EAP 7.1.
7.3.1. Migrate Referenced Modules
A configuration that is migrated from a source server to a target server might reference or depend on a module that is not installed on the target server. The JBoss Server Migration Tool detects this and automatically migrates the referenced modules, plus their dependent modules, from the source server to the target server.
A module referenced by a host server configuration is migrated using the following process.
- A module referenced by a security realm configuration is migrated as a plug-in module.
- A module referenced by a vault configuration is migrated to the new configuration.
The console logs a message noting the module ID for any module that is migrated. It is possible to exclude the migration of specific modules by specifying the module ID in the modules.excludes environment property. See Configuring the Migration of Modules for more information.
7.3.2. Migrate Referenced Paths
A configuration that is migrated from a source server to a target server might reference or depend on file paths and directories that must also be migrated to the target server. The JBoss Server Migration Tool does not migrate absolute path references. It only migrates files or directories that are configured as relative to the source configuration. The console logs a message noting each path that is migrated.
The JBoss Server Migration Tool automatically migrates the following path references:
- Vault keystore and encrypted file’s directory.
To skip the migration of referenced paths, set the paths.migrate-paths-requested-by-configuration.vault.skip environment property to true.
7.3.3. Add the Core Management Subsystem
The JBoss EAP 7.1 core-management subsystem provides management-related resources, which were previously configured in the management core service. Examples of these resources include the ability to view a history of configuration changes made to the server and the ability to monitor for server lifecycle events. The JBoss Server Migration Tool automatically adds the default core-management subsystem configuration to the migrated configuration file.
To skip the addition of the core-management subsystem configuration, set the subsystem.core-management.add.skip environment property to true.
7.3.4. Add the Elytron Subsystem
The JBoss EAP 7.1 elytron subsystem provides a single unified security framework that can manage and configure access for both standalone servers and managed domains. It can also be used to configure security access for applications deployed to JBoss EAP servers. The JBoss Server Migration Tool automatically adds the default elytron subsystem configuration to the migrated configuration file.
To skip the addition of the elytron subsystem configuration, set the subsystem.elytron.add.skip environment property to true.
7.3.5. Migrate Compatible Security Realms
Because the JBoss EAP 7.1 security realm configurations are fully compatible with the JBoss EAP 7.0 security realm configurations, they require no update by the JBoss Server Migration Tool. However, if the application-users.properties, application-roles.properties, mgmt-users.properties, and mgmt-groups.properties files are not referenced using an absolute path, the tool copies them to the path expected by the migrated configuration file.
To skip the security realms migration, set the security-realms.migrate-properties.skip environment property to true.
7.3.6. Add the Default SSL Server Identity to the ApplicationRealm
The JBoss EAP 7.1 default configuration includes an SSL server identity for the default ApplicationRealm security realm. The JBoss Server Migration Tool automatically adds this identity to the migrated configuration files.
To skip the addition of this identity, set the security-realm.ApplicationRealm.add-ssl-server-identity.skip environment property to true.
