Organization Chart Configuration – Version R12.2.

Author:
Creation Date: September 04, 2014
Last Update:
Version: 1.0

Page 1 of 48 Organization Chart Configuration

 Installation and Configuration Steps: Organization Chart

Data Source Deployment

Weblogic Weblogic Creation - of
ADF Runtime
Server Domain From Organization
Installation
Installation Creation Weblogic to Chart on
EBS Weblogic

Step 1: Weblogic Server Installation: Download the weblogic server (10.3.6) software using below link

http://www.oracle.com/technetwork/middleware/weblogic/downloads/wls-main-097127.html

Step 2: ADF Runtime Installation: Download ADF (11.1.1.7) software using below link

http://www.oracle.com/technetwork/developer-tools/adf/downloads/index.html?ssSourceSiteId=otnes

Step 3: Weblogic domain creation

Step 4: Data source creation in weblogic so that communication from weblogic to EBS will be successful

Step 5: Deployment of Organization Chart on weblogic

Step 6: Test Organization Setup

Page 2 of 48 Organization Chart Configuration

Step 1: Weblogic (10.3.6) Server Installation

1.1: Use below command to install weblogic 10.3.6

For Linux x86_64 bit Platform :

$ java -d64 -Xmx1024m -jar wls1036_generic.jar

Click “Next”

Page 3 of 48 Organization Chart Configuration

1.2: Click “Next” with selection: Create a new Middleware Home

1.3: If server is having Internet Connection and you wish to receive security updates then provide “My
Oracle Support” email address/username and password to receive security updates via “My Oracle
Support”

Page 4 of 48 Organization Chart Configuration

1.4: In case server doesn’t have internet connection or you choose to remain uninformed of critical security
issues (Example: For Internal Learning Purpose) then uncheck “I wish to receive security updates via My
Oracle Support” and click “Next”

1.5: Click “Yes” to proceed with warning

Page 5 of 48 Organization Chart Configuration

1.6: Click “Next”

1.7: Click “Yes”

Page 6 of 48 Organization Chart Configuration

1.8: Click “Yes”

1.9: Click Checkbox: “I wish to remain uninformed of security issues in my configuration or this machine
has no internet access” and click “Continue”

Page 7 of 48 Organization Chart Configuration

1.10: Select “Typical” Install Type and then click “Next”

1.11: Select appropriate JDK location and then click “Next”

Page 8 of 48 Organization Chart Configuration

1.12: Click “Next”

1.13: Click “Next”

Page 9 of 48 Organization Chart Configuration

1.14: Installation is in progress

1.15: Installation complete

Click “Done”

Page 10 of 48 Organization Chart Configuration

Step 2: ADF Runtime Installation: ADF (11.1.1.7) software

2.1: Use below command to install ADF (11.1.1.7)

For Linux x86_64 bit Platform :

$ ./runInstaller

Page 11 of 48 Organization Chart Configuration

2.2: Click “Next”

2.3: If server is having Internet Connection then provide “My Oracle Support” User Name and Password to
"Search My Oracle Support for Updates"

Page 12 of 48 Organization Chart Configuration

2.4: In case server doesn’t have internet connection then choose option "Skip Software Updates (Example:
For Internal Learning Purpose) and click “Next”

2.5: Click “Next”

Page 13 of 48 Organization Chart Configuration

2.6: Click “Next”. Please make sure that correct “Oracle Middleware Home” is selected

2.7: Click “Next” with “Weblogic Server” option selected

Page 14 of 48 Organization Chart Configuration

2.8: Installation Summary  Click on “Install”

2.9: Installation is in progress

Page 15 of 48 Organization Chart Configuration

2.10: Installation Successful  Click “Next”

2:11: Installation Complete  Click “Finish”

Page 16 of 48 Organization Chart Configuration

Step 3: Weblogic domain creation

3.1: Use below command to create weblogic domain

$. ./config.sh

Page 17 of 48 Organization Chart Configuration

3.2: Select “Create a new Weblogic domain” and click “Next”

3.3: Select “Oracle Enterprise Manager – 11.1.1.0 [oracle_common]” and “Oracle JRF - 11.1.1.0
[oracle_common]. Click “Next”

Page 18 of 48 Organization Chart Configuration

3.4: Enter Domain name: Example: FMW11gR1Domain

3.5: Enter weblogic password: Example: Welcome@1. Click “Next”

Page 19 of 48 Organization Chart Configuration

