Contents

List of Examples

List of Figures

List of Tables

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents
• Conventions

What's New in Oracle Collaboration Suite Administration?

Part I Getting Started

1 Getting Started After Installing Oracle Collaboration Suite

• Getting Started with Oracle Collaboration Suite
  • Set Up Operating System User Accounts
  • Getting Started with Oracle Content Services
  • Setting a Business Administrator Account for Oracle Real-Time Collaboration
  • Setting an Administrator Account for Oracle Mail and Oracle Discussions
  • Enabling Enterprise Manager Accessibility Mode
  • Using the Oracle Collaboration Suite Welcome Page
• Verifying the Current Configuration
  • Checking Oracle Collaboration Suite Port Numbers
  • Verifying Portal Configuration
  • Verifying Oracle Discussions Configuration
  • Verifying Oracle Mail Installation
  • Verifying Oracle Content Services Configuration
  • Verifying Oracle Calendar Configuration
  • Verifying Oracle Real-Time Collaboration Configuration
  • Verifying Oracle Voicemail & Fax Configuration
  • Verifying Oracle Mobile Collaboration Configuration
  • Verifying Oracle Workspaces Configuration
  • Setting Up the End-User Documentation Portal

2 Starting and Stopping Oracle Collaboration Suite

• Overview of Starting and Stopping Oracle Collaboration Suite
• Starting and Stopping Oracle Collaboration Suite Tiers
  • Starting the Infrastructure Tier
  • Stopping the Infrastructure Tier
  • Starting an Applications Tier
  • Stopping an Applications Tier
• Starting and Stopping Oracle Collaboration Suite Database Instances
• Starting and Stopping Individual Components
  • Starting and Stopping Using the Oracle Collaboration Suite Control
  • Starting and Stopping Using opmnctl
  • Starting and Stopping Oracle Calendar
  • Starting and Stopping Oracle Content Services
  • Starting and Stopping Oracle Discussions
  • Starting and Stopping Oracle Mail
  • Starting and Stopping Oracle Mobile Collaboration
  • Starting and Stopping Oracle Real-Time Collaboration Components
  • Starting and Stopping Oracle Collaboration Suite Search
  • Starting and Stopping Oracle Voicemail & Fax
  • Starting and Stopping Oracle Workspaces
• Enabling and Disabling Components
• Starting and Stopping: Special Topics
  • Using opmnctl Instead of Other Command-Line Tools to Start and Stop
  • Starting and Stopping Log Loader
  • Starting and Stopping in High Availability Environments
  • Shutting Down Oracle Collaboration Suite Database with the IMMEDIATE Option

Part II Managing Oracle Collaboration Suite

3 Oracle Collaboration Suite Management Tools

• Oracle Collaboration Suite Administration Tools
  • Introduction to Oracle Collaboration Suite Control
  • Introduction to Grid Control
  • Introduction to the Database Control Console
  • Introduction to Oracle Directory Manager
  • Managing Oracle Collaboration Suite from the Command Line
  • Using Other Tools to Monitor the Built-In Performance Metrics
• Using Oracle Collaboration Suite Control Console
  • Introducing the Oracle Collaboration Suite Control Console Home Pages
  • About the Underlying Technologies of Oracle Collaboration Suite Control
  • Using the Oracle Collaboration Suite Control Console Online Help
  • Getting Started with the Oracle Collaboration Suite Control Console
  • Monitoring and Diagnosing with the Oracle Collaboration Suite Control Console
• Using Grid Control to Manage Oracle Collaboration Suite
  • About the Components of Grid Control
  • Installing the Grid Control Components
  • Logging In to the Grid Control Console
  • Overview of Grid Control Monitoring Tasks
  • Obtaining More Information about Grid Control
• Using Oracle Directory Manager to Manage Oracle Collaboration Suite
• Managing Oracle Collaboration Suite from the Command Line

4 Managing Oracle Collaboration Suite Users and Groups

• Introduction to the Oracle Internet Directory Provisioning Console
  • Provisioning Process
  • User Enrollment in Applications
