6 Installing Oracle Collaboration Suite

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

See Also: "Installation Roadmap" for details about the installation sequence Before installing Oracle Collaboration Suite, Oracle Corporation recommends that you read Oracle Collaboration Suite Release Notes, available in the doc directory of each Oracle Collaboration Suite installation CD-ROM and on Oracle Technology Network at http://otn.oracle.com/

Note: Oracle Collaboration Suite is not supported on Windows NT 4.0 Terminal Server, or on Windows 2000 Server with Terminal Services active.

This chapter contains the following topics:

• Installing the Oracle9iAS Infrastructure

• Installing the Oracle Collaboration Suite Information Storage Database

• Installing the Oracle Collaboration Suite Middle Tier

• Installing the Oracle Web Conferencing Document and Voice Conversion Servers

• Installing Oracle Collaboration Suite Integrated Web Client

• Manually Setting Up HTTPS with mod_osso on the Middle Tier

• Additional Documentation

Installing the 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 %WINDIR%\system32\drivers\etc\services file, the Oracle Universal Installer uses them as the Oracle Internet Directory ports. If these ports are listed in your %WINDIR%\system32\drivers\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 %WINDIR%\system32\drivers\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.

1. Insert the first Oracle9iAS Infrastructure (32-bit) Release 2 (9.0.2.3.0) for Microsoft Windows CD-ROM and follow the instructions in "Starting Oracle Universal Installer".

   The Confirm Pre-Installation Requirements screen appears after you click Next on the Language Selection screen at step 9 in "Starting Oracle Universal Installer":

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

   
   

   See Also: Chapter 3, " Upgrading to Oracle Collaboration Suite Release 2 (9.0.4.1.1)" for procedural information about upgrades

   
   

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

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

5. Enter and confirm a guest account password.

6. Click Next to display the Summary screen.

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

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

9. Check the installation log files for any installation errors. The installation log files are located in SYSTEM_DRIVE:\Program Files\Oracle\Inventory\logs.

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

   
   

   Notes: In the directory specified by the TEMP environment variable, 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.

   
   

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

Installing the Oracle Collaboration Suite Information Storage Database

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

This section contains these topics:

• Installing a Database into an Existing Oracle Home

• Registering Oracle Collaboration Suite Information Storage with Oracle Internet Directory

Ensure that you have already installed the infrastructure.

1. Insert the first Oracle Collaboration Suite Information Storage (32-bit) Release 2 (9.2.0.3.0) for Microsoft Windows CD-ROM and follow the instructions in "Starting Oracle Universal Installer".

   The Database Creation screen appears after you click Next on the Language Selection screen in step 8 in "Starting Oracle Universal Installer". Follow these procedures to install an information storage database.

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

3. Select Yes to register the information storage database with Oracle Internet Directory. Click Next to display the Oracle Internet Directory Information screen.

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

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

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

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

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.

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.

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:

• Running the Oracle Net Configuration Assistant

• Running the Database Configuration Assistant

• Verifying Oracle Internet Directory Configuration

  
  

  Notes: This section applies only if you selected No in the Information Storage Registration screen. If your information storage is on a cluster database, then register one database instance with Oracle Internet Directory. You must run both the Oracle Net and database configuration assistants with the same Oracle user account used to install the Oracle software.

  
  

Running the Oracle Net Configuration Assistant

1. Start the Oracle Net configuration assistant by selecting Start > Programs > Oracle - HOME_NAME > Configuration and Migration Tools > Net Configuration Assistant to display the Welcome screen.

2. Select Directory Usage Configuration and click Next.

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

4. Click Next.

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

6. Click Next.

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

8. Click Next.

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

   
   

   Note: Do not select cn=OracleContext,subscriber_specific_DN.

   
   

10. Click Next.

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

12. 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 for more information about connect string options

  
  

Running the Database Configuration Assistant

1. Start the database configuration assistant by selecting Start > Programs > Oracle - HOME_NAME > Configuration and Migration Tools > Database Configuration Assistant.

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.

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.

    Database configuration progresses and the Database Configuration Assistant screen displays.

11. Enter new passwords for the SYS and SYSTEM users of the information storage database.

12. Click Password Management.

    Select all checkboxes on the screen after verifying that your computer meets the minimum pre-installation requirements.

