DOAG 2011 - Upgrade Guide for Oracle ADF on WebLogic Server

Beratung Software Lösungen
Andreas Koop
Upgrade Guide for Consultant
Oracle Technologies
Oracle ADF on
WebLogic Server

Who I am

 Andreas Koop
 Consultant Oracle Technologies
(Focus on: Oracle Fusion Middleware)
 Oracle ADF Certified Implementation Specialist
 Community
 DOAG
 Oracle ADF News Session
 ADF Enterprise Methodology Group
 XING Oracle ADF Community
 Twitter: @multikoop
 Blog
 http://padora.blogspot.com (TEAM, de)
 http://multikoop.blogspot.com (en)

21.11.2011 © TEAM - Ihr Partner für IT 2

Agenda

 Upgrade Challenge

 Choose an Upgrade-Strategy
 In-Place Upgrade
 Out-of-Place Upgrade

 Know the Upgrade-Tools

 Demonstration

 Conclusion


Development Division
There is a brand new
JDeveloper/ADF-Version.

3 Bug-Fixes, 500 new Features ;)

ADF-Developer We should urgently do an upgrade!



Download-
Server

ADF-Developer

Install


ADF-Developers
Maschine


Let‘s migrate
the „old“ ADF App

ADF-Developer



INFO: Migration successfully completed for the following
file(s):
C:akJDeveloperdoag2011-demodoag2011-demo.jws
C:akJDeveloper...demo-modeldemo-model.jpr
C:akJDeveloperdoag2011-demodemo-uidemo-ui.jpr
[9:55:24 PM] Migration finished.

It‘s so simple.
It just works!
ADF-Developer


ADF-Developer


OK, since everything is fine.Let‘s
deploy the (next gen) app!

ADF-Developer

Work done!


FMW Administration
Here is an update.
Please deploy

ADF-Developer doag-demo.ear

Admin

OK, should be
easy

Take care. It is now
based on ADF 11gR2


WTF!?

Slow down
please!

Quelle:http://www.ps3blog.de/

Oracle ADF Upgrade Challenge – Versionsorgie

Version 12.1.1?, WLS 12.?

today
11.1.2 R2, WLS 10.3.5
11.1.1.5, PS4, WLS 10.3.5
11.1.1.4, PS3, WLS 10.3.4
11.1.1.3, PS2, WLS 10.3.3
11.1.1.2, PS1, WLS 10.3.2
11.1.1.1, R1, WLS 10.3.1
11.1.1.0
10g
t

out of focus

ADF/WLS Versions you should know of

ADF WebLogic Bemerkung
11.1.1.0 10.3.0
11.1.1.1 10.3.1
11.1.1.2 10.3.2
11.1.1.3 10.3.3
11.1.1.4 10.3.4
11.1.1.5 10.3.5
11.1.2.0 10.3.5, Sherman-Patch p12611176 , p12556632
via My Oracle Support
11.1.2.1 10.3.5, Sherman-Patch p12979653, p12917525
UPDATE1 via My Oracle Support

!Don‘t try a „Cross-Version Deployment“!

Know the possibly concerned components

 Domainkonfiguration Web Cache
 AdminServer OHS (mod_wl)
 ManagedServer
AdminServer
 Cluster
 Machine
MS_App1
 Konfiguration adfapp1.ear
 Shared Libraries (JRF)
 NodeManager
 Application (EAR) DB
 Meta Data Services
MDS
 Directory (LDAP)
LDAP
 DB Schema


What should you be aware of?

 WebLogic Server
 Application Development Runtime
 Domainkonfiguration (Parameter, Logging, etc)
 Rechner, Nodemanager
 AdminServer, ManagedServer1..n
 Cluster/Verteilung
 Identity Management (Benutzer/Gruppen)
 Datenquellen
 Metadata Service Repository
 Webtier: OHS, WebCache
 Neu ADF-Applikation, Andere ADF-Applikationen (die
möglicherweise in alter Version erhalten bleiben sollen)

Don‘t forget to TEST the Upgrade!

“Oracle does not recommend upgrading an
application environment that is currently deployed in
production.

Instead, you should upgrade your application
environment while it is under development or test and
execute standard
procedures for quality assurance and performance
tuning before promoting the upgraded environment to
production.“ (p. 18, Upgrade Guide WLS10.3.5)

