Skip to content

Commit

Permalink
[CMTOOL-357] Document jgroups subsystem config update
Browse files Browse the repository at this point in the history
  • Loading branch information
emmartins committed Oct 27, 2023
1 parent f5601ec commit 1305ab6
Show file tree
Hide file tree
Showing 10 changed files with 57 additions and 18 deletions.
Original file line number Diff line number Diff line change
@@ -1,14 +1,11 @@
= Update the JGroups Subsystem
= Update jgroups Subsystem Configuration

The JBoss Server Migration Tool does the following updates to any *jgroups* subsystem configuration found while migrating a server configuration:
The JBoss Server Migration Tool currently is not capable to automate the migration of the `jgroups` subsystem configuration, and thus reverts it to the default {server-target-productName} `jgroups` configuration.

* Replaces protocol `FRAG2` with `FRAG3`.
If you prefer, you can set the `subsystem.jgroups.update.skip` environment property to `true` to skip automatic update of the *jgroups* subsystem configuration.

Upon successful migration of the *jgroups* subsystem configuration, you should see the following message in the console:
Please note that further manual `jgroups` subsystem configuration may be needed if the configuration being used was not the default {server-source-productName} `jgroups` subsystem configuration!

The console logs a message when it updates the `jgroups` subsystem configuration.
[source,options="nowrap"]
----
INFO Subsystem jgroups updated.
----
WARN Configuration of JGroups protocols has been changed to match the default protocols of the target server. Please note that further manual configuration may be needed if the legacy configuration being used was not the source server's default configuration!
----
Original file line number Diff line number Diff line change
@@ -1,14 +1,11 @@
= Update the JGroups Subsystem
= Update jgroups Subsystem Configuration

The JBoss Server Migration Tool does the following updates to any *jgroups* subsystem configuration found while migrating a server configuration:
The JBoss Server Migration Tool currently is not capable to automate the migration of the `jgroups` subsystem configuration, and thus reverts it to the default {server-target-productName} `jgroups` configuration.

* Replaces protocol `FRAG2` with `FRAG3`.
If you prefer, you can set the `subsystem.jgroups.update.skip` environment property to `true` to skip automatic update of the *jgroups* subsystem configuration.

Upon successful migration of the *jgroups* subsystem configuration, you should see the following message in the console:
Please note that further manual `jgroups` subsystem configuration may be needed if the configuration being used was not the default {server-source-productName} `jgroups` subsystem configuration!

The console logs a message when it updates the `jgroups` subsystem configuration.
[source,options="nowrap"]
----
INFO Subsystem jgroups updated.
----
WARN Configuration of JGroups protocols has been changed to match the default protocols of the target server. Please note that further manual configuration may be needed if the legacy configuration being used was not the source server's default configuration!
----
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,8 @@ include::EAP7.2toEAP8.0-ServerMigration-ServerConfiguration-Subsystem-Migrate-ke

include::EAP7.2toEAP8.0-ServerMigration-ServerConfiguration-Subsystem-Migrate-picketlink.adoc[]

include::EAP7.2toEAP8.0-ServerMigration-ServerConfiguration-Subsystem-Update-jgroups.adoc[]

include::ServerMigration-ManagedDomain-AddHostExcludes.adoc[]

include::ServerMigration-ServerConfiguration-MigrateDeployments.adoc[]
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
= Update jgroups Subsystem Configuration

The JBoss Server Migration Tool currently is not capable to automate the migration of the `jgroups` subsystem configuration, and thus reverts it to the default {server-target-productName} `jgroups` configuration.

Please note that further manual `jgroups` subsystem configuration may be needed if the configuration being used was not the default {server-source-productName} `jgroups` subsystem configuration!

The console logs a message when it updates the `jgroups` subsystem configuration.
[source,options="nowrap"]
----
WARN Configuration of JGroups protocols has been changed to match the default protocols of the target server. Please note that further manual configuration may be needed if the legacy configuration being used was not the source server's default configuration!
----
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,8 @@ include::EAP7.2toEAP8.0-ServerMigration-ServerConfiguration-Subsystem-Migrate-ke

include::EAP7.2toEAP8.0-ServerMigration-ServerConfiguration-Subsystem-Migrate-picketlink.adoc[]

