Skip Headers
Oracle® Fusion Middleware Enterprise Deployment Guide for Oracle Business Intelligence
11g Release 1 (11.1.1)

Part Number E15722-06
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

8 Creating a Domain with the Administration Server and First Managed Server

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:

8.1 Overview of Creating a Domain

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.

Section 8.3, "Post-Configuration and Verification 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.

Section 8.6, "Backing Up the Installation"


8.2 Creating a Domain and the bi_server1 Managed Server on APPHOST1

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.

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

  2. 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
    
  3. Start the Configuration Assistant:

    APPHOST1> ./config.sh
    
  4. In the Welcome screen, click Next.

  5. In the Prerequisite Checks screen, verify that all checks complete successfully, and click Next.

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

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

  8. In the Configure Components screen, select the following:

    • Oracle Business Intelligence

      • Oracle BI EE

      • BI Publisher

      • Real-Time Decisions

      • Essbase Suite

    Click Next.

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

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

  11. In the Configure Ports screen, select one the following:

    • Auto Port Configuration

    • Specify Ports using Configuration File

    Click Next.

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

  13. In the Summary screen, click Configure.

  14. In the Configuration Progress screen, verify that all the Configuration Tools have completed successfully and click Next.

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

8.3 Post-Configuration and Verification Tasks

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:

8.3.1 Configuring JMS for BI Publisher

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.

  1. Log into the Administration Console.

  2. In the Domain Structure window, expand the Services node and click the Persistent Stores node. The Summary of Persistent Stores page is displayed.

  3. In the Change Center, click Lock & Edit.

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

  5. Click Save and Activate Changes.

  6. The changes do not take effect until the Managed Server is restarted. Restart the Managed Server.

8.3.2 Creating boot.properties for the Administration Server on APPHOST1

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.

  1. Go to the following directory:

    ORACLE_BASE/admin/domain_name/aserver/domain_name/servers/AdminServer/security
    
  2. 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.

  3. Save the file and close the editor.

8.3.3 Starting the Administration Server on APPHOST1

The Administration Server is started and stopped using Node Manager. However, the first start of the Administration Server with Node Manager requires changing the default user name and password that the Configuration Assistant set for Node Manager. Perform the following steps to start the Administration Server using Node Manager:

  1. Use the Administration Console to update the Node Manager credentials, using the following steps:

    1. Open a Web browser and go to http://APPHOST1:7001/console.

    2. Log in as the administrator.

    3. In the Change Center, click Lock & Edit to enable configuration changes.

    4. Click domain_name, then Security, then General, and expand the Advanced options at the bottom.

    5. Enter a new user name for Node Manager, or make a note of the existing one and update the Node Manager password.

    6. Click Save.

    7. Click Activate Changes.

  2. Stop the Administration Server process using one of the following methods:

    • Use Ctrl+C in the shell in which it was started

    • Use the standard process identification and kill commands in the operating system

    • Log in to the Administration Console and click Servers under the Environment heading, then click the Control tab. Select AdminServer(admin) and click Shutdown.

  3. Stop and restart Node Manager and enable dynamic registration, using the following steps:

    1. Stop the running NodeManager process.

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

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

8.3.4 Enabling Administration Server High Availability

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:

8.3.4.1 Create a Machine for the Administration Server

Perform the following steps to create a new machine and assign the Administration Server to the new machine using the Administration Console:

  1. Log in to the Administration Console.

  2. In the Change Center, click Lock & Edit.

  3. In the Environment section of the Home page, click Machines.

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

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

  6. On the Summary of Machines page, click the newly created Machine link.

  7. On the Settings page for the ADMINHOST machine, select the Servers tab.

  8. Click Add under the Servers table.

  9. On the Add a Server to Machine page, choose Select an existing server, and associate it with this machine option.

  10. Choose the AdminServer from the drop-down menu.

  11. Click Finish to associate the Administration Server with the Machine.

  12. In the Change Center, click Activate Changes.

