Red Hat JBoss Enterprise Application Platform 7.3.Beta ... · PDF file New Features and...

Click here to load reader

  • date post

    16-Oct-2020
  • Category

    Documents

  • view

    1
  • download

    0

Embed Size (px)

Transcript of Red Hat JBoss Enterprise Application Platform 7.3.Beta ... · PDF file New Features and...

  • Red Hat JBoss Enterprise Application Platform 7.3

    Migration Guide

    For Use with Red Hat JBoss Enterprise Application Platform 7.3

    Last Updated: 2020-09-03

  • Red Hat JBoss Enterprise Application Platform 7.3 Migration Guide

    For Use with Red Hat JBoss Enterprise Application Platform 7.3

  • Legal Notice

    Copyright © 2020 Red Hat, Inc.

    The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/ . In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.

    Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.

    Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.

    Linux ® is the registered trademark of Linus Torvalds in the United States and other countries.

    Java ® is a registered trademark of Oracle and/or its affiliates.

    XFS ® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.

    MySQL ® is a registered trademark of MySQL AB in the United States, the European Union and other countries.

    Node.js ® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.

    The OpenStack ® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.

    All other trademarks are the property of their respective owners.

    Abstract

    This guide provides information about how to migrate your application from previous versions of Red Hat JBoss Enterprise Application Platform.

  • . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

    Table of Contents

    CHAPTER 1. INTRODUCTION 1.1. ABOUT MIGRATIONS AND UPGRADES 1.2. ABOUT THE USE OF EAP_HOME IN THIS DOCUMENT

    CHAPTER 2. PREPARE FOR MIGRATION 2.1. PREPARATION OVERVIEW 2.2. REVIEW THE JAVA EE 8 FEATURES 2.3. REVIEW THE JAVA EE 7 FEATURES 2.4. REVIEW WHAT’S NEW IN JBOSS EAP 7

    New Features and Enhancements Introduced JBoss EAP 7.0 New Features and Enhancements Introduced in JBoss EAP 7.1 New Features and Enhancements Introduced in JBoss EAP 7.2 New Features and Enhancements Introduced in JBoss EAP 7.3

    2.5. REVIEW THE LIST OF DEPRECATED AND UNSUPPORTED FEATURES 2.6. REVIEW THE JBOSS EAP GETTING STARTED MATERIAL 2.7. MIGRATION ANALYSIS AND PLANNING 2.8. BACK UP IMPORTANT DATA AND REVIEW SERVER STATE 2.9. MIGRATING AN RPM INSTALLATION 2.10. MIGRATE JBOSS EAP RUNNING AS A SERVICE

    CHAPTER 3. TOOLS TO ASSIST IN MIGRATION 3.1. USE RED HAT APPLICATION MIGRATION TOOLKIT TO ANALYZE APPLICATIONS FOR MIGRATION 3.2. USE THE JBOSS SERVER MIGRATION TOOL TO MIGRATE SERVER CONFIGURATIONS

    CHAPTER 4. SERVER CONFIGURATION CHANGES 4.1. RPM INSTALLATION CHANGES 4.2. SERVER CONFIGURATION MIGRATION OPTIONS

    JBoss Server Migration Tool Management CLI Migrate Operation

    4.3. MANAGEMENT CLI MIGRATION OPERATION Start the Server and the Management CLI Migrate the JacORB, Messaging, and Web Subsystems

    4.4. LOGGING CHANGES 4.4.1. Logging Message Prefix Changes 4.4.2. Root Logger Console Handler Changes

    4.5. WEB SERVER CONFIGURATION CHANGES 4.5.1. Replace the Web Subsystem with Undertow 4.5.2. Migrate JBoss Web Rewrite Conditions 4.5.3. Migrate JBoss Web System Properties 4.5.4. Update the Access Log Header Pattern 4.5.5. Migrate Global Valves

    Migrate JBoss Web Valves JDBCAccessLogValve Manual Migration Procedure

    4.5.6. Changes to Set-Cookie Behavior 4.5.7. Changes to HTTP Method Call Behavior 4.5.8. Changes in the Default Web Module Behavior 4.5.9. Changes in the Undertow Subsystem Default Configuration

    4.6. JGROUPS SERVER CONFIGURATION CHANGES 4.6.1. JGroups Defaults to a Private Network Interface 4.6.2. JGroups Channels Changes

    4.7. INFINISPAN SERVER CONFIGURATION CHANGES 4.7.1. Infinispan Default Cache Configuration Changes

    8 8 8

    10 10 10 10 10 11 11

    12 12 13 14 15 16 16 17

    18 18 18

    20 20 20 20 20 20 21 22 25 25 25 25 26 26 29 29 29 30 31 32 32 33 34 35 35 35 35 35

    Table of Contents

    1

  • . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

    4.7.2. Infinispan Cache Strategy Changes 4.7.3. Configuring Custom Stateful Session Bean Cache for Passivation 4.7.4. Infinispan Cache Container Transport Changes

    4.8. EJB SERVER CONFIGURATION CHANGES DuplicateServiceException

    4.9. MESSAGING SERVER CONFIGURATION CHANGES 4.9.1. Messaging Subsystem Server Configuration Changes

    Management Model Messaging Subsystem Migration and Forward Compatibility Change in Behavior of forward-when-no-consumers Attribute Change in Default Cluster Load Balancing Policy Messaging Subsystem XML Configuration

    4.9.2. Migrate Messaging Data 4.9.2.1. Migrate Messaging Data Using Export and Import

    Export Messaging Data from JBoss EAP 6.4 Export Messaging Data from JBoss EAP 7.x Import the XML Formatted Messaging Data Recovering from an Import Messaging Data Failure

    4.9.2.2. Migrate Messaging Data Using a JMS Bridge Configure the Source JBoss EAP 6.4 Server Configure the Target JBoss EAP 7.x Server Migrate the Messaging Data

    4.9.2.3. Mapping Messaging Folder Names 4.9.2.4. Backing Up Messaging Folder Data

    4.9.3. Migrate JMS Destinations 4.9.4. Migrate Messaging Interceptors 4.9.5. Replace Netty Servlet Configuration 4.9.6. Configuring a Generic JMS Resource Adapter 4.9.7. Messaging Configuration Changes 4.9.8. Changes in JMS Serialization Behavior Between Releases

    4.10. JMX MANAGEMENT CHANGES 4.11. ORB SERVER CONFIGURATION CHANGES 4.12. MIGRATE THE THREADS SUBSYSTEM CONFIGURATION 4.13. MIGRATE THE REMOTING SUBSYSTEM CONFIGURATION 4.14. WEBSOCKET SERVER CONFIGURATION CHANGES 4.15. SINGLE SIGN-ON SERVER CHANGES 4.16. DATASOURCE CONFIGURATION CHANGES

    4.16.1. JDBC Datasource Driver Name Driver Containing a Single Class Driver Containing Multiple Classes

    4.17. SECURITY SERVER CONFIGURATION CHANGES 4.17.1. Changes in Legacy Security Behavior between JBoss EAP 7.0 and JBoss EAP 7.1

    4.17.1.1. HTTP Status Change for Unreachable LDAP Realms 4.17.1.2. Enabling the LDAP Security Realm to Parse Roles from a DN 4.17.1.3. Changes in Sending the JBoss EAP SSL Certificate to an LDAP Server

    4.17.2. FIPS Mode Changes 4.18. TRANSACTIONS SUBSYSTEM CHANG