Skip Headers

Oracle® Collaboration Suite Installation and Configuration Guide
Release 2 (9.0.4.1) for hp-ux PA-RISC (64-bit), Linux x86, and Solaris Operating Environment (SPARC 32-bit)

Part Number B10874-04
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Feedback

Go to previous page
Previous
Go to next page
Next
View PDF

6 Installing Oracle Collaboration Suite

This chapter guides you through the installation steps for Oracle Collaboration Suite Release 2 (9.0.4.1).


See Also:

"Installation Roadmap" for details about the installation sequence

This chapter contains the following topics:

6.1 Installing Oracle9iAS Infrastructure

This section describes how to install Oracle9iAS Infrastructure.


Note:

The industry standard LDAP ports are 389 for non-SSL and 636 for SSL. If these ports are not listed in your /etc/services file, then the Oracle Universal Installer uses them as the Oracle Internet Directory ports. If these ports are listed in your /etc/services file, then the Oracle Universal Installer consecutively tries ports 4031 through 4039 as the Oracle Internet Directory ports.

To use the standard ports 389 or 636, you must delete the lines with these port number from your /etc/services file before you start configuration. It is not sufficient to comment out these lines: they must be deleted.

If you currently have an LDAP server running on ports 389 or 636, shut down the server before configuring.


The Confirm Pre-Installation Requirements screen appears after you click Next on the Language Selection screen at step 15:

  1. Click Next to display the Select Configuration Options screen.

  2. Select accept default selection and click Next to display the Create Instance Name and ias_admin Password screen.

  3. Choose an Instance Name and choose and confirm an ias_admin Password.


    Notes:

    • The Instance Name is not a database instance name but a name for the Oracle9iAS infrastructure instance.

    • The ias_admin password chosen here will also be the Oracle Internet Directory administrator's password for the infrastructure.


    Click Next to display the Guest Account Password screen.

  4. Enter and confirm a guest account password.

  5. Click Next. If you are a member of the DBA group, the Summary screen displays. Proceed to step 8.

    If you are not a member of the DBA group, the Privileged Operating System Groups screen displays.

  6. Enter Database Administratror (OSDBA) Group and Database Operator (OSOPER) Group names.

  7. Click Next to display the Summary screen.

  8. Review the information and click Install. The location of the log files for the installation displays.

    After you click Install, files are copied and linked. This process can run for more than an hour.

  9. As prompted, run root.sh. You must do this as root from another terminal window. When root.sh completes, return to the Oracle Universal Installer and click OK to display the Configuration Assistants screen.

    Review the status of the Oracle9iAS Infrastructure configuration tools.

    The Oracle Universal Installer executes a configuration assistant for each component selected previously in the Select Configuration Options screen.

  10. The End Of Installation screen displays the port numbers for installation and confirms success.

  11. Check the installation log files for any installation errors. The installation log files are located in the oraInventory directory, as explained in "oraInventory Directory and Installation Session Log Files". The default installation log file directory is orInventory_directory/logs.

    Each installation log takes the form InstallActionsYYYY-MM-DD_HH-MM-SSAM.log.


    Notes:

    • In the /tmp directory, the format of the directory is as follows: OraInstallYYYY-MM-DD_HH-MM-SSAM.log. The installCluster.log file shows which installation module is currently running.

    • The list of ports can be found in the portlist.ini file located in the $ORACLE_HOME/install directory.


6.1.1 Oracle9iAS Infrastructure Additional Documentation

For further information about postinstallation and configuration tasks, refer to the Oracle9i Application Server Administrator's Guide and component-specific documentation.

Although it is not necessary for a new installation of Oracle Collaboration Suite, you can create a test user to test the installation.


See Also:

"Upgrading Oracle9iAS Infrastructure" for instructions on creating a test user

6.2 Installing Oracle Collaboration Suite Information Storage Database

This section describes how to install Oracle Collaboration Suite information storage database.

This section contains these topics:

Ensure that you have already installed the infrastructure.