p. 18, Upgrade Guide WLS10.3.5

Keep in mind your environments /
different requirements

Web Cache Web Cache
OHS (mod_wl) OHS (mod_wl)

Production (Cluster, HA)
JDeveloper
AdminServer AdminServer

Test / Integration MS1_App1
MS_App1
Development

AdminServer MS2_App1
adfapp1.ear
adfapp1.ear adfapp1.ear MS1_App1
adfapp1.ear
adfapp1.ear

DB adfapp2.ear
DB

DB
DB
DB


What is important to backup / what‘s not

MW_HOME

webtier common wl_home user_projects jdk
home home

nodemanager adf_domain
home

instance_home AdminServer MS1

ohs1 webcache1


Wie wurde die ADF WLS Domain installiert?

jdevstudio111Xinstall.bin wls103X_X.bin ofm_appdev_X.zip

install install
install

Middleware Home Middleware Home

Application Development Application Development
EM
Runtime Runtime

WebLogic Server WebLogic Server

configure configure
ADF Domain ADF Domain

adfapp1.ear deploy em.ear

adfapp1.ear


Agenda

 Upgrade Challenge

 Choose an Upgrade-Strategy

 Know the Upgrade-Tools

 Demonstration

 Conclusion


Upgrade Roadmap

 Prepare
 Stop all servers
 Backup!
 MW_HOME, WL_HOME, DOMAIN_HOME, INSTANCE_HOME
 Database Schema, Whole Database (falls notwendig)
 other application specific files, file based mds repo
 Better: Whole Machine! In times of virtualization and Cloud
Computing no problem at all….


or


In-Place Upgrade - Roadmap

 Upgrade WebLogic Server to 10.3.5
 p12395517_1035_LINUX.zip (only via MOS)
 Upgrade ADF Runtime to 11.1.1.5
 => app developer installer (+Patch)
 (Upgrade MDS Repository (DB basierend))
 => Patch Set Assistant
 Upgrade FMW (Fusion Middleware) Configuration /
Domain stuff
 => WLST: upgradeJRF(..) upgradeOpss(..) upgradeADF(..)
(Kann je nach Migrationspfad variieren!)
 Redeploy ADF Applikation


Know Oracles Upgrade and Patch Tools

Werkzeug Einsatz Anmerkung
WebLogic Upgrade Installer Update des WebLogic
Servers
Smart Update Utility Installation von ehemals BEA Smart
Patches auf dem Update. Seit Juni 2011
WebLogic Servers kein Online Update mehr
möglich.
Patch Set Installer Patch WebTier Utilities Oracle HTTP Server
(OHS), Web Cache
Patch Set Assistant Patch Datenbank- hier: Falls MDS DB-
Schemata basiert
OPatch Installation von Hot- z.B. Sherman-Patch ADF
Patches 11.1.2.x
WebLogic Scripting Tool Post-Upgrade upgradeADF(..)
Processing


ADF 11.1.2.x - Characteristic

Note - Oracle ADF 11.1.2.x Application Development Runtime is
provided as a patch for Oracle ADF Runtime 11.1.1.5 and is available
through Oracle Support.

 Patch p<siehe MOS>_111150_Generic.zip on top of
Oracle ADF Runtime 11.1.1.5 (ADF Runtime)
 Patch p<siehe MOS>_111150_Generic.zip on top of
Oracle ADF Runtime 11.1.1.5 (JSF 2)

 wlst:/offline> upgradeADF('/DOMAIN_HOME')

 ! Use the right wlst.sh (oracle_common vs.
wl_server )

Upgrade ADF Shared Libs,
ADF Security Configuration

 Mittels WLST (./oracle_common/common/bin/wlst.sh)
Domäne mit den neuen ADF Bibliotheken ausstatten

wls:/offline> applyJRF('$DH')

 Mittels WLST (./oracle_common/common/bin/wlst.sh)
Security-Konfiguration aktualisieren

