Skip Headers
Oracle® Collaboration Suite Administrator's Guide
10
g
Release 1 (10.1.1) for Windows or UNIX
Part Number B14476-03
Home
Book List
Index
Master Index
Contact Us
Next
View PDF
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
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 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 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 10
g
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
i
SQL*Plus
Starting SQL*Plus
Starting
i
SQL*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
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
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 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
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
Downloading and Configuring the Oracle Collaboration Suite Recovery Manager
Step 1: Obtain the Oracle Collaboration Suite Recovery Manager
Step 2: Review Installation Prerequisites
Step 3: Install the Oracle Collaboration Suite Recovery Manager
Step 4: Learn about Oracle Collaboration Suite Recovery Manager Files
Step 5: Create Backup Directories
Step 6: 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
Oracle Real-Time Collaboration Re-association
13
Managing High-Availability Environments
Adding and Removing RAC nodes
Overview of Node Addition Procedures
Step 1: Connecting New Nodes to the Cluster
Step 2: Extending Clusterware and Oracle Software to New Nodes
Step 3: Preparing Storage for RAC on New Nodes
Step 4: Adding Nodes at the Oracle RAC Database Layer
Step 5: Adding Database Instances to New Nodes
Adding Nodes that Already Have Clusterware and Oracle Software to a Cluster
Deleting Instances from Real Application Clusters Databases
Deleting Nodes from Oracle Clusters on UNIX-Based Systems
Deleting Nodes from Oracle Clusters on Windows-Based Platforms
Adding or Deleting Nodes from Oracle Collaboration Suite Database
Step 1: Modify the RAC Database Connect String in Oracle Internet Directory
Step 2: Modify the Crawler's Connect String Through the Search Admin Application
Step 3: Bounce the Oracle Collaboration Suite Applications Tier Processes
Removing Nodes from Oracle Collaboration Suite Applications
Configuring Manual Cold Failover for Oracle Calendar Server
Starting and Stopping Oracle Collaboration Suite in a High-Availability Environment
Stopping Oracle Collaboration Suite
Starting Oracle Collaboration Suite
14
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
15
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 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
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
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
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