Deploying the Talent Matrix Oracle Applications

Development Framework (ADF) Component

ORACLE WHITE PAPER | AUGUST 2019
Overview
Talent Matrix is a flexible and configurable tool that helps enterprises to define succession planning dimensions
according to their business requirements. To assess succession potential of their workforce, plan administrators can
create different talent matrix templates for use in their enterprise, based on the delivered talent matrix types and
combinations of X and Y axes dimensions.

Important: The Talent Matrix tool is not displayed in the application, by default. If required, system administrators
must enable this tool by completing additional implementation steps. For more information, see: Enabling Talent
Matrix, Oracle Succession Planning Implementation and User Guide.

Oracle Succession Planning provides the following default templates to display talent matrixes in the nine-box
format:

• Default Retention vs. Impact of Loss

• Default Performance vs. Potential
• Default Performance vs. Retention
These templates are of 3*3 matrix type. These nine box matrixes are built on Oracle Applications Development
Framework (ADF).

Deployment Steps for Talent Matrix in an Oracle WebLogic Server (WLS)

Before you enable Talent Matrix in Oracle Succession Planning and start using the default matrix templates, you
must complete deployment steps in an Oracle WebLogic Server (WLS) instance. This document provides
information about the deployment steps.

1. Completing Prerequisites
1. Ensure that the following prerequisites are satisfied:
2. Your instance is at any one of the release levels or above:
a. Oracle E-Business Suite R12.2.5 or above
b. R12.1 HRMS RUP9 or above
c. R12.2 HRMS RUP8 or above
3. You are on ADF version 11.1.1.7.
4. The following profiles are available in your system:
o FND_SERVER_SEC
o FND_SERVER_IP_SEC
o 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 the 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, refer to Note 946372.1 “Secure Configuration of E-Business Suite Profiles”
on My Oracle Support.

2. Preparing the Deployment File

1 | DEPLOYING THE TALENT MATRIX ORACLE APPLICATIONS DEVELOPMENT FRAMEWORK (ADF) COMPONENT
 1. 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.
2. Unzip the per_nbox.ear file, which contains the SuccessionPlan_9Box_Project1_webapp.war file.
3. Unzip the war file and open WEB-INF\web.xml file in text editor.
4. Change the param-value for APPL_SERVER_ID with instance server id. If the tag context-param is not
there, add one.
<context-param>

<param-name>APPL_SERVER_ID</param-name>

<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';
1. Place this value in above web.xml
2. Zip the folder and rename it to .war file again.
3. 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 web.xml and edit to change the
parameter and save.

Move the ear file into server machine

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

3. Creating a Weblogic Server Domain

It is recommended to use different WLS server than the one that comes with EBS 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.

1. Install the WLS server.

2. Navigate to the Weblogic server home directory and change directory to <wlserver_version>/common/bin.
For example: cd /u01/R122_EBS/fs1/FMW_Home/wlserver_10.3/common/bin.
3. Run config.sh. For example, ./config.sh
4. Select Create a new WebLogic domain.

2 | DEPLOYING THE TALENT MATRIX ORACLE APPLICATIONS DEVELOPMENT FRAMEWORK (ADF) COMPONENT
 5. Select the two products starting with ‘Oracle JRF’.

6. Enter the domain name and location.

3 | DEPLOYING THE TALENT MATRIX ORACLE APPLICATIONS DEVELOPMENT FRAMEWORK (ADF) COMPONENT
 7. Enter the Administrator username and password.

4 | DEPLOYING THE TALENT MATRIX ORACLE APPLICATIONS DEVELOPMENT FRAMEWORK (ADF) COMPONENT
 8. Select the server start mode.

9. Select the Administration server.

5 | DEPLOYING THE TALENT MATRIX ORACLE APPLICATIONS DEVELOPMENT FRAMEWORK (ADF) COMPONENT
 10. Enter port numbers.

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

11. Click Create.

12. Start the Application Server.

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

6 | DEPLOYING THE TALENT MATRIX ORACLE APPLICATIONS DEVELOPMENT FRAMEWORK (ADF) COMPONENT
 15. You can read the log data from nohup.out file as shown in the following screenshot using the command
‘tail –f nohup.out’:
16. 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

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)

1. 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

For example: rws3220111.us.oracle.com:7001/console

7 | DEPLOYING THE TALENT MATRIX ORACLE APPLICATIONS DEVELOPMENT FRAMEWORK (ADF) COMPONENT
 2. Navigate to Domain Structure->Services ->Data Sources.