• Getting Started with the Provisioning Console
• Managing User Entries Using the Provisioning Console
  • Creating Individual User Entries
  • Managing User Entries in Bulk
  • Modifying User Entries
  • Assigning Privileges to Users
  • Changing the Password of a User
  • Changing the orcladmin Password
  • Unlocking User Accounts
  • Enabling and Disabling User Accounts
  • De-provisioning Users from Applications
  • Deleting User Accounts and Data
  • Oracle Collaboration Suite Application-Specific User Attributes
• Managing Group Entries Using the Provisioning Console
  • Creating Group Entries
  • Modifying Group Entries
  • Deleting Group Entries
  • Assigning Privileges to Groups
• Configuring User Account Creation Using the Provisioning Console
  • Managing Oracle Collaboration Suite Application-Specific Attribute Defaults
  • Configuring the Self-Service Console for User Management
  • Setting Default Provisioning Policies
• Changing the Default Password Policies
• Searching for Entries Using the Provisioning Console
  • Searching for User Entries
  • Searching for Group Entries
• Managing Identity Management Realms Using the Provisioning Console
  • Configuring an Identity Management Realm
  • Viewing Configuration Settings for an Identity Management Realm
  • Modifying Configuration Settings for an Identity Management Realm
  • Configuring the Parent Distinguished Name for Entries in a Realm
  • Creating an Additional Identity Management Realm

5 Managing Oracle Collaboration Suite Applications

• Administrating Oracle Collaboration Suite Components using Component Administration Tools
  • Oracle Calendar Administration Tools
  • Oracle Mail Administration Tools
  • Oracle Content Services Administration Tools
  • Oracle Real-Time Collaboration Administration Tools
  • Oracle Voice Mail & Fax Administration Tools
  • Oracle Mobile Collaboration Administration Tools
• Overview of Typical Administration Tasks for Oracle Collaboration Suite Components
  • Oracle Calendar Administration Tasks
  • Oracle Mail Administration Tasks
  • Oracle Content Services Administration Tasks
  • Oracle Real-Time Collaboration Administration Tasks
  • Oracle Voicemail & Fax Administration Tasks
  • Oracle Mobile Collaboration Administration Tasks
• Managing Oracle Collaboration Suite Search
  • Monitoring Oracle Collaboration Suite Search
  • Configuring Oracle Collaboration Suite Search
• Managing Oracle Contacts
  • Managing Oracle Contacts Default Categories
  • Managing Oracle Contacts Maximum Entries
• Managing Oracle Discussions
  • Introduction to Oracle Discussions
  • Oracle Discussions Access Control
  • Oracle Discussions Administration Tasks
  • Oracle Discussions Forum E-mail Integration
  • Accessing Oracle Discussions with RSS
  • Accessing Oracle Discussions using E-mail
  • Oracle Discussions Message Indexing for Search
• Managing the End-User Documentation Portal
  • About the End-User Documentation Portal
  • Customizing the End-User Documentation Portal
  • Editing End-User Documentation Portal Views
  • Using Static Version of End-User Documentation Portal
  • Directory Structure of End-User Documentation Portal
  • Editing Content in End-User Documentation Portal
• Managing Oracle Application Server Portal and Oracle Collaborative Portlets
  • Managing Oracle Application Server Portal
  • Configuring OracleAS Portal After Installation
  • Managing Oracle Collaborative Portlets
• Managing Oracle Web Access Client
  • Viewing Oracle Web Access Client Performance Metrics
  • Managing Oracle Web Access Client System Configuration
  • Managing Oracle Web Access Client Default Settings
  • Configuring Oracle Web Access Client Attachment Caching
  • Configuring Oracle Web Access Client for Non-Single Sign-On IMAP Mode
  • Corporate Directory Searches with Oracle Web Access Client
  • Using an Alternate Search Base for Entries Returned by Oracle Web Access Client
  • Placing Constraints on Directory Entries Returned by Oracle Web Access Client
• Managing Oracle Workspaces
  • Introduction to Oracle Workspaces
  • Oracle Workspaces Initialization
  • Oracle Workspaces Access Control
  • Oracle Workspaces Management Tasks
