Oracle® Fusion Applications Enterprise Deployment Guide 11g Release 1 (11.1.1.5) Part Number E16684-02 |
|
|
View PDF |
This chapter describes how to scale out the Oracle Fusion Incentive Compensation domain.
This chapter includes the following topics:
Section 12.1, "Overview of the Oracle Fusion Incentive Compensation Domain"
Section 12.2, "Prerequisites for Scaling Out the Oracle Fusion Incentive Compensation Domain"
Section 12.3, "Adding a New Machine in the Oracle WebLogic Server Console"
Section 12.4, "Packing and Unpacking the Managed Server Domain Home"
Section 12.5, "Cloning Managed Servers and Assigning Them to CRMHOST2"
The Oracle Fusion Incentive Compensation domain provides Oracle Fusion Customer Relationship Management with a comprehensive solution that integrates with Quota Management to ensure consistent and accurate incentive compensation plan goals and enables organizations to measure and pay for performance that aligns with organizational strategies. Embedded participant and manager dashboards support sales performance management by enable salespeople to easily track their performance achievements against objectives and allowing them to focus on customers instead of shadow accounting.
Figure 12-1 shows the Oracle Fusion Incentive Compensation domain within the overall reference enterprise deployment topology for Oracle Fusion Applications.
Before you begin, ensure the following:
Node Manager has been started in the Secure Sockets Layer (SSL) mode by following the instructions in Chapter 6, "Configuring Node Manager"
You are starting with a clean machine if it is the first time it is being used for a scale out
The /etc/hosts
file has proper entries. To verify, ping this machine with the fully qualified name of the machine
The user created on CRMHOST2
should the same as the user on CRMHOST1
The directory structure /u01/oracle
is mounted to same shared file system as CRMHOST1
The directory structure /u02/local/oracle/config
on CRMHOST2
has been created
The initial Oracle Fusion Customer Relationship Management deployment on CRMHOST1
has already been done and verified by provisioning
To add a new machine:
Log in to the Administration Server: http://
icinternal
.mycompany.com:7777/console
.
Navigate to ICDomain > Environment > Machines.
LocalMachine is located in the right-hand pane.
In the left-hand pane, click Lock & Edit.
In the right-hand pane, first click New to add the remote machine, and then specify the following:
Name - enter CRMHOST2
Machine operating system - Unix
Click Next.
In the window that opens, set the following attributes:
Type - SSL
Listen Address - <CRMHOST2
>
Note:
The "localhost" default value here is wrong.Listen port - 5556
Click Finish and activate the changes.
Note:
If you get an error when activating the changes, see Section 18.8.18, "Administration Console Redirects from Internal URL to Container URL after Activation" for the temporary solution.Since the CRMHOST1
domain directory file system is also available from CRMHOST2
, both the pack
and unpack
commands can be executed from the CRMHOST2
.
Do the following:
Change directory to ORACLE_BASE
/products/fusionapps/oracle_common/common/bin
.
Run the pack
command:
CRMHOST2> ./pack.sh -managed=true -domain=ORACLE_BASE/config/domains/ CRMHOST1/ICDomain -template=ORACLE_BASE/user_templates/ICDomain_managed.jar -template_name="IC_Managed_Server_Domain"
Ensure that /u02/local/oracle/config/domains/
CRMHOST2
/ICDomain
is empty, and then run the unpack
command:
CRMHOST2> ./unpack.sh -domain=/u02/local/oracle/config/domains/ CRMHOST2/ICDomain -template=ORACLE_BASE/user_templates/ICDomain_managed.jar
Here, ORACLE_BASE
is shared, and /u02/local
is local to CRMHOST2
.
To add a managed server and assign it to CRMHOST2
:
Log in to the Administration Server: http://
icinternal
.mycompany.com:7777/console
.
Navigate to ICDomain > Environment > Servers.
Switch to Lock & Edit mode.
Select the Managed_Servers checkbox (for example, IncentiveCompensationServer_1) and then click Clone.
Specify the following Server Identity attributes:
Server Name - IncentiveCompensationServer_2
Note:
To ensure consistency in naming, copy the name of the server shown in Server Identity and paste it into the Server Name field. Then change the number to "_2".Server Listen Address - <CRMHOST2
>
Server Listen Port - leave "as is"
Click OK.
You now should see the newly cloned server, IncentiveCompensationServer_2
.
Click IncentiveCompensationServer_2 and change the following attributes:
Machine - <CRMHOST2
>
Cluster Name - Default, IncentiveCompensationCluster
Click Save and then Activate Changes.
From the Name column, click the IncentiveCompensationServer_2 scaled-out server link.
Click Lock & Edit, and then choose the Keystores tab.
Ensure that the keystores value is Custom Identity and Custom Trust.
Do the following:
Change the Custom Identity Keystore path to point to the ORACLE_BASE
/products/fusionapps/wlserver_10.3/server/lib/
CRMHOST2
_fusion_identity.jks
file.
Leave the Custom Identity Keystore type blank.
Change the Custom Identity Keystore Passphrase entry. This should be the same as the keystorepassword field described in the first bullet in Step 4 in Section 6.2, "Creating the Identity Keystore on CRMHOST2."
Re-enter the Confirm Custom Identity Keystore Passphrase.
Ensure that the Confirm Custom Trust Keystore path is pointing to the ORACLE_BASE
/products/fusionapps/wlserver_10.3/server/lib/fusion_trust.jks
file.
Leave the Custom Trust Keystore type blank.
Change the Custom Trust Keystore Passphrase entry. This should be the same as the keystorepassword field described in the first bullet in Step 4 in Section 6.2, "Creating the Identity Keystore on CRMHOST2."
Re-enter the Custom Trust Keystore Passphrase.
Click Save.
Choose the SSL tab.
Make sure that Identity and Trust Locations is set to Keystores.
Change the Private Key Alias to CRMHOST2
_fusion
.
Change the Private Key Passphrase to the keypassword, as described in the second bullet in Step 4 in Section 6.2, "Creating the Identity Keystore on CRMHOST2."
Re-enter the keypassword from Step c for the Confirm Private Key Passphrase.
Click Save.
Click Activate Changes.
Repeat Steps 2 to 14 for all the managed servers on this domain.
Set the following environment variable:
WLST_PROPERTIES="-Dweblogic.security.SSL.trustedCAKeyStore=ORACLE_BASE/
products/fusionapps/wlserver_10.3/server/lib/fusion_trust.jks"
Stop the domain's Administration Server:
CRMHOST1> ORACLE_BASE/config/domains/CRMHOST1/ICDomain/bin/stopWebLogic.sh
Restart the domain's Administration Server:
CRMHOST2> ORACLE_BASE/products/fusionapps/wlserver_10.3/common/bin/wlst.sh CRMHOST2> nmConnect(username='<username>', password='<password>', domainName='ICDomain', host='CRMHOST1',port='5556', nmType='ssl', domainDir='ORACLE_BASE/config/domains/CRMHOST1/ICDomain') CRMHOST2> nmStart('AdminServer')
Note:
The username and password used in thenmConnect
are the Node Manager credentials (username and password) specified when creating the provisioning plan. This is shown in Figure 4-3 in "Using the Provisioning Process to Install Components for an Enterprise Deployment".Run the newly created managed server:
Navigate to ICDomain > Environment > Servers > Control.
Select the newly created managed server and click Start.
Navigate to ICDomain > Environment > Servers and check the State to verify that the newly created managed servers are running.
Log in to the Administration Server once again (http://
icinternal
.mycompany.com:7777/console
) and verify that all the managed servers, including scaled-out servers, are running.
Note:
For all the scaled-up and scaled-out servers, change the Arguments in the/u02/local/oracle/config/domains/
HOSTNAME
/
DomainName
/servers/
ManagedServer
/data/nodemanager/startup.properties
file to the following:
Arguments=-DJDBCProgramName\=DS/ICDomain/ IncentiveCompensationServer_2 -Dserver.group\ =IncentiveCompensationCluster
Note:
For all the scaled-up and scaled-out managed servers, do the following:Access the Oracle WebLogic Server Administration Console for the ICDomain:
http://
icinternal
.mycompany.com:7777/console
Navigate to Environment > Servers and click the "Managed Server" link.
First select the Logging tab and then the HTTP tab.
Update the following parameters:
– Log file name: logs/access.log.%yyyyMMdd%
– Rotation Type: By Time
– Limit number of retained files: leave this option unchecked
– Rotate log file on startup: leave this option unchecked
Click Save.
Expand Advanced Node and set the following:
– Format: Extended
– Extended Logging Format Fields:
date time time-taken cs-method cs-uri sc-status sc(X-ORACLE-DMS-ECID) cs(ECID-Context) cs(Proxy-Remote-User) cs(Proxy-Client-IP)
Click Save and Activate Changes.
Restart the Managed Server for the changes to take affect.
To configure Oracle HTTP Server:
On WEBHOST1
:
Change directory to ORACLE_BASE
/config/CommonDomain_webtier/config/OHS/ohs1/moduleconf
.
Copy FusionVirtualHost_ic.conf
to FusionVirtualHost_ic.conf.org
.
Edit the FusionVirtualHost_ic.conf
file, adding the scaled-out host and port to all the WebLogic Application Clusters. Example 12-1 shows sample code for IncentiveCompensationServer.
Repeat Step 2 for all applications.
Restart Oracle HTTP Server: cd
to ORACLE_BASE
/config/CommonDomain_webtier/bin
and enter the following:
WEBHOST1> ./opmnctl stopall WEBHOST1> ./opmnctl startall
You should verify URLs to ensure that the appropriate routing and failover are working.
To verify the URLs:
Log in to the ICDomain
Oracle WebLogic Server Administration Console and stop all the managed servers on the CRMHOST1
while the managed servers on CRMHOST2
are running.
Access the following URL to verify that routing and failover are functioning properly. (Ensure the log in prompt is visible.)
https://icexternal.mycompany.com/incentiveCompensation/faces/IcCnCompPlanWorkarea
Log in to the ICDomain
Oracle WebLogic Server Administration Console and stop all the managed servers on CRMHOST2
.
Start the managed servers on CRMHOST1
.
Repeat Step 2. (Ensure the log in prompt is visible.)
Start all the managed servers on CRMHOST2
and verify that they are running on CRMHOST1
.