Deploying the Talent Matrix ADF Component

Contributors
o
o
o
o

Jabej Nerella
Pravin Kottawar
Jeet Bhawsar
Anima Prasad

Change History
Date

Author

Change Reference

14-October2015

Jabej Nerella

Published the initial version

25-May2016

Jeet Bhawsar

Updated content for R12.1 HRMS RUP9

30-May2016

Jeet Bhawsar

Updated content for R12.2 HRMS RUP8

Deploying the Talent Matrix ADF Component

Copyright 2016, Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions
on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in
your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast,
modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any
means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for
interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free.
If you find any errors, please report them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it
on behalf of the U.S. Government, the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated
software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government
end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation
and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and
adaptation of the programs, including any operating system, integrated software, any programs installed
on the hardware, and/or documentation, shall be subject to license terms and license restrictions
applicable to the programs. No other rights are granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management
applications. It is not developed or intended for use in any inherently dangerous applications, including
applications that may create a risk of personal injury. If you use this software or hardware in dangerous
applications, then you shall be responsible to take all appropriate failsafe, backup, redundancy, and other
measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any
damages caused by use of this software or hardware in dangerous applications.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks
of their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks
are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD,
Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of
Advanced Micro Devices. UNIX is a registered trademark of The Open Group.
This software or hardware and documentation may provide access to or information about content,
products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and
expressly disclaim all warranties of any kind with respect to third-party content, products, and services
unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its
affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of
third-party content, products, or services, except as set forth in an applicable agreement between you and
Oracle.

Deploying the Talent Matrix ADF Component

Contents
Deploying the Talent Matrix ADF Component .............................................................................................. 1
Contributors .................................................................................................................................................. 2
Change History .............................................................................................................................................. 2
Contents ........................................................................................................................................................ 4
1.

Prerequisites: ........................................................................................................................................ 5

2.

Prepare the Deployment File ................................................................................................................ 5

3.

Create a Weblogic Server Domain ........................................................................................................ 6

4.

Creating Data Source in the Oracle WebLogic Domain Console......................................................... 11

5.

Deploying the Application on the WebLogic Server ........................................................................... 16

6.

Setting Talent Matrix Profile Options and Testing the Application: ................................................... 20

7.

Common Errors ................................................................................................................................... 20

Deploying the Talent Matrix ADF Component

1. Prerequisites:
Ensure the following Prerequisites are satisfied:

Your instance is at any one of the release levels or above:

o

Oracle E-Business Suite R12.2.5 or above

R12.1 HRMS RUP9 or above

R12.2 HRMS RUP8 or above

You are on ADF version 11.1.1.7.

The following profiles are available in your system:

o

FND_SERVER_SEC

FND_SERVER_IP_SEC

FND_SERVER_DESKTOP_USER

If these profile options do not exist in your system, then apply Patch 12715586
SEEDING MISSING FND_SERVER* PROFILES INTO R12 (compatible with
R12.FND.B). Note that AOLJ patch#12715586 is EBS mid-tier patch and is release
dependent.
If these profile options exist in your system, then there is no need to apply the patch.
For more details on these profile options, please refer to Note 946372.1 Secure
Configuration of E-Business Suite Profiles.

2. Prepare the Deployment File

o

Download the patch for Talent Matrix mentioned in the Document ID: 2049909.1
from My Oracle Support. Unzip the patch zip file. The zip file contains per_nbox.zip,
which contains file Nbox_application1.ear.

Unzip the per_nbox.ear file, you will find

SuccessionPlan_9Box_Project1_webapp.war file.

Unzip the war file and open WEB-INF\web.xml file in text editor.

Change the param-value for APPL_SERVER_ID with instance server id. If the tag contextparam is not there, add one.
<context-param>
<param-name>APPL_SERVER_ID</param-name>

Deploying the Talent Matrix ADF Component

<param-value>[Enter the value here]</param-value>

</context-param>

How to get the server id?

Connect to the database of respective instance and run the following query.
select SERVER_ID from fnd_nodes where node_name <>
'AUTHENTICATION';
o

Place this value in above web.xml

Zip the folder and rename it to .war file again.

Zip the folder and rename it to .ear file again.

Tip: If 7-Zip software is installed, you can directly edit web.xml file without
Unzipping and zipping the file. Steps Open archive for ear file, again same for
war file, open WEB-INF and right click on web.xml and Edit to change the
parameter and save.

Move the ear file into server machine

o
o
o

You can use WinSCP or any ftp application to move the .ear file to the weblogic
server machine.
Create/Start the Weblogic Server
Connect to the environment where Weblogic Server is installed using ssh as below.
ssh l <username> <server>

3. Create a Weblogic Server Domain

o

It is recommended to use different WLS server than the one that comes with EBS in
order to minimize the impact of online patching on the Talent Matrix feature. You can
download the weblogic server (10.3.6) from MOS.
Note: Whenever you apply any patch that contains any fix on per_nbox.zip, the
changes will not take effect until you deploy the ear file on the respective domain.

Install the WLS server.

Navigate to the Weblogic server home directory and change directory to

<wlserver_version>/common/bin
Eg: cd /u01/R122_EBS/fs1/FMW_Home/wlserver_10.3/common/bin

Run config.sh Eg ./config.sh

Deploying the Talent Matrix ADF Component

Select Create a new WebLogic domain

Select the two products starting with Oracle JRF.

Deploying the Talent Matrix ADF Component

Enter the domain name and location.

Enter the Administrator username and password.