• Adding Applications to your Oracle Collaboration Suite Deployment

6 Managing Oracle Collaboration Suite Databases

• Using the Oracle Enterprise Manager 10g Database Control Console
  • Database Management Features
  • Database Control Console Online Help
  • Database Control Console Navigational Features
• Starting the Database Control Console
  • Starting dbconsole in Windows
• Accessing the Database Control Console
• Administering Database Users
  • Creating Database Users
  • Using a Shortcut to Create Database Users
  • Editing Database Users
  • Dropping Database Users
• Granting Database Control Administrative Privileges
• Setting Up Database Control Preferences
  • Defining Database Alert Blackout Time Periods
  • Setting Database Preferred Credentials
• SQL Statements and Other Management Tools: SQL*Plus and iSQL*Plus
  • Starting SQL*Plus
  • Starting iSQL*Plus
• Starting and Stopping the Oracle Collaboration Suite Database
  • Options for Starting Up Oracle Collaboration Suite Database
  • Preparing to Start an Oracle Collaboration Suite Database Instance
  • Using SQL*Plus to Start Up an Oracle Collaboration Suite Database
  • Scenarios for Starting a Oracle Collaboration Suite Database Instance
  • Altering Oracle Collaboration Suite Database Availability
  • Options for Shutting Down an Oracle Collaboration Suite Database
  • Shutting Down an Oracle Collaboration Suite Database with the NORMAL Clause
  • Shutting Down an Oracle Collaboration Suite Database with the IMMEDIATE Clause
  • Shutting Down an Oracle Collaboration Suite Database with the TRANSACTIONAL Clause
  • Shutting Down an Oracle Collaboration Suite Database with the ABORT Clause
• Viewing Listener Configuration
  • Starting up and Shutting Down the Listener
• Managing Oracle Collaboration Suite Database Structures
  • Exploring the Storage Structure of Your Database
  • Common DBA Tasks for Managing Database Storage
  • Managing Undo for Your Database
• Viewing and Modifying Initialization Parameters
• Managing Memory Parameters
  • Modifying Memory Parameters
• Managing the OracleAS Metadata Repository
  • Frequently Asked Questions About OracleAS Metadata Repository
  • Viewing OracleAS Metadata Repository Schema Passwords
  • Changing OracleAS Metadata Repository Schema Passwords
  • Changing the Character Set of OracleAS Metadata Repository
  • Renaming and Relocating OracleAS Metadata Repository Datafiles
• Changing Oracle Collaboration Suite Schema Passwords
  • Changing the Oracle Calendar Schema Password
  • Changing the Oracle Content Services Schema Password
  • Changing the Oracle Mail Schema Password
  • Changing the Oracle Real-Time Collaboration Schema Password
  • Changing the Oracle Workspaces Schema Password

7 Managing Oracle Collaboration Suite Infrastructure

• Setting Up and Enabling Multiple Realms
  • How the Single Sign-On Server Enables Authentication to Multiple Realms
  • Configuring the Single Sign-On Server for Multiple Realms
  • Granting Administrative Privileges for Multiple Realms
• Managing the Oracle Internet Directory Service Registry
  • Introduction to the Oracle Internet Directory Service Registry
  • URIs Recorded in the Oracle Internet Directory Service Registry
  • Retrieving the Contents of the Oracle Internet Directory Service Registry
  • Using Oracle Directory Manager to Edit the Oracle Internet Directory Service Registry

8 Managing Oracle Collaboration Suite Log Files

• Introduction to Oracle Collaboration Suite Logging
  • Understanding Log File Data and Naming
  • Using a Log Repository
  • Configuring Component Logging Options
• Listing and Viewing Log Files with Oracle Collaboration Suite Control
  • Listing Log Files for Components
  • Listing Log Files from Oracle Collaboration Suite Components Pages
  • Using Log Files Advanced Search
• Searching Diagnostic Messages in a Log Repository
  • Getting Started with Log Repository
  • Searching Log Repository with Simple Search
  • Searching Log Repository with Advanced Search
  • Viewing Repository Log Entry Details
  • Using Regular Expressions With Log Repository Search
