Skip Headers

Oracle® Collaboration Suite Installation and Configuration Guide
Release 2 (9.0.4.1) for AIX-Based Systems

Part Number B12204-02
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

2 Preparing for Installation

This chapter describes how to plan each Oracle Collaboration Suite installation.This chapter describes how to plan each Oracle Collaboration Suite installation.

This chapter contains these topics:

2.1 Hardware Requirements

This section contains these topics:

Table 2-1 describes the minimum hardware requirements for each installation of Oracle Collaboration Suite.

Table 2-1 Oracle Collaboration Suite Hardware Requirements Foot 

Requirement Value
AIX CPUFoot  All AIX compatible processors (64-bit)
Monitor 256 color viewing capability
/var/tmp Directory Space Oracle Collaboration Suite: 33 MB

Oracle9iAS Infrastructure: 7 MB

Oracle Collaboration Suite Information Storage: 34 MB

Swap Space 2 GB
Memory

(minimum requirement)

Oracle Collaboration Suite: 512 MB

Oracle9iAS Infrastructure: 512 MB

Oracle Collaboration Suite information storage: 512 MB

Note: Allocate additional memory depending on the applications and the number of users on the systems.

Disk Space for AIX Oracle Collaboration Suite: 6.0 GB

Oracle9iAS Infrastructure: 5.6 GB

Oracle Collaboration Suite Information Storage: 6.0 GB


Footnote For detailed information regarding Oracle Files hardware and sizing requirements, see the Oracle Files Planning Guide.
Footnote An additional CPU is recommended on the computer where the Oracle Collaboration Suite information store is running if you want Oracle Text indexing of documents in Oracle Files or e-mail messages in Oracle Email.


Note:

Regardless of the operating system, disk space must be available on a single disk. Oracle Collaboration Suite does not support spanning the installation over multiple disks.

2.1.1 Determining Available Disk Space

To determine the amount of disk space available on the system, enter the following command:

# df -k

To determine the amount of disk space available in the /var/tmp directory, enter the following command:

# df -k /var/tmp

2.1.2 Determining Random Access Memory

Use the following command to determine the amount of random access memory installed on the system:

# /usr/sbin/lsattr -E -1 sysO -a realmem

If the amount of RAM installed is less than 512 MB, you must install more before you can continue for the installation.

2.1.3 Determining Swap Space

To determine the size of configured swap space, enter the following command:

# /usr/sbin/lsps -a

2.2 Operating System Versions

Table 2-2 lists the operating system version requirements, and the command to determine the current operating system version.

Table 2-2 Operating System Versions and Requirements

Item Operating System Requirements
Operating System AIX 5.1 (64-bit only) or AIX 5.2 (64-bit only).

Use the following command to determine the operating system version currently installed on your system:

# oslevel -r
5100-02

Software IBM JDK 1.3.1, with patches IY30887, IY33957, and IY47055.

To determine what version of JDK is installed in the default location, enter the following command:

$ /usr/java131/bin/java -fullversion

This should display the following:

java full version "J2RE 1.3.1 IBM AIX build ca131-20030630a"

If the JDK is not found, or if the version installed is lower than 1.3.1, download and install JDK 1.3.1 from the following Web site:

http://www.ibm.com/developerworks/java/jdk/aix/index.html

Window Manager Use any supported IBM AIX window manager that supports Motif, such as dtwm, twm and olwm.

2.3 Operating System Patches and Packages

Your operating system can require the installation of patches and packages. Several of the patches listed in the following tables have dependency patches that must also be installed. See the readme files included with the patches and packages for additional information. When downloading a specific patch or package, verify dependencies and download the dependency patches or packages, if required.


Note:

Your operating system must include the sendmail program.

This section contains these topics:

2.3.1 Required AIX-Based System Patches for Oracle9iAS Infrastructure and Oracle Collaboration Suite

Table 2-3 lists the operating system patches you must install for Oracle9iAS Infrastructure installation and Oracle Collaboration Suite installation on AIX-based systems.

Table 2-3 Required AIX-Based System Patches for Oracle9iAS Infrastructure and Oracle Collaboration Suite

Operating System Required Patches
AIX 5.1
  • ML04
  • Fileset bos.adt.libm

  • Fileset bos.perf.libperfstat

  • IY39508

  • IY40840

AIX 5.2
  • ML01
  • Fileset bos.adt.libm

  • Fileset bos.perf.libperfstat

  • IY39508

  • IY40840