The Database Creation screen appears after you click Next on the File Locations screen in step 15. Follow these procedures to install an information storage database.

  1. Select Yes to create a new Oracle9i database and click Next to display the Information Storage Registration screen.

  2. Enter the fully-qualified Host name, Port, Username (by default, the Oracle Universal Installer displays cn=orcladmin), and Password. Click Next to display the Database Identification screen.

  3. Enter the Global Database Name and SID. If required, change the default SID.

  4. Click Next to display the Database File Location screen.

  5. Accept the default and click Next to display the Summary screen.

  6. Review and change any entries, if necessary. Click Install to accept the entries and begin the installation.


    Note:

    After you click Install, files are copied and linked. This process can run for more than an hour.

  7. When prompted, run root.sh from the root account in another terminal window. Progress screens display while root.sh is running, charting the installation progress.

  8. When root.sh completes, return to the Oracle Universal Installer and click Next to display the Configuration Assistants screen.

  9. When the database configuration assistant prompts you, choose and confirm the SYS and SYSTEM account passwords. Click OK.

  10. When the End of Installation screen displays, click Exit.

6.2.1 Installing a Database into an Existing Oracle Home

You can install more than one database in the same Oracle home.

Install a starter database or select the Software Only database configuration option when prompted from one of the following software CD-ROMs:

  • Oracle Collaboration Suite information storage

  • Oracle9i Database


    Important:

    Oracle Corporation does not recommend installing more than one database in an Oracle home in a production environment. This configuration is recommended for evaluation purposes only.

  1. Run the database configuration assistant after the software is installed.

    $ORACLE_HOME/bin/dbca
    
    
  2. Select Create a new database.

  3. Click Next.

  4. Select the database configuration type that you want to create when prompted.

  5. Answer questions such as Oracle home name and instance name.

    The database is created by the database configuration assistant in the same manner that it is created by Oracle Universal Installer.

6.2.2 Registering Oracle Collaboration Suite Information Storage with Oracle Internet Directory

The following sections describe how to register the information storage database with Oracle Internet Directory:

6.2.2.1 Running the Oracle Net Configuration Assistant

  1. Start the Oracle Net configuration assistant:

    $ORACLE_HOME/bin/netca
    
    
  2. The Welcome screen appears.

  3. Select Directory Usage Configuration and click Next.

  4. Select the directory server you want to use. The directory server must already be configured for Oracle usage.

  5. Click Next.

  6. Select Oracle Internet Directory as the directory server type you want to use.

  7. Click Next.

  8. Enter the Oracle Internet Directory host name, port, and SSL port.

  9. Click Next.

  10. Select cn=OracleContext as the default Oracle Context in the directory server.


    Note:

    Do not choose cn=OracleContext,subscriber_specific_DN.

  11. Click Next.

  12. Proceed to the end of the Oracle Net configuration assistant configuration.

    This creates an ldap.ora file that specifies the Oracle Internet Directory server and port number in the $ORACLE_HOME/network/admin directory.

  13. Exit the Oracle Net configuration assistant.

Additional Configuration Steps for Real Application Clusters

Use Oracle Net Manager to either:

  • Add network addresses to the database entry for the nodes in the cluster for which there is no address listed.

  • Create a separate net service name specifying the network address for one of the nodes in the cluster and the Real Application Clusters global database name as the service name of the database. Then add network address to the net service name for the other nodes in the cluster.


    See Also:

    Oracle9i Real Application Clusters Setup and Configuration and the for more information about connect string options

6.2.2.2 Running Database Configuration Assistant

  1. Start Database Configuration Assistant:

    $ORACLE_HOME/bin/dbca
    
    
  2. Click Next.

  3. Select Configure database options in a database.

  4. Click Next.

  5. Select the SID of the Oracle Email database to configure.

  6. Click Next.


    Note:

    If the SID does not appear, check the oratab file in the /var/opt/oracle directory on Solaris, and the /etc/oratab directory on HP and Linux.

  7. Select the Yes, register the database option.

    1. Enter cn=orcladmin in the User DN field.

    2. Enter the password for the name entered in the User DN field.

  8. Click Finish.

    The Restart Database screen appears.

  9. Click Yes.

    The Summary screen appears.

  10. Click OK.

    The progress of database configuration displays in the Database Configuration Assistant screen.

  11. Exit Database Configuration Assistant when configuration completes.

6.2.2.3 Verifying Oracle Internet Directory Configuration

  1. Run oidadmin.

  2. Log in to Oracle Internet Directory and check under cn=oraclecontext for the information storage SID selected in step 4.

6.3 Installing the Oracle Collaboration Suite Middle Tier

This section follows the sequence of steps performed by the Oracle Universal Installer to install the middle tier and assumes that all Oracle Collaboration Suite components are being installed.

This section contains the following topics:

Before You Begin


Note:

