Sun logo      Copyright      Index      Next     

Sun ONE Instant Messaging 6.1

Contents


About This Guide
Who Should Read This Book
What You Need to Know
How This Book is Organized
Document Conventions Used in This Manual
Monospaced Font
Bold Monospaced Font
Italicized Font
Square or Straight Brackets
Command-Line Prompts
Related Third-Party Web Site References
Accessing Related Sun Documentation Online

Chapter 1   Introduction to Sun™ ONE Instant Messaging Software
Sun ONE Instant Messaging Components
Basic Deployment Scenarios
Quick Reference of Core Instant Messaging Components
Quick Reference of Instant Messaging Related Components
Deployment Overview: LDAP-Only Deployment
Deployment Overview: Identity Server and Portal Server in a Single Sign-On Environment
The Role of the Instant Messaging Components
Sun ONE Instant Messenger
Sun ONE Portal Server
Sun ONE Identity Server
Instant Messaging Server
Instant Messaging Multiplexor
Web Server
LDAP Directory Server
SMTP Server
Sun ONE Instant Messaging Deployment Configurations
The Web Server and the Instant Messenger Resources Installed on a Different Host
Multiple Multiplexor Hosts
Federation of Multiple Instant Messaging Deployments
Configuration Files and Directory Structure
Instant Messaging server Directory Structure
Sun ONE Instant Messaging Server Configuration File
Sun ONE Instant Messaging Data
Using SSL in Sun ONE Instant Messaging
Sun ONE Privacy, Security, and Site Policies
Site Policies
Conference Room and News Channel Access Controls
User Privacy

Chapter 2   Administering Sun™ ONE Instant Messaging Server and Multiplexor
Administering Instant Messaging: End Users
Stopping and Starting the Server and Multiplexor (On Unix)
To Start the Instant Messaging Server and Multiplexor
To Stop the Instant Messaging Server and Multiplexor
To Refresh the Configuration (Instant Messaging Server and Multiplexor)
To Start and Stop the Instant Messaging Server and Multiplexor (Windows Only)
Changing Instant Messaging Server and Multiplexor Configuration Parameters
To Change Configuration Parameters
Managing Logging
Logging Levels
To Set Log File Levels
Managing End-User Privileges
Conference Room and News Channel Access Controls
Room and News Channels Access Control File Format
User Privacy
Federating Deployment of Multiple Instant Messaging Servers
To Configure Communication Between Instant Messaging Servers
Configuring SSL
Requesting a Certificate from the Certificate Authority
Installing the Certificate
Configuring the Instant Messaging Server to Enable SSL between the Multiplexor and the Instant Messenger
Invoking the Secure Version of Instant Messenger
To Activate SSL for Server to Server Communication
Configuring the Instant Messaging server to enable SSL between two Instant Messaging servers
Managing Sun ONE Instant Messaging's LDAP Configuration
Searching the Directory as Anonymous Users
To Enable Instant Messaging server to Conduct Directory Searches as a Specific End User (Not Anonymous)
Configuring Dynamic LDAP Server Group
Displaying Calendar Reminders and Notifications as Instant Messenger Popups
Configuring Calendar Server for Displaying Calendar Reminders and Notifications as Instant Messenger popups
Enabling Alarms
Configuring Instant Messaging Server for Displaying Calendar Reminders and Notifications as Instant Messenger Popups
Example for Displaying Calendar Reminders and Notifications as Instant Messenger Popups
Configuring Calendar Server
Configuring Instant Messaging Server
Enabling Calendar Alerts in Instant Messenger
Troubleshooting Display Calendar Reminders and Notifications as Instant Messenger Popups
Backing Up Instant Messaging Data
Backup Information
Performing Backup
Restoring the Back Up Information

Chapter 3   Managing Sun™ ONE Instant Messenger
Configuring Sun ONE Instant Messenger
Invoking Instant Messenger
To Invoke Sun ONE Instant Messenger
Solving Web Server Issues
Changing Web Server Port
Customizing Sun ONE Instant Messenger
Instant Messenger Resources
Sun ONE Instant Messenger Files
Customizing the index.html and im.html Files (Only LDAP Deployments)
Launching Instant Messenger Using Sun ONE Identity Server SSO:
Customizing the Application (Java Web Start)
Contents Listing of imbrand.jar
Rebranding Instant Messenger
Customizing User Name Display
Customizing User Name Display in Search Results
Customizing User Name Display in Tooltip
Administering Sun ONE Instant Messenger Conference Rooms and News Channels
Granting End Users the Privilege to Create Conference Rooms and News Channels
Modifying Sun ONE Instant Messenger Proxy Settings
To Modify Sun ONE Instant Messenger Proxy Settings
Controlling the Exposed Messenger Feature Set
Instant Messenger Data Stored in the End User’s System

Chapter 4   Managing Instant Messaging and Presence Policies
Methods for Controlling End User and Administrator Privileges
Introduction to Managing Policies Using Access Control Files
Introduction to Managing Policies Using Sun ONE Identity Server
Managing Policies: The Method to Use
Policy Configuration Parameters
Managing Policies Using Access Control Files
Access Control File Format
Access Control File Examples
sysTopicsAdd.acl File
Changing End User Privileges
Managing Policies using Sun ONE Identity Server
Instant Messaging Service Attributes
Modifying Attributes Directly
Pre-Defined Examples of Instant Messaging and Presence Policies
Creating New Instant Messaging Policies
Assigning Policies to a Role, Group, Organization, or User
Creating New Suborganizations Using Identity Server
Adding End Users to New Suborganizations
Migrating from the Instant Messaging Service of Sun ONE Instant Messaging 6.0 Server
Non-Migration Option
Migration Option
Migrating Access Control Files
Migrate Access Control File Information Manually
Migrate Access Control File Information Automatically
Migrate Sun ONE Instant Messenger Settings

Chapter 5   Managing The Instant Messaging Archive
Instant Messaging Archive Overview
Archiving Instant Messages
Enabling the Archive Provider
Configuring the Archive Provider
Archive Provider Configuration Parameters
Storing Sun ONE Instant Messaging Archived Messages in a non-default database
Managing Archived Data in the Portal Server Search Database
rdmgr Command
Searching Resource Descriptors (RD)
Deleting Resource Descriptors
Enabling Instant Messenger Archive Control
Changing the Display of the Archived Data
Sample Deployment Scenario for Archive Provider

Appendix A   Instant Messaging Configuration Parameters
Using the iim.conf file
General Configuration Parameters
User Source Configuration Parameters
Logging Configuration Parameters
Instant Messaging Server Configuration Parameters
Multiple Server Configuration Parameters
Multiplexor Configuration Parameters

Appendix B   Instant Messaging Reference
imadmin
Synopsis
Options
Actions
Components

Appendix C   Instant Messaging APIs
Sun ONE Instant Messaging APIs Overview
Instant Messaging Service API
Messenger Beans
Service Provider Interfaces
Archive Provider API
Message Conversion API
Authentication Provider API

Appendix D   Troubleshooting Instant Messaging
The Messenger client does not load or start
Connection refused and timed out
Authentication errors
IM channel display error
Instant Messaging content is not archived
Server-to-server communication fails to start
Catastrophic Error Leaves Server in an Inconsistent State

Appendix E   Legacy Instant Messaging Service 6.0
Index


Copyright      Index      Next     

Copyright 2003 Sun Microsystems, Inc. All rights reserved.