to the recent release of Oracle JDeveloper 12c and ADF 12c, many developers
and ISVs would want to migrate to the new version. Therefore let’s take a look
on the deployment of ADF 12c in production domain.
In this post I
would like to cover simple use case of deployment sample ADF 12c
production domain. In order to do this it is necessary to have the following
components: Application Development Runtime (12.1.2), Oracle Database 11g Express Edition (NOT CERTIFIED, but
suitable for our sample, for enterprise production or development environments
it will be needed Oracle DB SE One, SE or EE)
and JDK 7.
links for products distributives you could find bellow:
our example we will demonstrate deployment process in MS Windows OS environment.
are also some useful links bellow, which could be interesting:
would like to pay attention to the following important facts:
following self-extracting installer JARs are available:
our case we will go through shortest way using only ADR installer.
consider the whole process step by step:
Stage 1: JDK installation.
our case we use Java SE version 7u25. But it is possible to use
also Oracle JRockit JVM.
Stage 2: Oracle Database XE
installation is necessary stage, as in addition to application specific data, you
should install the metadata schemas on a database which certified for this
release of Oracle Fusion Middleware.
NOTE: It is important to
know that Oracle Database XE 11g is NOT certified for FMW 12c infrastructure. In this case it will
be used for sample purposes. For FMW 12c certified the following
versions of Oracle Database: 126.96.36.199+; 188.8.131.52+; 184.108.40.206+. Please, be
familiar with Oracle
Fusion Middleware 12c (220.127.116.11.0) Certification Matrix.
Stage 3: Fusion Middleware
the command prompt use the following command:
NOTE: For Mac OS X environment use the following command:
/usr/libexec/java_home --version 1.7.0 --exec java -jar ./fmw_infra_121200.jar
look at the key aspects of installation process:
2) On 4th
step of installation wizard be aware, that all prerequisite checks
have been completed successfully.
3) Finish the installation process.
schemas creation by RCU utility.
should start RCU with the following command:
NOTE: For Mac OS X environment before running RCU use the following commands:
bin $ export DISPLAY=:0
bin $ export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.7.0_21.jdk/Contents/Home
bin $ ./rcu
could get more information about RCU utility in the «Creating
Schemas with the Repository Creation Utility» guide:
launching RCU utility you might get an error that OS cannot found JRE
location directory. You could fix this issue by the following way:
look at the key points of this stage:
1) On the 2nd
step of configuration wizard you should specify Database Connection
this, click Next button and the utility will make all the necessary
checks and report about database incompatibility. Click Ignore here
to continue process.
2) On the 3rd
step of configuration wizard, you should specify schemas prefix and
check AS Common Schemas in the components tree:
3) On the 4th
step of configuration wizard, you should specify passwords for schemas:
4) On the 5th
step of configuration wizard, RCU makes tablespaces
configurations. You could change default values here:
5) After the
completion of the 6th step of configuration wizard, click the
Stage 5: Domain deployment and
order to configure domain we will use Configuration Wizard utility:
order to start wizard you should execute the following command:
look at the key points of this stage:
1) On the 2nd
step of configuration wizard, check the following options in Available Templates
2) On the 5th
step of configuration wizard, specify Production Mode and leave and JDK
path the same:
3) On the 6th
step of configuration wizard, specify DB connection parameters, and RCU
service table (STB) schema credentials. Click Get RCU Configuration
and ensure that Connection Result Log is OK. Click Next.
4) On the 9th
step of configuration wizard, check Administration Server, Managed
servers, clusters and coherence options. We will configure its later. Click
5) On the 11th
step of configuration wizard, click Add button in order to add managed
server and specify it name as ADFManagedServer. Leave other parameters
with its default values and click Next.
6) On the 14th
step of configuration wizard, click Add button to add machine as ADFMachine
and then click Next.
7) On the 15th
step of configuration wizard, target AdminServer and ADFManagedServer
to ADFMachine and click Next.
8) On the 16th
step of configuration wizard, click Create button and wait until
wizard will create and configure domain. Click Finish after this.
9) Domain creation
now has been completed.
Stage 6: Additional configuration of
the domain and other components.
command below and run AdminServer:
During the domain configuration process, we specified Production mode,
so in our case you need to input weblogic account credentials to
run AdminServer. After this wait until AdminServer goes to state RUNNING.
Navigate to WebLogic Administartion Console, on URL:
Log in using weblogic account.
In our configuration we will not use SSL encryption in the Node
Manager configuration. So in order to use Plain type let’s
make the following steps:
1) Go in the Domain Structure tree to Machines
node. Click on our ADFMachine and go to the Node Manager
tab. Click Lock & Edit to edit current configuration and select Plain value
of Type parameter. Click Save и Activate
Changes in order to save current configuration.
2) Open nodemanager.properties file located in the
following path in the text editor:
Edit SecureListener parameter,
and specify it value as false.
3) Run Node Manager service, using the following
4) Restart AdminServer and ensure that the Node Manager is
available and has Reachable status. You could check it in Monitoring tab
and Node Manager Status tab inside it.
Stage 7: Targeting
JRF libraries on managed servers.
For regular ADF Application with working Enterprise Manager
Fusion Middleware Control, it is necessary, to target JRF (Java
Required Files) libraries on managed servers.
1) Navigate to Enterprise Manager Console, using URL:
in, using weblogic account.
2) Find out single managed server (in our case) ADFManagedServer
in components tree. Click Apply JRF Templates button. Wait until
the operation is complete. Targeting libraries is complete now.
3) Now it is necessary to run our managed server. Select Control -> Start
Up in the context menu of managed server. Wait until the process is
4) Ensure that AdminServer and all managed servers (in our
case it is one server) are running (has RUNNING stage). You could
do this, for example, in the WebLogic Administration Console.
Stage 8: Applications
deployment and domain testing.
So all necessary
procedures are complete and our sample domain is ready for ADF applications
deployment. You could simply deploy your applications using WebLogic
Administration Console or Enterprise Manager Fusion Middleware Console
and you are ready!
Russian-speaking readers could find this article on Russian language in Middleware Technology blog for Russian developer’s community.