Clusterware patches for AIX-based systems
  • HACMP/ES CRM 4.4.1
  • IY21047

  • IY28111

  • PSSP 3.4


2.3.2 Required AIX-Based System Patches for Oracle Collaboration Suite Information Storage

Table 2-4 lists the operating system patches you must install for Oracle Collaboration Suite information storage on AIX-based systems.

Table 2-4 Patches and Packages for Oracle Collaboration Suite Information Storage

Operating System Required Patches Download Location
AIX 5.1 Maintenance Level 04 (ML04), IY339508, IY40840 http://techsupport.services.ibm.com/server/fixes
AIX 5.2 Maintenance Level 01 (ML01), IY339508, IY40840 http://techsupport.services.ibm.com/server/fixes

2.3.3 Operating System Requirements to Support Real Application Clusters

Table 2-5 lists the operating system packages and patches required to support Real Application Clusters.

Table 2-5 Patches and Packages for Real Application Clusters

Platform Packages and Patches
AIX-Based Systems PSSP 3.4 (SP only), HACMP/ES CRM 4.4.1 (RS6000 only)

2.3.4 Additional Operating System Requirements

Table 2-6 lists additional software required for all platforms:

Table 2-6 Additional Required Operating System Requirements

Software Requirement
X Server and Window Manager Use any X Server and window manager supported by your UNIX operating system.

For Hummingbird Exceed, use a native window manager.

For WRQ Reflections, allow a remote window manager.

To determine if your X Window System is working properly on your local system, enter the following command:

prompt> xclock

The X clock should appear on your monitor.

Required executables The following executables must be present: make, ar, ld, and nm.

2.4 Additional Software Requirements for Oracle Web Conferencing

Oracle Web Conferencing uses a Document Conversion Server to convert Microsoft Office documents into HTML or other compatible formats for sharing during conferences. The server must reside on a separate computer from the middle tier, and it must have Microsoft Windows NT and Microsoft Office 2000 or Microsoft Office XP.

Oracle Web Conferencing also uses a Voice Conversion Server to support streaming voice data during conferences or playback of recorded conferences with voice data. The server requires Microsoft Windows 2000 Server SP4 or above, and Intel Dialogic System Software 5.1.1 SP1 or above.


See Also:

Oracle Web Conferencing Sizing Guide for more details about required hardware and software

2.5 Multilingual Support

The Oracle Collaboration Suite user interface is available in the following languages: Arabic, Brazilian Portuguese, Danish, Dutch, English, Finnish, French, German, Greek, Italian, Japanese, Korean, Norwegian, Portuguese, Simplified Chinese, Spanish, Swedish, Traditional Chinese, and Turkish.

2.5.1 Oracle Calendar Multilingual Support Limitations

Oracle Calendar server administration tools have an English interface but support entering data in all Oracle Collaboration Suite supported languages.

The Oracle Calendar clients are available only in English with the following exceptions:

  • Oracle Connector for Outlook: All Oracle Collaboration Suite supported languages, except Arabic

  • Oracle Calendar Web client: All Oracle Collaboration Suite supported languages, except Arabic

  • Oracle Calendar desktop client for Windows: English, French, German, and Japanese

  • Oracle Calendar Sync for Palm for Windows: English, French, German, and Japanese

  • Oracle Calendar Sync for Pocket PC for Windows: English, French, German, and Japanese

2.6 Online Documentation Requirements

You can view Oracle Collaboration Suite documentation online using a Web browser or Portable Document Format (PDF) Viewer.

Table 2-7 lists the requirements for viewing Oracle Collaboration Suite online documentation.

Table 2-7 Online Documentation Requirements

Requirement Items
Online Readers Any one of the following:

HTML

  • Netscape Navigator 4.7 or later

  • Microsoft Internet Explorer 5.0 or later

PDF

  • Acrobat Reader 4.0 or later

  • Acrobat Reader+Search 4.0 or later

  • Acrobat Exchange 4.0 or later

  • PDFViewer Web browser plug-in 1.0 or later

Library-wide HTML search and navigation Active Internet connection
Disk Space 37.5 MB


See Also:

Oracle Collaboration Suite Documentation Roadmap

2.7 Port Allocations

Following installation, Oracle Universal Installer creates a file named portlist.ini showing the ports assigned during the installation of Oracle Collaboration Suite components. The installation process automatically detects any port conflicts and selects an alternate port in the range allocated for that component. The file is located at:

$ORACLE_HOME/install/portlist.ini