3.6: Select WebLogic Domain Startup Mode as “Development Mode” and click “Next”

3.7: Select “Administration Server” and click “Next”

Page 20 of 48 Organization Chart Configuration

3.8: Enter “Administration Server Name”: Example: “FMW11gR1AdminServer”. Click “Next”

3.9: Click “Create” to create weblogic domain

Page 21 of 48 Organization Chart Configuration

3.10: Creating Domain is in progress

3.11: Domain creation successful. Click “Done”

Page 22 of 48 Organization Chart Configuration

Step 4: Datasource creation in weblogic so that communication from weblogic to EBS will be successful.

A. Register “External Node” and generate the “Desktop DBC File” (If EBS Instance and weblogic server
is running on same server then this step is not required)
B. Set up necessary “Oracle E-Business Suite Users” (If using “apps” user then this step is not required)
C. Configuring AppsDataSource on oracle weblogic server (WLS)

A. Register “External Node” and generate “Desktop DBC File”

4.1: Login to EBS Instance: “Telnet Session” and run the below command:

To register the external server with Oracle E-Business Suite instance, system administrator should run
the following command, passing the name of the external application server node.

java oracle.apps.fnd.security.AdminDesktop <apps user>/<apps pwd> \

CREATE \
NODE_NAME=<node name of the external application server> \
[IP_ADDRESS=<IP address of external application server> \
DBC=<full name and path of existing standard dbc_file>

Example:

java oracle.apps.fnd.security.AdminDesktop apps/apps \

CREATE \
NODE_NAME= -in2.idc.oracle.com \
IP_ADDRESS=1 7\
DBC= upg122.dbc

Page 23 of 48 Organization Chart Configuration

B. Set up necessary “Oracle E-Business Suite Users”

4.2: Login to EBS Instance using SYSADMIN user and navigate to System Administrator  Security  User
 Define  Create a user named “WEBLOGIC”  Save the record.

4.3: The authorization to connect to the Oracle E-Business Suite database is determined by the role
UMX|APPS_SCHEMA_CONNECT. A user that has this role will be authorized to connect to the Oracle E-
Business Suite database.

Please assign role “UMX|APPS_SCHEMA_CONNECT” to “WEBLOGIC” user.

Login to EBS Instance using “SYSADMIN” user and navigate to responsibility “User Management” 
Users  Query for user “WEBLOGIC”  Click on “Update” icon Click on “Assign Roles” button 
Select search by “Code” and search “UMX|APPS_SCHEMA_CONNECT”  Select
“UMX|APPS_SCHEMA_CONNECT” Enter justification as “To Setup Organization Chart” and click on
Apply.

Page 24 of 48 Organization Chart Configuration

4.4: Run concurrent program “Workflow Background Process” as per below confirmation message:

Updates to Role data will not be visible in the application until the following processes are started:
Workflow Background Engine

4.5: Navigate to System Administrator  Requests  Run  Run “Workflow Background Process” with
below parameters and make sure that it is successfully completing.

Page 25 of 48 Organization Chart Configuration

C. Configuring AppsDataSource on Oracle WebLogic Server (WLS)

4.6: ftp below files to weblogic server:

i. upg122_ -IN2.IDC.ORACLE.COM.dbc (From $FND_SECURE directory of EBS Instance)
ii. per_orgchart.zip (From $PER_TOP/patch/115/ear directory of EBS Instance)

If you plan to use the Oracle E-Business Suite Java Authentication and Authorization Service (JAAS)
feature on Oracle WebLogic Server, you must rebuild the fndext.jar file on the target Oracle WebLogic
Server instance first, instead of using the fndext.jar file exactly as it comes from the per_orgchart.zip. If
you are using other fndext.jar features, such as AppsDataSource or Oracle E-Business Suite lightweight
error logging, but you do not plan to use the Oracle E-Business Suite JAAS implementation, rebuilding
the fndext.jar file is optional but strongly recommended. Rebuilding the file will not affect those
features, but it will make implementation and maintenance simpler to already have the rebuilt file in
place if you decide to use JAAS later.

For detailed information about JAAS, please follow the below blog URL:

https://blogs.oracle.com/stevenChan/entry/java_authentication_authorization_services_jaas_for_ebs

https://blogs.oracle.com/ebusinesssuiteintegration/entry/jaas_for_ebusiness_suite

Note that you will need to rebuild the fndext.jar file (and put the rebuilt file in the correct locations) any
time you install a patch that includes a new version of the fndext.jar file or a new version of oracle
Weblogic Server.

Page 26 of 48 Organization Chart Configuration

Rebuilding the fndext.jar file for Oracle WebLogic Server on UNIX/LINUX (Optional Step):

4.7: Set up the Weblogic domain environment

4.8: Copy “fndext.jar” to a new temporary directory named: “/home/applprod/122OrgChart/rebuild”

4.9: Unzip fndext.jar in directory “/home/applprod/122OrgChart/rebuild” and then delete fndext.jar

Page 27 of 48 Organization Chart Configuration

4.10: Copy $WL_HOME/server/lib/commo.dtd in directory “/home/applprod/122OrgChart/rebuild”

4.11: Run the following Java commands from “/home/applprod/122OrgChart/rebuild”

$ java -DMDF=/home/applprod/122OrgChart/rebuild/ExtAuthenticator.xml \
-Dfiles=/home/applprod/122OrgChart/rebuild \
-DcreateStubs="true" \
weblogic.management.commo.WebLogicMBeanMaker

$ java -DMDF=/home/applprod/122OrgChart/rebuild/ExtAuthOnlyAuthenticator.xml \
-Dfiles=/home/applprod/122OrgChart/rebuild \
-DcreateStubs="true" \
weblogic.management.commo.WebLogicMBeanMaker

Page 28 of 48 Organization Chart Configuration

4.12: From “/home/applprod/122OrgChart/rebuild”, run

$ mv oracle/apps/fnd/ext/jaas/weblogic/*.java .

4.13: Change to the parent directory

$ cd ..

And from the “/home/applprod/122OrgChart /” directory, run the Java commands

$ java -classpath /home/applprod/122OrgChart/rebuild:$CLASSPATH \

-DMJF=/home/applprod/122OrgChart/rebuild/fndext.jar \
-Dfiles=/home/applprod/122OrgChart/rebuild \
weblogic.management.commo.WebLogicMBeanMaker

Page 29 of 48 Organization Chart Configuration

Page 30 of 48 Organization Chart Configuration
4.14: Now we have a new fndext.jar file in “/home/applprod/122OrgChart/rebuild”. Unzip the file and
ensure that the jar has the following directory structure:

• META-INF
• oracle
• schemacom_bea_xml
• weblogic
• commo.dtd
• ExtAuthOnlyAuthenticator.xml
• ExtAuthenticator.xml

4.15: Make sure that weblogic server is down. Copy fndext.jar file to the $DOMAIN_DIR/lib subdirectory of
the managed server in the external node (where Oracle Weblogic Server will be running). For example:
“/home/applprod/Oracle/Middleware/user_projects/domains/FMW11gR1Domain/lib”

Page 31 of 48 Organization Chart Configuration

4.16: Now Add the below in “setDomainEnv.sh” so that it oracle weblogic server appends JAR files found in
the lib directory to the system classpath. By default it adds the file to the end of the CLASSPATH.

CLASSPATH="${LONG_DOMAIN_HOME}/lib/fndext.jar${CLASSPATHSEP}${CLASSPATH}"
export CLASSPATH

Save the file.

4.17: Start weblogic server

Page 32 of 48 Organization Chart Configuration

Step 5 : Deployment of Organization Chart on Weblogic

5.1: Login to weblogic server: http:// -in2.idc.oracle.com:7001/console/

User Name: weblogic

Password: Welcome@1

From Left Pane: Domain Structure: Services  Data Sources  Click “New” and select “Generic Data
Source”

5.2: Please input below parameter value and click “Next”

Name : AppsDS
JNDI Name: jdbc/AppsDS
Database Type : Oracle

Page 33 of 48 Organization Chart Configuration

5.3: Select Database Driver as “Oracle's Driver (Thin) for Instance connections; Versions:9.0.1 and later”
and Click on “Next”

5.4: Uncheck “Supports Global Transactions” and click “Next”

Page 34 of 48 Organization Chart Configuration

5.5: Please input below parameter value and click “Next”

A. What is the name of the database you would like to connect to? : EBS Instance SID
B. What is the name or IP address of the database server? : EBS Instance Hostname or IP Address
C. What is the port on the database server used to connect to the database? EBS Database Port
D. What database account user name do you want to use to create database connections? : EBS
Username having role “UMX|APPS_SCHEMA_CONNECT” or “apps” user
E. Password: Password of username input as per “D”.

Page 35 of 48 Organization Chart Configuration

5.6: Please input below parameter value and click “Test Configuration” and connection should be
successful.

A. What is the full package name of JDBC driver class used to create database connections in the
connection pool? oracle.apps.fnd.ext.jdbc.datasource.AppsDataSource
B. What is the URL of the database to connect to? The format of the URL varies by JDBC driver. Will be
picked automatically from previous screen
C. What database account user name do you want to use to create database connections? Will be
picked automatically from previous screen
D. What is the database account password to use to create database connections? Will be picked
automatically from previous screen
E. Properties: In the Properties field, add a new property after the user property:

dbcFile=<full path of your desktop DBC file>

For example:
dbcFile=/home/applprod/122OrgChart/upg122_NRAGAVAR-IN2.IDC.ORACLE.COM.dbc

Page 36 of 48 Organization Chart Configuration

5.7: Connection test succeeded. Click “Next”

5.8: Select “FMW11gR1AdminServer” and Click “Finish”

5.9: Confirmation Screen

Page 37 of 48 Organization Chart Configuration

5.10: Weblogic Server: Create a directory named “orgchart” under
“/home/applprod/Oracle/Middleware/user_projects/domains/FMW11gR1Domain/servers/FMW11g
R1AdminServer/” and copy OrgChartApplication.ear (Extract file from per_orgchart.zip) in this
directory.

5.11: From Left Pane: Navigate to Domain Structure  Deployments  Click “Install”

5.12: Select “OrgChartApplication.ear” and click “Next”

Page 38 of 48 Organization Chart Configuration

5.13: Select “Install this deployment as an application” and Click “Next”

5.14: Click “Next”

5.15: Select “Yes, take me to the deployment's configuration screen” and click “Finish”

Page 39 of 48 Organization Chart Configuration

5.16: Click “Configuration” tab

5.17: Click “Save” to save configuration

5.18: Select a directory to save configuration file “Plan.xml” file. Click “Ok”

Page 40 of 48 Organization Chart Configuration

5.19: Confirmation Screen

5.20: Now edit “Plan.xml” on weblogic server and add the below lines

5.21: Edit Plan.xml and add below after “<application-name>OrgChartApplication</application-name>”

and save file.

<variable-definition>
<variable>
<name>app_APPL_SERVER_ID</name>
<value>01FF175E4F151E8EE0534F78B00AC4EE18305468602816835541104309245714</value>
</variable>
</variable-definition>

Page 41 of 48 Organization Chart Configuration

Page 42 of 48 Organization Chart Configuration
5.22: Also add below after “<uri>WEB-INF/web.xml</uri>” and save file.

<variable-assignment>
<name>app_APPL_SERVER_ID</name>
<xpath>/web-app/context-param/[param-
name="01FF175E4F151E8EE0534F78B00AC4EE18305468602816835541104309245714"]/param-
value</xpath>
<operation>replace</operation>
</variable-assignment>

Page 43 of 48 Organization Chart Configuration

5.23: After editing the deployment “Plan.xml” file, we have to redeploy the application with this modified
plan.

Navigate to Domain Structure Deployments, check the box corresponding to application

“OrgChartApplication”, then click the "Update" button.

5.24: Select "Redeploy this application using the following deployment files", and make sure it shows your
modified “Plan.xml” file. Click "Next"

5.25: Click "Finish"

Page 44 of 48 Organization Chart Configuration

5.26: Confirmation Screen

5.27: Navigate to Domain Structure  Deployments, check the box corresponding to application
“OrgChartApplication”. We should able to see the status of application “OrgChartApplication” as
“Active” and “Health” as “Ok”.

Page 45 of 48 Organization Chart Configuration

Step 6: Test Organization Setup

6.1: Login to EBS => Navigate to System Administrator  Profile  System  Query for profile option
“External ADF Application URL” and set the site level value as http://nragavar-
in2.idc.oracle.com:7001/OrgChart-ViewController-context-root/

Note: Where http://nragavar-in2.idc.oracle.com:7001/ is weblogic URL.

6.2: Login as user having responsibility “Manager Self-Service”. Navigate to Manager Self-Service  Talent
Profile

Page 46 of 48 Organization Chart Configuration

6.3: “Organization Chart” is displayed

6.4: Click “Actions”

Page 47 of 48 Organization Chart Configuration

6.5: “Personal Information” is getting displayed

Page 48 of 48 Organization Chart Configuration