JBoss Enterprise Application Platform 6.3 Guide de migration
Red Hat Customer Content Services
JBoss Enterprise Application
Platform 6.3
Guide de migration
À utiliser dans Red Hat JBoss Enterprise Application Platform 6
JBoss Enterprise Application Platform 6.3 Guide de migration
À utiliser dans Red Hat JBoss Enterprise Application Platform 6
Notice légale
Copyright © 2015 Red Hat, Inc..
This document is licensed by Red Hat under the Creative Commo ns Attribution-ShareAlike 3.0
Unported License. If you distribute this document, or a modified version of it, you must provide
attribution to Red Hat, Inc. and provide a link to the original. If the document is modified, all Red
Hat trademarks must be removed.
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, JBoss, MetaMatrix, 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 Software Collectio ns 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.
Résumé
Cet ouvrage est un guide pour la migration de votre application en provenance de versions plus
anciennes de Red Hat JBoss Enterprise Application Platform 6.
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table des matières
Préface
1. Co nventio ns d 'écriture
1.1. Co nventio ns typ o g rap hiq ues
1.2. Co nventio ns p o ur citatio ns mises en avant
1.3. No tes et avertissements
2. Ob tenir d e l'aid e et faire d es co mmentaires
2.1. Avez-vo us b eso in d 'aid e ?
2.2. Vo s co mmentaires so nt imp o rtants !
Chapit re 1 . Int roduct ion
1.1. Red Hat JBo ss Enterp rise Ap p licatio n Platfo rm 6
1.2. G uid e d e Mig ratio n
Chapit re 2 . Préparat ion à la migrat ion
2.1. Prép aratio n à la mig ratio n
2.2. Ce q u'il y a d e no uveau et d e d ifférent d ans JBo ss EAP 6
2.3. Vérifier la Liste d es fo nctio nnalités d ép réciées et no n p rises en charg e.
Chapit re 3. Migrat ion de vot re applicat ion
3.1. Chang ements req uis p ar la p lup art d es ap p licatio ns
3.1.1. Revue d es chang ements d e mig ratio n req uis p ar la p lup art d es ap p licatio ns
3.1.2. Chang ements au niveau d u charg ement d es classes
3.1.2.1. Mise à jo ur d e l'ap p licatio n en raiso n d es chang ements d e charg ement d e classes
3.1.2.2. Les Dép end ances d e mo d ules
3.1.2.3. Mise à jo ur d es d ép end ances d 'ap p licatio ns en raiso n d es chang ements d e charg ement
d e classes
3.1.3. Chang ements d ans les fichiers d e co nfig uratio n
3.1.3.1. Créer o u mo d ifier d es fichiers q ui co ntrô lent le charg ement d e classes d ans JBo ss EAP
6
3.1.3.2. jb o ss-dep lo yment-structure.xml
3.1.3.3. Emp aq uetag e d es resso urces d ans le no uveau système d e charg ement d e classes
mo d ulaires
3.1.3.4. Chang er la lo catio n d es p ro p riétés d e Reso urceBund le
3.1.3.5. Créer un mo d ule p erso nnalisé
3.1.4. Chang ements au niveau d u lo g g ing
3.1.4.1. Mo d ifier les Dép end ances d e Lo g g ing
3.1.4.2. Mise à jo ur d u Co d e d 'ap p licatio n p o ur les framewo rks d e Lo g g ing (jo urnalisatio n) d e
tierce p artie
3.1.4.3. Mo d ifier le co d e p o ur utiliser le no uveau framework d e JBo ss Lo g g ing
3.1.5. Chang ements au niveau p ackag ing d 'ap p licatio ns
3.1.5.1. Mo d ifier l' emp aq uetag e d es EAR et d es WAR
3.1.6 . Chang ements au niveau d e la co nfig uratio n d 'ad ap tateur d e resso urces et d e so urce d e
données
3.1.6 .1. Mise à jo ur d e l' ap p licatio n en raiso n d es chang ements d e co nfig uratio n
3.1.6 .2. Mise à jo ur d e la Co nfig uratio n d e la So urce d e d o nnées
3.1.6 .3. Installer et Co nfig urer le Pilo te JDBC
3.1.6 .4. Co nfig urer la so urce d e d o nnées d 'Hib ernate o u JPA
3.1.6 .5. Mise à jo ur d e la Co nfig uratio n d e l'ad ap tateur d e resso urces
3.1.7. Chang ements au niveau sécurité
3.1.7.1. Co nfig urer les chang ements d e sécurité d 'ap p licatio ns
3.1.7.2. Mettre à jo ur les ap p licatio ns utilisant PicketLink STS et les Services Web
3.1.8 . Chang ements JNDI
3.1.8 .1. Mise à jo ur d es no ms d 'esp ace-no ms JNDI d 'ap p licatio n
4
4
4
5
6
7
7
7
8
8
8
9
9
10
11
1 2
12
12
12
12
12
13
14
14
18
18
19
19
21
21
21
23
24
24
25
25
25
26
31
31
33
33
34
35
35
T able des mat ières
1
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
1
/
140
100%