The Oracle Calendar server will not work if it is installed by a user whose UNIX user ID is greater than eight characters.

Beginning Oracle Collaboration Suite Middle Tier Installation

To start the Oracle Universal Installer, see "Starting Oracle Universal Installer".

The Confirm Pre-Install Requirements screen appears after you click Next on the File Locations screen at step 15. Follow these procedures to install an application middle tier.

  1. Confirm the pre-install requirements and click Next to display the Component Configuration screen.

  2. Select the components you want to install and click Next. Note that Oracle Calendar Web client, Sync Server and Web services cannot be installed unless you select Oracle Calendar Application System. Oracle Calendar will be installed in the following locations:


    Notes:

    To install only the Oracle Calendar server:

    1. Select Oracle Calendar Server instead of Oracle Calendar Application System.

    2. Consequently, you will be prompted for the client's Host and Port. If you do not know these values, you can enter temporary values and later, edit the server's unison.ini file, as follows:

      [RESOURCE_APPROVAL]url=http://host_name:port_number/ocas-bin/ocas.fcgi
      
      

    To install only the Oracle Calendar application system:

    1. Select Oracle Calendar Application System instead of Oracle Calendar Server.

    2. Consequently, you will only be prompted to enter the Host, Port and Node-ID for the Oracle Calendar server. If you do not know these values, you can enter temporary values and, later, edit the application system's ocas.conf file with the correct values, as follows:

      [CONNECTION]mnode=host_name:engine_port,node
      

    Component Location
    Server $ORACLE_HOME>/ocal/
    Administrator $ORACLE_HOME>/ocad/
    Application System $ORACLE_HOME>/ocas/

  3. Click Next to display the Existing Oracle9iAS Single Sign-On screen.

  4. Enter the host name and port number for your existing instance of Oracle9iAS Single Sign-On and click Next to display the Oracle Internet Directory screen.

  5. Enter the administrator's user name and password of the existing Oracle Internet Directory instance and click Next to display the Specify Administrative Password and Instance Name screen.

  6. Choose an Instance Name and choose and confirm an Administrative Password.


    Notes:

    • The Instance Name is not a database instance name but a name for the middle tier instance installation.

    • The Administrative Password chosen here will also be the Oracle Internet Directory administrator's password for the middle tier.


Installing Oracle Web Conferencing

  1. Click Next to display the Oracle Real-Time Collaboration Repository Location screen. Enter the required information in all the fields.

  2. Click Next to display the Oracle Real-Time Collaboration Repository Details screen. The information for which you are prompted depends on the database you are using.

    If you are using the Oracle Collaboration Suite information storage database, reset the passwords for the schema.

  3. After entering the information, click Next to display the Oracle Calendar Default Time Zone screen.

Installing the Oracle Calendar Server and the Oracle Calendar Application System


Note:

If the kernel parameters on your computer are not sufficient to run the Oracle Calendar server, an information dialog box opens explaining which parameters you might have to change. Make whatever changes are necessary, restart the computer, and restart the installation. For details on calculating required kernel parameters, see Appendix B, "Adjusting Calendar Kernel Parameters," of the Oracle Calendar Administrator's Guide.

  1. Select the default time zone for new Oracle Calendar users. Click Next to display the Oracle Calendar Node-ID screen.

  2. Specify a unique numerical ID for the Oracle Calendar node between 1 and 49999. Click Next to display the Oracle Calendar Master Node screen.

  3. If this is your first installation of the Oracle Calendar server, select Yes in the Oracle Calendar Master Node screen to make the current installation the master node. You must have one master node on your network in order for Web services and Sync Server to work. Click Next to display the Summary screen.

  4. Review the settings for your installation. If you need to make any changes, click Back. Click Next to display the Install screen.

    The progress of the installation displays in a progress bar on this screen.

  5. As prompted, run root.sh. You must do this as root from another terminal window. When root.sh completes, log off as root and click OK to display the Configuration Assistants screen.

    Each component configuration assistant will launch automatically. If a configuration assistant fails, the cause of the failure displays in a window on the screen. Correct the cause of the failure and click Retry.

  6. When the Oracle Net Configuration Assistant Welcome screen displays, select Perform typical installation. Click Next to display the Configuration Assistants screen.

Configuring Oracle Files

  1. When the Files Configuration Assistant screen displays, go to "Configure Oracle Files" and complete the procedures listed there.