• Diagnosing Problems and Correlating Messages
  • Correlating Messages Across Log Files and Components
  • Diagnosing Component Problems
• Using Oracle Collaboration Suite Log Loader
  • Starting and Stopping Log Loader
  • Enabling and Disabling Log Loader
  • Updating the Log Configuration
  • Setting Log Loader Properties
  • Understanding Log Loader Diagnostic Messages
• Advanced Logging Topics
  • Using the printlogs Tool to View Log Messages
  • Understanding ODL Messages and ODL Log Files
  • Understanding Log Loader Log File Format Conversion
  • Component Diagnostic Log File Registration
  • Configuring Components to Produce ODL Messages and ECIDs
  • Creating and Managing a Diagnostic Message Database Repository
  • Limitations and Configuration

9 Managing Microsoft Active Directory Integration

• Concepts and Architecture of Microsoft Active Directory Integration
  • Components for Integrating with Microsoft Active Directory
  • How Oracle Directory Integration and Provisioning Maintains Synchronization
  • Oracle Internet Directory Schema Elements for Integration with Microsoft Active Directory
  • Directory Information Tree in an Integration with Microsoft Active Directory
• Deployment Options for Integrating with Microsoft Active Directory
  • Deployments with Oracle Internet Directory as the Central Directory
  • Deployments with Microsoft Active Directory as the Central Directory
• Configuration of Integration with Microsoft Active Directory
  • Configuring the Realm
  • Configuring Synchronization Profiles
  • Customizing Access Control Lists
  • Configuring the Active Directory Connector for Synchronization in SSL Mode
  • Considerations for Synchronizing with a Multiple-Domain Microsoft Active Directory Environment
  • Configuring the Active Directory Connector Profiles
  • Configuring the Active Directory External Authentication Plug-in
  • Configuring Windows Native Authentication
  • Configuring Synchronization of Oracle Internet Directory Foreign Security Principal References with Microsoft Active Directory
• Managing Integration with Microsoft Active Directory
  • Tasks After Configuring with Microsoft Active Directory
  • Typical Management of Integration with Microsoft Active Directory

10 Monitoring and Tuning Oracle Collaboration Suite Performance

• Performance Tuning Oracle Collaboration Suite
  • Tuning Oracle Calendar
  • Tuning Oracle Discussions
  • Tuning Oracle Mail
  • Tuning Oracle Content Services
  • Tuning Oracle Ultra Search
  • Tuning Oracle Application Server Portal
  • Tuning Oracle Real-Time Collaboration
  • Tuning Oracle Voicemail & Fax
  • Tuning Oracle Mobile Collaboration
  • Tuning Oracle Web Access Client
  • Tuning Oracle Workspaces
• Monitoring and Tuning the Oracle Collaboration Suite Database
  • Proactive Database Monitoring
  • Diagnosing Performance Problems
  • Using Advisors to Optimize Database Performance

11 Backing Up and Recovering Oracle Collaboration Suite

• Backup and Recovery Basics
• Oracle Collaboration Suite Backup and Recovery Strategy
  • Oracle Collaboration Suite Backup Strategy
  • Oracle Collaboration Suite Recovery Strategy
  • Prerequisites for Oracle Collaboration Suite Backup and Recovery Operations
• Understanding Database Backup and Recovery
  • Database Backup and Recovery Basics
  • Oracle Content Services Backup and Recovery Use of BFILEs
• Understanding Oracle Calendar Backup and Recovery
  • Oracle Calendar Backup
  • Oracle Calendar Recovery
• Understanding User-Level Backup and Recovery
  • Restoring a Single Oracle Calendar User
  • Restoring a Single Oracle Mail User
• Understanding the Oracle Collaboration Suite Recovery Manager
  • Oracle Collaboration Suite Recovery Manager Process Flow
  • Syntax of Oracle Collaboration Suite Recovery Manager
• Understanding Dynamic Plug-In Input Files
  • Formatting for Dynamic Plug-In Input Files
  • Syntax for Using Dynamic Plug-In Input Files
  • Notes on Using Dynamic Plug-In Input Files
