Red Hat SummitChapter 1. JBoss EAP XP for the latest MicroProfile capabilities
1.1. About JBoss EAP XP
The Eclipse 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 Eclipse MicroProfile 3.3 components:
- Eclipse MicroProfile Config
- Eclipse MicroProfile Fault Tolerance
- Eclipse MicroProfile Health
- Eclipse MicroProfile JWT
- Eclipse MicroProfile Metrics
- Eclipse MicroProfile OpenAPI
- Eclipse MicroProfile OpenTracing
- Eclipse MicroProfile REST Client
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 latest JBoss EAP XP 1.0.x patch is compatible with the latest JBoss EAP 7.3 patch.
1.3. JBoss EAP XP manager for managing JBoss EAP XP patch streams
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 3.3 implementations and the bug fixes for these MicroProfile 3.3 implementations.
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 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. Installing JBoss EAP XP 1.0.0 on JBoss EAP 7.3.0
JBoss JBoss EAP XP 1.0.0 is certified with JBoss EAP 7.3.1.
When you install JBoss EAP XP 1.0.0 on the JBoss EAP 7.3.0 server, you must apply a patch to upgrade it to JBoss EAP 7.3.1.
Prerequisites
You have downloaded the following files from the Product Downloads page:
-
The
jboss-eap-xp-1.0.0-manager.jarfile (JBoss EAP XP manager) - JBoss EAP 7.3.1 GA patch
- The JBoss EAP XP 1.0.0 patch
Procedure
Apply the JBoss EAP 7.3.1 GA patch using the following management command:
patch apply /path/to/jboss-eap-7.3.1-patch.zip
patch apply /path/to/jboss-eap-7.3.1-patch.zipCopy to Clipboard Copied! Toggle word wrap Toggle overflow Set up JBoss EAP XP manager using the following command:
java -jar jboss-eap-xp-manager.jar setup --jboss-home=/PATH/TO/EAP
$ java -jar jboss-eap-xp-manager.jar setup --jboss-home=/PATH/TO/EAPCopy to Clipboard Copied! Toggle word wrap Toggle overflow Apply the JBoss EAP XP 1.0.0 patch using the following management command:
patch apply /path/to/jboss-eap-xp-1.0.0-patch.zip
patch apply /path/to/jboss-eap-xp-1.0.0-patch.zipCopy to Clipboard Copied! Toggle word wrap Toggle overflow Restart the server:
shutdown --restart
shutdown --restartCopy to Clipboard Copied! Toggle word wrap Toggle overflow
1.5. Installing JBoss EAP XP 1.0.0 on JBoss EAP 7.3.1
Prerequistes
You have downloaded the following files from the Product Downloads page:
-
The
jboss-eap-xp-1.0.0-manager.jarfile (JBoss EAP XP manager) - The JBoss EAP XP 1.0.0 patch
Procedure
Set up JBoss EAP XP manager using the following command:
java -jar jboss-eap-xp-manager.jar setup --jboss-home=/PATH/TO/EAP
$ java -jar jboss-eap-xp-manager.jar setup --jboss-home=/PATH/TO/EAPCopy to Clipboard Copied! Toggle word wrap Toggle overflow Apply the JBoss EAP XP 1.0.0 patch using the following management command:
patch apply /path/to/jboss-eap-xp-1.0.0-patch.zip
patch apply /path/to/jboss-eap-xp-1.0.0-patch.zipCopy to Clipboard Copied! Toggle word wrap Toggle overflow Restart the server:
shutdown --restart
shutdown --restartCopy to Clipboard Copied! Toggle word wrap Toggle overflow
1.6. Uninstalling JBoss EAP XP
Uninstalling JBoss EAP XP removes all the files related to enabling the JBoss EAP XP 1.0.0 patch stream and the Eclipse MicroProfile 3.3 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 1.0.0 by issuing the following command:
java -jar jboss-eap-xp-manager.jar remove --jboss-home=/PATH/TO/EAP
$ java -jar jboss-eap-xp-manager.jar remove --jboss-home=/PATH/TO/EAPCopy to Clipboard Copied! Toggle word wrap Toggle overflow
To install Eclipse MicroProfile 3.3 functionality again, run the setup command again to enable the patch stream, and then apply JBoss EAP XP patches to add the Eclipse MicroProfile 3.3. 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
- The available JBoss EAP XP manager commands to change the state
- Any support policy changes due to being in the current 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
$ java -jar jboss-eap-xp-manager.jar status --jboss-home=/PATH/TO/EAPCopy to Clipboard Copied! Toggle word wrap Toggle overflow
Additional Resources
'%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}