Completing the Middle Tier Installation

  1. When the Oracle Files configuration assistant completes, the Configuration Assistants screen displays. Click Next to display the End of Installation screen.

  2. Take note of the information displayed in the End of Installation screen.

  3. Click Exit to finish the installation.

  4. Use the following commands to restart Oracle Enterprise Manager:

    $ORACLE_HOME/bin/emctl stop
    $ORACLE_HOME/bin/emctl start
    

6.4 Installing the Oracle Web Conferencing Document and Voice Conversion Servers

The document conversion server and voice conversion server must be installed on a separate computer from the middle tier. Both servers can be installed on the same computer, or on separate ones. Before installing the document conversion server and voice conversion server, you must install the Oracle9i Application Server on each computer on which these components will reside. Follow the same steps for installing the middle-tier, with the following exceptions:

When you finish installing the middle tier, install the document and voice conversion servers.

  1. Install the document conversion server or voice conversion server by selecting the appropriate radio buttons. This selection makes it possible to install one or both of these components. Click Next.

  2. Select the components you want to install, and click Next.

  3. Enter the host, port number, and SID of the database that contains the Oracle Real-Time Collaboration repository. Also, enter a password for the Oracle Real-Time Collaboration repository schema RTC_APP. Click Next.

  4. This screen shows the status of the component installation.

6.5 Installing Oracle Collaboration Suite Integrated Web Client

Oracle Collaboration Suite provides an integrated Web client for browser-enabled computers. It uses the underlying Oracle9i Application Server to provide a secure, single sign-on environment. The integrated Web client can be used to access messages (e-mail, voice mail, and fax), calendar and directory information, Oracle Web Conferencing features, and content stored in Oracle Files.

By default, the Web client is automatically integrated during the component configuration when installing Oracle Collaboration Suite. If you deselect the Web client during installation, you must run the Web client installer.

The Web client installer performs the following tasks:

You can run the Web client installer whenever a new Oracle Collaboration Suite component is installed in order for the component to be available on the Oracle Collaboration Suite home page. The Web client installer is only available for the following Oracle Collaboration Suite components:

You can invoke the Web client installer using one of the following methods:

6.5.1 Invoking the Web Client Installer using the Command Line

When you install Oracle Collaboration Suite, you can choose to install selected components instead of the entire suite. If you install an additional component later, then in order for the component to be available on the Oracle Collaboration Suite home page, you must configure the component's URL and run the Web client command line installer.

Configuring the Component's URL

Configure the component's URL by modifying the webclient.properties file located in the following directory:

$ORACLE_HOME/webclient/classes/oracle/collabsuite/webclient/resources

The webclient.properties contains three URL listings for each Oracle Collaboration Suite component: the help page URL, the application URL, and the provider URL. Replace the token for the host name and the port number in all three URL listings for the component you are installing.

Running the Web Client Command Line Installer

To run the Web client command line installer, enter the following command:

$ORACLE_HOME/webclient/bin/webclient_installer.sh

The preceding command will install the provider and portlets for the new component on the Oracle Collaboration Suite home page.

If you know the Oracle9iAS Portal schema name, password, and connect string details, you can also invoke the configuration assistant as follows:

$ORACLE_HOME/webclient/bin/webclient_installer.sh -s schema -p password -c 
connect_string

Where:

  • schema: The Oracle database account for Oracle9iAS Portal

  • password: The Oracle9iAS Portal account password

  • connect_string: The connect string to the database instance where the Oracle9iAS Portal repository is installed; specified as host_name:port:SID

6.6 Manually Setting Up HTTPS with mod_osso on the Middle Tier

The Oracle Collaboration Suite installation program automatically configures your system to use https with mod_osso on a default Oracle Collaboration Suite middle tier. At times, however, it may be necessary to configure this manually.

The instructions in this section describe how to do this, which is necessary for using the Oracle Calendar Administrator with https, but will also work for any other Oracle9iAS Single Sign-On-protected application requiring https on the middle tier.

After completing the procedure in this section:

Before you begin:

This section contains the following topics:

