Oracle ADF Architecture TV - Deployment - Deployment Options

Deployment Options
ORACLE
PRODUCT
LOGO
Real World ADF Design & Architecture Principles
15th Feb 2013 v1.0

Learning Objectives
•  At the end of this module you should be able to:
–  Understand what application deployment models WLS supports
–  What prerequisites you must put in place before deploying an
application to WLS
–  What options you have for deploying ADF applications to WLS
Image: imagerymajestic/ FreeDigitalPhotos.net

Prerequisites & Presentation Scope
Before considering deployment you
need to understand "building" ADF
applications. Ensure you've viewed
the sister PPT first.
Primary focus of this PPT is the
tools for deploying ADF
applications, not the "methodology"
and associated processes and
literature on build & deployment
automation, that's up to you to
define.

Program Agenda
•  WLS Supported Deployment Units
•  ojdeploy vs Deployment
•  Deployment Prerequisites
•  Deployment Options
–  JDeveloper IDE
–  WLS Administration Console
–  Oracle Enterprise Manager "FMW Control" Console
–  weblogic.Deployer
–  WLST

WLS Supported Deployment Units
•  WLS supports several different Java EE deployment units
•  Relevant to ADF applications:
–  Enterprise Applications (EARs) Suitable for ADF Applications
–  Web Applications (WARs)
–  Shared Java EE Libraries (JARs) Suitable for ADF Libraries
•  An EAR can comprise your Web Application (WAR) and ADF Libraries
•  Or the ADF Libraries can be separately deployed as Shared Libraries

7 Copyright © 2013, Oracle and/or its affiliates. All rights reserved.7 Copyright © 2013, Oracle and/or its affiliates. All rights reserved. Image: imagerymajestic/ FreeDigitalPhotos.net
Exercise
Hmm, what are the advantages
and disadvantages of using
WLS shared libraries?

Program Agenda
–  Oracle Enterprise Manager "FMW Control" console
–  WLST
–  Maven WLS Deployment Plug-In

9 Copyright © 2013, Oracle and/or its affiliates. All rights reserved.9 Copyright © 2013, Oracle and/or its affiliates. All rights reserved.
Exercise
If we're talking about
deployment, surely this is a
discussion about ojdeploy?!
Can't ojdeploy deploy our
software to our servers?

ojdeploy for Deployment?
•  The use of the terms "build" and "deployment" are subjective
•  In this training
–  To "Build" the software
•  Is to compile the source and create the JAR/WAR/EAR
•  This is what ojdeploy does
•  The original ojdeploy authors subjectively called this the act of "deploying"
–  To "Deploy" the software
•  Is to install the JAR/WAR/EAR in the Java EE server
•  For the definition of this training, this isn't what ojdeploy does
•  This presentation focuses on how to deploy to the server

Program Agenda
–  WLST

Exercise
What are the prerequisites
for deploying an ADF
application to a server?

ADF Deployment Prerequisites
•  JAR/WAR/EAR is available to deploy
–  Via JDeveloper you've previously created a deployment profile
–  Generated JAR/WAR/EAR via the deployment profile and build tools
•  ADF runtime libraries already installed & targeted to WLS managed servers
–  These must match the version of JDev/ADF your application was built on
–  And version of WLS the ADF runtimes are supported on
–  Ensure to read Oracle Support notes on installing ADF runtimes
–  Unofficial summary of ADF Runtime install instructions (courtesy Timo Hahn)
•  http://tompeez.wordpress.com/2011/09/14/jdeveloper-versions-vs-weblogic-server-
versions/
•  Other software deployments may need to be completed beforehand
–  e.g. database changes, system patches etc

Program Agenda
–  WLST

Exercise
One of my "previous" developers botched
the deployment of an application to
production, it cost us $1000s to rectify.
He now works in HR.
What choices do we have for deploying
ADF applications? Which options can be
automated?

Options in Deploying ADF Applications
•  Manually deploy via
–  WLS console
•  Automated deploy via
–  WLST
–  Maven WLS Deployment Plug In