2.8 Certified Software

Many Oracle Collaboration Suite components require a Web browser. All Oracle Collaboration Suite installations require an Oracle9iAS Infrastructure and Oracle9i database. A complete list of certified software, including certified Oracle9iAS Infrastructure releases, database releases, and Web browsers for Oracle Collaboration Suite is located at OracleMetaLink:

http://metalink.oracle.com

2.9 Release Notes

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. See Oracle Collaboration Suite Documentation Roadmap for more information about Oracle Collaboration Suite documentation. Although this document is accurate at the time of publication, you can access the latest information and documentation on Oracle Technology Network:

http://otn.oracle.com/

2.10 Environment Preinstallation Tasks

This section contains these topics:

2.10.1 Setting Environment Variables

Table 2-8 explains how to set and unset environment variables.

Table 2-8 Setting and Unsetting Environment Variables

To... C shell Bourne/Korn shell
Set an environment variable
prompt> setenv VARIABLE value
prompt> VARIABLE=value;export VARIABLE
Unset an environment variable
prompt> unsetenv VARIABLE
prompt> unset VARIABLE


Note:

You do not need to set the environment variables ORACLE_HOME, LIBPATH, TMP, TMPDIR, and TNS_ADMIN.

2.10.1.1 DISPLAY

Before starting Oracle Universal Installer, set the DISPLAY environment variable to refer to the X Server that displays Oracle Universal Installer. The format of the DISPLAY environment variable is:

hostname:display_number.screen_number

Oracle Collaboration Suite requires a running X Server to properly create graphics for Oracle Universal Installer, Web applications, and management tools. The frame buffer X Server installed with your operating system requires that you remain logged in and have the frame buffer running at all times. If you do not want to do this, then you must use a virtual frame buffer, such as X Virtual Frame Buffer (XVFB) or Virtual Network Computing (VNC).

Oracle Universal Installer configures this instance to use the same X Server from the installation process for applications and management tools. This X Server must either always be running or you must reconfigure Oracle Collaboration Suite to use another X Server that is always running after the installation completes.