6.6.1 Verifying the Setup

  1. Using a Web browser, go to the Oracle9iAS Single Sign-On server home page (assuming http is on port 7777):

    http://SSO_HOST:7777/pls/orasso
    
    
  2. Click Login and log in with administration privileges.

  3. Click SSO Server Administration.

  4. Click Administer Partner Applications and verify the following:

    • The Oracle9iAS Single Sign-On server must be listening (and functional) on the https port that is to be configured on the middle tier

    • There must be only one partner application listed for the https port on the middle tier (click Edit to view the settings: usually 7777 when using Oracle Web Cache)

    • The partner application for the https port on the middle tier must have the same port number for the all of the following Oracle9iAS Single Sign-On URLs:

      Home URL

      Success URL

      Logout URL

    • There must not be any partner applications listed for the http port on the middle tier (usually 4443 when using Oracle Web Cache)

    If either of these requirements are not met, please refer to Oracle9iAS Single Sign-On and Oracle HTTP Server documentation to correct the configuration.

  5. Ensure that you can restart the Oracle HTTP Server on the middle tier with no errors:

    >dcmctl restart -ct ohs
    

6.6.2 Setting up https with mod_osso

Proceed with the following steps from the middle tier console.


Note:

Ensure that the ORACLE_HOME environment variable is correct and that you have permissions to all files. In addition, set the LD_LIBRARY_PATH to $ORACLE_HOME/lib (on HP, set SHLIB_PATH to $ORACLE_HOME/lib32).

  1. Create a text file named ssl_osso.sh, as shown in Example 6-1.

    Example 6-1 Content of ssl_osso.sh script

    #!/bin/sh
      # This script creates a osso\osso-conf file ($AS_HOST.AS_PROTOCOL-osso.conf)
      # AS = Application server or midtier
      # Modify following variables before running
      AS_PROTOCOL=https
      AS_HOST=MIDTIER_HOST
      AS_PORT=MIDTIER_HTTPS_PORT
      SSO_HOST=SSO_HOST
      MODOSSO_FILE=${ORACLE_HOME}/Apache/Apache/conf/mod_osso.conf
      MODOSSO_HTTPSFILE=${ORACLE_HOME}/Apache/Apache/conf/mod_osso_https.conf
      echo 'Registering mod_osso, please wait...'
      cp $MODOSSO_FILE $MODOSSO_HTTPSFILE
      # Note: make sure that your Oracle9iAS Single Sign-On server runs on port
      # 1521. If not, replace '-port 1521' with correct port number.
      $ORACLE_HOME/jdk/bin/java \
        -jar $ORACLE_HOME/sso/lib/ossoreg.jar \
        -host $SSO_HOST \
        -port 1521 \
        -sid iasdb \
        -site_name $AS_HOST.$AS_PROTOCOL:$AS_PORT \
        -oracle_home_path $ORACLE_HOME \
        -success_url $AS_PROTOCOL://$AS_HOST:$AS_PORT/osso_login_success \
        -logout_url $AS_PROTOCOL://$AS_HOST:$AS_PORT/osso_logout_success \
        -cancel_url $AS_PROTOCOL://$AS_HOST:$AS_PORT/ \
        -home_url $AS_PROTOCOL://$AS_HOST:$AS_PORT/ \
        -config_mod_osso TRUE  -u root -sso_server_version v1.2 \
        -config_file $ORACLE_HOME/Apache/Apache/conf/osso/$AS_HOST.$      {AS_PROTOCOL}-osso.conf
      cp $MODOSSO_HTTPSFILE $MODOSSO_FILE
    
    
  2. Run the ssl_osso.sh script:

    sh ssl_osso.sh
    
    
  3. Comment out the line with LoadModule osso_module libexec/mod_osso.so within the mod_osso.conf and mod_osso_https.conf files, both located in the $ORACLE_HOME/Apache/Apache/conf/ directory.

  4. In mod_osso_https.conf, replace the OssoConfigFile directive with the following (if it is missing, add it to the <IfModule mod_osso.c> section):

    OssoConfigFile conf/osso/MIDTIER_HOST.https-osso.conf
    
    
  5. In httpd.conf, add the following directive directly after all of the LoadModule directives (right after fastcgi_module with a default setup):

    LoadModule osso_module libexec/mod_osso.so
    
    
  6. Within the VirtualHost _default_:4444 directive (or your https VirtualHost if the port is different) of httpd.conf, add the following line:

    include conf/mod_osso_https.conf
    
    
  7. Restart Oracle HTTP Server on the middle tier (you may also use opmnctl):

    dcmctl stop -ct ohs
    dcmctl start -ct ohs
    

6.7 Additional Documentation

The Oracle Collaboration Suite Documentation Library CD-ROM is included in your Oracle Collaboration Suite CD Pack. For information about accessing the documentation from the CD-ROM, refer to Oracle Collaboration Suite Documentation Roadmap.