3. Click the New button for Data Sources and select Generic Data Source
o Name for the datasource – AppsDS
o JNDI Name - jdbc/AppsDS
o Database Type - Oracle
4. Click Next.

8 | DEPLOYING THE TALENT MATRIX ORACLE APPLICATIONS DEVELOPMENT FRAMEWORK (ADF) COMPONENT
 5. Set the Database Driver:
6. Select "Oracle's Driver (Thin) for Instance connections; Versions:9.0.1 and later".
7. Click Next.
The database administrator must decide the database driver to be used depending on their database type.

9 | DEPLOYING THE TALENT MATRIX ORACLE APPLICATIONS DEVELOPMENT FRAMEWORK (ADF) COMPONENT
10 | DEPLOYING THE TALENT MATRIX ORACLE APPLICATIONS DEVELOPMENT FRAMEWORK (ADF) COMPONENT
 1. Uncheck the Supports Global Transactions check box.
2. Click Next.
3. Enter following information for Connection Property:
a. Database Name: (SID of Oracle E-Business Suite database)
b. Hostname (DB hostname)
c. Port (DB port)
d. DB username - apps
e. Password for the Oracle E-Business Suite user. (For QA instance the password for apps user
should come from QA).
4. Confirm the password and click Next.
5. The Driver class name should be ‘oracle.jdbc.OracleDriver’ when ‘apps’ user is used.
6. Click Test Configuration to test the data source.
7. If Successful, a is displayed message stating Connection has succeeded.
8. Click Next.
9. Select the check box for the appropriate target server (AdminServer) and click Finish.

Note: If the password for apps user is not provided, then enter a user who has Apps Schema Connect role.

5. Deploying the Application on the Oracle WebLogic Server

1. Navigate to Domain Structure->Environments->Deployments and click the "Install" button.
2. Follow the steps as shown in these screenshots:

3. Enter the location of your application .ear file.

11 | DEPLOYING THE TALENT MATRIX ORACLE APPLICATIONS DEVELOPMENT FRAMEWORK (ADF) COMPONENT
 4. Give location where the ear file which is extracted from the patch is ftped to the 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’.

1. Select the ear file and then click "Next".

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

12 | DEPLOYING THE TALENT MATRIX ORACLE APPLICATIONS DEVELOPMENT FRAMEWORK (ADF) COMPONENT
 3. Select the Target Server and click Next.

4. Click the Next button.

13 | DEPLOYING THE TALENT MATRIX ORACLE APPLICATIONS DEVELOPMENT FRAMEWORK (ADF) COMPONENT
 5. Click the Finish button.

14 | DEPLOYING THE TALENT MATRIX ORACLE APPLICATIONS DEVELOPMENT FRAMEWORK (ADF) COMPONENT
 6. Navigate to Domain Structure-> Deployments and verify the application deployment is active.

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

15 | DEPLOYING THE TALENT MATRIX ORACLE APPLICATIONS DEVELOPMENT FRAMEWORK (ADF) COMPONENT
6. Setting Talent Matrix Profile Options and Testing the Application
1. Log in to the application and set the Profile “External ADF Application URL” at site level.
2. Value must be in the below format:- https://<host>:<port>/
3. host:port value will be available in the weblogic console link.
For example:- http://rws3220xyz.com:7010/
4. 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. Resolving Common Errors

• 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)

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.

• 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.

16 | DEPLOYING THE TALENT MATRIX ORACLE APPLICATIONS DEVELOPMENT FRAMEWORK (ADF) COMPONENT
 Oracle Corporation, World Headquarters Worldwide Inquiries
500 Oracle Parkway Phone: +1.650.506.7000
Redwood Shores, CA 94065, USA Fax: +1.650.506.7200

CONNECT W ITH US

blogs.oracle.com/oracle
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. This document is provided for information purposes only, and the
contents hereof are subject to change without notice. This document is not warranted to be error-free, nor subject to any other
facebook.com/oracle warranties or conditions, whether expressed orally or implied in law, including implied warranties and conditions of merchantability or
fitness for a particular purpose. We specifically disclaim any liability with respect to this document, and no contractual obligations are
formed either directly or indirectly by this document. This document may not be reproduced or transmitted in any form or by any
twitter.com/oracle means, electronic or mechanical, for any purpose, without our prior written permission.

oracle.com 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. 0819

Deploying the Talent Matrix Oracle Applications Development Framework (ADF) Component
AUGUST 2019
Author: Jabej Nerella, Pravin Kottawar, Jeet Bhawsar

17 | DEPLOYING THE TALENT MATRIX ORACLE APPLICATIONS DEVELOPMENT FRAMEWORK (ADF) COMPONENT