13. Locate the CTXSYS account and unlock it by clicking the box in the Lock Account column.

14. Enter and confirm a new CTXSYS password.

15. Click OK to display the Confirm Pre-Install Requirements screen.

16. Click Next to display the Create Instance Name and ias_admin Password screen.

    The installation of the information storage database is complete.

Verifying Oracle Internet Directory Configuration

To verify Oracle Internet Directory configuration, log in to Oracle Internet Directory and check under cn=oraclecontext for the information storage SID selected in step 3 in "Installing the Oracle9iAS Infrastructure".

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

• Beginning Oracle Collaboration Suite Middle Tier Installation

• Installing Oracle Web Conferencing

• Installing the Oracle Calendar Server and the Oracle Calendar Application System

• Configuring Oracle Files

• Completing the Middle Tier Installation

Before You Begin

• Ensure that you have installed and configured Oracle Internet Directory and Oracle9iAS Single Sign-On somewhere in your network before installing an instance of the Oracle Collaboration Suite middle tier.

• Ensure that you have installed and configured an Oracle9i database or the Oracle Collaboration Suite information storage database somewhere in your network if you are configuring Oracle Email or Oracle Files in this application middle tier instance.

  
  

  Note: If you installed the Oracle Collaboration Suite information storage database, it is automatically registered with Oracle Internet Directory. If you installed an Oracle9i database, you must manually register it with Oracle Internet Directory.

  
  

• Have the database host name, database listener port, and the SID for the database instance in which you will have the Oracle Real-Time Collaboration repository. Verify that you can connect to the database using the preceding information from the host on which you are installing this instance of Oracle Web Conferencing.

• Have the username and password for a user with system privileges, such as privileges for creation of users and tablespaces. The installer defaults to user SYSTEM, and if you plan to use the default, you must have the SYSTEM password.

• The Oracle Universal Installer detects whether the database you are using already contains the Oracle Real-Time Collaboration repository. If the installer does not find one, then a new one is created in the given database. If this happens, you must enter the full path to the directory on the preceding database host where the data files for the Oracle Real-Time Collaboration tablespaces will be created during the installation. This location must have at least 500 MB of free space and be writable by the database.

  
  

  Caution: If the information entered here is incorrect, you will not be able to recover from installation failure, and you will have to restart the entire installation process for this Oracle home.

  
  

  The tablespace picks up the default value in step 3.

• If the database already contains the Oracle Real-Time Collaboration repository and if the installer detects the schemas to be locked, you are prompted for new passwords for the RTC and RTC_APP schemas. If the schemas are not locked, the installer prompts you for the existing RTC_APP schema password.

• The installer tries to find free ports for use by the Oracle Real-Time Collaboration components in the range of 2400-2700. If it does not find any free ports in this range, the installer extends its search to range 2400-49152 and picks up the first available ports it can find. The installer warns you when this happens.

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

1. Insert the first Oracle Collaboration Suite (32-bit) Release 2 (9.0.4.1.1) for Microsoft Windows CD-ROM and follow the instructions in "Starting Oracle Universal Installer".

   The Confirm Pre-Install Requirements screen appears after you click Next on the Language Selection screen in step 8 in "Starting Oracle Universal Installer". Follow these procedures to install an application middle tier.

2. Confirm the preinstallation requirements and click Next to display the Component Configuration screen.

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

   Component	Location
   Server	%ORACLE_HOME%\ocal\
   Administrator	%ORACLE_HOME%\ocad\
   Application System	%ORACLE_HOME%\ocas\

   
   
   
   

   Notes: To install only the Oracle Calendar server: Select Oracle Calendar Server instead of Oracle Calendar Application System. 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: Select Oracle Calendar Application System instead of Oracle Calendar Server. 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

   
   

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

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

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

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

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

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

   • If you are using an existing database, create the required passwords, and designate a location for the datafiles.

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

See Also: Oracle Web Conferencing Administrator's Guide

Installing the Oracle Calendar Server and the Oracle Calendar Application System

10. Select the default time zone for new Oracle Calendar users. Click Next to display the Oracle Calendar Services screen.

11. The Oracle Calendar Services screen appears. Enter the password for the specified user. Click Next.

12. If you did not choose to install Oracle Email, the Oracle Calendar Mail Notification screen opens. Enter the fully qualified domain name of your SMTP server. Click Next to display the Oracle Calendar Node-ID screen.

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

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

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