See Also:

  • Your operating system documentation for more information about the DISPLAY environment variable

  • Oracle Technology Network (http://otn.oracle.com/) for information about obtaining and installing XVFB or other virtual frame buffer solutions. Search Oracle Technology Network for "frame buffer".


Installing From a Remote Computer

Setting the DISPLAY environment variable enables you to run Oracle Universal Installer remotely from another workstation. On the system where you launch Oracle Universal Installer, set DISPLAY to the system name or IP address of your local workstation.


Note:

You can use a PC X emulator to run the install if it supports a PseudoColor color model or PseudoColor visual. Set the PC X emulator to use a PseudoColor visual, and then start Oracle Universal Installer. See the X emulator documentation for instructions on how to change the color model or visual settings.

If you get an Xlib error similar to "Failed to connect to server", "Connection refused by server," or "Can't open display" when starting Oracle Universal Installer, then run the commands on your local workstations as listed in Table 2-9.

Table 2-9 DISPLAY Environment Variable Commands

Shell Types On Server Where Oracle Universal Installer Is Running In Session on Your Workstation
C shell
prompt> setenv DISPLAY hostname:0.0
prompt> xhost + server_name
Bourne/Korn shell
prompt> DISPLAY=hostname:0.0;export DISPLAY
prompt> xhost + server_name

2.10.2 Hostnames File Configuration

Oracle Universal Installer requires that the fully-qualified hostname information appear in the configuration files for your computer. A fully-qualified hostname includes both the name of the system and its domain.

Failure to properly configure the hostname information in the listed files may result in runtime errors during Oracle Collaboration Suite installation.

Verify that /etc/hosts has the following format:

ip_address fully_qualified_hostname short_hostname aliases

The following example shows a properly configured /etc/hosts file:

148.87.9.44 oasdocs.us.oracle.com oasdocs oracleinstall

Verify that the hostname command returns this fully-qualified hostname before starting the install.

2.10.3 Creating UNIX Accounts and Groups

The installation process requires a special UNIX account and several special groups. See the following subsections for more information:

2.10.3.1 UNIX Group Name for the Oracle Universal Installer Inventory

Use the admintool or groupadd utility to create a group name such as oinstall. The oinstall group owns the Oracle Universal Installer oraInventory directory. The oracle user account that runs the installation must have the oinstall group as its primary group.


Note:

The UNIX group name must not exceed 8 characters, otherwise the Oracle Calendar configuration assistant will fail.

For more information about these utilities, see your operating system documentation.

2.10.3.2 UNIX Account to Own Oracle Software

The oracle account is the UNIX account that owns Oracle software for your system. You must run Oracle Universal Installer from this account.

Create an oracle account with the properties listed in Table 2-10.

Table 2-10 Oracle Account Properties

Variable Property
Login Name Select any name to access the account. This document refers to the name as the oracle account.
Group Identifier The oinstall group is used in this document.
Home Directory Select a home directory consistent with other user home directories.
Login Shell The default shell can be either the C, Bourne, or Korn shell.


Note:

Use the oracle account only for installing and maintaining Oracle software. Never use it for purposes unrelated to Oracle Universal Installer. Do not use root as the oracle account.

2.10.3.3 UNIX Group Names for Privileged Groups

Two privileged groups are required for Oracle9iAS Infrastructure installation and Oracle Collaboration Suite information storage installation:

  • Database operator group

  • Database administrator group

These privileged groups are not required for Oracle Collaboration Suite installation.

Oracle documentation refers to these groups as OSOPER and OSDBA, respectively. Databases use these groups for operating system authentication. This is necessary in situations where the database is shut down and database authentication is unavailable.

The privileges of these groups are given to either a single UNIX group or two corresponding UNIX groups. There are two ways to choose which groups get the privileges:

  • If the oracle account is a member of the dba group before starting Oracle Universal Installer, then dba is given the privileges of both OSOPER and OSDBA.

  • If the oracle account is not a member of the dba group, then Oracle Universal Installer prompts you for the group names that get these privileges.

Table 2-11 lists the privileges for the OSOPER and OSDBA groups.

Table 2-11 Privileges for the OSOPER and OSDBA Groups

Group Privileges
OSOPER Permits the user to perform STARTUP, SHUTDOWN, ALTER DATABASE OPEN/MOUNT, ALTER DATABASE BACKUP, ARCHIVE LOG, and RECOVER, and includes the RESTRICTED SESSION privilege.
OSDBA Contains all system privileges with ADMIN OPTION, and the OSOPER role; permits CREATE DATABASE and time-based recover.

2.10.4 Real Application Clusters for Oracle Collaboration Suite Information Storage Installation

Perform the following preinstallation steps to install Real Application Clusters.


See Also:

Oracle9i Real Application Clusters Setup and Configuration for more information about preinstallation steps for Real Application Clusters. This manual is available on Oracle Technology Network at
http://otn.oracle.com/

2.10.4.1 Steps to Perform as the root User for Real Application Clusters Installation

  1. Log in as the root user.

  2. Ensure that you have the OSDBA group defined in the /etc/group file on all nodes in the cluster. The OSDBA group name and number, and OSOPER group if you plan to designate one, must be identical for all nodes of a UNIX cluster accessing a single database. The default UNIX group name for the OSDBA group is dba.

  3. Create the oracle account on each node of the cluster so that the account:

    • Has the ORAINVENTORY group as the primary group

    • Has the dba group as the secondary group

    • Is used only to install and update Oracle software

    • Has write permissions on remote directories

  4. Create a mount point directory on each node to serve as the top of the Oracle software directory structure so that:

    • The name of the mount point on each node is identical to that on the initial node

    • The oracle account has read, write, and execute privileges

  5. Set up user equivalence by adding entries for all nodes in the cluster on the node from which to run Oracle Universal Installer, including the local node, to either the .rhosts file of the oracle account or the /etc/hosts.equiv file.

  6. Check user equivalence by executing a remote command on every node as the oracle user. For example, enter the following at the prompt:

    prompt> rsh another_host pwd
    
    
  7. Check RCP equivalence by copying a small file from every node to every node. For example, enter:

    prompt> rcp /tmp/dummy_file another_host:/tmp/dummy_file
    
    This is required for Oracle Universal Installer to install Oracle software on all selected nodes of the clusster. 
    

2.10.4.2 Steps to Perform as the oracle User for Real Application Clusters

  1. Log in as the oracle account.

  2. Verify that the Cluster Membership Monitor is running, using the following commands for AIX-based systems:

    HACMP

    $ /usr/bin/lssrc -ls grpsvcs
    
    

    Note: Verify that the CLSTRMGR_cluster_id has number of providers equal to the number of nodes.

    PSSP 3.4

    $ /usr/bin/lssrc -ls hags
    
    

    Note: Verify that css has the correct number of nodes. There should also be a local provider.

  3. Check for user equivalence of the oracle account by performing a remote login (rlogin) to each node in the cluster.

    If you are prompted for a password, the oracle account does not have user equivalence. Ensure that you gave the same attributes to the oracle user on all the nodes in the cluster. Oracle Universal Installer cannot use the rcp command to copy Oracle products to the remote directories without user equivalence.

    If you have not set up user equivalence, you must perform Step 6 in "Steps to Perform as the root User for Real Application Clusters Installation".

  4. Create at least one shared configuration file as an information repository for the database server configuration. If your platform supports the Cluster File System, skip this step.

    Create a shared raw device of at least 100 MB for the Server Management (SRVM) configuration. Oracle Universal Installer prompts you for the name of this shared file on the Shared Configuration File Name Page. Alternatively, set the environment variable SRVM_SHARED_CONFIG to the absolute path name of the shared raw device from which Oracle Universal Installer can retrieve the configuration file.


    See Also:

    Oracle9i Real Application Clusters Setup and Configuration for more information about setting up a shared configuration file

2.10.5 Configuring Kernel Parameters for Oracle9iAS Infrastructure and Oracle Collaboration Suite

On AIX Based Systems you do not need to configure kernel parameters before installing Oracle9iAS Infrastructure and Oracle Collaboration Suite. However, you might need to modify some kernel parameters for performance reasons.

For more information, refer to Appendix A of the Oracle9i Administrator's Reference Release 2 (9.2.0.1.0) for UNIX Systems: AIX-Based Systems, Compaq Tru64 UNIX, HP 9000 Series HP-UX, Linux Intel, and Sun Solaris.

2.10.6 Configuring Kernel Parameters for Oracle Collaboration Suite Information Storage

Oracle Collaboration Suite information storage uses UNIX resources such as shared memory, swap memory, and semaphore extensively for interprocess communication. If your parameter settings are insufficient for Oracle Collaboration Suite information storage, then you experience problems during installation and instance startup.The greater the amount of data you can store in memory, the faster your database operates. In addition, by maintaining data in memory, the UNIX kernel reduces disk I/O activity.

Review your kernel parameter settings to ensure that they meet Oracle Collaboration Suite information storage requirements. If you do not do this, you may experience errors during installation, or operational errors after installation. These are the recommended kernel parameter requirements for a typical Oracle Collaboration Suite information storage environment.If you have previously tuned your kernel parameters to levels that meet your application needs, then continue to use these values. A system restart is necessary if you change the kernel settings for the kernel changes to take effect.

2.10.6.1 Kernel Parameter Settings for AIX-Based Systems)

