Red Hat SummitEste conteúdo não está disponível no idioma selecionado.
Chapter 1. Red Hat JBoss Enterprise Application Platform migration overview
As a system administrator, you can upgrade from Red Hat JBoss Enterprise Application Platform 7 to Red Hat JBoss Enterprise Application Platform 8.0. This guide covers new features available in the release, deprecated and unsupported features, and any necessary application and server configuration updates to maintain consistent behavior.
It also provides information about tools that can help with the migration, such as Migration Toolkit for Runtimes, which simplifies migration of Java applications, and the JBoss Server Migration Tool, which updates the server configuration.
After successfully deploying and running JBoss EAP 8.0, you can upgrade individual components to use the new functions and features of JBoss EAP 8.0.
If you want to migrate from older releases of JBoss EAP, you must first migrate to JBoss EAP 7.4. For more information, see JBoss EAP 7.4 Migration Guide.
1.1. Understanding migrations and upgrades
This section provides explanations and guidelines for upgrading and patching JBoss EAP, including major upgrades, minor updates, and cumulative patches.
1.1.1. Major upgrades in JBoss EAP
A major upgrade or migration is necessary when an application is moved from one major release to another, such as from JBoss EAP 7 to JBoss EAP 8.0. Applications that comply with the Jakarta EE 8 specification, contain proprietary code, or use deprecated APIs might require modifications to their application code to run on JBoss EAP 8.0. The introduction of Jakarta EE 10 involves changes in Java package names and other aspects that require adjustments to Jakarta EE application code for compatibility with JBoss EAP 8.0. Additionally, the server configuration has changed in JBoss EAP 8.0 and requires migration. This type of migration is addressed in this guide.
1.1.2. Minor updates in JBoss EAP
Minor Updates in JBoss EAP are point releases that provide bug fixes, security fixes, and new features. The changes made in each point release are documented in the Release notes for Red Hat JBoss Enterprise Application Platform 8.0.
Use the JBoss Server Migration Tool to automatically upgrade from one point release to another, for example from JBoss EAP 7.0 to JBoss EAP 7.1. For more information, see Using the JBoss Server Migration Tool.
1.1.3. Cumulative patches in JBoss EAP
JBoss EAP periodically provides cumulative patches that contain bug and security fixes. Cumulative patches increment the release by the last digit, for example, upgrading from version 7.1.0 to 7.1.1.
1.2. Use of variable
In this document, the <EAP_HOME> variable denotes the path to the JBoss EAP installation. Replace this variable with the actual path to your JBoss EAP installation.
<EAP_HOME> is not an environment variable. Use the JBOSS_HOME environment variable in scripts.
Depending on the installation option you choose to install JBoss EAP, you can locate the installation directory or the default path as follows:
-
If you installed JBoss EAP by using the archive installation method, the installation directory is the
jboss-eap-8.0directory where you extracted the archive. -
If you installed JBoss EAP by using the RPM installation method, the installation directory is the
/opt/rh/eap8/root/usr/share/wildfly/. If you installed JBoss EAP by using the installer application, the default path for
<EAP_HOME>is${user.home}/EAP-8.0.0:-
For Red Hat Enterprise Linux and Oracle Solaris:
/home/USER_NAME/EAP-8.0.0/ -
For Microsoft Windows:
C:\Users\USER_NAME\EAP-8.0.0\
-
For Red Hat Enterprise Linux and Oracle Solaris:
If you installed and configured the JBoss EAP server by using the Red Hat CodeReady Studio installer application, the default path for
<EAP_HOME>is${user.home}/devstudio/runtimes/jboss-eap:-
For Red Hat Enterprise Linux:
/home/USER_NAME/devstudio/runtimes/jboss-eap/ -
For Microsoft Windows:
C:\Users\USER_NAME\devstudio\runtimes\jboss-eaporC:\Documents and Settings\USER_NAME\devstudio\runtimes\jboss-eap\
-
For Red Hat Enterprise Linux:
If you set the Target runtime to 8.0 or a later runtime version in Red Hat CodeReady Studio, your project is compatible with the Jakarta EE 10 specification.
'%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}