Configuring Oracle Files

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

Completing the Middle Tier Installation

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

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

19. Click Exit to finish the installation.

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

    %ORACLE_HOME%\bin\emctl stop
    %ORACLE_HOME%\bin\emctl start
    
    

21. To install Oracle Email and complete the installation of the middle tier, go to Chapter 12, " Installing and Configuring Oracle Email".

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:

• In the Component Configuration screen, it is not necessary to select Oracle Web Cache

• In the Oracle9iAS Infrastructure Use screen, select No

• In the Create Instance Name and ias_admin Password screen, create a new instance name. It is not necessary to associate this component with an existing instance.

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

1. Insert the Oracle Web Conferencing Voice & Document Conversion Components Release 2 (9.0.4.1.1) for Microsoft Windows 2000 (32-bit) CD-ROM.

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

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

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

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

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:

• Installs the Oracle Collaboration Suite home page

• Adds Web providers and portlets for installed Oracle Collaboration Suite components

• Sets the Oracle Collaboration Suite home page as the default Web page for Oracle Collaboration Suite users

• Grants customized privileges to users of the Oracle Collaboration Suite home page

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:

• Oracle Calendar

• Oracle Email

• Oracle Files

• Oracle Web Conferencing

• Oracle9iAS Wireless

• Oracle Ultra Search

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

• Through the Oracle Universal Installer by inserting the Oracle Collaboration Suite Clients Release 2 (9.0.4.1.1) CD-ROM

• Using the command line

See Also: Security Web Providers document on the Oracle9iAS Portal Web site at http://portalstudio.oracle.com

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

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

Manually Setting Up HTTPS with mod_osso on the Middle Tier

The Oracle Collaboration Suite installation program does not automatically configure your system to use https with mod_osso on a default Oracle Collaboration Suite middle tier. However, you can configure this manually.

The instructions in this section describe how to do this, which is recommended when using Oracle9iAS Single Sign-On-protected application requiring https on the middle tier.

Before you begin:

• SSO_HOST is the fully qualified host name of the Oracle9iAS Single Sign-On server

• MIDTIER_HOST is the fully qualified host name or IP address of the middle tier

• MIDTIER_HTTPS_PORT is the https port on the middle tier, usually 4443

After completing the procedure in this section:

• There will be an additional partner application for the preferred https port on the middle tier. This partner application will use that https port for each of the Oracle9iAS Single Sign-On URLs (the Oracle9iAS Single Sign-On port must match that of the middle tier's requested URL, which is why these steps are required for https).

• There will be two new Oracle HTTP Server configuration files on the middle tier to support this setup: mod_osso_https.conf and MIDTIER_HOST.https-osso.conf

This section contains the following topics:

• Verifying the Setup

• Setting up https with mod_osso

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:

   • For best results, the Oracle9iAS Single Sign-On server should be listening (and functional) on the https port that is to be configured on the middle tier. This will help you avoid having to re-register the https port with mod_osso when your Oracle9iAS Single Sign-On login page becomes SSL-protected.

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

   • The partner application for the http 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 https 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:

   %ORACLE_HOME%\dcm\bin\dcmctl.bat restart -ct ohs
   

Setting up https with mod_osso

Note: Ensure that the ORACLE_HOME environment variable is correct and that you have permissions to all files. In addition, add %ORACLE_HOME%\bin to the PATH environment variable.

1. Make the following changes to %ORACLE_HOME%\Apache\Apach\bin \ssl-osso.bat:

   • Set AS_HOST to the middle tier host name

   • Set AS_PORT to the middle tier Oracle Web Cache SSL port (typically 4443)

   • If your Oracle9iAS Single Sign-On server does not run on port 1521, replace -port 1521 with the correct number

2. Run ssl-osso.bat.

3. Comment out the line with LoadModule osso_module modules\ApacheModuleOSSO.dll 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 modules/ApacheModuleOSSO.dll
   
   

6. Also in httpd.conf, add the following directive directly after the AddModule directives (right after AddModule mod_fastcgi.c):

   AddModule mod_osso.c
   
   

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

8. Restart Oracle HTTP Server on the middle tier (you may also use opmnctl):

   dcmctl stop -ct ohs
   dcmctl start -ct ohs
   

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.