8.3.4.2 Enabling the Administration Server to Listen on the Virtual IP Address

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:

  1. Log in to the Administration Console.

  2. In the Change Center, click Lock & Edit.

  3. Expand the Environment node in the Domain Structure window.

  4. Click Servers. The Summary of Servers page is displayed.

  5. Select AdminServer(admin) in the Names column of the table. The Setting page for AdminServer(admin) is displayed.

  6. Set the Listen Address to ADMINVHN.

  7. Click Save.

  8. Click Activate Changes.

  9. The changes do not take effect until the Administration Server is restarted. Perform the following steps to restart the Administration Server:

    1. In the Summary of Servers page, select the Control tab.

    2. Select AdminServer(admin) in the table and then click Shutdown.

    3. 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','9556','domain_name','DOMAIN home')
      wls:/nm/domain_name> nmStart ('AdminServer')
      

8.3.4.3 Creating a Separate Domain Directory for the bi_server1 Managed Server

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:

  1. Stop the Administration Server and bi_Server1 Managed Server, using the following steps:

    1. Log in to the Administration Console.

    2. Expand the Environment node in the Domain Structure window.

    3. Click Servers. The Summary of Servers page is displayed.

    4. On the Summary of Servers page, select the Control tab.

    5. Select AdminServer(admin) and bi_server1 in the table and then click Shutdown.

  2. 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
    
  3. 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
    
  4. 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')
    
  5. Start the bi_server1 Managed Server on APPHOST1, using the following steps (ensuring that Node Manager is up and running):

    1. Log in to the Administration Console.

    2. Expand the Environment node in the Domain Structure window.

    3. Click Servers. The Summary of Servers page is displayed.

    4. On the Summary of Servers page, select the Control tab.

    5. Select bi_server1 in the table and then click Start.

8.3.4.4 Enabling Fusion Middleware Control Failover

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.

8.3.5 Validating the Administration Server

Perform the following steps to ensure that the Administration Server is properly configured:

  1. Open a Web browser and go to http://ADMINVHN:7001/console.

  2. Log in as the administrator.

  3. Check that you can access Fusion Middleware Control at:

    http://ADMINVHN:7001/em

  4. 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."

8.3.6 Setting the Listen Address for bi_server1 Managed Server

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:

  1. Log in to the Administration Console.

  2. In the Change Center, click Lock & Edit.

  3. Expand the Environment node in the Domain Structure window.

  4. Click Servers. The Summary of Servers page is displayed.

  5. Select bi_server1 in the Names column of the table. The Setting page for bi_server1 is displayed.

  6. Set the Listen Address to APPHOST1VHN1.

  7. Click Save.

  8. Click Activate Changes.

  9. 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):

    1. On the Summary of Servers page, select the Control tab.

    2. Select bi_server1 in the table and then click Shutdown.

    3. After the server has shut down, select bi_server1 in the table and then click Start.

  10. Restart the Oracle Business Intelligence system components, as follows:

    cd ORACLE_BASE/admin/instance1/bin
    ./opmnctl stopall
    ./opmnctl startall
    

8.3.7 Updating the BI Publisher Scheduler Configuration

Perform the following steps to update the WebLogic JNDI URL for the BI Publisher Scheduler:

  1. Log in to BI Publisher at the following URL:

    http://APPHOST1VHN1:9704/xmlpserver

  2. Click the Administration link.

  3. Click Scheduler Configuration under System Maintenance. The Scheduler Configuration screen is displayed.

  4. Update the WebLogic JNDI URL under JMS Configuration, as follows:

    cluster:t3://bi_cluster

  5. Click Test JMS.

    You see a confirmation message that JMS tested successfully.

  6. Click Apply. The changes are sent to the cluster to be applied at runtime.

  7. Check the Scheduler status from the Scheduler Diagnostics tab.

8.3.8 Disabling Host Name Verification for the bi_server1 Managed Server

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:

  1. Log in to the Administration Console.

  2. In the Change Center, click Lock & Edit.

  3. Expand the Environment node in the Domain Structure window.

  4. Click Servers. The Summary of Servers page is displayed.

  5. Select bi_server1 in the Names column of the table. The settings page for the server is displayed.

  6. Open the SSL tab.

  7. Expand the Advanced section of the page.

  8. Set Hostname Verification to 'None'.

  9. Click Save.

  10. Click Activate Changes.

  11. 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):

    1. On the Summary of Servers page, select the Control tab.

    2. Select bi_server1 in the table and then click Shutdown.

    3. Select bi_server1 in the table and then click Start.

  12. Restart the Oracle Business Intelligence system components, as follows:

    cd ORACLE_BASE/admin/instance1/bin
    ./opmnctl stopall
    ./opmnctl startall
    