17 Copyright © 2013, Oracle and/or its affiliates. All rights reserved.17 Copyright © 2013, Oracle and/or its affiliates. All rights reserved. Image: Ambro / FreeDigitalPhotos.net
The key to a stress-free,
efficient & error free deployment
is to remove humans from the
process as much as possible,
and automate all the way.

Program Agenda
–  WLST

Deployment
Op,ons:
JDeveloper
WLS
console
FMW
control
weblogic.Deployer
WLST

Interface
IDE

Manual/Automated
Manual

Start
from
source
code
or
JAR/EAR
Source

Suitable
for
development
server
Yes

Suitable
for
test/produc=on
servers

Apply
WLS
deployment
plans
Yes

Apply
ADF/MBean
run=me
changes

Supports
WLS
produc=on
redeployment

Program Agenda
–  WLST

WLS Console
•  Web based console
•  Administrate WLS servers and their applications in a WLS domain
•  Treats all applications as generic Java EE applications
•  Has no intelligence built administrating ADF or FMW applications

Deployment
Op,ons:
JDeveloper
WLS
console
FMW
control
weblogic.Deployer
WLST

Interface
IDE
Web

Manual/Automated
Manual
Manual

Start
from
source
code
or
JAR/EAR
Source
JAR/EAR

Suitable
for
development
server
Yes
Yes

Suitable
for
test/produc=on
servers
Yes

Apply
WLS
deployment
plans
Yes
Yes

Apply
ADF/MBean
run=me
changes

Supports
WLS
produc=on
redeployment
Yes

Program Agenda
–  WLST

FMW Control
•  Web based console
•  Extension of Oracle Enterprise Manager for FMW
•  For administrating FMW applications and infrastructure
•  Has intelligence built-in for administrating ADF or FMW applications
•  ADF specific:
–  Configure ADF Business Component parameters
–  Configure connection parameters

Deployment
Op,ons:
JDeveloper
WLS
console
FMW
control
weblogic.Deployer
WLST

Interface
IDE
Web
Web

Manual/Automated
Manual
Manual
Manual

Start
from
source
code
or
JAR/EAR
Source
JAR/EAR
JAR/EAR

Suitable
for
development
server
Yes
Yes
Yes

Suitable
for
test/produc=on
servers
Yes
Yes

Apply
WLS
deployment
plans
Yes
Yes
Yes

Apply
ADF/MBean
run=me
changes
Yes

Supports
WLS
produc=on
redeployment
Yes

Program Agenda
–  WLST

weblogic.Deployer
•  Command line deployment utility
•  Provided in default WLS install

Deployment
Op,ons:
JDeveloper
WLS
console
FMW
control
weblogic.Deployer
WLST

Interface
IDE
Web
Web

Command
line,
OS

scripts,
or
Ant

Manual/Automated
Manual
Manual
Manual
Both

Start
from
source
code
or
JAR/EAR
Source
JAR/EAR
JAR/EAR
JAR/EAR

Suitable
for
development
server
Yes
Yes
Yes
Yes

Suitable
for
test/produc=on
servers
Yes
Yes
Yes

Apply
WLS
deployment
plans
Yes
Yes
Yes
Yes

Apply
ADF/MBean
run=me
changes
Yes

Supports
WLS
produc=on
redeployment
Yes
Yes

weblogic.Deployer Command Line Example
// All on one line
java -classpath <wls_home>/wlserver_10.3/server/lib/weblogic.jar weblogic.Deployer
-adminurl t3://localhost:7101
-username weblogic
-password weblogic1
-name MyApp
-deploy /Dev/MyApp/deploy/MyApp.ear
-targets DefaultServer
01
02
03
04
05
06
07
08

