Oracle® Fusion Applications Financials Enterprise Deployment Guide 11g Release 1 (11.1.4) Part Number E27364-02 |
|
|
PDF · Mobi · ePub |
This chapter describes how to scale out the Oracle Fusion Common domain.
This chapter includes the following topics:
Section 10.2, "Prerequisites for Scaling Out the Oracle Fusion Common Domain"
Section 10.3, "Adding a New Machine in the Oracle WebLogic Server Console"
Section 10.5, "Packing and Unpacking the Managed Server Domain Home"
Section 10.6, "Cloning Managed Servers and Assigning Them to FINHOST2"
Section 10.8, "Configuring Server Migration for the Managed Servers"
The Oracle Fusion Common domain is shared by all Oracle Fusion Applications product families. Oracle Fusion Financials implementation is dependent on the Oracle Fusion Common domain for the following components:
Oracle Fusion Functional Setup Manager, for all setup task flows
Help Portal, for centralized help
Home page application, which has the Oracle Fusion Financials home page and launch pad
Oracle WebCenter Content, to store all marketing collateral as well as all attachments. Import flow also uses WebCenter Content to stage the CSV files that the user uploads
Oracle WebCenter Content: Imaging, for end-to-end management of document images within enterprise business processes
Oracle Secure Enterprise Search
Oracle WebCenter Community Space and forums
Oracle WebLogic Communication Services (OWLCS) and Oracle WebLogic SIP Server
Figure 2-5 in Chapter 2, "Introduction to the Enterprise Deployment Reference Topologies," shows the topology for the Oracle Fusion Common domain within the overall reference enterprise deployment topology.
Before you begin, ensure the following:
Node Manager has been started in the Secure Sockets Layer (SSL) mode by following the instructions in Chapter 7, "Setting Up Node Manager for an Enterprise Deployment"
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 FINHOST2
should be the same as the user on FINHOST1
The directory structure /u01/oracle
is mounted to same shared file system as FINHOST1
The directory structure /u02/local/oracle/config
on FINHOST2
has been created
The initial Oracle Fusion Financials deployment on FINHOST1
has already been done and verified by provisioning
To add a new machine:
Log in to the Administration Server: http://
commoninternal
.mycompany.com:7777/console
.
Navigate to CommonDomain > 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 FINHOST2
Machine operating system - Unix
Click Next.
In the window that opens, set the following attributes:
Type - SSL
Listen Address - <FINHOST2
>
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 20.8.18, "Administration Console Redirects from Internal URL to Container URL after Activation" for the temporary solution.
Scaling out WebCenter Content involves two tasks:
Do the following:
Ensure that the UCM_server1
Managed Server is functioning properly. You should be able to access and log in to the following:
http://
FINHOST1
:7012/cs
Shut down the UCM_server1
Managed Server:
Log in to the Oracle WebLogic Server Administration Console (http://commoninternal.mycompany.com:7777/console
).
In the Domain Structure window, first navigate to Environment > Servers, and then select the Control tab.
Select the UCM_server1 checkbox.
Click Shutdown and then Force Shutdown Now.
Copy FINHOST1
/u02/local/oracle/config/domains/
FINHOST1
/CommonDomain/ucm/cs
directory from the local to the shared location: ORACLE_BASE
/config/domains/
FINHOST1
/CommonDomain/ucm/cs
.
In the ORACLE_BASE
/config/domains/
FINHOST1
/CommonDomain/ucm/cs/bin/intradoc.cfg
file, create the variables IntradocDir
, vaultDir
, and weblayoutDir
so that they point to the shared location, ORACLE_BASE
/config/domains/
FINHOST1
/CommonDomain/ucm/cs
.
Ensure that the edits you made in Step 4 you also make to the intradoc.cfg
file in /u02/local/oracle/config/domains/
FINHOST1
/CommonDomain/ucm/cs/bin
.
Start the UCM_server1
Managed Server.
This section describes the additional steps you must perform in order to complete the Oracle WebCenter Content scale out.
This section includes the following topics:
Section 10.4.2.4, "Configuring a Default Persistence Store for Transaction Recovery"
Section 10.4.2.6, "Creating a Connection to Oracle WebCenter Content"
Before proceeding with the configuration, ensure that you have performed the procedures in Section 10.5, "Packing and Unpacking the Managed Server Domain Home" and in Section 10.6, "Cloning Managed Servers and Assigning Them to FINHOST2".
To configure the WebCenter Content server, do the following:
Navigate to http://
FINHOST1
:7012/cs
and select Administration > Providers.
Note:
ibrprovider is already defined in this list.
Add a new outgoing provider:
Click Add.
Set the values to match the values of ibrprovider.
Note:
The value for the new outgoing ibrprovider must differ from the value of the default ibrprovider.
Set the server host name to the second host address's FINHOST2
IP address.
Set the server socket port to 7035
.
Assign unique values to Provider Name, Provider Description, Server Host Name, Server Port, Instance Name, and Relative Web Root.
Restart the UCM_server1
and UCM_server2
Managed Servers.
Create a COMMONUCMVH1
TCP VIP with an unused port on the load-balancing router (LBR) with FINHOST1
:7012
and FINHOST2
:7012
as its members.
After scaling out the Oracle WebCenter Portal Managed Server, do the following:
Log in to: http://commoninternal.mycompany.com:7777/em
.
Note:
If you don't see WebCenter Content after logging in to Oracle Enterprise Manager, bounce the WebCenter Content Managed Servers.
Navigate to WebCenter > Spaces > webcenter ( 1.1.*.*) (wc_spaces) > WebCenter Portal (top left or right pane) > Settings > Service configuration.
Click Content Repository.
Highlight WebCenter-UCM and click Edit.
Select Socket and enter COMMONUCMVH1
as the host.
Restart the Oracle WebCenter Portal Managed Servers.
You must configure the location for all persistence stores to a directory visible from both nodes. Change all persistent stores to use this shared base directory.
To configure the file store for FINHOST2
:
Log in to the Oracle WebLogic Server Administration Console (http://commoninternal.mycompany.com:7777/console
).
In the Domain Structure window, expand the Services node and then click the Persistence Stores node.
The Summary of Persistent Stores page displays.
In the Change Center, click Lock & Edit.
Click New, and then Create File Store.
Enter the following directory information:
Name: For example, IPMJMSFileStore_auto_2
Target: IPM_server1
Directory: ORACLE_BASE
/config/domains/
FINHOST1
/CommonDomain
Click Save and Activate Changes.
In the Domain Structure window, expand the Services node and then click the Messaging > JMS Servers node.
The Summary of JMS Servers page displays.
Click Lock & Edit, then click New.
Enter a name (for example, IpmJmsServer_1
), then select IPMJMSFileStore_auto_2 in the Persistence Store dropdown list.
Click Next.
Select IPM_server2 as the target.
Click Finish and Activate Changes.
Each server has a transaction log which stores information about committed transactions that are coordinated by the server that may not have been completed. Oracle WebLogic Server uses this transaction log for recovery from system crashes or network failures. To leverage the migration capability of the Transaction Recovery Service for the servers within a cluster, store the transaction log in a location accessible to a server and its backup servers.
Note:
Preferably, this location should be a dual-ported SCSI disk or on a Storage Area Network (SAN).
To set the location for the default persistence store:
Log in to the Oracle WebLogic Server Administration Console (http://commoninternal.mycompany.com:7777/console
).
In the Change Center, click Lock & Edit.
In the Domain Structure window, expand the Environment node and then click the Servers node.
The Summary of Servers page displays.
Click the name of the server (represented as a hyperlink) in the IPM_server1 table. The settings page for the selected server opens with the Configuration tab active.
Open the Services tab.
In the Default Store section of the page, enter the path to the folder where the default persistent stores will store its data files. For example:
FINHOST1> ORACLE_BASE/config/domains/FINHOST1/CommonDomain/tlogs
Click Save.
Repeat Steps 1 through 7 for the IPM_server2
Managed Server.
Click Activate Changes.
Restart the Managed Servers to activate the changes (ensure that Node Manager is up and running):
Log in to the Oracle WebLogic Server Administration Console (http://commoninternal.mycompany.com:7777/console
).
In the Summary of Servers screen, select the Control tab.
Select IPM_server1 and IPM_server2 in the table and then click Shutdown.
Restart the IPM_server1
and IPM_server2
Managed Servers.
Notes:
To enable migration of the Transaction Recovery service, specify a location on a persistent storage solution that is available to other servers in the cluster. Both IPM_server1
and IPM_server2
must be able to access this directory.
Ensure the following the path exists on your machine: /usr/share/X11/fonts/TTF
.
Perform these steps to add the host names of the IPM_server1
and IPM_server2
Managed Servers to the SocketHostNameSecurityFilter parameter list:
Open the following file in a text editor:
ORACLE_BASE/config/domains/FINHOST1/CommonDomain/ucm/cs/config/config.cfg
Remove or comment out the following line:
SocketHostAddressSecurityFilter=127.0.0.1|FINHOST1|FINHOST2|0.0.0.0.0.0.0.1
Add the following two lines to include the IPM_server1
and IPM_server2
listen addresses to the list of addresses that are allowed to connect to Oracle WebCenter Content:
SocketHostAddressSecurityFilter=localhost|localhost.mycompany.com|FINHOST1| FINHOST2|COMMONIPMVH1|COMMONIPMVH2 AlwaysReverseLookupForHost=Yes
Save the modified config.cfg
file and restart the Oracle WebCenter Content servers for the changes to take effect.
To create a connection to Oracle WebCenter Content Server:
Log in to the IPM_server1
Imaging console at https://commonexternal.mycompany.com/imaging
.
In the left-hand pane, click Manage Connections, and then Create Content Server Connection.
Enter a name and description for the new connection, and then click Next.
In the Connection Settings screen, do the following:
Make sure the Use Local Content Server checkbox is not selected.
Set the Content Server port to 7034
.
The port value should be the value of the IntradocServerPort
from ORACLE_BASE
/config/domains/
FINHOST1
/CommonDomain/ucm/cs/config/config.cfg
.
Add two servers to the Content Server pool:
FINHOST1
: 7034
FINHOST2
: 4444
Click Next.
In the Connection Security screen, leave the default selections for the WebLogic user, and then click Next.
Review the connection details and click Submit.
Since the FINHOST1
domain directory file system is also available from FINHOST2
, both the pack
and unpack
commands can be executed from FINHOST2
.
To pack and unpack the Managed Server domain home:
Change directory to ORACLE_BASE
/products/fusionapps/oracle_common/common/bin
.
Run the pack
command:
FINHOST2> ./pack.sh -managed=true -domain=ORACLE_BASE/config/domains/ FINHOST1/CommonDomain -template=ORACLE_BASE/user_templates/ CommonDomain_managed.jar -template_name="Common_Managed_Server_Domain"
Ensure that /u02/local/oracle/config/domains/
FINHOST2
/CommonDomain
is empty, and then run the unpack
command:
FINHOST2> ./unpack.sh -domain=/u02/local/oracle/config/domains/FINHOST2/ CommonDomain -template=ORACLE_BASE/user_templates/CommonDomain_managed.jar
Here, ORACLE_BASE
is shared, and /u02/local
is local to FINHOST2
.
To add a Managed Server and assign it to FINHOST2
:
Log in to the Administration Server: http://
commoninternal
.mycompany.com:7777/console
.
Navigate to CommonDomain > Environment > Servers.
Switch to Lock & Edit mode.
Select the Managed_Server checkbox (for example, HomePageServer_1) and then click Clone.
Specify the following Server Identity attributes:
Server Name - HomePageServer_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 - <FINHOST2
>
Server Listen Port - leave "as is"
Note:
For Oracle SOA Suite server, add a port value that is different than the soa_server1
server value. This will help in server migration.
Click OK.
You now should see the newly cloned sales server, HomePageServer_2
.
Click HomePageServer_2 and change the following attributes:
Machine - <FINHOST2
>
Cluster Name - accept the default, HomePageCluster
Note:
Ensure that this cluster name is the same as the cluster name of the original Managed Server.
Click Save and then Activate Changes.
Navigate to CommonDomain > Environment > Servers.
From the Name column, click the HomepageServer_2 scaled-out server link.
Click Lock & Edit, and then select the Configuration tab.
Select the Keystores tab, and then 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/
FINHOST2
_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 7.2, "Creating the Identity Keystore on FINHOST2."
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 7.2, "Creating the Identity Keystore on FINHOST2."
Re-enter the Custom Trust Keystore Passphrase.
Click Save.
Select the SSL tab.
Make sure that Identity and Trust Locations is set to Keystores.
Change the Private Key Alias to FINHOST2
_fusion
.
Change the Private Key Passphrase to the keypassword, as described in the second bullet in Step 4 in Section 7.2, "Creating the Identity Keystore on FINHOST2."
Re-enter the keypassword from Step c for the Confirm Private Key Passphrase.
Click Save.
Select the Server Start tab.
Change the Arguments to reflect the name of your cloned Managed Server and make sure the server group is the correct cluster name. For example, you should see the following:
-DJDBCProgramName=DS/CommonDmain/HomePageServer_2 -Dserver.group=HomePageCluster
Click Save.
Select the Logging tab, and then select the HTTP tab.
Do the following:
Change the Log file name to logs/access.log.%yyyyMMdd%
.
Change the rotation type to By Time.
Leave the Limit number of retained files option unchecked.
Leave the Rotate log file on startup option unchecked.
Click Save.
Expand Advanced.
Change the format to Extended.
Change the extended logging format fields to the following:
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.
Click Activate Changes.
Repeat Steps 2 to 18 for all the Managed Servers on this domain.
Set the following environment variable on FINHOST2
:
WLST_PROPERTIES="-Dweblogic.security.SSL.trustedCAKeyStore=ORACLE_BASE/
products/fusionapps/wlserver_10.3/server/lib/fusion_trust.jks"
Stop the domain's Administration Server:
FINHOST1> ORACLE_BASE/config/domains/FINHOST1/CommonDomain/bin/stopWebLogic.sh
Restart the domain's Administration Server:
FINHOST2> ORACLE_BASE/products/fusionapps/wlserver_10.3/common/bin/wlst.sh FINHOST2> nmConnect(username='<username>', password='<password>', domainName='CommonDomain', host='FINHOST1',port='5556', nmType='ssl', domainDir='ORACLE_BASE/config/domains/FINHOST1/CommonDomain') FINHOST2> nmStart('AdminServer')
Note:
The username and password used in the nmConnect
are the Node Manager credentials (username and password) specified when creating the provisioning response file. This is shown in Figure 5-3 in "Using the Provisioning Process to Install Components for an Enterprise Deployment".
For the wlcs_sipstate2
scaled-out server only, do the following:
Change directory to:
ORACLE_BASE/config/domains/FINHOST1/CommonDomain/config/custom
In the datatier.xml
file, after the following line:
<server-name>wlcs_sipstate1</server-name>
add
<server-name>wlcs_sipstate2</server-name>
For Oracle WebCenter Content: Imaging scaleout only: Before starting the IPM_server2
server, perform the steps listed in Section 10.4.2.3, "Configuring a JMS Persistence Store."
In the intradoc.cfg
file located at /u02/local/oracle/config/domains/
FINHOST2
/CommonDomain/ucm/cs/bin
, create the variables IntradocDir
, vaultDir
, and weblayoutDir
so that they point to the shared location, ORACLE_BASE
/config/domains/CRMHOST1/CommonDomain/ucm/cs
.
Run the newly created Managed Servers:
Log in to the Administration Server: http://
commoninternal
.mycompany.com:7777/console
.
Navigate to CommonDomain > Environment > Servers > Control.
Select the newly created Managed Servers and click Start.
Navigate to CommonDomain > Environment > Servers and check the State to verify that the newly created Managed Servers are running.
For additional scale-out instructions for Oracle WebCenter Content, see Section 10.4.
To configure Oracle HTTP Server:
On WEBHOST1
:
Change directory to ORACLE_BASE
/config/CommonDomain_webtier/config/OHS/ohs1/moduleconf
.
Copy FusionVirtualHost_fs.conf
to FusionVirtualHost_fs.conf.org
.
Edit the FusionVirtualHost_fs.conf
file, adding the scaled-out host and port to all the WebLogic Application Clusters. Add this to both the Internal and External part of the FusionVirtualHost_fs.conf
file. Example 10-1 shows sample code for HomePageServer.
Notes:
Do not add these values for Oracle Enterprise Manager, Oracle WebLogic Server Administration Console, or Oracle Authorization Policy Manager.
If the Managed Servers are running on VIPs, replace FINHOST1
and FINHOST2
with the VIP addresses in Example 10-1.
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
Server migration is required for proper failover of Oracle Fusion Financials components in the event of failure in any of the FINHOST1
and FINHOST2
nodes. For more information, see Chapter 18, "Setting Up Server Migration for an Enterprise Deployment."
You should verify URLs to ensure that the appropriate routing and failover are working.
To verify the URLs:
Log in to the CommonDomain
Oracle WebLogic Server Administration Console and stop all the Managed Servers on FINHOST1
while the Managed Servers on FINHOST2
are running.
Access the following URLs to verify that routing and failover are functioning properly. (Ensure the log in prompt is visible.)
https://commonexternal.mycompany.com/helpPortal/faces/AtkHelpPortalMain
https://commonexternal.mycompany.com/homePage/faces/AtkHomePageWelcome
Log in to the CommonDomain
Oracle WebLogic Server Administration Console and stop all the Managed Servers on FINHOST2
.
Start the Managed Servers on FINHOST1
.
Repeat Step 2. (Ensure the log in prompt is visible.)
Start all the Managed Servers on FINHOST2
and verify that they are running on FINHOST1
and FINHOST2
.