Deploying the Talent Matrix ADF Component

Select the server start mode.

Select the Administration server.

Deploying the Talent Matrix ADF Component

Enter port numbers

Note: SSL needs to be enabled when configuring for an Oracle E-Business Suite
instance, which uses https protocol.
o

Click Create.

Start the Application Server.

Navigate to user_projects/domains/<domain_name>
Start the server nohup ./startWebLogic.sh &

Deploying the Talent Matrix ADF Component

 You can read the log data from nohup.out file as shown in the following
screenshot using the command tail f nohup.out:
Find the message Server started in RUNNING mode to know that the server
started successfully.

4. Creating Data Source in the Oracle WebLogic Domain

Console
o

Please refer to the My Oracle Support Note 974949.1 for details about the
AppsDataSource and on how to configure it in the chapter Using Oracle E-Business
Suite DataSources. The sections that are to be followed from the note for this
chapter are:
2.1.2. Register the External Node and Generate the Desktop DBC File
2.1.3. Set Up Necessary Oracle E-Business Suite Users
2.1.5. Configuring AppsDataSource on Oracle WebLogic Server (WLS)

Once the server is in running mode, launch the Oracle WebLogic Administration
Console for your application server using URL like this one:
http://<your host>:<your port>/console
e.g: rws3220111.us.oracle.com:7001/console

Deploying the Talent Matrix ADF Component

Navigate to Domain Structure->Services ->Data Sources

Click on the New button for Data Sources and select Generic Data Source

Name for the datasource AppsDS

JNDI Name - jdbc/AppsDS

Database Type - Oracle

Click Next.

Deploying the Talent Matrix ADF Component

Set the Database Driver:

Select "Oracle's Driver (Thin) for Instance connections; Versions:9.0.1 and later".

Click Next.

The database administrator must decide the database driver to be used depending on their
database type.

Deploying the Talent Matrix ADF Component

Deploying the Talent Matrix ADF Component

Uncheck the Supports Global Transactions check box.

Click Next.

Enter following information for Connection Property:

o

Database Name: (SID of Oracle E-Business Suite database)

Hostname (DB hostname)

Port (DB port)

DB username - apps

Password for the Oracle E-Business Suite user. (For QA instance the
password for apps user should come from QA).

Confirm the password and click Next.

The Driver class name should be oracle.jdbc.OracleDriver when apps user is used.

Click on Test Configuration to test the data source.

If Successful, we will get a message stating Connection has succeeded.

Click Next.

Select the check box for the appropriate target server (AdminServer) and click on
Finish.
Note: If the password for apps user is not provided then enter a user who has Apps
Schema Connect role.

Deploying the Talent Matrix ADF Component

5. Deploying the Application on the WebLogic Server

o

Navigate to Domain Structure->Environments->Deployments and click the "Install"

button.
Follow the steps as shown in these screenshots:

Enter the location of your application .ear file.

Give location where the ear file which is extracted from the patch is ftped to web
logic server.
Note: This is the location where you stored the .ear file after the last step from the
step Preparing the deployment file.
Select the ear file and then click "Next".

Deploying the Talent Matrix ADF Component

Select "Install this deployment as an application", and click Next.

Select the Target Server and click Next.

Deploying the Talent Matrix ADF Component

Click the "Next" button.

Deploying the Talent Matrix ADF Component

Click the Finish button.

Navigate to Domain Structure-> Deployments and verify the application deployment

is active.

Deploying the Talent Matrix ADF Component

Once ear is deployed and is active to be sure that there is no issue from WLS end.

6. Setting Talent Matrix Profile Options and Testing the

Application:
o

Log in to the application and set the Profile External ADF Application URL at site
level.

Value must be in the below format:- https://<host>:<port>/

host:port value will be available in the weblogic console link.

e.g:- http://rws3220xyz.com:7010/

Set the profile Option SP: Use Talent Matrix to Yes

Once the profile is set, clear the Cache and navigate to Succession Planning
Responsibility-> Succession planning- > Talent Matrix tab.

7. Common Errors
o

NoClassDefFoundError
java.lang.NoClassDefFoundError: oracle/binding/DataControl
Bounce the Weblogic server of adf domain, our deployed application is not
compiled properly, so we need to bounce once to get all the class file are
created.

ADFContext (Error 500--Internal Server Error)

Deploying the Talent Matrix ADF Component

oracle.jbo.DMLException: JBO-29114 ADFContext is not setup to process messages for

this exception. Use the exception stack trace and error code to investigate the root
cause of this exception. Root cause error code is JBO-27200. Error message
parameters are {0=Data Source, 1=java:comp/env/jdbc/AppsDS}
at
oracle.jbo.server.DBTransactionImpl.lookupDataSource(DBTransactionImpl.java:1491)
There is a problem with Datasource configuration in weblogic, check the AppsDS
Datasource is created and working properly. Also check for Target is selected for
Datasource.
o

XML File not found (Error 500--Internal Server Error)

oracle.jbo.NoXMLFileException: JBO-26001: XML File not found for the Container
/null.cpx
at oracle.jbo.mom.MOMParserNonMDS.parse(MOMParserNonMDS.java:134)
at
oracle.jbo.mom.MOMParserNonMDS.readAndParse(MOMParserNonMDS.java:63)

This is because the PATH and CLASSPATH env variables contain paths leading to the
Oracle E-Business Suite installation are under the same user. Unset these env variables
and set them to default ones and restart the WebLogic server.

Deploying the Talent Matrix ADF Component