weblogic.Deployer ANT Example
<path id="wldeploy.classpath">
<fileset dir="${wls_home}/wlserver_10.3/server/lib">
<include name="*.jar"/>
<exclude name="jrmp.jar"/>
<exclude name="jrmpclient.jar"/>
</fileset>
</path>
<taskdef name="wlsdeploy"
classpathref="wldeploy.classpath"
classname="weblogic.ant.taskdefs.management.WLDeploy"/>
<target name="deploy">
<wlsdeploy action="deploy" upload="true" verbose="true" usenonexclusivelock="true"
name="MyApp"
source="/Dev/MyApp/deploy/MyApp.ear"
adminurl="t3://localhost:7101"
user="weblogic"
password="weblogic1"
targets="DefaultServer"/>
</target>
01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
19

Program Agenda
–  WLST

WLST
•  Command line WLS scripting tool
•  Amongst other operations supports deployment
•  Provided in default WLS install

Deployment
Op,ons:
JDeveloper
WLS
console
FMW
console
weblogic.Deployer
WLST

Interface
IDE
Web
Web

Command
line,
OS

scripts,
or
Ant

Command
line,
OS

scripts,
or
Ant

Manual/Automated
Manual
Manual
Manual
Both
Both

Start
from
source
code
or
JAR/EAR
Source
JAR/EAR
JAR/EAR
JAR/EAR
JAR/EAR

Suitable
for
development
server
Yes
Yes
Yes
Yes
Yes

Suitable
for
test/produc=on
servers
Yes
Yes
Yes
Yes

Apply
WLS
deployment
plans
Yes
Yes
Yes
Yes
Yes

Apply
ADF/MBean
run=me
changes
Yes
Yes

Supports
WLS
produc=on
redeployment
Yes
Yes
Yes

WLST Command Line Example
// Run WLST via command line – open the WLST command line console
./<jdev_home>/oracle_common/common/bin/wlst.cmd
// Following can be saved as a Python script to be reexecuted
connect('weblogic','weblogic1','t3://localhost:7101')
edit()
startEdit()
deploy('MyApp','/Dev/MyApp/deploy/MyApp.ear', targets='DefaultServer')
save()
activate()
startApplication('MyApp')
01
02
03
04
05
06
07
08
09
10
11

WLST ANT Example
<path id="wlst.classpath">
<fileset dir="${wls_home}/wlserver_10.3/server/lib">
<include name="*.jar"/>
<exclude name="jrmp.jar"/>
<exclude name="jrmpclient.jar"/>
</fileset>
</path>
<taskdef name="wlst" classname="weblogic.ant.taskdefs.management.WLSTTask"
classpathref="wlst.classpath"/>
<target name="deploy">
<wlst debug="true" failonerror="true" classpathref="wlst.classpath"><script>
connect('weblogic','weblogic1','t3://localhost:7101')
edit()
startEdit()
deploy('MyApp','/Dev/MyApp/deploy/MyApp.ear', targets='DefaultServer')
save()
activate()
startApplication('MyApp')
</script></wlst>
</target>
01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
19
20

Program Agenda
–  WLST

Maven WLS Deployment Plug In
•  Previous automated options via Ant can be integrated into your CI engine
•  WLS also provides Maven a Deployment Plug In
•  Allows via pom.xml a WLS deployment to be a Maven goal
•  (More info pending dependent on research into the plug-in’s capabilities)

Conclusion
•  Automate, automate, automate

Further Reading
•  Deployment Automation Patterns http://bit.ly/VGOfdh
•  FMW Admin Guide http://bit.ly/TFRu73
•  FMW Admin Guide for ADF http://bit.ly/VJCiE8
•  WLST Guide http://bit.ly/TW8pRz
•  weblogic.Deployer Guide http://bit.ly/XdzMrg
•  Maven WLS Deploy Plug-in http://bit.ly/1f1oMV5
•  WLS production redeployment http://bit.ly/WnuVBc

Oracle ADF Architecture TV - Deployment - Deployment Options

Recommended

Recommended

More Related Content

What's hot

What's hot (20)

Similar to Oracle ADF Architecture TV - Deployment - Deployment Options

Similar to Oracle ADF Architecture TV - Deployment - Deployment Options (20)

Recently uploaded

Recently uploaded (20)

Oracle ADF Architecture TV - Deployment - Deployment Options