• Configuring the Oracle Collaboration Suite Recovery Manager
  • Step 1: Learn about Oracle Collaboration Suite Recovery Manager Files
  • Step 2: Create Backup Directories
  • Step 3: Configuring the Oracle Collaboration Suite Recovery Manager
• Backup Procedures with Oracle Collaboration Suite Recovery Manager
  • Oracle Collaboration Suite Backup Roadmap
  • Oracle Collaboration Suite Backup Procedures
• Recovery Procedures with Oracle Collaboration Suite Recovery Manager
  • Recovery Strategies for Data Loss, Host Failure, or Media Failure (Critical)
  • Recovery Procedures
• Centralized Control of the Oracle Collaboration Suite Recovery Manager

Part III Reconfiguring Oracle Collaboration Suite

12 Changing Infrastructure Services

• Overview of Procedures for Changing Infrastructure Services
• Changing the Oracle Internet Directory or HTTP (SSO) Ports on Identity Management
• Changing Oracle Internet Directory from Dual Mode to SSL Mode
• Moving Identity Management to a New Host
  • Sample Uses for this Procedure
  • Assumptions and Restrictions
  • Overview
  • Procedure
  • Strategy for Performing Failover with this Procedure
• Changing the OracleAS Metadata Repository Used by an Applications Tier
  • Sample Uses for this Procedure
  • Assumptions and Restrictions
  • Overview
  • Procedure
• About LDAP-based Replicas
  • What is an LDAP-based Replica?
  • How is the LDAP-based Replica Used for Changing Infrastructure Services?
• Installing and Setting Up an LDAP-Based Replica
  • Things to Know Before You Start
  • Procedure
• Applications Tier Application Reconfiguration
  • Oracle Calendar Re-association

13 Changing Oracle Collaboration Suite Network Configurations

• Introduction to Changing Oracle Collaboration Suite Ports
  • Viewing Port Numbers
• Changing Applications Tier Ports
  • Changing Oracle Enterprise Manager Ports
  • Changing OC4J Ports
  • Changing the Oracle HTTP Server Listen Port
  • Changing the OracleAS Web Cache Listen Port
  • Changing the OracleAS Web Cache Administration Port
  • Changing the OracleAS Web Cache Invalidation Port
  • Changing the OracleAS Web Cache Statistics Port
  • Changing the DCM Discovery Port
  • Changing the Java Object Cache Port
  • Changing the Log Loader Port
  • Changing OPMN Ports (ONS Local, Request, and Remote)
  • Changing the Oracle HTTP Server Diagnostic Port
  • Changing the Port Tunneling Port
  • Changing OracleAS Portal Ports
  • Changing Oracle Mobile Collaboration Ports
  • Specifying Ports for DMS-Monitored Services
• Changing Infrastructure Ports
  • Changing the OracleAS Metadata Repository Net Listener Port
  • Changing Oracle Internet Directory Ports
  • Changing the HTTP Server Port on Identity Management
• Changing a Hostname, Domain Name, or IP Address
  • Changing the Hostname or Domain Name of an Applications Tier Installation
  • Changing the Hostname, Domain Name, or IP Address of an Infrastructure Installation
  • Changing the IP Address of an Infrastructure Tier
  • Special Topics for Changing Your Hostname or Domain Name

14 Customizing Oracle Collaboration Suite

• Customizing Default Logos
  • Replacing the Default Logo on the Oracle Collaboration Suite Portal Home Page
  • Customizing the Oracle WebMail Logo
  • Customizing the Oracle Calendar Logo
  • Customizing the Oracle Mobile Collaboration & Voice Logo
  • Customizing the Oracle Discussions Logo
• Customizing Colors and Fonts
  • Changing the Default Colors and Fonts on the Oracle Collaboration Suite Portal Home Page
  • Customizing Oracle WebMail Colors and Fonts
  • Customizing Oracle Calendar Colors and Fonts
  • Customizing Oracle Mobile Collaboration & Voice Colors and Fonts
  • Customizing Oracle Workspaces Colors and Fonts
  • Customizing Oracle Discussions Colors and Fonts
  • Changing the Look and Feel of the Provisioning Console
