红帽全球峰会此内容没有您所选择的语言版本。
Chapter 1. JBoss EAP XP for the latest MicroProfile capabilities
1.1. About JBoss EAP XP
The MicroProfile Expansion Pack (JBoss EAP XP) is available as a patch stream, which is provided using JBoss EAP XP manager.
JBoss EAP XP is subject to a separate support and life cycle policy. For more details, see the JBoss Enterprise Application Platform expansion pack Support and Life Cycle Policies page.
The JBoss EAP XP patch provides the following MicroProfile 4.0 components:
- MicroProfile Config
- MicroProfile Fault Tolerance
- MicroProfile Health
- MicroProfile JWT
- MicroProfile Metrics
- MicroProfile OpenAPI
- MicroProfile OpenTracing
- MicroProfile REST Client
- MicroProfile Reactive Messaging
The MicroProfile Reactive Messaging subsystem supports Red Hat AMQ Streams. This feature implements the MicroProfile Reactive Messaging 1.0 API and Red Hat provides the feature as a technology preview for JBoss EAP XP 3.0.0.
Red Hat tested Red Hat AMQ Streams 2021.Q2 on JBoss EAP. However, check the Red Hat JBoss Enterprise Application Platform supported configurations page for information about the latest Red Hat AMQ Streams version that has been tested on JBoss EAP XP 3.0.0.
1.2. JBoss EAP XP installation
When you install JBoss EAP XP, make sure that the JBoss EAP XP patch is compatible with your version of JBoss EAP. The JBoss EAP XP 3.0.x patch is compatible with the JBoss EAP 7.4 release.
You can install JBoss EAP XP either through the XP manager and EAP archive or using the JBoss EAP XP OpenShift Container images. You cannot install JBoss EAP XP on top of EAP RPMs.
1.3. JBoss EAP XP manager
JBoss EAP XP manager is an executable jar file that you can download from the Product Downloads page. Use JBoss EAP XP manager to apply the JBoss EAP XP patches from the JBoss EAP XP patch stream. The patches contain the MicroProfile 4.0 implementations and the bug fixes for these MicroProfile 4.0 implementations.
You can not manage the JBoss EAP XP patches using the management console.
If you run JBoss EAP XP manager without any arguments, or with the help command, you get a list of all the available commands with a description of what they do.
Run the manager with the help command to get more information about the arguments available.
Most of the JBoss EAP XP manager commands take a --jboss-home argument to point to the JBoss EAP XP server to manage the JBoss EAP XP patch stream. Specify the path to the server in the JBOSS_HOME environment variable if you want to omit this. --jboss-home takes precedence over the environment variable.
1.4. JBoss EAP XP manager 3.0 commands
JBoss EAP XP manager 3.0 provides different commands for managing JBoss EAP XP patch streams and applying JBoss EAP 7.4.x base patches.
The following commands are provided:
patch-applyUse this command to apply patches to your JBoss EAP installation.
The
patch-applycommand is similar to thepatch applymanagement CLI command. Thepatch-applycommand accepts only those arguments that are required for applying patches using the tool. It uses the default values for otherpatch applymanagement CLI command arguments.You can use the
patch-applycommand to apply patches to any patch stream that is enabled on the server. You can also use the command to apply both the base server patches as well as the XP patches.Example of using the
patch-applycommand:$ java -jar jboss-eap-xp-manager.jar patch-apply --jboss-home=/PATH/TO/EAP --patch=/PATH/TO/PATCH/jboss-eap-7.3.4-patch.zipWhen you apply an XP patch, JBoss EAP XP manager 3.0 performs validation to prevent patch and patch stream mismatch. The following example illustrates incorrect combinations:
Trying to install JBoss EAP XP 2.0 patch on a server with XP 3.0 patch stream set up causes the following error:
java.lang.IllegalStateException: The JBoss EAP XP patch stream in the patch 'jboss-eap-xp-2.0' does not match the currently enabled JBoss EAP XP patch stream [jboss-eap-xp-3.0] at org.jboss.eap.util.xp.patch.stream.manager.ManagerPatchApplyAction.doExecute(ManagerPatchApplyAction.java:33) at org.jboss.eap.util.xp.patch.stream.manager.ManagerAction.execute(ManagerAction.java:40) at org.jboss.eap.util.xp.patch.stream.manager.ManagerMain.main(ManagerMain.java:50)Trying to install JBoss EAP XP 3.0 patch on a server that is not set up for JBoss EAP XP 3.0 patch stream causes the following error:
java.lang.IllegalStateException: You are attempting to install a patch for the 'jboss-eap-xp-3.0' JBoss EAP XP Patch Stream. However this patch stream is not yet set up in the JBoss EAP server. Run the 'setup' command to enable the patch stream. at org.jboss.eap.util.xp.patch.stream.manager.ManagerPatchApplyAction.doExecute(ManagerPatchApplyAction.java:29) at org.jboss.eap.util.xp.patch.stream.manager.ManagerAction.execute(ManagerAction.java:40) at org.jboss.eap.util.xp.patch.stream.manager.ManagerMain.main(ManagerMain.java:50)In both the cases, no changes are made to the server.
removeUse this command to remove the JBoss EAP XP patch stream setup from the JBoss EAP server.
Example of using the
removecommand$ java -jar jboss-eap-xp-manager.jar remove --jboss-home=/PATH/TO/EAPsetupUse this command to set up a clean JBoss EAP server for the JBoss EAP XP patch stream.
When you use the
setupcommand, JBoss EAP XP manager performs the following actions:- Enables the JBoss EAP XP 3.0 patch stream.
-
Applies patches specified using
--base-patchand--xp-patchattributes. Copies the
standalone-microprofile.xmlandstandalone-microprofile-ha.xmlconfiguration files into the server configuration directory.If older configuration files are already installed, the new files are saved as timestamped copies in the target configuration directory, such as
standalone-microprofile-yyyyMMdd-HHmmss.xml.You can set the target directory using the
--jboss-config-directoryargument.
Example of using the
setupcommand$ java -jar jboss-eap-xp-manager.jar setup --jboss-home=/PATH/TO/EAPstatusUse this command to find the current status of your JBoss EAP XP server. The status command returns the following information:
- The status of the JBoss EAP XP stream.
- Any support policy changes due to being in the current state.
- The major version of JBoss EAP XP.
- Enabled patch streams and their cumulative patch IDs.
- The available JBoss EAP XP manager commands to change the state.
Example of using the
statuscommand$ java -jar jboss-eap-xp-manager.jar status --jboss-home=/PATH/TO/EAPupgradeUse this command to upgrade an old JBoss EAP XP patch stream to the latest patch stream in the JBoss EAP server.
When you use the
upgradecommand, JBoss EAP XP manager performs the following actions:- Creates a backup of the files enabling the old patch stream in the server.
- Enables the JBoss EAP XP 3.0 patch stream.
-
Applies patches specified using
--base-patchand--xp-patchattributes. -
Copies the
standalone-microprofile.xmlandstandalone-microprofile-ha.xmlconfiguration files into the server configuration directory. If older configuration files are already installed, the new files are saved as timestamped copies in the target configuration directory, such asstandalone-microprofile-yyyyMMdd-HHmmss.xml. If something goes wrong, JBoss EAP XP manager attempts to restore the previous patch stream from the backup it created.
You can set the target directory using the
--jboss-config-directoryargument
Example of using the
upgradecommand:$ java -jar jboss-eap-xp-manager.jar upgrade --jboss-home=/PATH/TO/EAP
1.5. Installing JBoss EAP XP 3.0.0 on JBoss EAP 7.4.x
Install JBoss EAP XP 3.0.0 on the JBoss EAP 7.4 base server.
Use JBoss EAP XP manager 3.0.0 to manage JBoss EAP XP 3.0.0 patch streams.
JBoss EAP XP 3.0.0 is certified with JBoss EAP 7.4.x.
Prerequisites
You have downloaded the following files from the Product Downloads page:
-
The
jboss-eap-xp-3.0.0-manager.jarfile (JBoss EAP XP manager 3.0) - JBoss EAP 7.4 server archive file
- JBoss EAP XP 3.0.0 patch
-
The
Procedure
- Extract the downloaded JBoss EAP 7.4 server archive file to the path of your JBoss EAP installation.
Set up JBoss EAP XP manager 3.0.0 to manage the JBoss EAP XP 3.0 patch stream by using the following command:
$ java -jar jboss-eap-xp-manager.jar setup --jboss-home=<path_to_eap>NoteYou can apply the JBoss EAP XP 3.0.0 patch at the same time. Include the path to the JBoss EAP XP 3.0.0 patch by using the
--xp-patchargument.Example:
$ java -jar jboss-eap-xp-manager.jar setup --jboss-home=<path_to_eap> --xp-patch <path_to_patch>jboss-eap-xp-3.0.0-patch.zipThe server is now ready to manage the JBoss EAP XP 3.0.0 patch stream.
Optional: If you have not applied the JBoss EAP XP 3.0.0 patch to your JBoss EAP server by using the
--xp-patchargument, apply the JBoss EAP XP 3.0.0 patch by using the JBoss EAP XP manager 3.0.0patch-applycommand:$ java -jar jboss-eap-xp-manager.jar patch-apply --jboss-home=<path_to_eap> --patch=<path_to_patch>jboss-eap-xp-3.0.0-patch.zipThe
patch-applycommand is similar to thepatch applymanagement CLI command. You can also use thepatch applymanagement CLI command to apply the patch.
The JBoss EAP server is now ready to manage the JBoss EAP XP 3.0.0 patch stream as you patched the JBoss EAP server with the JBoss EAP XP 3.0.0 patch.
1.6. Uninstalling JBoss EAP XP
Uninstalling JBoss EAP XP removes all the files related to enabling the JBoss EAP XP 3.0.0 patch stream and the MicroProfile 4.0 functionality. The uninstallation process does not affect anything in the base server patch stream or functionality.
The uninstallation process does not remove any configuration files, including the ones you added to the JBoss EAP XP patches when you enabled the JBoss EAP XP patch stream.
Procedure
Uninstall JBoss EAP XP 3.0.0 by issuing the following command:
$ java -jar jboss-eap-xp-manager.jar remove --jboss-home=/PATH/TO/EAP
To install MicroProfile 4.0 functionality again, run the setup command again to enable the patch stream, and then apply JBoss EAP XP patches to add the MicroProfile 4.0 modules.
1.7. Viewing the status of JBoss EAP XP
You can view the following information with the status command:
- The status of the JBoss EAP XP stream.
- Any support policy changes due to being in the current state.
- The major version of JBoss EAP XP.
- Enabled patch streams and their cumulative patch ids.
- The available JBoss EAP XP manager commands to change the state.
JBoss EAP XP can be in one of the following states:
Not set up- JBoss EAP is clean and does not have JBoss EAP XP set up.
Set up- JBoss EAP has JBoss EAP XP set up. The version of the XP patch stream is not displays as the user can use CLI to determine it.
Inconsistent-
The files relating to the JBoss EAP XP are in an inconsistent state. This is an error condition and should not happen normally. If you encounter this error, remove the JBoss EAP XP manager as described in the Uninstalling JBoss EAP XP topic and install JBoss EAP XP again using the
setupcommand.
Procedure
View the status of JBoss EAP XP by issuing the following command:
$ java -jar jboss-eap-xp-manager.jar status --jboss-home=<path_to_eap>
Additional Resources
You can roll back a previously applied JBoss EAP XP patch or JBoss EAP 7.4.x base patch using the management CLI.
'%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}