AIX Based Systems do not require kernel parameter configuration prior to Oracle9i installation. However, certain system parameters may need to be adjusted to increase performance.

For more information, refer to Appendix A of the Oracle9i Administrator's Reference Release 2 (9.2.0.1.0) for UNIX Systems: AIX-Based Systems, Compaq Tru64 UNIX, HP 9000 Series HP-UX, Linux Intel, and Sun Solaris.

2.11 Before You Install

Before you begin the Oracle Collaboration Suite installation, enter the following commands:

# mv /usr/java131/bin/java /usr/java131/bin/java.ORIG
# cd /usr/java131/bin
# ln -sf ../jre/bin/java ./java

2.12 Installing Oracle Collaboration Suite on a Single Computer

Although Oracle Corporation recommends that you install the Oracle9iAS Infrastructure, Oracle Collaboration Suite information storage database, and Oracle Collaboration Suite middle tier on separate computers for better performance, you can install Oracle Collaboration Suite on one computer. A single-computer installation DVD is provided in the CD pack for Linux and Windows platforms. For other platforms, you can perform a single-computer installation using the CD-ROM sets in the CD pack.


See Also:

http://otn.oracle.com/software/products/cs/files/README.html

for information about single-computer installations on Windows and

http://otn.oracle.com/software/products/cs/files/readme
_linux.html

for information about single-computer installations on Linux



Note:

The Oracle Web Conferencing document conversion server and voice conversion server must be installed on a separate computer from the Oracle Collaboration Suite middle tier. Additionally, Oracle Corporation recommends that you install the Oracle Web Conferencing document conversion server and voice conversion server on separate computers. Both the Oracle Web Conferencing document conversion server and voice conversion server must be installed on Windows platforms.


See Also:

The Oracle Web Conferencing Administrator's Guide for more information about the Oracle Web Conferencing document and voice conversion servers