Oracle® Collaboration Suite Installation Guide 10g Release 1 (10.1.1) for Solaris Operating System (SPARC) Part Number B14483-02 |
|
|
View PDF |
This chapter contains the following sections:
The order for the installation of Oracle Collaboration Suite Distributed Identity Management Architecture is as follows:
Install Oracle Cluster Ready Services. This is a prerequisite for the installation of Oracle Collaboration Suite 10g Database (ocsdb) in an Oracle Real Application Clusters (Oracle RAC) database.
Apply the Oracle Cluster Ready Services 10.1.0.4.2 patch set for your platform.The Oracle Cluster Ready Services 10.1.0.4.2 patch set for your platform is located on the Oracle Database 10g patch set (10.1.0.4.2) for Solaris Operating System (SPARC) DVD. patch set (10.1.0.4.2) for HP-UX DVD.
Install Oracle Collaboration Suite Database on Oracle RAC.
Configure load balancers for the Identity Management tier appropriately.
Install Identity Management on high availability nodes. The virtual server name of the load balancer must be specified in the Specify LDAP Virtual Host and Ports and the Specify HTTP Load Balancer Host and Ports screens during installation.
Run OCSdbSchemaReg.sh
script on a database node. This script registers the database with Oracle Internet Directory and runs the component Configuration Assistants that create schema objects for each Oracle Collaboration Suite component.
Install Oracle Calendar Server in Cold Failover Cluster Configuration. It must use a virtual host name, such as vhost.mydomain.com
. Install the oraInventory
directory and ORACLE_HOME
on a shared device that can be mounted to the other node for a cold failover.
Install Oracle Collaboration Suite Applications (without Oracle Calendar Server).
This section contains the following topics:
Section 13.2.1, "Installing and Applying a Patch to Oracle Cluster Ready Services"
Section 13.2.2, "Installing the Oracle Collaboration Suite 10g Database (ocsdb) on Oracle RAC"
Section 13.2.3, "Configuring Load Balancers for Identity Management"
Section 13.2.4, "Installing Identity Management on High Availability Nodes"
Section 13.2.9, "Installing the Subsequent Instance of Oracle Collaboration Suite Applications"
This section explains the installation steps for Oracle Cluster Ready Services. It also explains the steps involved in applying the patch to Oracle Cluster Ready Services.
Perform the steps listed in Table 13-1 to install Oracle Cluster Ready Services.
For Oracle Cluster Ready Services Installation steps, refer to Oracle Real Application Clusters Installation and Configuration Guide at
http://otn.oracle.com/pls/db10g/portal.portal_demo3?selected=16
.
Install the Oracle Cluster Ready Services software from the Oracle Collaboration Suite Supplemental DVD.
Table 13-1 Installing Oracle Cluster Ready Services
Step | Screen | Action |
---|---|---|
1. | None | Log in as the oracle user and set the ORACLE_BASE environment variable to specify the Oracle base directory that you created previously. For example:
/u01/app/oracle |
2. | None | Set the ORACLE_HOME environment variable to specify the Oracle Cluster Ready Services home directory that you created previously. For example:
/u01/crs/oracle/product/10.1.0/crs_1 |
3. | None | Run the runInstaller command from the top-level directory of the Oracle Cluster Ready Services Release 1 CD-ROM or the crs directory on the DVD-ROM. These are separate CD-ROMs and DVD-ROMs that contain the Cluster Ready Services software. |
4. | Welcome page | Click Next. |
5. | Specify Inventory Directory and Credentials
(Advanced installation only) |
This screen appears only if this is the first installation of any Oracle product on this computer.
Enter the full path for the inventory directory: Enter a full path to a directory for the installer files. Enter a directory that is different from the Oracle home directory for the product files. Example: Click OK. |
6. | UNIX Group Name
(Advanced installation only) |
This screen appears only if this is the first installation of any Oracle product on this computer.
Enter the name of the operating system group to have write permission for the inventory directory. Example: Click Next. |
7. | Run orainstRoot.sh
(Advanced installation only) |
This screen appears only if this is the first installation of any Oracle product on this computer.
Run the Click Continue. |
8. | Specify File Locations
(Advanced installation only) |
Enter the full path of the Source directory in the Path field for Source, if required.
Name: Enter a name to identify this Oracle home. The name cannot contain spaces, and has a maximum length of 16 characters. Example: Destination Path: Enter the full path to the destination directory. This is the Oracle home. If the directory does not exist, the installer creates it. To create the directory beforehand, create it as the oracle user; do not create it as the Example: Click Next. |
9. | Language Selection
(Advanced installation only) |
Select the required language from the Available Languages list and add it to the Selected Languages list.
Click Next. |
10. | Cluster Configuration
(Advanced installation only) |
Cluster Name: Specify the cluster name.
Specify the host name under Public Node Name. Similarly, specify the private name under Private Node Name. These names will be used to interconnect the node names within the cluster. Note: The private name cannot be the same as the public name. However, the private name can be an IP address. Click Next. |
11. | Specify Network Interface Usage
(Advanced installation only) |
Select the interface name, subnet, and interface type for the node in the cluster from the respective drop-down list.
The interface that you mark private will only be used for Oracle RAC internode traffic. Note: If there is more than one subnet associated with an interface, then specify the subnet that you want to associate with the interface type. |
12. | Oracle Cluster Registry
(Advanced installation only) |
Specify OCR Location: Specify the shared raw device or the cluster file system file that will be visible to all nodes of the cluster.
Note: At least 100 MB of disk space is required for the OCR. Click Next. |
13. | Voting Disk
(Advanced installation only) |
Enter voting disk file name: Specify the raw device or the cluster file system file for voting disk that will be visible to all nodes of the cluster.
Click Next. Note: At least 20 MB of disk space is required for the OCR. |
14. | Summary | Verify your selections and click Install. |
15. | Install Progress | This screen displays the progress of the installation. |
16. | Run root.sh |
Note: Do not run the root.sh script until this dialog box appears.
|
17. | Configuration Assistants | This screen shows the progress of the configuration assistants. Configuration assistants configure components. |
18. | End of Installation | Click Exit to quit the installer. |
After installing Oracle Cluster Ready Services, you must apply Oracle Cluster Ready Services 10.1.0.4.2 patch set.The Oracle Cluster Ready Services 10.1.0.4.2 patch set for your platform is located on the Oracle Database 10g patch set (10.1.0.4.2) for Solaris Operating System (SPARC) DVD. The Oracle Cluster Ready Services 10.1.0.4.2 patch set for your platform is located on the Oracle Database 10patch set (10.1.0.4.2) for Linux x86 DVD. The Oracle Cluster Ready Services 10.1.0.2 patch set for your platform is located on the Oracle Database 10 patch set (10.1.0.4.2) for HP-UX DVD.
The steps to do so are listed in the Table 13-2.
Table 13-2 Installing Oracle Cluster Ready Services 10.1.0.4.2 Patch Set
Step | Screen | Action |
---|---|---|
1. | Welcome | Click Next. |
2. | Specify File Locations | Enter the full path of the Source directory in the Path field for Source, if required.
Destination Path: Enter the full path to the destination directory. This is the Oracle home. Both source and destination will be same as that provided during the installation of Oracle Cluster Ready Services. |
3. | Selected Nodes | Verify the nodes listed in the Node Names list and click Next. |
4. | Summary | Verify your selections and click Install. |
5. | End of Installation | Click Exit to quit the installer. |
To install Oracle Collaboration Suite 10g Database (ocsdb) on clustered hardware, follow the steps listed in Section 13.2.2.
The following table shows the storage options supported for storing Oracle Cluster Ready Services files, Oracle Database files, and Oracle Database recovery files. Oracle Database files include datafiles, control files, redo log files, the server parameter file, and the password file. Oracle Cluster Ready Services files include the Oracle Cluster Registry (OCR) and the Oracle Cluster Ready Services voting disk.
For all installations, you must choose the storage option that you want to use for Oracle Cluster Ready Services files and Oracle Database files. To enable automated backups during the installation, you must also choose the storage option that you want to use for recovery files (the flash recovery area). You do not have to use the same storage option for each file type.
Storage Option | File Types Supported | ||
---|---|---|---|
CRS | Database | Recovery | |
Automatic Storage Management | No | Yes | Yes |
Cluster file system
Note: Requires a supported cluster file system |
Yes | Yes | Yes |
NFS file system
Note: Currently supported only with Fujitsu PRIMECLUSTER and a certified NAS device (SPARC only) |
Yes | Yes | Yes |
Shared raw logical volumes (SPARC only) | Yes | Yes | No |
Shared raw partitions | Yes | Yes | No |
Use the following guidelines when choosing the storage options that you want to use for each file type:
You can choose any combination of the supported storage options for each file type as long as you satisfy any requirements listed for the chosen storage options.
Oracle recommends that you choose ASM as the storage option for database and recovery files.
For Standard Edition installations, ASM is the only supported storage option for database or recovery files.
You cannot use Automatic Storage Management to store Oracle Cluster Ready Services files, because these files must be accessible before any Oracle instance starts.
If you plan to use ASM instances for the OracleAS Metadata Repository database, consider these recommendations:
If you plan to use ASM with Oracle Database instances from multiple database homes on the same node, then you should run the ASM instance from an Oracle home that is different from the database homes.
The ASM home should be installed on every cluster node. This prevents the accidental removal of ASM instances that are in use by databases from other homes during the deinstallation of a database Oracle home.
The postinstallation tasks involve troubleshooting any installation errors.
You might have to perform the postinstallation step to solve the following problem.
Oracle Collaboration Suite 10g Database (ocsdb) with ASM install fails at DBCA with ORA-15018 and ORA-15031. To resolve this error, download and replace the dbca.jar
file in ORACLE_HOME/assistants/dbca/jlib
before running root.sh
.
This section explains the implementation of load balancing for Identity Management in a high availability environment.
This section discusses the prerequisites for the installation of Identity Management on high availability nodes.
A load balancer should be configured to detect service down on a node and automatically stop traffic to that node. Also, the load balancer is recommended to be in a fault tolerant mode. This section provides instructions for configuring a load balancer for Identity Management.
To configure a load balancer for OracleAS Cluster (Identity Management), perform the following steps:
Verify that the load balancer virtual server name you select does not contain the physical host names of the nodes in the Identity Management.
When the installer copies files to different nodes in the Identity Management, it replaces the current host name in the files with the host name of the target node. Ensure that the load balancer's virtual server name does not contain the host names of the nodes in the cluster, or the installer might change the virtual server name of the load balancer as well.
For example, if you are installing on nodes named rac-1 and rac-2, be sure that the load balancer virtual server name does not contain "rac-1" or "rac-2". When the installer is installing files to rac-2, it searches for the string "rac-1" in the files and replaces it with "rac-2". If the load balancer's virtual server name happens to be LB-rac-1x, the installer sees the string "rac-1" in the name and replaces it with "rac-2", thus mangling the virtual server name to LB-rac-2x.
Configure your load balancer with virtual server names and associated ports as follows:
Configure a virtual server name for LDAP connections. For this virtual server, you must configure one port for SSL connections and the other for non-SSL connections.
Configure a virtual server name for HTTP connections. For this virtual server, you must configure one port for SSL connections and the other for non-SSL connections.
Configure your LDAP server to direct response to the first node initially. Note that this procedure applies only to the LDAP virtual server configured on your load balancer. This does not apply to the HTTP virtual server configured on the load balancer.
The installer will prompt you for the virtual server names and port numbers.
After you complete installation on a node, then you can add that node to the virtual server. For example, if you have three nodes, then perform the following steps:
Configure the LDAP virtual server to direct requests to node 1 only.
Install Identity Management components on node 1.
Install Identity Management components on node 2.
Add node 2 to the LDAP virtual server.
Install Identity Management components on node 3.
Add node 3 to the LDAP virtual server.
Set up cookie persistence for HTTP traffic on the load balancer. Specifically, set up cookie persistence for URIs starting with /oiddas/
. This is the URI for Oracle Delegated Administration Services. If your load balancer does not allow you to set cookie persistence at the URI level, then set the cookie persistence for all HTTP traffic. In either case, set the cookie to expire when the browser session expires. Refer to your load balancer documentation for details.
To configure the load balancer for automatic monitoring of the Oracle Internet Directory and OracleAS Single Sign-On, Oracle Delegated Administration Services, set up monitors for the following:
LDAP port
LDAP SSL port
HTTP or HTTPS listen port (depending on the deployment type)
Oracle recommends that these monitors use the respective protocols to monitor the services. That is LDAP for the LDAP port, LDAP over SSL for the LDAP SSL port, and HTTP/HTTPS for the web server port. If the load balancer does not offer one or all of these monitors, consult the load balancer documentation for details on the best method to set up the load balancer.
This section describes how to install Identity Management on high availability nodes.
To install the first instance of Identity Management that consists of Oracle Internet Directory and Directory Integration and Provisioning, follow the steps listed in Table 13-3.
Table 13-3 Installing the First Instance of Oracle Internet Directory and Directory Integration and Provisioning
Step | Screen | Action |
---|---|---|
1. | Welcome | Click Next. |
2. | Specify File Locations | Enter a name and path for the new Oracle home.This new Oracle home will be the destination Oracle home for Identity Management. Click Next. |
3. | Specify Hardware Cluster Installation Mode (optional) | Select Local Installation.This screen will only show up if you are installing Identity Management on a cluster. Click Next. |
4. | Select a Product to Install | Select Oracle Collaboration Suite Infrastructure 10.1.1.0.2.
Click Next. |
5. | Select Installation Type | Select Identity Management.
Click Next. |
6. | Product-Specific Prerequisite Checks | Make sure all the checks complete successfully.
Click Next. |
7 | Language Selection | Select the languages. Click Next. |
8. | Select Configuration Options | Select Oracle Internet Directory.Select OracleAS Directory Integration and Provisioning.Do not select OracleAS Certificate Authority (OCA).Select High Availability and Replication.
Click Next. |
8. | Specify Repository | Username: Enter the username to use to log in to the Oracle Collaboration Suite 10g Database (ocsdb). The user must have DBA privileges.
Password: Enter the user password. Hostname and Port: Enter the names of all the nodes where the Oracle Collaboration Suite 10g Database (ocsdb) is running and the port numbers.Use the format: Host1.domain.com:port1^Host2.domain.com:port2^… Service Name: Enter the service name of the database. Note that the service name must include the database domain name. Click Next. |
9. | Select High Availability or Replication Option | Select OracleAS Cluster (Identity Management).
Click Next. |
10. | Specify New Oracle Application Server Cluster Name | Specify a cluster name you want to create for the OracleAS Cluster (Identity Management) in the New Oracle Application Server Cluster Name field.
Click Next. |
11. | Specify Namespace in Internet Directory | Enter a new namespace for Oracle Internet Directory or select the Suggested Namespace:
dc=us,dc=oracle,dc=com Click Next. |
12. | Specify Port Configuration Options | Select Manual Port Selection option.
Oracle HTTP Server port: 7777 Oracle HTTP Server SSL port: 4443 Oracle Internet Directory port: 7389 Oracle Internet Directory (SSL) port: 4636 Click Next. |
13. | Guest Account Password | Enter the password for the orclguest account.
Click Next. |
14. | Specify Instance Name and ias_admin Password |
Instance Name: Enter a name for this Identity Management instance.
|
15. | Summary | Verify your selection and click Install. |
16. | The Configuration Assistant | This screen shows the progress of the configuration assistants. |
Before installing the subsequent instance of Identity Management, you must perform the preinstallation tasks.
Preinstallation Tasks
The preinstallation tasks for the installation of subsequent instance of Identity Management are as follows:
Ensure that the system time on this Identity Management node is synchronized with the time on the other Identity Management nodes that are part of this Oracle Cluster (Identity Management) configuration. Failure to ensure this may result in unwanted instance failovers, inconsistent operational attributes in directory entries, and potential inconsistent behavior of password state policies.
To install the current OracleAS (Identity Management) node correctly, set up your load balancer LDAP virtual server to direct requests to any existing OracleAS Cluster (Identity Management) node that is already running. After you complete the installation on this node, then you can add it to the load balancer LDAP virtual server.
Installation Tasks
To install the second instance of Identity Management, which consists of Oracle Internet Directory and Directory Integration and Provisioning, follow the steps listed in Table 13-4.
Table 13-4 Installing the Second Instance of Oracle Internet Directory and Directory Integration and Provisioning
Step | Screen | Action |
---|---|---|
1. | Welcome | Click Next. |
2. | Specify File Locations | Enter a name and path for the new Oracle home.This new Oracle home will be the destination Oracle home for your Identity Management. Click Next. |
3. | Specify Hardware Cluster Installation Mode (optional) | Select Local Installation.This screen will only show up if you are installing Oracle Collaboration Suite Identity Management on a cluster. Click Next. |
4. | Select a Product to Install | Select Oracle Collaboration Suite Infrastructure 10.1.1.0.2.
Click Next. |
5. | Select Installation Type | Select Identity Management.
Click Next. |
6. | Product-specific Prerequisite Checks | Make sure all the checks complete successfully.
Click Next. |
7 | Language Selection | Select the languages. Click Next. |
8. | Select Configuration Options | Select Oracle Internet Directory.Select OracleAS Directory Integration and Provisioning.Do not select OracleAS Certificate Authority (OCA).Select High Availability and Replication.
Click Next. |
9. | Specify Repository | Username: Enter the username to use to log in to the Oracle Collaboration Suite 10g Database (ocsdb). The user must have DBA privileges.
Password: Enter the user password. Hostname and Port: Enter the names of all the nodes where the Oracle Collaboration Suite 10g Database (ocsdb) is running and the port numbers.Use the format: Host1.domain.com:port1^Host2.domain.com:port2^… Service Name: Enter the service name of the database. Note that the service name must include the database domain name. Click Next. |
Warning: Ensure that the system time on this Identity Management Node is synchronized with the time on other Identity Management Nodes that are part of this Oracle Cluster (Identity Management) configuration. Failure to ensure this may result in unwanted instance failovers, inconsistent operational attributes in directory entries and potential inconsistent behavior of password state policies.
Click OK. |
||
10. | Specify ODS password | Enter the password for ODS schema. |
11. | Specify Oracle Internet Directory Login | Username: Enter the username to log in to Oracle Internet Directory. You must log in as the Oracle Internet Directory superuser (cn=orcladmin ).
Password: Enter the password for the username Click Next. |
12. | Guest Account Password | Enter the password for the orclguest account.
Click Next. |
13. | Specify Instance Name and ias_admin Password |
Instance Name: Enter a name for this Identity Management instance.
|
14. | Summary | Verify your selection and click Install. |
15. | The Configuration Assistant | This screen shows the progress of the configuration assistants. |
The postinstallation tasks involve troubleshooting the installation errors and performing manual postinstallation steps.
You might have to perform the postinstallation steps to solve the following problems:
During execution of root.sh
script, the following error is encountered:
chmod: WARNING: Corresponding set-ID also disabled on emtgtcl2 since set-ID requires execute permission
Ignore this error.
To install the first instance of Delegated Administration Services and OracleAS Single Sign-On, follow the steps listed in Table 13-5.
Table 13-5 Installing the First Instance of Delegated Administration Services and OracleAS Single Sign-On
Step | Screen | Action |
---|---|---|
1. | Welcome | Click Next. |
2. | Specify File Locations | Enter a name and path for the new Oracle home.This new Oracle home will be the destination Oracle home for your Identity Management. Click Next. |
3. | Specify Hardware Cluster Installation Mode (optional) | Select Local Installation.This screen will only show up if you are installing Oracle Collaboration Suite Identity Management on a cluster. Click Next. |
4. | Select a Product to Install | Select Oracle Collaboration Suite Infrastructure 10.1.1.0.2.
Click Next. |
5. | Select Installation Type | Select Identity Management.
Click Next. |
6. | Product-specific Prerequisite Checks | Make sure all the checks complete successfully.
Click Next. |
7 | Language Selection | Select the languages. Click Next. |
8. | Select Configuration Options | Select Oracle Application Server SSO..Select Oracle Application Server DAS.Select High Availability and Replication.
Click Next. |
9. | Select High Availability Option | Select Oracle AS Cluster (Identity Management).
Click Next. |
10. | Create or Join an Oracle Application Server Cluster | Select Create a New Oracle Application Server Cluster.
Click Next. |
11. | Specify New Oracle Application Server Cluster Name | Enter the Application Server Cluster Name.(for example: AppServer_crs ).
Click Next. |
12. | Specify LDAP Virtual Host and Ports | Hostname: Enter the fully qualified virtual server name of the LDAP virtual server configured on your load balancer (for example: im_virtual.mycompany.com ).
SSL PORT: Enter the SSL port number for Oracle Internet Directory (for example, 4636) Non-SSL PORT: Enter the SSL port number for Oracle Internet Directory. (for example, 7389) Click Next. |
13. | Specify Oracle Internet Directory Login | Enter the password for login to Oracle Internet Directory.
Click Next. |
14. | Specify HTTP Load Balancer Host and Ports | HTTP Listener: Port: Enter the port number that you want Oracle HTTP Server to listen on (for example, 7777).
HTTP Load Balancer: Hostname: Enter the name of the HTTP virtual server configured on your load balancer (for example, HTTP Load Balancer: Port: Enter the port of the HTTP virtual server (for example, 7777) Click Next. |
15. | Specify Instance Name and ias_admin Password |
Instance Name: Enter a name for this Identity Management instance.
|
16. | Summary | Verify your selection and click Install. |
17. | The Configuration Assistant | This screen shows the progress of the configuration assistants. |
To install the second instance of Delegated Administration Services and OracleAS Single Sign-On, follow the steps listed in Table 13-6.
Table 13-6 Installing the Second Instance of Delegated Administration Services and Single Sign-On
Step | Screen | Action |
---|---|---|
1. | Welcome | Click Next. |
2. | Specify File Locations | Enter a name and path for the new Oracle home.This new Oracle home will be the destination Oracle home for your Identity Management. Click Next. |
3. | Specify Hardware Cluster Installation Mode (optional) | Select Local Installation.This screen will only show up if you are installing Oracle Collaboration Suite Identity Management on a cluster. Click Next. |
4. | Select a Product to Install | Select Oracle Collaboration Suite Infrastructure 10.1.1.0.2.
Click Next. |
5. | Select Installation Type | Select Identity Management.
Click Next. |
6. | Product-specific Prerequisite Checks | Make sure all the checks complete successfully.
Click Next. |
7 | Language Selection | Select the languages. Click Next. |
8. | Select Configuration Options | Select Oracle Application Server SSO..Select Oracle Application Server DAS.Select High Availability and Replication.
Click Next. |
9. | Select High Availability Option | Select Oracle AS Cluster (Identity Management).
Click Next. |
10. | Create or Join an Oracle Application Server Cluster | Select Join an Existing Oracle Application Server Cluster.
Click Next. |
11. | Specify Existing Oracle Application Cluster Name | Enter the name of the existing OracleAS Cluster (Identity Management) that you want the current instance that you are installing to join. The cluster was created during the first installation of Delegated Administration Services and OracleAS Single Sign-On.
Click Next. |
12. | Specify LDAP Virtual Host and Ports | Hostname: Enter the fully qualified virtual server name of the LDAP virtual server configured on your load balancer (for example: im_virtual.mycompany.com ).
SSL PORT: Enter the SSL port number for Oracle Internet Directory (for example, 4636) Non-SSL PORT: Enter the SSL port number for Oracle Internet Directory. (for example, 7389) Click Next. |
13. | Specify Oracle Internet Directory Login | Enter the password for login to Oracle Internet Directory.
Click Next. |
14. | Specify HTTP Load Balancer Host and Ports | HTTP Listener: Port: Enter the port number that you want Oracle HTTP Server to listen on (for example, 7777).
HTTP Load Balancer: Hostname: Enter the name of the HTTP virtual server configured on your load balancer (for example, HTTP Load Balancer: Port: Enter the port of the HTTP virtual server (for example, 7777) Click Next. |
15. | Specify Instance Name and ias_admin Password |
Instance Name: Enter a name for this Identity Management instance.
|
16. | Summary | Verify your selection and click Install. |
17. | The Configuration Assistant | This screen shows the progress of the configuration assistants. |
The Oracle Collaboration Suite 10g Database (ocsdb) must be registered in the Oracle Internet Directory for Oracle Collaboration Suite to work correctly. Additionally, the database schemas for each Oracle Collaboration Suite Applications component must be created in the Oracle Collaboration Suite 10g Database (ocsdb). The ORACLE_HOME/install/OCSdbSchemaReg.sh
script accomplishes both of these tasks. This script must only be run on a single database node.
The OCSdbSchemaReg.sh
script is located in ORACLE_HOME/install
directory on the Oracle Collaboration Suite 10g Database (ocsdb) nodes.
Copy ORACLE_HOME/install/OCSdbSchemaReg.ini.sample
to ORACLE_HOME/install/OCSdbSchemaReg.ini.
Modify the ORACLE_HOME/install/OCSdbSchemaReg.ini
script with the appropriate values.
Run OCSdbSchemaReg.sh
from ORACLE_HOME/install
directory in Oracle RAC mode by entering multiple hosts in the $hostList
option of the OCSdbSchemaReg.ini
file from one of the Oracle Collaboration Suite 10g Database (ocsdb) machine.
Run the following script.
OCSdbSchemaReg.sh –f OCSdbSchemaReg.ini
This section explains the installation and postinstallation tasks for Identity Management.
Before installing Oracle Calendar Server in a Cold Failover Cluster, perform the following procedures:
Section 13.2.6.1.2, "Map the Virtual Host Name and Virtual IP Address"
Section 13.2.6.1.3, "Set Up a File System That Can Be Mounted from Both Nodes"
For Cold Failover Cluster, each node in a cluster should be running hardware vendor clusterware. If you plan to install the Calendar Server on a cluster that is also running Oracle Cluster Ready Services (CRS), you still should have the clusterware from the hardware vendor to support an automated cold failover. Running CRS without the hardware vendor clusterware does not support Cold Failover Cluster.
To check that the clusterware is running, use the command appropriate for your clusterware.
Each node in a Cold Failover Cluster configuration is associated with its own physical IP address. In addition, the active node in the cluster is associated with a virtual host name and virtual IP address. This enables clients to access the Cold Failover Cluster using the virtual host name.
Virtual host names and virtual IP addresses are any valid host name and IP address in the context of the subnet containing the hardware cluster.
Note:
Map the virtual host name and virtual IP address only to the active node. Do not map the virtual host name and IP address to both active and secondary nodes at the same time. When you failover, only then do you map the virtual host name and IP address to the secondary node, which is now the active node.The following example configures a virtual host name called vhost.mydomain.com
, with a virtual IP of 138.1.12.191:
Become the root
user.
prompt> su Password: root_password
Determine the public network interface.
# ifconfig -a
lo0: flags=1000849<UP,LOOPBACK,RUNNING,MULTICAST,IPv4> mtu 8232 index 1
inet 127.0.0.1 netmask ff000000
lo0:1: flags=1008849<UP,LOOPBACK,RUNNING,MULTICAST,PRIVATE,IPv4> mtu 8232 index 1
inet 172.16.193.1 netmask ffffffff
ge0: flags=1000843<UP,BROADCAST,RUNNING,MULTICAST,IPv4> mtu 1500 index 2
inet 138.1.13.146 netmask fffffc00 broadcast 138.1.15.255
ether 8:0:20:fd:1:23
hme0: flags=1008843<UP,BROADCAST,RUNNING,MULTICAST,PRIVATE,IPv4> mtu 1500 index 3
inet 172.16.1.1 netmask ffffff80 broadcast 172.16.1.127
ether 8:0:20:fd:1:23
hme0:2: flags=1008843<UP,BROADCAST,RUNNING,MULTICAST,PRIVATE,IPv4> mtu 1500 index 3
inet 172.16.194.6 netmask fffffffc broadcast 172.16.194.7
ge1: flags=1008843<UP,BROADCAST,RUNNING,MULTICAST,PRIVATE,IPv4> mtu 1500 index 4
inet 172.16.0.129 netmask ffffff80 broadcast 172.16.0.255
ether 8:0:20:fd:1:23
From the output, ge0
is the public network interface. It is not a loopback interface and not a private interface.
Add the virtual IP to the ge0
network interface.
# ifconfig ge0 addif 138.1.12.191 up
"ge0
" and the IP address are values specific to this example. Replace them with values appropriate for your cluster.
Check that new interface was added:
# ifconfig -a
lo0: flags=1000849<UP,LOOPBACK,RUNNING,MULTICAST,IPv4> mtu 8232 index 1
inet 127.0.0.1 netmask ff000000
lo0:1: flags=1008849<UP,LOOPBACK,RUNNING,MULTICAST,PRIVATE,IPv4> mtu 8232 index 1
inet 172.16.193.1 netmask ffffffff
ge0: flags=1000843<UP,BROADCAST,RUNNING,MULTICAST,IPv4> mtu 1500 index 2
inet 138.1.13.146 netmask fffffc00 broadcast 138.1.15.255
ether 8:0:20:fd:1:23
ge0:1: flags=1000843<UP,BROADCAST,RUNNING,MULTICAST,IPv4> mtu 1500 index 2
inet 138.1.12.191 netmask ffff0000 broadcast 138.1.255.255
hme0: flags=1008843<UP,BROADCAST,RUNNING,MULTICAST,PRIVATE,IPv4> mtu 1500 index 3
inet 172.16.1.1 netmask ffffff80 broadcast 172.16.1.127
ether 8:0:20:fd:1:23
hme0:2: flags=1008843<UP,BROADCAST,RUNNING,MULTICAST,PRIVATE,IPv4> mtu 1500 index 3
inet 172.16.194.6 netmask fffffffc broadcast 172.16.194.7
ge1: flags=1008843<UP,BROADCAST,RUNNING,MULTICAST,PRIVATE,IPv4> mtu 1500 index 4
inet 172.16.0.129 netmask ffffff80 broadcast 172.16.0.255
ether 8:0:20:fd:1:23
The virtual IP appears in the ge0:1
entry. During installation, when you enter "vhost.mydomain.com
" as the virtual host name in the Specify Virtual Hostname screen, the installer checks that "vhost.mydomain.com
" is a valid interface.
On Failover If the active node fails, then the secondary node takes over. If you do not have a clusterware agent to map the virtual IP from the failed node to the secondary node, then you must do it manually. You must remove the virtual IP mapping from the failed node, and map it to the secondary node.
On the failed node, if possible, become superuser and remove the virtual IP.
If the failed node fails completely (that is, it does not start), you can skip this step and go to Step 2. If the node fails partially (for example, disk or memory problems), and the node is still pingable, you must perform this step.
prompt> su
Password: root_password
# ifconfig ge0 removeif 138.1.12.191
"ge0" and the IP address are values specific to this example. Replace them with values appropriate for your cluster.
On the secondary node, add the virtual IP to the ge0
network interface.
# ifconfig ge0 addif 138.1.12.191 netmask 255.255.252.0 up
"ge0" and the IP address are values specific to this example. Replace them with values appropriate for your cluster.
On the secondary node, check that the new interface was added:
# ifconfig -a ...
Although the hardware cluster has shared storage, you must create a file system on this shared storage such that both nodes of the Cold Failover Cluster can mount this file system. You will use this file system for the following directories:
Oracle home directory for Infrastructure
The oraInventory
directory
If you are running a volume manager on the cluster to manage the shared storage, refer to the volume manager documentation for steps to create a volume. Once a volume is created, you can create the file system on that volume.
If you do not have a volume manager, you can create a file system on the shared disk directly. Ensure that the hardware vendor supports this, that the file system can be mounted from either node of the Cold Failover Cluster, and that the file system is repairable from either node if a node fails.
To check that the file system can be mounted from either node, do the following steps:
Set up and mount the file system from node 1.
Unmount the file system from node 1.
Mount the file system from node 2 using the same mount point that you used in Step 1.
Unmount it from node 2, and mount it on node 1, because you will be running the installer from node 1.
Note:
Only one node of the Cold Failover Cluster should mount the file system at any given time. File system configuration files on all nodes of the cluster should not include an entry for the automatic mount of the file system upon a node restart or execution of a global mount command. For example, on UNIX platforms, do not include an entry for this file system in/etc/fstab
file.Before installing Oracle Calendar in a Cold Failover Cluster configuration, make sure that the virtual IP address and host name is enabled on the install node.
To install Oracle Calendar in Cold Failover Cluster configuration, follow the steps listed in Table 13-7.
Table 13-7 Installing Oracle Calendar Server in Cold Failover Cluster Configuration
Step | Screen | Action |
---|---|---|
1. | None | Start the installer. |
2. | Welcome | Click Next. |
3. | Specify Inventory Directory and Credentials
(Advanced installation only) |
This screen appears only if this is the first installation of any Oracle product on this computer.
Enter the full path for the inventory directory: Enter a full path to a directory for the installer files. Enter a directory that is different from the Oracle home directory for the product files. Example: Click OK. |
4. | UNIX Group Name
(Advanced installation only) |
This screen appears only if this is the first installation of any Oracle product on this computer.
Enter the name of the operating system group to have write permission for the inventory directory. Example: Click Next. |
5. | Run orainstRoot.sh
(Advanced installation only) |
This screen appears only if this is the first installation of any Oracle product on this computer.
Run the Click Continue. |
6. | Specify File Locations
(Advanced installation only) |
Enter the full path of the Source directory in the Path field for Source, if required.
Name: Enter a name to identify this Oracle home. The name cannot contain spaces, and has a maximum length of 16 characters. Example: Destination Path: Enter the full path to the destination directory. This is the Oracle home. If the directory does not exist, the installer creates it. To create the directory beforehand, create it as the oracle user. Do not create it as the Example: Click Next. |
7. | Specify Hardware Cluster Installation Mode
(Advanced installation only) |
This screen appears only if the computer is part of a hardware cluster.
When you are installing Oracle Collaboration Suite Applications, select Local Installation because hardware cluster is not supported for Oracle Collaboration Suite Applications. Click Next. |
8. | Select a Product to Install
(Advanced installation only) |
Select Oracle Collaboration Suite Applications 10.1.1.0.2.
If you need to install additional languages, click Product Languages. Click Next. |
9. | Product-specific Prerequisite Checks
(Advanced installation only) |
The installer verifies requirements such as memory, disk space, and operating system version. If any check fails, make the required changes and click Retry.
Click Next. |
10. | Select Components to Configure
(Advanced installation only) |
Select Oracle Calendar Server.
Note: You can also configure any component after installation. Click Next. |
11. | Register with Oracle Internet Directory
(Advanced installation only) |
Host: Enter the LDAP virtual server name.
Port: Enter the non-SSL port number for the LDAP virtual server name. Use SSL to connect to Oracle Internet Directory: Select this option if you want Oracle Collaboration Suite components to use only SSL to connect to Oracle Internet Directory. Click Next. |
12. | Specify UserName and Password for Oracle Internet Directory
(Advanced installation only) |
Username: Enter the user name to use to log in to Oracle Internet Directory.
Password: Enter the user password. Click Next. Note: Use |
13. | OracleAS Metadata Repository
(Advanced installation only) |
Select the Oracle Collaboration Suite 10g Database (ocsdb) from the list.
Click Next. |
14. | Select Database Components
(Advanced installation only) |
Component Name: Oracle Calendar Server
Database Name: Name of the Oracle Collaboration Suite 10g Database (ocsdb). Click Next. Note: If multiple instances of Oracle Collaboration Suite Databases are available in Oracle Internet Directory, then you must click on the Database Name column and then select the correct database for each component from the drop-down list. However, when you click Next to go to the next screen, the selection might not be retained. To ensure that the selection is retained, you must click the Database Name column again after selecting the required database for each component. |
15. | Specify Port Configuration Options
(Advanced installation only) |
Select Automatic Port Selection or Manual and enter the port numbers for:
Click Next. Note: If you manually configure the ports, then you must specify the port values for each port. |
16. | Specify Administrative Password and Instance Name
(Advanced installation only) |
Instance Name: Enter a name for this Calendar Server instance.
Administrative Password: Set the password for the administrative user. This is the administrative user for the Calendar Server instance. Confirm Password: Confirm the password. Click Next. |
17. | Oracle Calendar Server Host Alias
(Advanced installation only) |
Host or Alias: Enter the virtual host name for the Calendar Server instance.
Click Next. Note: Oracle recommends that you use alias in place of host name if later you want to move the calendar server instance or change the host name. Specify the host name if an alias is not configured. |
18. | Summary | Verify your selections and click Install. |
19. | Install Progress | This screen displays the progress of the installation. |
20. | Run root.sh |
Note: Do not run the root.sh script until this dialog box appears.
|
21. | Configuration Assistants | This screen shows the progress of the configuration assistants. Configuration assistants configure components. |
22. | End of Installation | Click Exit to quit the installer. |
The postinstallation tasks involve troubleshooting the installation errors and performing manual postinstallation steps.
You might have to perform the postinstallation steps to solve the following problems:
During execution of root.sh
script, the following error is encountered:
chmod: WARNING: Corresponding set-ID also disabled on emtgtcl2 since set-ID requires execute permission
Ignore this error.
You must also perform the following additional postinstallation steps:
In ORACLE_HOME/ocal/misc/unison.ini
file, add dir_connectmodel = ondemand
entry under the [DAS] section.
Restart Oracle Calendar Server.
ORACLE_HOME/opmn/bin/opmnctl restartproc ias-component=CalendarServer
This section describes the installation of the first instance of Oracle Collaboration Suite Applications without Oracle Calendar Server.
To install first instance of Oracle Collaboration Suite Applications, follow the steps listed in Table 13-8.
Table 13-8 Installing the First Instance of Oracle Collaboration Suite Applications
Step | Screen | Action |
---|---|---|
1. | Welcome | Click Next. |
2. | Specify File Locations | Enter a name and path for the new Oracle home. This new Oracle home will be the destination Oracle home for Oracle Collaboration Suite Applications.
Click Next. |
4. | Select a Product to Install | Select Oracle Collaboration Suite Applications 10.1.1.0.2.
Click Next. |
5. | Product-specific Prerequisite Checks | Make sure all the checks complete successfully.
Click Next. |
6. | Select Components to Configure | Select Oracle Mail.Select Oracle Mobile Collaboration.Select Oracle Content Services.Do not select Oracle Calendar Server.Select Oracle Calendar Web Client.Select Oracle Real-Time Collaboration.Select Oracle Collaboration Suite Search.Select Oracle Collaboration Suite Web Access.Select Oracle Collaborative Portlets.Select Oracle Workspaces.Select Oracle Discussions.
Click Next. |
7. | Register with Oracle Internet Directory | Host: Enter the LDAP virtual server name.
Port: Enter the non-SSL port number for the LDAP virtual server name. Click Next. |
8. | Specify UserName and Password for Oracle Internet Directory | Username: Enter the username to log onto Oracle Internet Directory. You must log in as the Oracle Internet Directory superuser (cn=orcladmin ).
Password: Enter the password for the username. Click Next. |
9. | OracleAS Metadata Repository | Select Oracle Collaboration Suite 10g Database (ocsdb) from the list.
Click Next. |
10. | Select Database Components | Component Name: Oracle Mail, Oracle Discussions, Oracle Search, Oracle Real-Time Collaboration, Oracle Collaboration Suite Search, Oracle Workspaces, Oracle Content Services, Oracle Collaboration Suite Web Access
Database Name: Name of the Oracle Collaboration Suite 10g Database (ocsdb). Click Next. |
11. | Specify Port Configuration Options | Select Automatic Port Selection or Manual and enter the port numbers for:
|
12. | Specify Administrative Password and Instance Name | Instance Name: Enter a name for this Oracle Collaboration Suite Applications instance.
Administrative Password: Set the password for the administrative user. This is the administrative user for the Oracle Collaboration Suite Applications instance. Click Next. |
13. | Specify Oracle Mail Domain Information | Mail Domain: Enter the domain that you want to use for Oracle Mail server.
Click Next. |
14. | Summary | Verify your selection and click Install. |
15. | Install Progress | This screen displays the progress of the installation. |
16. | Run root.sh |
Note: Do not run the root.sh script until this dialog box appears.
|
17. | The Configuration Assistants | This screen shows the progress of the configuration assistants. |
18. | End of Installation | Click Exit to quit the installer. |
You can configure two or more Oracle Collaboration Suite Applications instances in a highly-available deployment by placing a load balancer in front of them. The load balancer publishes a single address for Oracle Collaboration Suite Applications while providing a redundant set of application servers that actually service requests. The load balancer can be configured to detect when one of the OCS Applications instances has failed and can then fail over requests to another instance.
Our configuration is as follows:
There are two Oracle Collaboration Suite Applications computers: ocs_apps1.mycompany.com
and ocs_apps2.mycompany.com
. Both application servers listen on non-SSL port 7777.
The Oracle Collaboration Suite Applications computers are configured to use the Single Sign-On server located at im_virtual.mycompany.com
.
The effective host name of the Oracle Collaboration Suite Applications published to the user is apps_virtual.mycompany.com
. A load balancer is configured to listen at this address, on port 80. It has been configured to load balance and fail over user requests between ocs_apps1.mycompany.com
and ocs_apps2.mycompany.com
.
The Single Sign-On server and Directory server are located at im_virtual.mycompany.com
.
The Oracle Collaboration Suite Database (including Identity Management metadata) is located at ocs_store1.mycompany.com
and ocs_store2.mycompany.com
(2-node Oracle RAC).
To set up the load balancer to work with the first middle-tier install, ensure that the following is configured:
A virtual server name (apps_virtual.mycompany.com
) that listens for requests on port 80 and balances them to the Web Cache on Oracle Collaboration Suite Applications tier running on ocs_apps1.mycompany.com
on port 7777 (an HTTP listening port).
A virtual server name (apps_virtual.mycompany.com
) that listens for requests on port 7777 (an HTTP listening port), and balances them to the Web Cache on Oracle Collaboration Suite Applications tier on ocs_apps1.mycompany.com
port 7777 (an HTTP listening port). Port 7777 on the load balancer receives the HTTP loop-back requests made by the Parallel Page Engine on ocs_apps1.mycompany.com
. This 7777 port also receives requests from the Portal Metadata Repository for web providers design time messages. This configuration may require a Network Address Translation (NAT) rule in the load balancer in order for the loop-back request from the PPE to succeed.
A virtual server name (apps_virtual.mycompany.com
) that listens for requests on port 9401 (Web Cache Invalidation Port) and balances them to the Web Cache on Oracle Collaboration Suite Applications tier on ocs_apps1.mycompany.com
on port 9401 (Web Cache Invalidation Port). Port 9401 on the load balancer receives invalidation messages from the OracleAS Portal Repository when content that is cached in OracleAS Web Cache becomes stale. This configuration might require a NAT rule in the load balancer in order for the invalidation requests from the OracleAS Portal repository to succeed.
A virtual server name (apps_virtual.mycompany.com
) that listens for requests on port 25 (SMTP) and balances them to the Oracle Collaboration Suite Applications tier's SMTP port on ocs_apps1.mycompany.com
on port 25 (an SMTP listening port). This virtual server on port 25 (SMTP) should also have simple persistence. Simple Persistence returns a client to the same node to which it connected previously. Simple persistence tracks connections based only on the client IP address.
The virtual server name (apps_virtual.mycompany.com
) listens for requests on port 143 (Oracle Mail IMAP4 port) and balances them to the Oracle Collaboration Suite Applications tier on ocs_apps1.mycompany.com
on port 143 (Oracle Mail IMAP4 port).
Note:
apps_virtual.mycompany.com
listens on 80 for external traffic, on port 7777 for Parallel Page Engine loop-back messages, and port 9401 for invalidation messages, and port 25 for SMTP traffic.For security reason, port 9401 and 7777 on the load balancer should not be visible to external users.
This step associates the components on which OracleAS Portal depends with load balancer virtual server name and port: apps_virtual.mycompany.com:80 as follows:
Access the Oracle Enterprise Manager – Oracle Collaboration Suite Control console.
Click the link for the ocs_apps1.mycompany.com
installation.
Click the HTTP Server link.
Click the Administration link.
Click Advanced Server Properties.
Open the httpd.conf
file.
Perform the following steps:
Add LoadModule certheaders_module
directive.
LoadModule certheaders_module libexec/mod_certheaders.so
The LoadModule directives (in particular, the LoadModule rewrite_module
directive) must appear in the httpd.conf file at a location preceding the VirtualHost directives. The server must load all modules before it can execute the directives in the VirtualHost container. It is a good idea to create the VirtualHost directives at the end of the httpd.conf
file.
Add the following lines to create a NameVirtualHost directive and a VirtualHost container for apps_virtual.mycompany.com
and port 80.
NameVirtualHost *:7778 <VirtualHost *:7778> ServerName apps_virtual.mycompany.com Port 80 ServerAdmin you@your.address RewriteEngine On RewriteOptions inherit </VirtualHost>
Note:
The 7778 port used is an example and might vary depending on the port availability, if you choose Automatic Port Selection in the Specify Port Configuration Options screen.However, instead of using the default ports chosen by the installer, you can also instruct the installer to assign custom port numbers for components. For this, you must specify the path to the staticports.ini
file as a parameter to the runInstaller
command. Refer to Section 2.4.3 for more information about this.
If you choose to assign custom port numbers for components, then the Specify Port Configuration Options screen will not be displayed. In this case, the installer attempts to use the ports that you specified in the staticports.ini
file. If the ports are already being used, an error is displayed. Also, if there are ports that the installer needs but you have not specified in the staticports.ini
file, then it will automatically select them for you.
It is recommended that you always check the $ORACLE_HOME
/install/portlist.ini
at the end of installation to verify the ports that are assigned for the installation.
Create a second VirtualHost container for apps_virtual.mycompany.com
and port 7777.
<VirtualHost *:7778> ServerName apps_virtual.mycompany.com Port 7777 ServerAdmin you@your.address RewriteEngine On RewriteOptions inherit </VirtualHost>
Save the httpd.conf
file, and restart the Oracle HTTP Server when prompted.
In this step, you configure non-SSL loop-back communication between the load balancer and the Parallel Page Engine on ocs_apps1.mycompany.com
.Before you start this configuration, ensure the following:
You are able to resolve apps_virtual.mycompany.com
from ocs_apps1.mycompany.com
such that it contacts the load balancer. To ensure you can resolve apps_virtual.mycompany.com
, issue the following command from ocs_apps1.mycompany.com
.
nslookup apps_virtual.mycompany.com
The IP address for the load balancer should be returned.
You are able to contact port 7777 on apps_virtual.mycompany.com
from ocs_apps1.mycompany.com
. Issue the following command on ocs_apps1.mycompany.com
.
telnet apps_virtual.mycompany.com 7777
Verify that no connection failure message is returned.
To create the loop-back configuration, the steps are as follows:
Open the ORACLE_HOME/j2ee/OC4J_Portal/applications/portal/portal/WEB-INF/web.xml
file.
Locate the Page servlet section.
Add the lines shown in bold.
<servlet> <servlet-name>page</servlet-name> <servlet-class>oracle.webdb.page.ParallelServlet</servlet-class> <init-param> <param-name>useScheme</param-name> <param-value>http</param-value> </init-param> <init-param> <param-name>usePort</param-name> <param-value>7777</param-value> </init-param> </servlet>
Save the web.xml
file.
Issue this command in ORACLE_HOME/dcm/bin
to update the DCM repository.
dcmctl updateConfig
Issue these commands in ORACLE_HOME/opmn/bin
to restart the OCS Applications instance.
opmnctl stopall opmnctl startall
The Portal Dependency Settings file iasconfig.xml
must contain the correct host, port, and farm name to enable access to OracleAS Portal and perform OracleAS Web Cache invalidation. To edit the file to include this information, the steps are as follows:
Create a backup copy of the ORACLE_HOME/portal/conf/iasconfig.xml
file.
Open the ORACLE_HOME/portal/conf/iasconfig.xm
l file and perform the following steps:
Change the existing code as follows:
<IASConfig XSDVersion="1.0"> <IASFarm Name="Farm1.apps_virtual.mycompany.com" Host="apps_virtual.mycompany.com"> <WebCacheComponent ListenPort="80" InvalidationPort="9401" InvalidationUsername="invalidator" InvalidationPassword="welcome1" SSLEnabled="false" AdminPort="9400"/> </IASFarm> <IASInstance Name="iAS-1.im_virtual.mycompany.com"" Host="im_virtual.mycompany.com"> <OIDComponent AdminPassword="@Bek8qQ8PvU3EDjlucAhlOguPBMTdOIj25w==" AdminDN="cn=orcladmin" SSLEnabled="false" LDAPPort="389"/> </IASInstance> <IASInstance Name="ocsapps1.ocs_apps1.mycompany.com" Host="ocs_apps1.mycompany.com"> <WebCacheComponent ListenPort="80" InvalidationPort="9401" InvalidationUsername="invalidator" InvalidationPassword="@BctMARCvTji7teoBGNrE97+aJmQmT0jroQ==" SSLEnabled="false" AdminPort="9400"/> <EMComponent ConsoleHTTPPort="1810" SSLEnabled="false"/> </IASInstance> <PortalInstance DADLocation="/pls/portal" SchemaUsername="portal" SchemaPassword="@BT4T3g9vFHRYWmRTNRdYNYl/9NY8RzRCJQ==" ConnectString="cn=orcl,cn=oraclecontext"> <WebCacheDependency ContainerType="IASFarm" Name="Farm1.apps_virtual.mycompany.com"/> <OIDDependency ContainerType="IASInstance" Name="iAS-1.im_virtual.mycompany.com"/> <EMDependency ContainerType="IASInstance" Name="ocsapps1.ocs_apps1.mycompany.com"/> </PortalInstance> </IASConfig>
Save the iasconfig.xml
file.
Encrypt any plain text passwords in the iasconfig.xml
configuration file by setting the ORACLE_HOME
environment variable, if necessary, and issuing the following command from ORACLE_HOME/portal/conf
:
ptlconfig –encrypt
In this step, you register the OracleAS Portal URLs using the load balancer virtual server name and port instead of the OracleAS Web Cache host name and port. Follow the steps in this section to use the OracleAS Portal Configuration Assistant to register the URLs.
Ensure that the ORACLE_HOME
environment variable is set.
Register the URLs using the Portal Dependency Settings tool, which is available in $ORACLE_HOME
/portal/conf
:
ptlconfig –dad dadname –wc –site
In the previous syntax, dadname
is the name of the OracleAS Portal Database Access Descriptor that is specified in the iasconfig.xml
file under the PortalInstance DADLocation
entry. For example, in the iasconfig.xml
file, the location of this descriptor is specified as:
PortalInstance DADLocation="/pls/portal"
As a result, you can register the URLs using the Portal Dependency Settings tool as follows:
ptlconfig -dad portal -wc -site
Note:
Older versions ofmod_plsql
were mounted on a virtual path with a prefix of /pls
. This restriction has been removed in newer versions, but the restriction is still imposed by the PL/SQL applications.To prevent access to Oracle Enterprise Manager 10g from the outside, the link provided by OracleAS Portal must be changed back to point to the internal server. To do this, issue the following command in $ORACLE_HOME
/portal/conf
:
ptlconfig –dad dadname –em
In the previous syntax, dadname
is the name of the OracleAS Portal Database Access Descriptor that is specified in the iasconfig.xml
file under the PortalInstance DADLocation
entry.
You must configure a site definition, site alias, and a site-to-server mapping to make OracleAS Web Cache function correctly with the load balancer.
Use the Web Cache Manager, the graphical user interface provided for editing the configuration stored in the webcache.xml
file.
Access the Web Cache Administrator at: http://ocs_apps1.mycompany.com:9400/webcacheadmin
. The Web Cache Administrator password dialog box appears.
Enter the OracleAS Web Cache administrator password. For the user name, enter ias_admin
or administrator
, and enter the OracleAS Web Cache administrator password.
Note:
At installation time, the OracleAS Web Cache administrator password is set to the same password as theias_admin
password. The OracleAS Web Cache administrator password must be identical for all cache cluster members.Click the Site Definitions link in the Origin Servers, Sites and Load Balancing section. The Site Definitions window opens.
Click Add Site.
Enter the following information (leave other fields blank):
Host name: apps_virtual.mycompany.com
Port: 80
Client-side Certificate: Not requiredDefault Site: Yes
Create Alias from Site Name with/without www: No
Click Submit.
Select the radio button for the site for which the alias will be added (apps_virtual.mycompany.com
)
Click Add Alias. The Add Alias for Site window opens.
Enter apps_virtual.mycompany.com
for the host name and 7777 for the port. (7777 is the value for the usePort parameter in the web.xml
file in the Parallel Page Engine configuration).
Click Submit. The alias is added. An alias is needed in the configuration because Portal sends invalidation messages with the value of the HOST attribute in the invalidation message the same as the site name (in this case, apps_virtual.mycompany.com:80
), but OracleAS Web Cache caches the portal content keyed on a host:port combination such as apps_virtual.mycompany.com:7777
; thus, the invalidation is not executed. Therefore, it is necessary to define an alias, so that OracleAS Web Cache manages the content caching so that it recognizes apps_virtual.mycompany.com:80
and apps_virtual.mycompany.com:7777
as one and the same, and thereby correctly invalidating OracleAS Portal content, although the content is keyed on a different host:port combination than the site name.Click Add Alias. A window with host name and port fields opens.
Enter apps_virtual.mycompany.com
for the host name and 80 for the port.
Click Submit. The alias is added.
Note:
An alias for port 80 is needed because the HOST header sent by the browser will beapps_virtual.mycompany.com
(without a port number appended to it). Since OracleAS Web Cache is listening on the HTTP port, it will assume that the port number is 80 and use this to determine the site-to-server mapping, and for any cache key creation.Click Apply Changes.
Click the Site-to-Server Mapping link in the Origin Servers, Sites, and Load Balancing section. The Site-to-Server Mapping page appears, in which you map the site and site alias to an origin server.
Select the first mapping in the table and click Insert Above. The Edit/Add Site-to-Server Mapping page appears.
Select the Select From Site Definitions option.
Select apps_virtual.mycompany.com.
Select ocs_apps1.mycompany.com in the Select Application Web Servers section.
Click Submit.
Remove unused mappings or entries containing the wild card character *.
Click Apply Changes.
Click Restart.
The steps for reregistering mod_osso are as follows:
Set the ORACLE_HOME
environment variable to the current Oracle home.
Execute the SSO registration script ORACLE_HOME/sso/bin/ssoreg
.
ORACLE_HOME/sso/bin/ssoreg.sh \ -site_name <Partner Application site name> \ -mod_osso_url <The protocol://host.domain.port of the mod_osso partner> \ -config_mod_osso TRUE \ -oracle_home_path <Absolute path to Oracle Home> \ -config_file <config_file_path> \ -admin_info <Administrator info. You can put cn=orcladmin here.> \ -virtualhost
Parameter values in < > are to be replaced by the actual value.
You can refer Chapter 4 Configuring and Administering Partner Applications chapter of Oracle Application Server Single Sign-On Administrator's Guide 10g Release 2 at http://iasdocs/iasdl/101202doc_final/idmanage.1012/b14078/part_apps.htm#CIHDBF
.
ORACLE_HOME/sso/bin/ssoreg.sh -help
also lists out all the options for ssoreg.sh
.
A partner application, ocsapps.apps_virtual.mycompany.com
, is created.
Log on to the OracleAS Single Sign-On Administration page as the Administrator, and use the Administer Partner Applications page to delete the entry for the partner application ocsapp1.ocs_apps1.mycompany.com
.
When an object is changed in the database, the application metadata repository database sends an invalidation message to Web Cache to invalidate that object if it exists in the cache. Since the target configuration has two instances of OracleAS Web Cache, the invalidation message must be load balanced across both OracleAS Web Cache instances. This is an example of component level load balancing.
Before you proceed with this verification, ensure that messages can be sent from the computer hosting the database to the load balancer. To do this, issue the following command from ocs_store1.mycompany.com
and ocs_store2.mycompany.com
:
telnet apps_virtual.mycompany.com 9401
Verify that no connection failure message is returned.
The steps to enable monotoring of the host at the front end of the load balancer and port settings for OracleAS Portal are as follows:
Open the ORACLE_HOME/sysman/emd/targets.xml
file.
Locate the OracleAS Portal targets, for example, TYPE="oracle_portal
".
Edit the PortalListeningHostPort property so that it points to the load balancer. For example: <Property NAME="PortalListeningHostPort
" VALUE="http://apps_virtual.mycompany.com:80
"/>
Save and close targets.xml
file.
Reload the targets.xml
file in the OracleAS Control Console by issuing this command in ORACLE_HOME/bin
:
emctl reload
Note:
Refer to Section 2.1.1, "Considerations for Real-Time Collaboration".For Real-Time Collaboration, set GlobalWebHost
and GlobalWebPort
properties to integrate with a load balancer.
A load balancer provides a single published address to the client browser, while distributing requests to multiple Oracle Real-Time Collaboration core component Application tiers that serve the request. It acts as a global Web host for all of the requests.
If you add a load balancer, set the following parameters:
GlobalWebHost
is the name of the global Web host.
For example, multiple Application tiers could be placed behind a load balancer (ocs_apps1.mycompany.com
, ocs_apps2.mycompany.com
), but the Web host name you want to have appear in the URL used to join a conference is apps_virtual.mycompany.com
.
Note:
Once set, the only way to unset this property is to use the –pvaluenull
true
option with the SetProperty command. For example, to set the global Web host to apps_virtual.mycompany.com
, run the following command:
ORACLE_HOME/imeeting/bin/rtcctl rtcctl> setProperty –system true –pname GlobalWebHost –pvalue "apps_virtual.mycompany.com"
GlobalWebPort
is the HTTP port of the global Web host.
For example, to reset the global Web host to listen on port 80 for HTTP requests run the following command:
ORACLE_HOME/imeeting/bin/rtcctl rtcctl> setProperty –system true –pname GlobalWebPort –pvalue 80
SmtpHost
is the name of the SMTP host. To set the smtp host to apps_virtual.mycompany.com
, run the following command:
ORACLE_HOME/imeeting/bin/rtcctl rtcctl> setProperty –system true –pname SmtpHost –pvalue "apps_virtual.mycompany.com"
Because the SMTP default port is 25, there is no need to set the SMTP port.
Restart Oracle Collaboration Suite Applications using the following commands:
ORACLE_HOME/opmn/bin/opmnctl stopall ORACLE_HOME/opmn/bin/opmnctl startall
You can update the Oracle Collaboration Suite registry entries in Oracle Internet Directory by using the Oracle Directory Manager as follows:
Start the Oracle Directory Manager.
ORACLE_HOME/bin/oidadmin
When you start Oracle Directory Manager, it will prompt you for connection information. Enter the following information to connect to your Oracle Internet Directory, typically hosted in the Oracle Collaboration Suite Database on your Oracle Collaboration Suite Infrastructure:
Host: <infrahost.yourdomain.com> Port: 389 Username: cn=orcladmin Password: <password>
Port 389 is the default port used by Oracle Internet Directory. If you are using a different port, then enter the correct Oracle Internet Directory port.
If you have configured your Oracle Internet Directory to be accessed using SSL, select the SSL Enabled check box. Otherwise, leave it blank.
Select Login to log in to the Oracle Internet Directory. When the connection is successful, the Oracle Internet Directory management screen is displayed.
To access the Service Registry, drill down in to the Oracle Internet Directory by selecting the following items in the System Objects pane:
Select Entry Management.
Select cn=OracleContext.
Select cn=Services.
The System Objects pane displays a list of the Oracle Collaboration Suite Applications which have entries in the Service Registry. The Properties tab displays the properties of the cn=Services
object.
To display URIs stored by each component in the Service Registry, select the component in the System Objects pane. Most components will contain a cn=VirtualServices
object. This object contains one or more URIs used by other applications and OracleAS Portal to access that application. Applications store URIs in one or more child objects of the cn=VirtualServices
object.
Note:
The Oracle Universal Installer seeds the Oracle Internet Directory with objects for every Oracle Collaboration Suite Applications during installation, even if you do not configure and deploy every application. These unconfigured application entries will not contain child objects of theircn=VirtualServices
objects. The child objects, and the URIs they store, are created in the Service Registry by each component's Configuration Assistant when it first runs.After you verify your configuration, update Oracle Collaboration Suite Service Registry entries in Oracle Internet Directory to use the load balancer virtual host name as follows:
Oracle Calendar
dn: cn=OCAS_xxxxx,cn=VirtualServices,cn=Calendar,cn=Services,cn=OracleContext labeleduri;syncserversecureurl labeleduri:syncserverurl labeleduri;webbaseurl labeleduri;webserviceurl
Oracle Collaborative Workspaces
dn:cn=<DBNAME>,cn=VirtualServices,cn=CollaborativeWorkspaces,cn=Services, cn=OracleContext labeleduri;adminurl labeleduri;webbaseurl labeleduri:webui
Oracle Mail
dn: cn=emailadmin,cn=VirtualServices,cn=Email,cn=Services,cn=OracleContext labeleduri;adminurl dn: cn=imap,cn=VirtualServices,cn=Email,cn=Services,cn=OracleContext labeleduri dn: cn=smtp,cn=VirtualServices,cn=Email,cn=Services,cn=OracleContext labeleduri dn: cn=Webmail,cn=VirtualServices,cn=Email,cn=Services,cn=OracleContext labeleduri;peopleurl labeleduri;webbaseurl orclraparameter;webbaseurl dn: cn=webservice,cn=VirtualServices,cn=Email,cn=Services,cn=OracleContext labeleduri;webservices
Oracle Content Services
dn: cn=Content,cn=VirtualServices,cn=Files,cn=Services,cn=OracleContext labeleduri;adminurl labeleduri;s2swebserviceurl labeleduri;webdavurl labeleduri;webservicesurl
Oracle Collaboration Suite Client
dn:cn=IntegratedClient,cn=VirtualServices,cn=OCSClient,cn=Services, cn=OracleContext labeleduri;baseurl labeleduri;popuplibraryurl dn: cn=Search,cn=VirtualServices,cn=OCSClient,cn=Services,cn=OracleContext labeleduri;webbaseurl
OracleAS Portal
dn:cn=ReturnToPortalURL,cn=VirtualServices,cn=Portal,cn=Services, cn=OracleContext labeleduri;
Note:
In addition to changing the host name to use the load balancer virtual host name, the port should also match the listen port used in Step 1 in Section 13.2.8.1. In this example it was port 80 (the defualt port), which means the port specification can be removed. So, for example, the Oracle Internet Directorylabeleduri
for the Portal ReturnToPortalURL should change from
http://ocs_apps1.mycompany.com:7778/portal/page?_dad=portal&_schema=PORTAL&_pageid=
to
http://apps_virtual.mycompany.com/portal/page?_dad=portal&_schema=PORTAL&_pageid=
Oracle Discussions
dn:cn=Discussions:<DBNAME>:<MailDomain>,cn=VirtualServices, cn=ThreadedDiscusssions,cn=Services,cn=OracleContext labeleduri;adminurl labeleduri;rss labeleduri;webbaseurl labeleduri;webui
Oracle Mobile Collaboration
dn: cn=WIRELESS1,cn=VirtualServices,cn=Wireless,cn=Services,cn=OracleContext labeleduri;adminurl labeleduri;calendarnotificationlistenerurl labeleduri;mobilesetupurl labeleduri;presencewebserviceurl
When you have finished editing the properties of an object, select Apply to save the new values in Oracle Internet Directory. If you decide to reject the changes you have made, select Revert to reset the displayed attributes to those currently stored in the Oracle Internet Directory.
Using opmnctl
or Oracle Enterprise Manager 10g, restart the Oracle Collaboration Suite Infrastructure and all Oracle Collaboration Suite Applications tiers, to clear caches that may still be storing the old URIs and to load the new URIs you have entered.
Restart Oracle Collaboration Suite Applications using the following commands:
ORACLE_HOME/opmn/bin/opmnctl stopall ORACLE_HOME/opmn/bin/opmnctl startall
There is no need to restart the Oracle Collaboration Suite Database.
The steps to test the configuration are as follows:
Access OracleAS Web Cache and Oracle HTTP Server through the load balancer with the following URL:
http://apps_virtual.mycompany.com
Test the connection to the Oracle Collaboration Suite Database through the load balancer, by accessing the following URL:
http://apps_virtual.mycompany.com/pls/portal/htp.p?cbuf=test
The response should be test. If this succeeds, then the Oracle Collaboration Suite Applications tier can connect to the Oracle Collaboration Suite Database. If this test fails, then examine the Oracle HTTP Server ORACLE_HOME/Apache/Apache/logs/error_log
file to determine the cause.
Test the OracleAS Portal using following URL (ensure that you can log in):
http://apps_virtual.mycompany.com/pls/portal
Verify that content is being cached in OracleAS Web Cache on ocs_apps1.mycompany.com
, using Web Cache Administrator. Under Monitoring, click Popular Requests. Select Cached from the Filtered Objects drop-down list, and click Update.
If you accessed OracleAS Portal, portal content will appear. If there is no portal content, open another browser and log on to OracleAS Portal. Return to the Popular Requests page, and click Update to refresh the page content.
This section describes the installation of the subsequent instance of Oracle Collaboration Suite Applications without Oracle Calendar Server and postinstallation tasks.
To install the subsequent instance of Oracle Collaboration Suite Applications, follow the steps listed in Table 13-9.
Table 13-9 Installing the Subsequent Instance of Oracle Collaboration Suite Applications
Step | Screen | Action |
---|---|---|
1. | Welcome | Click Next. |
2. | Specify File Locations | Enter a name and path for the new Oracle home. This new Oracle home will be the destination Oracle home for Oracle Collaboration Suite Applications.
Click Next. |
3. | Specify Hardware Cluster Installation Mode (optional) | Select Local Installation. This screen will only show up if you are installing Identity Management on a cluster.
Click Next. |
3. | Select a Product to Install | Select Oracle Collaboration Suite Applications 10.1.1.0.2.
Click Next. |
4. | Product-specific Prerequisite Checks | Make sure all the checks complete successfully.
Click Next. |
5. | Select Components to Configure | Select Oracle Mail.Select Oracle Mobile Collaboration.Select Oracle Content Services.Do not select Oracle Calendar Server.Select Oracle Calendar Web Client.Select Oracle Real-Time Collaboration.Select Oracle Collaboration Suite Search.Select Oracle Collaboration Suite Web Access.Do not select Oracle Collaborative Portlets.Select Oracle Workspaces.Select Oracle Discussions.
Click Next. |
6. | Register with Oracle Internet Directory | Host: Enter the LDAP virtual server name.
Port: Enter the non-SSL port number for the LDAP virtual server name. Click Next. |
7. | Specify UserName and Password for Oracle Internet Directory | Username: Enter the username to log in to Oracle Internet Directory. You must log in as the Oracle Internet Directory superuser (cn=orcladmin ).
Password: Enter the password for the username. Click Next. |
8. | OracleAS Metadata Repository | Select Oracle Collaboration Suite 10g Database (ocsdb) from the list.
Click Next. |
Error: The installation has detected that Oracle Collaborative Portlets has already been configured in the Metadata Repository you have selected. Oracle Collaborative Portlets will be unselected for this configuration.
This screen will only show up if you selected Oracle Collaborative Portlets from the Select Components to Configure screen. Click Yes. |
||
9. | Select Database Components | Component Name: Oracle Mail, Oracle Discussions, Oracle Search, Oracle Real-Time Collaboration, Oracle Collaboration Suite Search, Oracle Workspaces, Oracle Content Services, Oracle Collaboration Suite Web Access
Database Name: Name of the Oracle Collaboration Suite 10g Database (ocsdb). Click Next. |
10. | Specify Port Configuration Options | Select Automatic Port Selection or Manual and enter the port numbers for:
Click Next. |
11. | Specify Administrative Password and Instance Name | Instance Name: Enter a name for this Oracle Collaboration Suite Applications instance.
Administrative Password: Set the password for the administrative user. This is the administrative user for the Oracle Collaboration Suite Applications instance. Click Next. |
12. | Specify Oracle Mail Domain Information | Local Domain: Select it from the list.
Select the same domain as in the first Oracle Collaboration Suite Applications installation. Click Next. |
13. | Summary | Verify your selection and click Install. |
14. | Install Progress | This screen displays the progress of the installation. |
15. | Run root.sh |
Note: Do not run the root.sh script until this dialog box appears.
|
16. | The Configuration Assistants | This screen shows the progress of the configuration assistants. |
17. | End of Installation | Click Exit to quit the installer. |
The postinstallation tasks involve troubleshooting the installation errors and performing manual postinstallation steps.
You might have to perform the postinstallation steps to solve the following problems:
The index.jsp
packaged in the welcome.ear
has the incorrect Portal URL. In ORACLE_HOME/j2ee/OC4J_OCSClient/applications/welcome/welcome-web/index.jsp
change URL portalUrl = new URL("http", request.getServerName(), request.getServerPort(), "");
to URL portalUrl = new URL("http", request.getServerName(), request.getServerPort(), "/pls/portal");
Oracle Calendar Home Page cannot be accessed through orclguest
account. To resolve this error, the steps are as follows:
Stop all fast CGI (FCGI) processes using Oracle OCAS Control (ocasctl
). When OCS Application tier is started or stopped using OPMN control (opmnctl
), OCAS is not started or stopped because OCAS is not integrated with OPMN.
ORACLE_HOME/ocas/bin/ocasctl -stopall
Start the FCGI processes.
ORACLE_HOME/ocas/bin/ocasctl –start –t ochecklet –p 8020 –n 1 ORACLE_HOME/ocasctl –start –t ocas –p 8010 –n 5
The default ports are 8010 and 8020. The valid range is 8010-8020.
Verify the status of the FCGI processes:
ORACLE_HOME/ocas/bin/ocasctl –status
When you log on to Portal as a newly created user, the calendar portlet shows "Service temporarily unable due to maintenance message".
Click the Oracle Calendar link and go to the Oracle Calendar view page.
Click the Return to Portal link and the porlet should show up correctly.
When accessing workspaces, user cannot be found in LDAP directory. To resolve this error, run the following command:
$ORACLE_HOME/opmn/bin/opmnctl restartproc process-type=OC4J_OCSClient
You must also perform the following additional postinstallation steps for Oracle Mail and Oracle Mobile Collaboration:
For Oracle mail, the steps are as follows:
Get the user ID and group ID of the owner of the Oracle Collaboration Suite Applications.
Start LISTENER_ES
as root
, if the port that you are using is a privileged port (< 1024). Make sure ORACLE_HOME
, LD_LIBRARY_PATH
and PATH
environment variables are set correctly.
ORACLE_HOME/bin/tnslsnr listener_es –user <userid> -group <group_id> &
To enable Oracle Mobile Collaboration Calendar notifications, the steps are as follows:
Log in to Enterprise Manager. Go to System Components, Wireless, Site Administration.
Expand Component Configuration section and click XMS Configuration.
Under XMS Center, ensure that Enable XMSC is checked.
Go to System Components, Wireless, Notification eng xxxx. Click Enable/Disable link and make sure Notification engine is enabled.
Restart the wireless component.
You can configure two or more Oracle Collaboration Suite Applications instances in a highly-available deployment by placing a load balancer in front of them. The load balancer publishes a single address for Oracle Collaboration Suite Applications while providing a redundant st of application servers that actually service requests. The load balancer can be configured to detect when one of the Oracle Collaboration Suite Applications instances has failed and can then fail over requests to another instance.
The details of the configuration are as follows:
There are two Oracle Collaboration Suite Applications computers: ocs_apps1.mycompany.com
and ocs_apps2.mycompany.com
. Both application servers listen on non-SSL port 7777.
The Oracle Collaboration Suite Applications computers are configured to use the Single Sign-On server located at im_virtual.mycompany.com
.
The effective host name of the Oracle Collaboration Suite Applications published to the user is apps_virtual.mycompany.com
. A load balancer is configured to listen at this address, on port 80. It has been configured to load balance and fail over user requests between ocs_apps1.mycompany.com
and ocs_apps2.mycompany.com
.
The Single Sign-On server and Directory server are located at im_virtual.mycompany.com
.
The Oracle Collaboration Suite Database (including Identity Management metadata) is located at ocs_store1.mycompany.com
and ocs_store2.mycompany.com
(2-node Oracle RAC).
The postinstallation steps are follows:
Configure the Parallel Page Engine Loop-Back with the Load Balancer
Enable Monitoring of the Front-End Host and Port Settings of the Load Balancer for OracleAS Portal
The first task is to configure OracleAS Portal, using the Oracle Enterprise Manager 10g Collaboration Suites Control Console. Follow these steps to configure OracleAS Portal, beginning on the Oracle Collaboration Suite page:
Click Configure Component. The Select Component page appears.
Select portal from the list.
Click Continue. The configuration process may take 10 to 20 minutes to complete.
Before you continue with the OracleAS Portal application server configuration, ensure that the following is configured:
You are able to resolve apps_virtual.mycompany.com
from ocs_apps2.mycompany.com
, such that it contacts the load balancer. To ensure you can resolve apps_virtual.mycompany.com
by running the following command:
nslookup apps_virtual.mycompany.com
The IP address for the virtual server name should be returned.
You are able to contact port 7777 on apps_virtual.mycompany.com
from ocs_apps2.mycompany.com
. Run the following command on ocs_app2.mycompany.com
:
telnet apps_virtual.mycompany.com 7777
Verify that no connection failure message is returned.
This step associates the components on which OracleAS Portal depends with load balancer virtual server name and port: apps_virtual.mycompany.com:80
. The steps to configure the Oracle HTTP Server with the Load Balancer are as follows:
Access the Oracle Enterprise Manager – Oracle Collaboration Suite Control console.
Click the link for the ocs_apps2.mycompany.com
installation.
Click the HTTP Server link.
Click the Administration link.
Click Advanced Server Properties.
Open the httpd.conf
file.
Perform the following steps:
Add LoadModule certheaders_module directive.
LoadModule certheaders_module libexec/mod_certheaders.so
Note:
The LoadModule directives (in particular, the LoadModule rewrite_module directive) must appear in thehttpd.conf
file at a location preceding the VirtualHost directives. The server must load all modules before it can execute the directives in the VirtualHost container. It is a good idea to create the VirtualHost directives at the end of the httpd.conf
file.Add the following lines to create a NameVirtualHost directive and a VirtualHost container for apps_virtual.mycompany.com
and port 80.
NameVirtualHost *:7778 <VirtualHost *:7778> ServerName apps_virtual.mycompany.com Port 80 ServerAdmin you@your.address RewriteEngine On RewriteOptions inherit </VirtualHost>
Create a second VirtualHost container for ocs_apps2.mycompany.com
and port 7777.
<VirtualHost *:7778> ServerName ocs_apps2.mycompany.com Port 7777 ServerAdmin you@your.address RewriteEngine On RewriteOptions inherit </VirtualHost>
Save the httpd.conf
file, and restart the Oracle HTTP Server when prompted.
Copy the dads.conf
file from ocs_apps1.mycompany.com
to ORACLE_HOME/Apache/modplsql/conf
directory of ocs_apps2.mycompany.com
.
In this step, you configure non-SSL loop-back communication between the load balancer and the Parallel Page Engine on ocs_apps1.mycompany.com
and ocs_apps2.mycompany.com
. If the OracleAS Web Cache on ocs_app1.mycompany.com
is down, the Parallel Page Engine can loop back to the OracleAS Web Cache on ocs_apps2.mycompany.com
through the load balancer to reach mod_plsql
.
The steps to create the loop-back configuration are as follows:
Open the ORACLE_HOME/j2ee/OC4J_Portal/applications/portal/portal/WEB-INF/web.xml
file.
Locate the Page servlet section.
Add the lines shown in bold.
<servlet> <servlet-name>page</servlet-name> <servlet-class>oracle.webdb.page.ParallelServlet</servlet-class> <init-param> <param-name>useScheme</param-name> <param-value>http</param-value> </init-param> <init-param> <param-name>usePort</param-name> <param-value>7777</param-value> </init-param> </servlet>
Save the web.xml
file.
Save the manual configuration changes in the DCM repository by running the following command on ocs_apps2.mycompany.com
in ORACLE_HOME/dcm/bin
:
dcmctl updateConfig
Restart all components on ocs_apps2.mycompany.com
by running the following command in ORACLE_HOME/opmn/bin
:
opmnctl stopall opmnctl startall
The Portal Dependency Settings file iasconfig.xml
must contain the correct host, port, and farm name to enable access to OracleAS Portal and perform OracleAS Web Cache invalidation. Follow the steps to edit the file to include this information:
Create a backup copy of the ORACLE_HOME/portal/conf/iasconfig.xml
file.
Copy the iasconfig.xml
file in ocs_apps1.mycompany.com
to ORACLE_HOME/portal/conf
of ocs_apps2.mycompany.com
.
Overwrite the file on ocs_apps2.mycompany.com
when prompted.
The steps for reregistering mod_osso
are:
Back up the ORACLE_HOME/Apache/Apache/conf/osso/conf
file.
Use the FTP binary mode to copy the osso.conf
file of ocs_apps1.mycompany.com
to ORACLE_HOME/Apache/Apache/conf/osso/conf
of ocs_apps2.mycompany.com
.
Synchronize the DCM repository with the file by FTP using the following command:
ORACLE_HOME/Apache/Apache/bin/ssotransfer ORACLE_HOME/Apache/Apache/conf/osso/osso.conf
Note:
This does not create any new partner applications. It enables the partner applicationocsapps.apps_virtual.mycompany.com
for ocs_apps1.mycompany.com
and ocs_apps2.mycompany.com
.Restart the components on ocs_apps2.mycompany.com
by running the commands in ORACLE_HOME/opmn/bin
of ocs_apps2.mycompany.com
:
opmnctl stopall opmnctl startall
Log in to the OracleAS Single Sign-On Administration page as the Administrator, and use the Administer Partner Applications page to delete the entry for the partner application ocsapp1.ocs_apps2.mycompany.com
.
To cluster the OracleAS Web Cache instances, you will perform the configuration steps on ocs_apps1.mycompany.com
and propagate them to ocs_apps2.mycompany.com
.
From the Oracle Enterprise Manager Collaboration Suite Control Console, you can access the Web Cache Manager, the graphical user interface provided for editing the configuration stored in the webcache.xml
file. Start the Oracle Collaboration Suite Applications instance on ocs_apps1.mycompany.com
, then follow the steps to access the Web Cache Manager from the System Components page.
Access the Web Cache Administrator at the following URL:
http://ocs_apps1.mycompany.com:9400/webcacheadmin
The Web Cache Administrator password dialog box appears.
For the user name, enter ias_admin
or administrator
, and enter the OracleAS Web cache administrator password.
Note:
At installation time, the OracleAS Web Cache administrator password is set to the same password as the ias_admin password. The OracleAS Web Cache administrator password must be identical for all cache cluster members.The Web Cache Manager page appears.
Click Clustering in the Properties section. The Clustering page appears.
In the Cluster Members table, click Add. The Add Cache to Cluster page appears.
Enter the following information for ocs_apps2.mycompany.com
:
ocs_apps2.mycompany.com
ocs_apps2.mycompany.com
-WebcacheClick Submit.
Click the Origin Server link in the Origin Servers, Sites, and Load Balancing section. The Origin Server page appears.
Click Add under the Application Web Servers table.
Enter the following information:
ocs_apps2.mycompany.com
Click Submit.
Click the Site-to-Server Mapping link in the Origin Servers, Sites and Load Balancing section. The Site-to-Server Mapping page appears.
Select the mapping for the Load Balancer site (apps_virtual.mycompany.com
) from the table and click Edit Selected. The Edit/Add Site-to-Server mapping page appears.In the Select Application Web Servers section, select an application Web server specified in the Origin Servers page for ocs_apps2.mycompany.com
(ocs_apps1.mycompany.com
is already mapped). Click Submit.
Click Apply Changes.
In the Cache Operations page, click Propagate. The changes are propagated to ocs_apps2.mycompany.com
.
Click Restart. OracleAS Web Cache is restarted on ocs_apps1.mycompany.com
and ocs_apps2.mycompany.com
. OracleAS Web Cache on ocs_apps1.mycompany.com
begins to balance requests to the Oracle HTTP Server and OC4J_Portal instances on ocs_apps2.mycompany.com
.
The steps are as follows:
Open the ORACLE_HOME/sysman/emd/targets.xml
file.
Locate the OracleAS Portal targets, for example, TYPE="oracle_portal
".
Edit the PortalListeningHostPort
property so that it points to the load balancer. For example:
<Property NAME="PortalListeningHostPort" VALUE="http://apps_virtual.mycompany.com:80"/>
Save and close targets.xml
file.
Reload the targets.xml
file in the Oracle Collaboration Suite Control Console by running the following command in ORACLE_HOME/bin
:
emctl reload
The session binding feature in OracleAS Web Cache is used to bind user sessions to a given origin server to maintain state for a period of time. Enabling session binding forces all the user requests to go to a give OracleAS Portal middle-tier, resulting in a better cache hit ratio for the portal cache. For this reason, session binding is required although almost all components running in a given OracleAS Portal middle tier are stateless.
To enable session binding in OracleAS Web Cache, the steps on ocs_apps1.mycompany.com
or ocs_apps2.mycompany.com
are as follows:
Access the Web cache Administrator at the following URL:
http://ocs_apps1.mycompany.com:9400
The Web Cache Administrator password dialog box appears.
Enter the OracleAS Web Cache administrator password.
Note:
At installation time, the OracleAS Web Cache administrator password is set to the same password as theias_admin
password. The OracleAS Web Cache administrator password must be identical for all cache cluster members.The Web Cache Manager page appears.
Click the Session Binding link in the Origin Servers, Sites, and Load Balancing section. The Session Binding page appears.
Select the Load Balancing Router site, apps_virtual.mycompany.com:80
from the table and click Edit Selected. The Edit Session Binding window opens.
Select Any Set-Cookie from the Please select a session list.
Select Cookie-based from the Please select a session binding mechanism list.
Click Submit.
Click Apply Changes.
On the Cache Options page, click Propagate.The changes are propagated to the OracleAS Web Cache instance on the other computer.
Click Restart. OracleAS Web Cache is restarted on ocs_apps1.mycompany.com
and ocs_apps2.mycompany.com
.
Configure Collaborative Portlets Configure Components from Oracle Enterprise Manager 10g Application Server Control Console. The Configure Component button appears above the System Components table if you have installed, but not configured, some components.
To configure Collaborative Portlets, perform the following steps:
On the Oracle Collaboration Suite home page, click Configure Component.
Select Collaborative Portlets from the drop-down list on the Select Component page, and click Continue.
Enter the following values:
apps_virtual.mycompany.com
ORACLE_HOME/install/portlist.ini – 9401
Click Continue. The configuration process may take 10-15 minutes to complete.
Restart the components on ocs_apps2.mycompany.com
by running the following commands in ORACLE_HOME/opmn/bin
of ocs_apps2.mycompany.com
:
opmnctl stopall opmnctl startall
Configure the URLs of the current OracleAS Wireless Instance on each Oracle Collaboration Suite Applications tier. Configuring Oracle Collaboration Suite Mobile Collaboration enables you to define the instance URLs for an application server, or direct an application server to use the URLs defined for the entire OracleAS Wireless site.The steps are as follows:
Access the Oracle Enterprise Manager – Oracle Collaboration Suite Control console.
Click the link for the ocs_apps1.mycompany.com
installation.
Click the Wireless link under System Components.
Click the Instance URLs link under Instance Configuration.
Modify the Wireless Instance URLs to point to the load balancer's virtual server name (apps_virtual.mycompany.com
)
Repeat the preceding steps for each Oracle Collaboration Suite Applications tier.
When deploying Oracle Discussions in more than one Applications tier with a load balancer at the front end, ensure that you turn on session affinity in your load balancer. Oracle Discussions requires that once a user establishes a session with one OC4J instance, all the following requests must go to the same OC4J instance. In case of a failover, the original Applications tier is not available anymore and the requests are transferred to the second Applications tier. Oracle Discussions automatically re-creates a new user session in the new OC4J instance. There is no loss of data except that of the currently executing operation when the first Applications tier goes offline.
To ensure that it is working as it should, perform the following tests:
Ensure that all components on ocs_apps2.mycompany.com
are running.
Run the following command fromORACLE_HOME/opmn/bin
to query the status of the components:
opmnctl status
If necessary, run the following command in ORACLE_HOME/opmn/bin
:
opmnctl startall
Stop all components on ocs_apps1.mycompany.com
by running the following command in ORACLE_HOME/opmn/bin
:
opmnctl stopall
Access OracleAS Web Cache and Oracle HTTP Server through the load balancer with the following URL:
http://apps_virtual.mycompany.com
Test the connection to the Oracle Collaboration Suite Database through the load balancer, by accessing the following URL:
http://apps_virtual.mycompany.com/pls/portal/htp.p?cbuf=test
The response should be test. If this succeeds, then the Oracle Collaboration Suite Applications tier can connect to the Oracle Collaboration Suite Database. If this test fails, then examine the ORACLE_HOME/Apache/Apache/logs/error_log
of Oracle HTTP Server to determine the cause.
Test the OracleAS Portal using following URL (ensure that you can log in):
http://apps_virtual.mycompany.com/pls/portal
Verify that content is being cached in OracleAS Web Cache on ocs_apps1.mycompany.com
, using Web Cache Administrator. Under Monitoring, click Popular Requests. Select Cached from the Filtered Objects drop-down list, and click Update.
If you accessed OracleAS Portal, portal content will appear. If there is no portal content, open another browser and log in to OracleAS Portal. Return to the Popular Requests page, and click Update to refresh the page content.
Repeat steps 3 through 6, by ensuring that all components on ocs_apps1.mycompany.com
are running, and all components on ocs_apps2.mycompany.com
are stopped and vice versa.
If you plan to use Oracle Messenger in a Single Cluster high availability environment, perform the following steps:
From Oracle Real-Time Collaboration Control, run the getstate -v
command to fetch the ID number of the Oracle Presence Server (Instant Messaging router, imrtr
).
Run the following command from Oracle Real-Time Collaboration Control:
stop -cid ID_number_for_imrtr
Run the following command from Oracle Real-Time Collaboration Control:
start -cid ID_number_for_imrtr