8.3.9 Validating Oracle Business Intelligence on APPHOST1

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.

8.4 Configuring Oracle HTTP Server for the WebLogic Domain

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:

8.4.1 Configuring Oracle HTTP Server for the Administration Server and the bi_servern Managed Servers

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:

  1. 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>
    
  2. 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 /xmlpserver$ /xmlpserver/
    RedirectMatch 301 /ui$ /ui/
    RedirectMatch 301 /bisearch$ /bisearch/
    RedirectMatch 301 /mapviewer$ /mapviewer/
    RedirectMatch 301 /bicontent$ /bicontent/
    RedirectMatch 301 /bicomposer$ /bicomposer/
    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>
    
    # 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>
    
  3. 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 /bisearch$ /bisearch/
    RedirectMatch 301 /mapviewer$ /mapviewer/
    RedirectMatch 301 /bicontent$ /bicontent/
    RedirectMatch 301 /bicomposer$ /bicomposer/
    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>
    
    # 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>
    

    Note:

    Add other resources as appropriate (such as analyticsRes or ActionSamples to support functionality in the SampleApp.rpd file).

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

8.4.2 Turning On the WebLogic Plug-In Enabled Flag

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:

  1. Log in to the Administration Console.

  2. Click the domain name in the navigation tree on the left.

  3. Click the Web Applications tab.

  4. In the Change Center, click Lock & Edit.

  5. Select WebLogic Plugin Enabled.

  6. Click Save, then click Activate Changes.

8.4.3 Registering Oracle HTTP Server with Oracle WebLogic Server

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.

8.4.4 Setting the Frontend URL for the Administration Console

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:

  1. Log in to the Administration Console.

  2. In the Change Center, click Lock & Edit.

  3. Expand the Environment node in the Domain Structure window.

  4. Click Servers. The Summary of Servers page is displayed.

  5. Select AdminServer(admin) in the Names column of the table. The settings page for AdminServer(admin) is displayed.

  6. Click the Protocols tab.

  7. Click the HTTP tab.

  8. Set the Frontend Host field to admin.mycompany.com (your LBR address).

  9. Set the Frontend HTTP Port to 80.

  10. Click Save, then click Activate Changes.

To eliminate redirections, it is recommended that you disable the Administration Console's "Follow changes" feature. To do this, log in to the Administration Console and click Preferences, and Shared Preferences. Clear the Follow Configuration Changes option, and click Save.

8.4.5 Validating Access Through Oracle HTTP Server

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:

8.4.5.1 Validating the Administration Console and Fusion Middleware Control

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

8.4.5.2 Validating Access Through 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."

8.5 Verifying Manual Failover of the Administration Server

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

8.6 Backing Up the Installation

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:

  1. Back up the Web tier, using the following steps:

    1. Shut down the instance using opmnctl:

      WEBHOSTn> ORACLE_BASE/admin/instance_name/bin/opmnctl stopall
      
    2. Back up the Middleware home on the Web tier using the following command (as root):

      WEBHOSTn> tar -cvpf BACKUP_LOCATION/web.tar MW_HOME
      
    3. Back up the Oracle instance on the Web tier using the following command:

      WEBHOSTn> tar -cvpf BACKUP_LOCATION/web_instance_name.tar ORACLE_INSTANCE
      
    4. Start the instance using opmnctl:

      WEBHOSTn> cd ORACLE_BASE/admin/instance_name/bin
      WEBHOSTn> opmnctl startall
      
  2. 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.

  3. Back up the BI Instance in the application tier, using the following steps:

    1. Shut down the instance using opmnctl:

      APPHOST1> ORACLE_INSTANCE/bin/opmnctl stopall
      
    2. Back up the Middleware home on the application tier using the following command:

      APPHOST1> tar -cvpf BACKUP_LOCATION/bi.tar MW_HOME
      
    3. Back up the Oracle instance on the application tier using the following command:

      APPHOST1> tar -cvpf BACKUP_LOCATION/bi_instance_name.tar ORACLE_INSTANCE
      
    4. Start the instance using opmnctl:

      APPHOST1> ORACLE_INSTANCE/bin/opmnctl startall
      
  4. 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