include::EAP7.2toEAP8.0-ServerMigration-ServerConfiguration-Subsystem-Update-jgroups.adoc[]

include::ServerMigration-ServerConfiguration-Subsystem-Add-health.adoc[]

include::ServerMigration-ServerConfiguration-Subsystem-Add-metrics.adoc[]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,8 @@ include::EAP7.3toEAP8.0-ServerMigration-ServerConfiguration-Subsystem-Migrate-ke

include::EAP7.3toEAP8.0-ServerMigration-ServerConfiguration-Subsystem-Migrate-picketlink.adoc[]

include::EAP7.3toEAP8.0-ServerMigration-ServerConfiguration-Subsystem-Update-jgroups.adoc[]

include::ServerMigration-ManagedDomain-AddHostExcludes.adoc[]

include::ServerMigration-ServerConfiguration-MigrateDeployments.adoc[]
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
= Update jgroups Subsystem Configuration

The JBoss Server Migration Tool currently is not capable to automate the migration of the `jgroups` subsystem configuration, and thus reverts it to the default {server-target-productName} `jgroups` configuration.

Please note that further manual `jgroups` subsystem configuration may be needed if the configuration being used was not the default {server-source-productName} `jgroups` subsystem configuration!

The console logs a message when it updates the `jgroups` subsystem configuration.
[source,options="nowrap"]
----
WARN Configuration of JGroups protocols has been changed to match the default protocols of the target server. Please note that further manual configuration may be needed if the legacy configuration being used was not the source server's default configuration!
----
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,8 @@ include::EAP7.3toEAP8.0-ServerMigration-ServerConfiguration-Subsystem-Migrate-ke

include::EAP7.3toEAP8.0-ServerMigration-ServerConfiguration-Subsystem-Migrate-picketlink.adoc[]

include::EAP7.3toEAP8.0-ServerMigration-ServerConfiguration-Subsystem-Update-jgroups.adoc[]

include::ServerMigration-ServerConfiguration-Subsystem-Add-health.adoc[]

include::ServerMigration-ServerConfiguration-Subsystem-Add-metrics.adoc[]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -59,6 +59,8 @@ include::{includesDir}/EAP7.4toEAP8.0-ServerMigration-ServerConfiguration-Subsys

include::{includesDir}/EAP7.4toEAP8.0-ServerMigration-ServerConfiguration-Subsystem-Migrate-picketlink.adoc[]

include::{includesDir}/EAP7.4toEAP8.0-ServerMigration-ServerConfiguration-Subsystem-Update-jgroups.adoc[]

include::{includesDir}/ServerMigration-ServerConfiguration-Subsystem-Add-health.adoc[]

include::{includesDir}/ServerMigration-ServerConfiguration-Subsystem-Add-metrics.adoc[]
Expand Down Expand Up @@ -99,6 +101,8 @@ include::{includesDir}/EAP7.4toEAP8.0-ServerMigration-ServerConfiguration-Subsys

include::{includesDir}/EAP7.4toEAP8.0-ServerMigration-ServerConfiguration-Subsystem-Migrate-picketlink.adoc[]

include::{includesDir}/EAP7.4toEAP8.0-ServerMigration-ServerConfiguration-Subsystem-Update-jgroups.adoc[]

include::{includesDir}/ServerMigration-ManagedDomain-AddHostExcludes.adoc[]

include::{includesDir}/ServerMigration-ServerConfiguration-MigrateDeployments.adoc[]
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
= Update jgroups Subsystem Configuration

The JBoss Server Migration Tool currently is not capable to automate the migration of the `jgroups` subsystem configuration, and thus reverts it to the default {server-target-productName} `jgroups` configuration.

Please note that further manual `jgroups` subsystem configuration may be needed if the configuration being used was not the default {server-source-productName} `jgroups` subsystem configuration!

The console logs a message when it updates the `jgroups` subsystem configuration.
[source,options="nowrap"]
----
WARN Configuration of JGroups protocols has been changed to match the default protocols of the target server. Please note that further manual configuration may be needed if the legacy configuration being used was not the source server's default configuration!
----

0 comments on commit 1305ab6

Please sign in to comment.