Oracle® Beehive Installation Guide Release 1 (1.4) for Microsoft Windows (32-Bit) Part Number E13792-02 |
|
|
View PDF |
Note:
These procedures apply only to Oracle Beehive Release 1 (1.4) and later.This module describes how to install and configure Oracle Beehive to support deployment on multiple Oracle Real Application Clusters (RAC) nodes. It covers the following topics:
Note:
You may use Database Configuration Assistant (DBCA) to create Oracle RAC nodes. However, refer to OracleMetaLink Note 342419.1 to properly configure the LOCAL_LISTENER initialization parameter.This module uses the following naming conventions:
Global service name of the Oracle RAC database to be used: MYDB
Number of Oracle RAC nodes: R
SID of first Oracle RAC node: MyDB1
SID of second Oracle RAC node: MyDB2
SID of R
th Oracle RAC node: MyDBR
Virtual Internet Protocol (VIP) host names and listener port numbers for each Oracle RAC node: HOST-VIP1:PORT1
to HOST-VIPR:PORTR
Oracle Notification Services (ONS) host names and remote port numbers for each Oracle RAC node: ONS_HOST1:ONS_PORT1
to ONS_HOSTR:ONS_PORTR
Note:
The location of the archive redo logs for each Oracle RAC node must be accessible by all nodes in your Oracle RAC database.Refer to "Managing Archived Redo Logs Using RMAN in Oracle Real Application Clusters" in Chapter 5, "Configuring Recovery Manager And Archiving" in Oracle Real Application Clusters Administration and Deployment Guide for more information.
If your Oracle RAC database uses raw storage, you must manually create the tablespace ORABPEL before running the Oracle Beehive Install Wizard. To do this, run the following command:
CREATE TABLESPACE ORABPEL DATAFILE '/dev/raw/raw1' SIZE 100M
AUTOEXTEND ON NEXT 30M MAXSIZE UNLIMITED;
/dev/raw/raw1
is the name of the data file to create for the ORABPEL tablespace.
Note:
If you want to install Oracle Beehive with Oracle Beehive Provisioning Application and you require SSL Oracle Notification Services (ONS) notification, you must follow the steps described in "Enabling Secure ONS Notification".For more information about Oracle Beehive Provisioning Application, refer to "Installing Oracle Beehive with Provisioning Application".
Install Oracle Beehive with the Oracle Beehive Install Wizard. Enter the following database information:
Host and Port: HOST-VIP1:PORT1^HOST-VIP2:PORT2^HOST-VIP3:PORT3
Service Name: Use the global service name (MYDB
).
Note:
During the installation of Oracle Beehive, ensure the first Oracle RAC node (MyDB1
) remains up. Otherwise, the install will fail due to bug 5693566 (Web Services Manager Configuration Assistant will fail).These steps update Oracle Beehive with the Oracle RAC global service name and the multiple database service names:
Step 1 Backup Bootstrap File
The file <Oracle home>
/beehive/conf/beehiveconfig.xml
contains the bootstrap database connect information. Make a backup of this file before applying any post-install steps.
Step 2 Retrieve Site and Database Object System Identifiers
Retrieve the following system identifiers. You will need them for the following steps:
Site System Identifier:Use the following beectl
command to retrieve the Oracle Beehive site system identifier. In the following steps, <site_id>
represents this value:
beectl list_components --type Site
Database Object System Identifier: Use the following beectl
command to retrieve the default database system identifier. In the following steps, <database_system_object_id>
represents this value:
beectl list_properties --component <site_id>
This command lists all the properties of <site_id>
. The value of <database_system_object_id>
is the value of the property Database
.
Step 3 Update Database System Object
Modify the database system object's configuration to specify the ONS remote ports that are listening on your Oracle RAC nodes. The following example specifies two ONS remote ports with the ons_entry
option:
beectl modify_database --database <database_system_object_id> --ons_entry ONS_HOST1:ONS_PORT1 --ons_entry ONS_HOST2:ONS_PORT2
To determine the ONS remote port, run the following command:
<Oracle RAC database home>/bin/onsctl ping
You should see output similar to the following. The ONS remote port is indicated by the highlighted text:
Number of onsconfiguration retrieved, numcfg = 2 onscfg[0] {node = strasha05.us.oracle.com, port = 6200} Adding remote host strasha05.us.oracle.com:6200 onscfg[1] {node = strasha06.us.oracle.com, port = 6200} Adding remote host strasha06.us.oracle.com:6200 ons is running ...
Step 4 Commit Configuration Changes
Call beectl activate_configuration
on your Oracle Beehive instance. Afterwards, call beectl modify_local_configuration_files
on the same Oracle Beehive instance.
Note:
Thebeectl modify_local_configuration_files
command will ask you to run this command on all your other Oracle Beehive instances. Do not run this command on all your other instances at this time.
If you have, or plan to have, more than Oracle Beehive instance, refer to "Installing Multiple Oracle Beehive Instances with Oracle RAC".
Step 5 Restart Oracle Beehive
Restart your Oracle Beehive instance. You may use the beectl restart --all
command.
Note:
You must restart Oracle Beehive (after callingbeectl modify_local_configuration
) if you modify the ONS details in the database system object's configuration (as you have done previously).Step 6 Enable Secure ONS Notification
If you have not already done so and you require SSL ONS notification, follow the steps described in "Enabling Secure ONS Notification".
Step 7 Register for ONS Notification
By default, Oracle Beehive is configured to receive secure ONS notifications, which is recommended. If your Oracle RAC nodes are configured for SSL ONS notification, you may ignore this step.
If not, update the file <Oracle home>
/opmn/conf/opmn.xml
as follows in all Oracle Beehive instances to disable SSL ONS notifications:
In the file opmn.xml
, in the ssl
element, set the enabled
attribute to false:
<ssl enabled="false" wallet-file="$ORACLE_HOME/opmn/conf/ssl.wlt/default"/>
After changing the opmn.xml
file, run the following beectl
commands:
beectl list_components --type OpmnCluster -----------------+-------------------------------------------------------------- Component type | Component identifier -----------------+-------------------------------------------------------------- OpmnCluster | 5987aa04-2984-43ab-8752-8c27e0c45130 -----------------+-------------------------------------------------------------- 1 Record(s) displayed. beectl list_properties --component 5987aa04-2984-43ab-8752-8c27e0c45130 -----------------------------+-------------------------------------------------- Property name | Property value -----------------------------+-------------------------------------------------- Alias | -----------------------------+-------------------------------------------------- NotificationServerSslEnabled | true -----------------------------+-------------------------------------------------- Opmns | opmn_Beehive_R1.example.com -----------------------------+-------------------------------------------------- Site | _CURRENT_SITE -----------------------------+-------------------------------------------------- 4 Record(s) displayed. beectl modify_property --component 5987aa04-2984-43ab-8752-8c27e0c45130 --name NotificationServerSslEnabled --value false Changes to configuration repository are not activated. Successfully stored the property for component id 5987aa04-2984-43ab-8752-8c27e0c45130. beectl activate_configuration Local configuration files are not in sync with system model. Please run "modify_local_configuration_files" manually. Proposed configuration is saved successfully and activated now. beectl modify_local_configuration_files
You may ignore this step if your deployment does not require SSL notification.
Note:
You must perform this step if you wish to install Oracle Beehive with Oracle Beehive Provisioning Application. Refer to "Installing Oracle Beehive with Provisioning Application" for more information.This step involves specifying the Oracle Wallet directory in the ons.config
file. As a result, Oracle Cluster Ready Services (CRS) will use SSL when communicating with other nodes (other Oracle RAC nodes and Oracle Beehive instances) and require SSL certificate authentication from all Oracle Notification Services (ONS) instances that try to connect to it.
To enable SSL ONS notification, add the following line to all <Oracle Cluster Ready Services home>
/opmn/conf/ons.config
files of each Oracle RAC node:
walletfile=MY_SECURE_WALLER_DIR
MY_SECURE_WALLER_DIR
is your Oracle Wallet directory. Refer to "Configuring TLS with Oracle Wallet" for information about configuring Oracle Wallet.
Oracle Beehive supports the following ways to install multiple instances Oracle Beehive with Oracle RAC:
Install All Oracle Beehive Instances, then Apply Post-Install Steps
Install One Oracle Beehive Instance, Apply Post-Install Steps, then Add Additional Instances
You can install multiple Oracle Beehive instances, then run the post-install steps afterwards on all those instances as described in this module:
Install all your Oracle Beehive instances.
For one instance, apply all the post-installation steps.
For all the other instances, run the following post-installation steps:
Step 4, "Commit Configuration Changes", except run only the beectl modify_configuration_files command
.
Alternatively, instead of installing multiple Oracle Beehive instances then running the post-install steps on each one, you may install one Oracle Beehive instance, apply the post-install steps on that instance, then add additional Oracle Beehive instances.
After installing one Oracle Beehive instance and applying post-install steps, follow these steps:
Install other Oracle Beehive instances.
Apply Step 7, "Register for ONS Notification" to all new instances.
Oracle Beehive Affinity Service enables other Oracle Beehive services to take advantage of the enhanced performance when instances or nodes from your Oracle RAC environment has affinity for any data. Currently, only the event framework, or the Object Event Framework (OEF), and the E-mail Service can take advantage of the Affinity Service.
To enable Oracle Beehive Affinity Service, follow these steps:
Create one database service for each Oracle RAC node with the following command:
srvctl add service -d <database global service name> -s <database service name> -r <RAC node instance ID>
For example, suppose your database has the global service name BEEHIVE
, and has four Oracle RAC nodes with IDs BEEHIVE1
, BEEHIVE2
, BEEHIVE3
, and BEEHIVE4
. Create four database services (named afserv1
, afserv2
, afserv3
, and afserv4
) with the following commands:
srvctl add service -d BEEHIVE -s afserv1 -r BEEHIVE1 srvctl add service -d BEEHIVE -s afserv2 -r BEEHIVE2 srvctl add service -d BEEHIVE -s afserv3 -r BEEHIVE3 srvctl add service -d BEEHIVE -s afserv4 -r BEEHIVE4
Set the property AffinityServiceNames with the names of your newly created database services. For example, to set this property with the four database services created in the previous step, call the following command (the example assumes the domain name is example.com
):
beectl modify_property --component _CURRENT_SITE:Database --name AffinityServiceNames --value afserv1.example.com --value afserv2.example.com --value afserv3.example.com --value afserv4.example.com
Note:
If the global service name has been created with the domain name (such as example.com), all the database services should use the same domain name even though they have not been created with the domain name.Activate the configuration with the following command:
beectl activate_configuration
The database framework will immediately start using the Affinity Service.