• Customizing Oracle Content Services
• Customizing Oracle Real-Time Collaboration
• Customizing and Extending Oracle Web Access Client
  • General Notes on Customizing Oracle Web Access Client
  • Customizing Oracle Web Access Client Skins
  • Customizing Oracle Web Access Client Menu Sets
  • Customizing Oracle Web Access Client Resource Bundles
  • Popping Up Oracle Web Access Client Windows
  • Populating a Compose Window Opened from the Main Window
  • Receiving Data using Custom Items in Context Menus

Part IV Appendixes

A Default Port Numbers and Ranges

• Oracle Application Server Ports
  • J2EE and OracleAS Web Cache Ports
  • Portal and Oracle Mobile Collaboration Ports
  • Infrastructure Ports
  • OracleAS Integration InterConnect Ports
  • Oracle Enterprise Manager Grid Control 10g Ports
• Oracle Calendar Ports
• Oracle Content Services Ports
• Oracle Real-Time Collaboration Ports
• Oracle Voicemail & Fax Ports
• Port Numbers (Sorted by Port Number)

B Default Locations of Component Log Files

• Oracle Calendar Logs
• Oracle Content Services Logs
• Oracle Mail Logs
• Oracle Mobile Collaboration Logs
• Oracle Real-Time Collaboration Logs
• Oracle Voicemail & Fax Logs

C User Provisioning Java API

• Application Configuration
  • Application Registration and Provisioning Configuration
  • Application Configuration Classes
• User Management
  • UserFactoryBuilder and UserFactory
  • UserFactoryControl
  • Creating a User
  • Modifying a User
  • Deleting a User
  • Looking Up a User
• Debugging
• Sample Code
• Java Plug-ins for User Provisioning
  • Plug-in Types and Their Purpose
  • Plug-in Requirements
  • Data Entry Plug-in
  • Pre–Data-Entry Plug-in
  • Post–Data-Entry Plug-in
  • Data Access Plug-in
  • Plug-in Return Status
  • Configuration Template
  • Sample Code

D Configuration Files for Oracle Collaboration Suite Recovery Manager

• config.inp
• myconfig.inp

E Oracle Collaboration Suite Recovery Manager Usage Examples

F Troubleshooting the Oracle Collaboration Suite Recovery Manager

• Troubleshooting Overview
  • Using Log Files
  • Screen Output
  • E-mail Notification
  • Error Messages
• Prerequisite Check
• Troubleshooting the Installation and Configuration
  • Oracle Collaboration Suite Recovery Manager Not Found
  • No Permission for Executing Oracle Collaboration Suite Recovery Manager
  • Unnecessary Input Required for Applications Tier Configuration
  • Unable to Get dbid From the Database
• Troubleshooting Instance Backups
  • Cold Backup on Oracle Collaboration Suite Database Hangs
  • OPMN Restart Failure at Cold Instance Backup
• Troubleshooting Database Backups
  • Oracle Collaboration Suite Database Has a Portal Validation Warning
• Troubleshooting Configuration Backups
• Troubleshooting Instance Restore
  • Instance Restore Hang
  • No Oracle Calendar and Non-DCM Files Restore for an Instance Restore
  • Oracle Calendar Server Down Error
  • 'ORA-01276: Cannot add file' or 'ORA-25153: Temporary Tablespace is Empty' Errors
• Troubleshooting Database Restores
• Troubleshooting Configuration Restores
• Troubleshooting Miscellaneous Problems
  • OPMN Fails to Start Oracle Mail Processes
  • OPMN Fails to Start Some Processes on Slow Hosts
  • No File Found In Path Warning
  • Cannot Delete Unwanted Backups
  • Receiving restore_config Operation Fails Error
  • Receiving Missing Files Messages During restore_config Operation
  • Failure Due to Loss or Corruption of the opmn.xml File
  • Timeout Occurs While Trying to Stop Processes Using the "opmnctl stopall" Command

Glossary

Index