wls:/offline>
upgradeOpss(jpsConfig='$DH/config/fmwconfig/jps-
config.xml', jaznData='$DH/config/fmwconfig/system-
jazn-data.xml')


Out-Of-Place Upgrade Roadmap

 Parallel-Installation der neuen Version
 Variante A (kein Enterprise Manager)
 WebLogic Server inkl. Application Development Runtime aus dem
JDeveloper Installer
 Variante B (mit Enterprise Manager)
 WebLogic Server
 Application Development Runtime
 OPatches
 ADF Applikation bereitstellen
 Domain erstellen und konfigurieren
 Datenquelle anlegen
 MDS Repository definieren
 (Security-Provider / Testbenutzer konfigurieren )
 ADF-Anwendung bereitstellen


Die zwei Varianten im Überblick für
ADF 11.1.2.{0|1}
ofm_appdev_11115
jdevstudio1112Xinstall.bin wls1035_X.bin X.zip
install install Sherman-Patch
install

Middleware Home Middleware Home

Application Development Application Development
EM
Runtime Runtime

WebLogic Server WebLogic Server

configure configure
ADF Domain ADF Domain

adfapp1.ear deploy em.ear

adfapp1.ear


Sherman „Post Patch Task“
patch-domain-sherman.py
import os

_DOMAIN_DIR = os.environ['MW_HOME'] +
"/user_projects/domains/" + os.environ['WLS_DOMAIN']

# apply sherman patch on the given domain
upgradeADF(domainPath=_DOMAIN_DIR)
exit()

$ . $PRJ_HOME/env/env.sh
$ $MW_HOME/oracle_common/common/wlst.sh
patch-domain-sherman.py


Out-Of-Place Upgrade - Architektur

WebTier

webhost
Web Cache
OHS (mod_wl)

AppTier

AdminServer AdminServer

MS_App1 MS_App1

apphost
adfapp1.ear adfapp1.ear

ADF11.1.1.2 Domain ADF11.1.2.x Domain

DBTier
DB


Configure new „adf domain“ (1/2)
readTemplate(os.environ['WL_HOME'] +
'/common/templates/domains/wls.jar')
cd('/')
cmo.setName('adf_new_domain')
cd( "Servers/AdminServer" )
cmo.setListenAddress( "All Local Addresses" )
cmo.setListenPort( int(os.environ['WLS_ADMIN_PORT']) )

cd( '/' )
cd( 'Security/'+_DOMAIN_NAME+'/User/' + _WL_ADMIN_USER )
cmo.setPassword( _WL_ADMIN_PWD )

cd('/')
setOption( 'JavaHome', os.environ['MW_JAVA_HOME'] )
setOption( "ServerStartMode", "prod")
setOption( "OverwriteDomain", "true" )

writeDomain( _DOMAIN_DIR )
closeTemplate()


# extend domain JRF template
readDomain (_DOMAIN_DIR)
addTemplate(_MW_HOME +
'/oracle_common/common/templates/applications/jrf_templ
ate_11.1.1.jar')

updateDomain()
closeDomain()

exit()


FMW Administration
Out-Of-Place Upgrade Challenge

I have optimized here,
optimized there…
set log rotating
Admin

Once more now? for every
coming WLS Version?


Automatisierung mit WLST-Skripten

 Export (bestehende Domain)
 Export Config => WLST-Skript
 Export (Test)User/Gruppen => LDIF

 Import (neue Domain)
 WLST-Skript anpassen.
 In neuer Installationsumgebung ausführen.
 WLST-Skript
 LDIF

 Benefits (ggüb. manueller Neuinstallation)
 Alle Einstellungen in der alten Domäne werden übernommen
 Autom. ausführbar. (Test / Prod)


Export Domain Config (1/3)

wls:offline>configToScript(configPath='$DH',
pyPath='config.mydomain.py')

..
def setAttributes_Log_61():
cd("/Servers/AdminServer/Log/AdminServer")
print "setting attributes for mbean type Log"
set("RotateLogOnStartup", "false")
set("NumberOfFilesLimited", "true")
set("FileCount", "3")
set("RotationType", "bySize")
set("FileMinSize", "3000")
set("FileName", "logs/AdminServer.log")
...


Export Domain Config (2/3) – MDS, User/Groups

wls:online>exportMetadata(application='doag-
demo', server='AdminServer', toLocation='/tmp/exportm
ds'

wls:online> domainRuntime()
cd(‘/DomainServices/DomainRuntimeService/DomainConfiguratio
n/<domain>/SecurityConfiguration/<domain>/DefaultRealm/myre
alm/AuthenticationProviders/DefaultAuthenticator’)
cmo.exportData('DefaultAtn', '/export.ldif', Propertie
s())


Adopt exported WLST Skript for the new domain

 Search&Replace <old version> => <new version>
 Comment out most, keep the custom stuff
def initConfigToScriptRun():
execfile('connect.py')
..
#create_ShutdownClass_48("/", "DMSShutdown")
create_JDBCSystemResource_52("/", "hrconn")

create_Property_54("/JDBCSystemResources/hrconn/JDBCResourc
e/hrconn/JDBCDriverParams/hrconn/Properties/hrconn",
"user")
#setAttributesFor_AdminServer_1()
setAttributes_Log_68()
endTransaction()
#deploy_FMW_Welc...
..


 Domain config
 wlst.sh
config.adf11112_migrate_domainsettings.py
(JDBC, FileStore, AuthProvider, Logging, etc)

 MDS
 wlst.sh import-mds.py

 Security
 TEST-System:
wlst.sh create-testusersgroups.py
or wlst.sh import-usergroups.py
 PROD-System: --- (no additional action)


Demonstration


Sample Output (in case the demo is not working)

..
Starting an edit session ...
Started edit session, please be sure to save and activate your
changes once you are done.
creating mbean of type JDBCSystemResource ...
creating mbean of type Property ...
setting attributes for mbean type DefaultAuthenticator
setting attributes for mbean type JDBCSystemResource
setting attributes for mbean type JDBCProperty
setting attributes for mbean type JDBCDriverParams
setting attributes for mbean type JDBCDataSource
setting attributes for mbean type JDBCDataSourceParams
setting attributes for mbean type Log
setting attributes for mbean type JDBCConnectionPoolParams
setting attributes for mbean type WebServerLog
Ending transaction
Saving all your changes ...
Saved all your changes successfully.
Activating all your changes, this may take a while ...


OHS Proxy-Konfiguration
OHS (mod_wl)

<Location /adfapp>
SetHandler weblogic-handler
WebLogicHost apphost1
before

WebLogicPort 8003
</Location>

OHS (mod_wl)

<Location /adfapp>
SetHandler weblogic-handler
WebLogicHost apphost1
WebLogicPort 8103
after

</Location>


Benefits Out-Of-Place Upgrade

 Near No Risc (the old version is still available)
 Near No Downtime (Worst Case: Session lost)
 In case of more than one ADF application in a WLS
Domain step-by-step migration possible.
 In case you have no acceptance system, the migrated
ADF Application can be tested through direct access on
WLS Server
 There is a great period of time you can switch back to the
old version in case of problems.


Conclusion and Recommendations

 An easy upgrade is not always possible
 => „Version mismatch of ADF vs. WLS“ since 11.1.2

 Out-Of-Place-Upgrade is the better choice to go

 Automate as much as possible by WLST
 Creation, Configuration of „ADF-Domain“
 Creation, Reconfiguration of DataSources
 Configuration of Security-Provider, Testuser/groups, MDS-
Repository
 (Re)Deployment of ADF-Applikation
WLST rulez, makes
live easier

TEAM Partner für Technologie

Thank you und angewandte Methoden der
Informationsverarbeitung
GmbH

for your attention! Hermann-Löns-Str. 88
33104 Paderborn

Fon +49 5254 8008-0
Fax +49 5254 8008-19

Any questions? Mail team@team-pb.de
Web www.team-pb.de

DOAG 2011 - Upgrade Guide for Oracle ADF on WebLogic Server

Empfohlen

Empfohlen

Weitere ähnliche Inhalte

Was ist angesagt?

Was ist angesagt? (20)

Andere mochten auch

Andere mochten auch (11)

Ähnlich wie DOAG 2011 - Upgrade Guide for Oracle ADF on WebLogic Server

Ähnlich wie DOAG 2011 - Upgrade Guide for Oracle ADF on WebLogic Server (20)

Mehr von Andreas Koop

Mehr von Andreas Koop (15)

Kürzlich hochgeladen

Kürzlich hochgeladen (20)

DOAG 2011 - Upgrade Guide for Oracle ADF on WebLogic Server