This chapter describes how to create a domain with the Administration Server and the first Oracle Business Intelligence Managed Server using the Oracle Business Intelligence Configuration Assistant, Oracle WebLogic Server Administration Console, and Oracle Enterprise Manager Fusion Middleware Control. Later, you scale out the domain to add additional components. This is addressed in later chapters of this guide.
Important:
Oracle strongly recommends that you read the Oracle Fusion Middleware Release Notes for any additional installation and deployment considerations before starting the setup process.
This chapter contains the following topics:
Section 8.2, "Creating a Domain and the bi_server1 Managed Server on APPHOST1"
Section 8.4, "Configuring Oracle HTTP Server for the WebLogic Domain"
Section 8.5, "Verifying Manual Failover of the Administration Server"
Table 8-1 lists the steps for creating a WebLogic domain for Oracle Business Intelligence that contains the Administration Server and the first Managed Server, including post-configuration tasks.
Table 8-1 Steps for Creating a Domain for Oracle Business Intelligence
| Step | Description | More Information |
|---|---|---|
|
Create a WebLogic Domain |
Run the Oracle Business Intelligence Configuration Assistant to create a WebLogic domain that contains the Administration Server and the first Managed Server. |
Section 8.2, "Creating a Domain and the bi_server1 Managed Server on APPHOST1" |
|
Post-Configuration and Verification Tasks |
Follow the instructions for post-configuration and validation tasks. |
|
|
Configure Oracle HTTP Server for the WebLogic Domain |
Configure Oracle HTTP Server for the Administration Server and Managed Server in the WebLogic domain and validate the configuration. |
Section 8.4, "Configuring Oracle HTTP Server for the WebLogic Domain" |
|
Test Administration Server Failover |
Follow the instructions to manually fail over the Administration Server from APPHOST1 to APPHOST2. |
Section 8.5, "Verifying Manual Failover of the Administration Server" |
|
Back Up the Installation |
Back up the installation to the local disk. |
Perform the following steps to run the Oracle Business Intelligence Configuration Assistant from the Oracle home directory to create a domain that contains the Administration Server and the first Managed Server with Oracle Business Intelligence components.
Ensure that the database where you installed the Business Intelligence Platform schemas is running. For an Oracle RAC database, it is recommended that you ensure that all instances are running, so that the validation check that is performed in later steps is more reliable.
Change the directory to the location of the Configuration Assistant (created in Chapter 6, "Installing the Software for an Enterprise Deployment"):
APPHOST1> cd ORACLE_HOME/bin
Start the Configuration Assistant:
APPHOST1> ./config.sh
In the Welcome screen, click Next.
In the Prerequisite Checks screen, verify that all checks complete successfully, and click Next.
The Create, Scale Out or Extend screen is displayed. In this screen, select Create New BI System, then enter the following:
User Name: weblogic
User Password: your_password
Domain Name: bifoundation_domain
Click Next.
In the Specify Installation Location screen, enter:
Middleware Home: ORACLE_BASE/product/fmw (dimmed)
Oracle Home: ORACLE_BASE/product/fmw/Oracle_BI1 (dimmed)
WebLogic Server Home: ORACLE_BASE/product/fmw/wlserver_10.3 (dimmed)
Domain Home: ORACLE_BASE/admin/domain_name/aserver/domain_name
The Domain Home must end with the domain name.
Instance Home: ORACLE_BASE/admin/instance1
Instance Name: instance1
Click Next.
In the Configure Components screen, select the following:
Oracle Business Intelligence
Business Intelligence Enterprise Edition
Business Intelligence Publisher
Real-Time Decisions
Essbase Suite
Click Next.
In the BIPLATFORM Schema screen, provide the following information:
Database Type: Oracle Database
Connect String: CUSTDBHOST1-VIP.MYCOMPANY.COM:port-num:CUSTDB1^CUSTDBHOST2-VIP.MYCOMPANY.COM:port-num:CUSTDB2@BIEDG.MYCOMPANY.COM
where port-num might be 1521.
Note:
For Oracle Real Application Cluster (RAC) 11g Release 2 and later, specify Single Client Access Name (SCAN). For earlier releases, specify the virtual IP address. Use a connect string such as the following one for SCAN:
CUSTDB-SCAN.MYCOMPANY.COM:port-num:CUSTDB1^CUSTDB-SCAN.MYCOMPANY.COM:port-num:CUSTDB2@BIEDG.MYCOMPANY.COM
Oracle strongly recommends that you read the Oracle Fusion Middleware Release Notes for any additional installation and deployment considerations for RAC support.
BIPLATFORM Schema Username: prefix_BIPLATFORM
BIPLATFORM Schema Password: your_password
Click Next.
In the MDS Schema screen, verify the information. For example:
Database Type: Oracle Database
Connect String: CUSTDBHOST1-VIP.MYCOMPANY.COM:port-num:CUSTDB1^CUSTDBHOST2-VIP.MYCOMPANY.COM:port-num:CUSTDB2@BIEDG.MYCOMPANY.COM
where port-num might be 1521.
Note:
For Oracle Real Application Cluster (RAC) 11g Release 2 and later, specify Single Client Access Name (SCAN). For earlier releases, specify the virtual IP address. Use a connect string such as the following one for SCAN:
CUSTDB-SCAN.MYCOMPANY.COM:port-num:CUSTDB1^CUSTDB-SCAN.MYCOMPANY.COM:port-num:CUSTDB2@BIEDG.MYCOMPANY.COM
Oracle strongly recommends that you read the Oracle Fusion Middleware Release Notes for any additional installation and deployment considerations for RAC support.
MDS Schema Username: prefix_MDS
MDS Password: your_password
Click Next.
In the Configure Ports screen, select one the following:
Auto Port Configuration
Specify Ports using Configuration File
Click Next.
In the Specify Security Updates screen, specify whether you want to receive security updates from Oracle Support and if you do, enter your e-mail address.
Click Next.
In the Summary screen, click Configure.
In the Configuration Progress screen, verify that all the Configuration Tools have completed successfully and click Next.
In the Complete screen, click Finish.
Usually, Node Manager is started automatically when the config.sh process completes. If Node Manager is not running for some reason, then run these commands to start it on APPHOST1:
APPHOST1> cd WL_HOME/server/bin
APPHOST1> ./startNodeManager.sh
After configuring the domain with the Oracle Business Intelligence Configuration Assistant, follow these instructions for post-configuration and verification.
This section includes the following topics:
Section 8.3.2, "Creating boot.properties for the Administration Server on APPHOST1"
Section 8.3.3, "Starting the Administration Server on APPHOST1"
Section 8.3.4, "Enabling Administration Server High Availability"
Section 8.3.6, "Setting the Listen Address for bi_server1 Managed Server"
Section 8.3.7, "Disabling Host Name Verification for the bi_server1 Managed Server"
Section 8.3.8, "Validating Oracle Business Intelligence on APPHOST1"
Perform the following steps to configure the location for all persistence stores to a directory visible from both nodes. Change all persistent stores to use this shared base directory.
Log into the Administration Console.
In the Domain Structure window, expand the Services node and click the Persistent Stores node. The Summary of Persistent Stores page is displayed.
In the Change Center, click Lock & Edit.
Click BipJmsStore and enter a directory that is located in the shared storage. This shared storage is accessible from both APPHOST1 and APPHOST2:
ORACLE_BASE/admin/domain_name/bi_cluster/jms
Click Save and Activate Changes.
The changes do not take effect until the Managed Server is restarted. Restart the Managed Server.
Perform the following steps to create a boot.properties file for the Administration Server on APPHOST1. This file enables the Administration Server to start without prompting you for the administrator user name and password.
Go to the following directory:
ORACLE_BASE/admin/domain_name/aserver/domain_name/servers/AdminServer/security
In this directory, create a file called boot.properties using a text editor and enter the following lines in the file:
username=Admin_Username password=Admin_Password
Note:
When you start the Administration Server, the user name and password entries in the file get encrypted. You start the Administration Server in Section 8.3.3, "Starting the Administration Server on APPHOST1." For security reasons, you want to minimize the time that the entries in the file are left unencrypted. After you edit the file, start the server as soon as possible so that the entries get encrypted.
Save the file and close the editor.
Follow these steps to start the Administration Server using Node Manager:
Stop and restart Node Manager and enable dynamic registration, using the following steps:
Stop the running NodeManager process.
Restart Node Manager and enable dynamic registration using the following commands:
APPHOST1> cd WL_HOME/server/bin
APPHOST1> export JAVA_OPTIONS=-DDomainRegistrationEnabled=true
APPHOST1> ./startNodeManager.sh
Note:
It is important that you set the -DDomainRegistrationEnabled=true parameter whenever you start a Node Manager, which must manage the Administration Server. If there is no Administration Server on this computer and if this computer is not an Administration Server failover node, then you can start Node Manager as follows:
APPHOST1> ./startNodeManager.sh
If the computer on which the Administration Server is running is externally available, then you can choose not to set the -DDomainRegistrationEnabled=true parameter. If the -DDomainRegistrationEnabled parameter is not set to true, then you cannot start or stop the Administration Server using the Node Manager.
Start the Oracle WebLogic Scripting Tool (WLST) and connect to Node Manager with nmconnect and the credentials set in Step 1, and start the Administration Server using the nmstart command as follows:
APPHOST1> cd ORACLE_COMMON_HOME/common/bin
APPHOST1> ./wlst.sh
In the WLST shell, execute the following command:
wls:/offline>nmConnect('Admin_User','Admin_Pasword', 'APPHOST1',
'node_manager_port','domain_name','Domain_Home')
wls:/nm/domain_name> nmStart('AdminServer')
For example:
wls:/offline>nmConnect('weblogic', 'my_password', 'APPHOST1' , '9556',
'bifoundation_domain' ,'/u01/app/oracle/admin/bifoundation_domain/aserver/
bifoundation_domain')
wls:/nm/bifoundation_domain> nmStart('AdminServer')
Note:
APPHOST1 is the address of the node where the domain was created, not the listen address of the Administration Server. Also, the user name and password are used only to authenticate connections between Node Manager and clients. They are independent from the server admin ID and password and are stored in the ORACLE_BASE/admin/domain_name/aserver/domain_name/config/nodemanager/nm_password.properties file.
The Oracle WebLogic Server Administration Server is a singleton application, so it cannot be deployed in an active-active configuration. By default, the Administration Server is available only on the first installed node, and for this enterprise topology, it is available only on APPHOST1. If this node becomes unavailable, then the Administration Console and Fusion Middleware Control also become unavailable. To avoid this scenario, the Administration Server and the applications deployed to it must be enabled for high availability. The enterprise deployment architecture in this guide calls for the deploying the Administration Server on a disk shared between APPHOST1 and APPHOST2.
The process that is described in this guide initially deploys the Administration Server and the bi_server1 Managed Server on the shared disk that is mounted on APPHOST1, then manually migrates the bi_server1 Managed Server domain information to the local file system. This process is necessary to overcome certain design constraints in the Oracle Universal Installer.
Note:
Before performing the steps in the following sections, ensure that you have configured one of the network interface cards on the host that is running the Administration Server to listen on the virtual IP Address. See Section 3.4.1, "Enabling ADMINVHN on APPHOST1" for more information.
This section contains the following topics:
Section 8.3.4.1, "Create a Machine for the Administration Server"
Section 8.3.4.2, "Enabling the Administration Server to Listen on the Virtual IP Address"
Section 8.3.4.3, "Creating a Separate Domain Directory for the bi_server1 Managed Server"
Section 8.3.4.4, "Enabling Fusion Middleware Control Failover"
Perform the following steps to create a new machine and assign the Administration Server to the new machine using the Administration Console:
Log in to the Administration Console.
In the Change Center, click Lock & Edit.
In the Environment section of the Home page, click Machines.
On the Summary of Machines page, select the Machine that is associated with the Administration Server from under the Machines table and click Clone. For example: APPHOST1.MYCOMPANY.COM.
On the Clone a Machine page, enter the Name of the Machine under the Machine Identity section and click OK. For example, enter ADMINHOST as the machine name.
On the Summary of Machines page, click the newly created Machine link.
On the Settings page for the ADMINHOST machine, select the Servers tab.
Click Add under the Servers table.
On the Add a Server to Machine page, choose Select an existing server, and associate it with this machine option.
Choose the AdminServer from the drop-down menu.
Click Finish to associate the Administration Server with the Machine.
In the Change Center, click Activate Changes.
Ensure that you have performed the steps described in Section 3.4.1, "Enabling ADMINVHN on APPHOST1" before setting the Administration Server listen address.
Perform the following steps to set the Administration Server listen address:
Log in to the Administration Console.
In the Change Center, click Lock & Edit.
Expand the Environment node in the Domain Structure window.
Click Servers. The Summary of Servers page is displayed.
Select AdminServer(admin) in the Names column of the table. The Setting page for AdminServer(admin) is displayed.
Set the Listen Address to ADMINVHN.
Click Save.
Click Activate Changes.
The changes do not take effect until the Administration Server is restarted. Perform the following steps to restart the Administration Server:
In the Summary of Servers page, select the Control tab.
Select AdminServer(admin) in the table and then click Shutdown.
Start the Administration Server again from the command line, as follows:
APPHOST1> cd ORACLE_COMMON_HOME/common/bin APPHOST1> ./wlst.sh wls:/offline> nmConnect ('Admin_User','Admin_Password','APPHOST1','node_mgr_port','domain_name','Domain_home') wls:/nm/domain_name> nmStart ('AdminServer')
Perform the following steps to use the pack and unpack commands to separate the domain directory that is used by the Administration Server from the domain directory that is used by the bi_server1 Managed Server in APPHOST1:
Stop the Administration Server and bi_Server1 Managed Server, using the following steps:
Log in to the Administration Console.
Expand the Environment node in the Domain Structure window.
Click Servers. The Summary of Servers page is displayed.
On the Summary of Servers page, select the Control tab.
Select AdminServer(admin) and bi_server1 in the table and then click Shutdown.
Run the pack command on APPHOST1 to create a template pack using the following command. Ensure that you pass managed=true to pack just the bi_server1 Managed Server domain information.
APPHOST1> cd ORACLE_HOME/common/bin APPHOST1> ./pack.sh -managed=true -domain=path_to_installer_created_domain -template=templateName.jar -template_name=templateName
For example:
APPHOST1> cd ORACLE_HOME/common/bin APPHOST1> ./pack.sh -managed=true -domain= ORACLE_BASE/admin/bifoundation_domain/aserver/bifoundation_domain -template=/tmp/managedServer.jar -template_name=ManagedServer_Template
Run the unpack command on APPHOST1 to unpack the template to the domain directory of the Managed Server using the following command:
APPHOST1> cd ORACLE_HOME/common/bin APPHOST1> ./unpack.sh -domain=path_to_domain_on_LocalFileSystem -template=templateName.jar -app_dir=path_to_applications_dir_on_LocalFileSystem
For example:
APPHOST1> cd ORACLE_HOME/common/bin APPHOST1>./unpack.sh -domain= ORACLE_BASE/admin/bifoundation_domain/mserver/bifoundation_domain -template=/tmp/managedServer.jar -app_dir= ORACLE_BASE/admin/bifoundation_domain/mserver/applications
Start the Oracle WebLogic Scripting Tool (WLST) and connect to Node Manager with nmconnect and the credentials set in step 2, and start the Administration Server using nmstart:
APPHOST1> cd ORACLE_COMMON_HOME/common/bin
APPHOST1> ./wlst.sh
In the WLST shell, execute the following command:
wls:/offline>nmConnect('Admin_User','Admin_Pasword','APPHOST1',
'node_manager_port','domain_name','Domain_Home')
wls:/nm/domain_name> nmStart('AdminServer')
For example:
wls:/offline>nmConnect('weblogic', 'my_password', 'APPHOST1' , '9556',
'bifoundation_domain' ,'/u01/app/oracle/admin/bifoundation_domain/
aserver/bifoundation_domain')
wls:/nm/bifoundation_domain> nmStart('AdminServer')
Start the bi_server1 Managed Server on APPHOST1, using the following steps (ensuring that Node Manager is up and running):
Log in to the Administration Console.
Expand the Environment node in the Domain Structure window.
Click Servers. The Summary of Servers page is displayed.
On the Summary of Servers page, select the Control tab.
Select bi_server1 in the table and then click Start.
To enable Fusion Middleware Control failover, copy the em.ear file from the MW_HOME/user_projects/applications/bifoundation_domain directory to the equivalent directory on all nodes where high availability for Administration Server might be performed. In some cases, you might need to create the MW_HOME/user_projects/applications/bifoundation_domain directory on the other nodes.
Perform the following steps to ensure that the Administration Server is properly configured:
Open a Web browser and go to http://ADMINVHN:7001/console.
Log in as the administrator.
Check that you can access Fusion Middleware Control at:
http://ADMINVHN:7001/em
Log in to Fusion Middleware Control with the user name and password that you specified in Section 8.3.2, "Creating boot.properties for the Administration Server on APPHOST1."
Ensure that you have performed the steps that are described in Section 3.4.2, "Enabling Virtual IPs for the Managed Servers" before setting the bi_server1 listen address.
Perform the following steps to set the listen address for the Managed Server:
Log in to the Administration Console.
In the Change Center, click Lock & Edit.
Expand the Environment node in the Domain Structure window.
Click Servers. The Summary of Servers page is displayed.
Select bi_server1 in the Names column of the table. The Setting page for bi_server1 is displayed.
Set the Listen Address to APPHOST1VHN1.
Click Save.
Click Activate Changes.
The changes do not take effect until the bi_server1 Managed Server is restarted using the following steps (ensure that Node Manager is up and running):
On the Summary of Servers page, select the Control tab.
Select bi_server1 in the table and then click Shutdown.
After the server has shut down, select bi_server1 in the table and then click Start.
Restart the Oracle Business Intelligence system components, as follows:
cd ORACLE_BASE/admin/instance1/bin
./opmnctl stopall
./opmnctl startall
Perform the following steps to update the host information for the Logical Web Applications endpoints of EPM applications in the EPM registry:
Enter the following command to obtain the GUID for the logical web application for Oracle Business Intelligence:
/u01/app/oracle/admin/instance1/config/foundation/11.1.2.0/epmsys_registry.sh view LOGICAL_WEB_APP
Multiple components are returned by the command.
Change all the HOST values to the internal load balancer virtual host for each of the components. Update the port to 80:
/u01/app/oracle/admin/instance1/config/foundation/11.1.2.0/epmsys_registry.sh updateproperty \#<Component_GUID>/@host biinternal.mycompany.com
/u01/app/oracle/admin/instance1/config/foundation/11.1.2.0/epmsys_registry.sh updateproperty \#<Component_GUID>/@port 80
where GUID is the ID of the EPM application in the EPM registry.
Verify that the following properties have the appropriate values:
HOST = The internal LBR vip. For example, biinternal.mycompany.com.
isSSL = False.
port = 80.
Restart the Managed Servers and BI System components.
This step is required if you have not configured the appropriate certificates to authenticate the different nodes with the Administration Server (see Chapter 10, "Setting Up Node Manager for an Enterprise Deployment"). If you have not configured the server certificates, then you see errors when managing the different Oracle WebLogic Servers. To avoid these errors, disable host name verification while configuring and validating the topology, and enable it again after the EDG topology configuration is complete, as described in Chapter 10, "Setting Up Node Manager for an Enterprise Deployment."
Perform the following steps to disable host name verification:
Log in to the Administration Console.
In the Change Center, click Lock & Edit.
Expand the Environment node in the Domain Structure window.
Click Servers. The Summary of Servers page is displayed.
Select bi_server1 in the Names column of the table. The settings page for the server is displayed.
Open the SSL tab.
Expand the Advanced section of the page.
Set Hostname Verification to 'None'.
Click Save.
Click Activate Changes.
The change does not take effect until the bi_server1 Managed Server is restarted using the following steps (ensure that Node Manager is up and running):
On the Summary of Servers page, select the Control tab.
Select bi_server1 in the table and then click Shutdown.
Select bi_server1 in the table and then click Start.
Restart the Oracle Business Intelligence system components, as follows:
cd ORACLE_BASE/admin/instance1/bin
./opmnctl stopall
./opmnctl startall
Access the following URLs:
Access http://APPHOST1VHN1:9704/analytics to verify the status of bi_server1.
Access http://APPHOST1VHN1:9704/wsm-pm to verify the status of Web Services Manager. Click Validate Policy Manager. A list of policies and assertion templates available in the data is displayed.
Note: The configuration is incorrect if no policies or assertion templates appear.
Access http://APPHOST1VHN1:9704/xmlpserver to verify the status of the BI Publisher application.
Access http://APPHOST1VHN1:9704/ui to verify the status of the Oracle RTD application.
Access http://APPHOST1VHN1:9704/bicomposer to verify the status of the Oracle BI Composer application.
Access http://APPHOST1VHN1:9704/aps/Essbase to verify the status of the Oracle Essbase application.
Access http://APPHOST1VHN1:9704/aps/SmartView to verify the status of the Smart View application.
Access http://APPHOST1VHN1:9704/workspace to verify the status of the Workspace application.
Access http://APPHOST1VHN1:9704/hr to verify the status of the Financial Reporting application.
Access http://APPHOST1VHN1:9704/calcmgr/index.htm to verify the status of the Calculation Manager application.
This section describes how to configure Oracle HTTP Server for the WebLogic domain that contains the Administration Server and the bi_server1 Managed Server.
This section contains the following topics:
Section 8.4.2, "Turning On the WebLogic Plug-In Enabled Flag"
Section 8.4.3, "Registering Oracle HTTP Server with Oracle WebLogic Server"
Section 8.4.4, "Setting the Frontend URL for the Administration Console"
Section 8.4.5, "Validating Access Through Oracle HTTP Server"
To enable Oracle HTTP Server to route to the Administration Server and the bi_cluster, which contains the bi_servern Managed Servers, you must set the WebLogicCluster parameter to the list of nodes in the cluster.
Perform the following steps to set the WebLogicCluster parameter:
On WEBHOST1 and WEBHOST2, add directives to the admin_vh.conf and biinternal_vh.conf files located in the following directory:
ORACLE_BASE/admin/instance_name/config/OHS/component_name/moduleconf
Note that this step assumes you created the admin_vh.conf and biinternal_vh.conf files using the instructions in Section 7.5, "Defining Virtual Hosts."
Add the following directives to the admin_vh.conf file within the <VirtualHost> tags.
# Admin Server and EM
<Location /console>
SetHandler weblogic-handler
WebLogicHost ADMINVHN
WeblogicPort 7001
</Location>
<Location /consolehelp>
SetHandler weblogic-handler
WebLogicHost ADMINVHN
WeblogicPort 7001
</Location>
<Location /em>
SetHandler weblogic-handler
WebLogicHost ADMINVHN
WeblogicPort 7001
</Location>
Add the following directives to the biinternal_vh.conf file within the <VirtualHost> tags:
#redirect browser requests that omit document/dir RedirectMatch 301 /analytics$ /analytics/ RedirectMatch 301 /bimiddleware$ /bimiddleware/ RedirectMatch 301 /analytics/res$ /analytics/res/ RedirectMatch 301 /bioffice$ /bioffice/ RedirectMatch 301 /biofficeclient$ /biofficeclient/ RedirectMatch 301 /biservices$ /biservices/ RedirectMatch 301 /analytics-ws$ /analytics-ws/ RedirectMatch 301 /AdminService$ /AdminSErvice/ RedirectMatch 301 /AsyncAdminService$ /AsyncAdminService/ RedirectMatch 301 /rtis$ /rtis/ RedirectMatch 301 /wsm-pm$ /wsm-pm/ RedirectMatch 301 /xmlpserver$ /xmlpserver/ RedirectMatch 301 /ui$ /ui/ RedirectMatch 301 /bisearch$ /bisearch/ RedirectMatch 301 /mapviewer$ /mapviewer/ RedirectMatch 301 /bicontent$ /bicontent/ RedirectMatch 301 /bicomposer$ /bicomposer/ RedirectMatch 301 /mobile$ /mobile/ RedirectMatch 301 /rtis$ /rtis/ RedirectMatch 301 /aps$ /aps/ RedirectMatch 301 /calcmgr$ /calcmgr/ RedirectMatch 301 /hr$ /hr/ RedirectMatch 301 /workspace$ /workspace/ # WSM-PM <Location /wsm-pm> SetHandler weblogic-handler WebLogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 </Location> # BIEE Analytics <Location /analytics> SetHandler weblogic-handler WebLogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 </Location> <Location /analytics-ws> SetHandler weblogic-handler WebLogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 </Location> <Location /bimiddleware> SetHandler weblogic-handler WebLogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 </Location> <Location /bicontent> SetHandler weblogic-handler WebLogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 </Location> <Location /mobile> SetHandler weblogic-handler WebLogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 </Location> # MapViewer <Location /mapviewer> SetHandler weblogic-handler WebLogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 </Location> # BI Publisher <Location /xmlpserver> SetHandler weblogic-handler WebLogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 </Location> # Oracle RTD <Location /ui> SetHandler weblogic-handler WebLogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 </Location> <Location /rtis> SetHandler weblogic-handler WebLogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 </Location> <Location /schema> SetHandler weblogic-handler WebLogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 </Location> <Location /ws> SetHandler weblogic-handler WebLogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 </Location> # BI Search <Location /bisearch> SetHandler weblogic-handler WebLogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 </Location> # BI Composer <Location /bicomposer> SetHandler weblogic-handler WebLogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 </Location> # EPM Provider Services <Location /aps> SetHandler weblogic-handler WeblogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 </Location> # EPM Calc Manager <Location /calcmgr> SetHandler weblogic-handler WeblogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 </Location> # EPM Financial Reporting <Location /hr> SetHandler weblogic-handler WeblogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 </Location> # EPM Workspace <Location /workspace> SetHandler weblogic-handler WeblogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 </Location> # BI Office <Location /bioffice> SetHandler weblogic-handler WeblogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 </Location> # BI Office Client <Location /biofficeclient> SetHandler weblogic-handler WeblogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 </Location> # BI SOA Services <Location /biservices> SetHandler weblogic-handler WeblogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 </Location> # AdminService <Location /AdminService> SetHandler weblogic-handler WeblogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 </Location> # AsyncAdminService <Location /AsyncAdminService> SetHandler weblogic-handler WeblogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 </Location> #OWSM <Location /wsm-pm> SetHandler weblogic-handler WeblogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 </Location>
Add the following directives to the bi_vh.conf file within the <VirtualHost> tags:
#redirect browser requests that omit document/dir RedirectMatch 301 /analytics$ /analytics/ RedirectMatch 301 /bimiddleware$ /bimiddleware/ RedirectMatch 301 /xmlpserver$ /xmlpserver/ RedirectMatch 301 /ui$ /ui/ RedirectMatch 301 /analytics/res$ /analytics/res/ RedirectMatch 301 /biofficeclient$ /biofficeclient/ RedirectMatch 301 /biservices$ /biservices/ RedirectMatch 301 /analytics-ws$ /analytics-ws/ RedirectMatch 301 /ws$ /ws/ RedirectMatch 301 /wsm-pm$ /wsm-pm/ RedirectMatch 301 /bisearch$ /bisearch/ RedirectMatch 301 /mapviewer$ /mapviewer/ RedirectMatch 301 /bicontent$ /bicontent/ RedirectMatch 301 /bicomposer$ /bicomposer/ RedirectMatch 301 /mobile$ /mobile/ RedirectMatch 301 /rtis$ /rtis/ RedirectMatch 301 /aps$ /aps/ RedirectMatch 301 /calcmgr$ /calcmgr/ RedirectMatch 301 /hr$ /hr/ RedirectMatch 301 /workspace$ /workspace/ # BIEE Analytics <Location /analytics> SetHandler weblogic-handler WebLogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 WLProxySSL ON WLProxySSLPassThrough ON </Location> <Location /analytics-ws> SetHandler weblogic-handler WebLogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 WLProxySSL ON WLProxySSLPassThrough ON </Location> <Location /bimiddleware> SetHandler weblogic-handler WebLogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 WLProxySSL ON WLProxySSLPassThrough ON </Location> <Location /bicontent> SetHandler weblogic-handler WebLogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 WLProxySSL ON WLProxySSLPassThrough ON </Location> <Location /mobile> SetHandler weblogic-handler WebLogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 WLProxySSL ON WLProxySSLPassThrough ON </Location> # MapViewer <Location /mapviewer> SetHandler weblogic-handler WebLogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 WLProxySSL ON WLProxySSLPassThrough ON </Location> # BI Publisher <Location /xmlpserver> SetHandler weblogic-handler WebLogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 WLProxySSL ON WLProxySSLPassThrough ON </Location> # Oracle RTD <Location /ui> SetHandler weblogic-handler WebLogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 WLProxySSL ON WLProxySSLPassThrough ON </Location> <Location /rtis> SetHandler weblogic-handler WebLogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 WLProxySSL ON WLProxySSLPassThrough ON </Location> <Location /schema> SetHandler weblogic-handler WebLogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 WLProxySSL ON WLProxySSLPassThrough ON </Location> <Location /ws> SetHandler weblogic-handler WebLogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 WLProxySSL ON WLProxySSLPassThrough ON </Location> # BI Search <Location /bisearch> SetHandler weblogic-handler WebLogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 WLProxySSL ON WLProxySSLPassThrough ON </Location> # BI Composer <Location /bicomposer> SetHandler weblogic-handler WebLogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 WLProxySSL ON WLProxySSLPassThrough ON </Location> # EPM Provider Services <Location /aps> SetHandler weblogic-handler WeblogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 WLProxySSL ON WLProxySSLPassThrough ON </Location> # EPM Calc Manager <Location /calcmgr> SetHandler weblogic-handler WeblogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 WLProxySSL ON WLProxySSLPassThrough ON </Location> # EPM Financial Reporting <Location /hr> SetHandler weblogic-handler WeblogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 WLProxySSL ON WLProxySSLPassThrough ON </Location> # EPM Workspace <Location /workspace> SetHandler weblogic-handler WeblogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 WLProxySSL ON WLProxySSLPassThrough ON </Location> # BI Office <Location /bioffice> SetHandler weblogic-handler WeblogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 WLProxySSL ON WLProxySSLPassThrough ON </Location> # BI Office Client <Location /biofficeclient> SetHandler weblogic-handler WeblogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 WLProxySSL ON WLProxySSLPassThrough ON </Location> # OWSM <Location /wsm-pm> SetHandler weblogic-handler WeblogicCluster APPHOST1VHN1:9704,APPHOST2VHN1:9704 WLProxySSL ON WLProxySSLPassThrough ON </Location>
Note:
Add other resources as appropriate (such as analyticsRes or ActionSamples to support functionality in the SampleApp.rpd file).
Restart Oracle HTTP Server on both WEBHOST1 and WEBHOST2, as follows:
WEBHOST1> ORACLE_BASE/admin/instance_name/bin/opmnctl restartproc ias-component=ohs1 WEBHOST2> ORACLE_BASE/admin/instance_name/bin/opmnctl restartproc ias-component=ohs2
The servers that are specified in the WebLogicCluster parameters are important only at startup time for the plug-in. The list must provide at least one running cluster member for the plug-in to discover other members in the cluster. The listed cluster member must be running when Oracle HTTP Server is started. Oracle WebLogic Server and the plug-in work together to update the server list automatically with new, failed, and recovered cluster members.
Sample scenarios include:
Example 1: If you have a two-node cluster and add a third member, then you do not need to update the configuration to add the third member. The third member is discovered dynamically at runtime.
Example 2: You have a three-node cluster, but only two nodes are listed in the configuration. However, if both listed nodes are down when you start Oracle HTTP Server, then the plug-in fails to route to the cluster. You must ensure that at least one of the listed nodes is running when you start Oracle HTTP Server.
If you list all the members of the cluster, then you guarantee that you can route to the cluster, assuming at least one member is running when Oracle HTTP Server is started.
For more information on configuring the WebLogic Server plug-in, see Oracle Fusion Middleware Using Web Server Plug-Ins with Oracle WebLogic Server.
For security purposes, and because the load balancer terminates SSL requests (Oracle HTTP Server routes the requests as non-SSL to WebLogic Server), after SSL is configured for the load balancer, turn on the WebLogic Plugin Enabled flag for the domain. Perform the following steps to turn on the flag:
Log in to the Administration Console.
Click the domain name in the navigation tree on the left.
Click the Web Applications tab.
In the Change Center, click Lock & Edit.
Select WebLogic Plugin Enabled.
Click Save, then click Activate Changes.
For Fusion Middleware Control to manage and monitor Oracle HTTP Server instances, the instances must be registered with the domain. To do this, you must register Oracle HTTP Server with Oracle WebLogic Server using the following command:
WEBHOST1> cd ORACLE_INSTANCE/bin
WEBHOST1> ./opmnctl registerinstance -adminHost ADMINVHN -adminPort 7001 -adminUsername weblogic
You must also run this command from WEBHOST2 for OHS2.
Note:
After you register Oracle HTTP Server, it is displayed as a manageable target in Fusion Middleware Control. To verify this, log in to Fusion Middleware Control. The WebTier item in the navigation tree shows that Oracle HTTP Server has been registered.
The Administration Console application tracks changes made to ports, channels and security using the console. When changes made through the console are activated, the console validates its current listen address, port, and protocol. If the listen address, port, and protocol are still valid, then the console redirects the HTTP request, which replaces the host and port information with the listen address and port of the Administration Server. When the Administration Console is accessed using a load balancing router (LBR), you must change the frontend URL of the Administration Server so that the user's web browser is redirected to the appropriate LBR address. Perform the following steps to set the frontend URL:
Log in to the Administration Console.
In the Change Center, click Lock & Edit.
Expand the Environment node in the Domain Structure window.
Click Servers. The Summary of Servers page is displayed.
Select AdminServer(admin) in the Names column of the table. The settings page for AdminServer(admin) is displayed.
Click the Protocols tab.
Click the HTTP tab.
Set the Frontend Host field to admin.mycompany.com (your LBR address).
Set the Frontend HTTP Port to 80.
Click Save, then click Activate Changes.
Note:
To eliminate redirections, it is recommended that you disable the Administration Console's "Follow changes" feature. Ensure that the Follow Configuration Changes option in the Shared Preferences dialog under the Preferences menu is not selected.
Verify that the server status is reported as "Running" in the Administration Console. If the server is shown as "Starting" or "Resuming," then wait for the server status to change to "Started." If another status is reported (such as "Admin" or "Failed"), then check the server output log files for errors.
This section contains the following topics:
Section 8.4.5.1, "Validating the Administration Console and Fusion Middleware Control"
Section 8.4.5.2, "Validating Access Through the Load Balancer"
Validate the Administration Console and Fusion Middleware Control through both Oracle HTTP Server instances using the following URLs:
http://WEBHOSTn:7777/console
http://WEBHOSTn:7777/em
Note:
After setting the frontend URL to the LBR address, the access to the console through the WEBHOSTn addresses is redirected by the console to the frontend URL, thus validating the correct configuration of both Oracle HTTP Server and the LBR device.
http://admin.mycompany.com/console
http://admin.mycompany.com/em
For information on configuring system access through the load balancer, see Section 3.3, "Configuring the Load Balancer."
Validate bi_cluster through the load balancer using the following URLs:
http://bi.mycompany.com/analytics
http://bi.mycompany.com/mapviewer
http://bi.mycompany.com/xmlpserver
http://bi.mycompany.com/ui
http://biinternal.mycompany.com/wsm-pm
http://bi.mycompany.com/bicomposer
http://bi.mycompany.com/hr
http://bi.mycompany.com/calcmgr/index.htm
http://bi.mycompany.com/aps/Essbase
http://bi.mycompany.com/aps/SmartView
http://bi.mycompany.com/workspace
For information on configuring system access through the load balancer, see Section 3.3, "Configuring the Load Balancer."
In case a node fails, you can fail over the Administration Server to another node. Test Administration Server failover at this point by following the steps in Section 13.5, "Manually Failing Over the Administration Server to APPHOST2."
After you have verified that the extended domain is working, back up the installation. This is a quick backup for the express purpose of immediate restore in case of problems in the further steps. The backup destination is the local disk. This backup can be discarded after the enterprise deployment setup is complete. At that point, the regular deployment-specific backup and recovery process can be initiated. The Oracle Fusion Middleware Administrator's Guide provides further details. For information on describing the Oracle HTTP Server data that must be backed up and restored, refer to the "Backup and Recovery Recommendations for Oracle HTTP Server" section in that guide. For information on how to recover components, see the "Recovering Components" and "Recovering After Loss of Component Host" sections in the guide. For recommendations specific to recovering from the loss of a host, see the "Recovering Oracle HTTP Server to a Different Host" section in the guide. Also refer to Oracle Database Backup and Recovery User's Guide for information on database backup.
Perform these steps to back up the installation at this point:
Back up the Web tier, using the following steps:
Shut down the instance using opmnctl:
WEBHOSTn> ORACLE_BASE/admin/instance_name/bin/opmnctl stopall
Back up the Middleware home on the Web tier using the following command (as root):
WEBHOSTn> tar -cvpf BACKUP_LOCATION/web.tar MW_HOME
Back up the Oracle instance on the Web tier using the following command:
WEBHOSTn> tar -cvpf BACKUP_LOCATION/web_instance_name.tar ORACLE_INSTANCE
Start the instance using opmnctl:
WEBHOSTn> cd ORACLE_BASE/admin/instance_name/bin WEBHOSTn> opmnctl startall
Back up the database. This is a full database backup (either hot or cold) using Oracle Recovery Manager (recommended) or operating system tools such as tar for cold backups if possible.
Back up the BI Instance in the application tier, using the following steps:
Shut down the instance using opmnctl:
APPHOST1> ORACLE_INSTANCE/bin/opmnctl stopall
Back up the Middleware home on the application tier using the following command:
APPHOST1> tar -cvpf BACKUP_LOCATION/bi.tar MW_HOME
Back up the Oracle instance on the application tier using the following command:
APPHOST1> tar -cvpf BACKUP_LOCATION/bi_instance_name.tar ORACLE_INSTANCE
Start the instance using opmnctl:
APPHOST1> ORACLE_INSTANCE/bin/opmnctl startall
Back up the Administration Server and Managed Server domain directories to save the domain configuration. The configuration files all exist in the ORACLE_BASE/admin/ domain_name directory. Run the following command to create the backup:
APPHOST1> tar -cvpf edgdomainback.tar ORACLE_BASE/admin/domain_name