Sun Java logo     Copyright      Index      Next     

Sun logo
Sun Java System Instant Messaging 6 2004Q2 Administration Guide 

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   Configuration Files and Directory Structure
Instant Messaging Server Directory Structure
Instant Messaging Server Configuration File
Instant Messaging Data

Chapter 2   Administering Instant Messaging Server and Multiplexor
Administering 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
Using SSL in Instant Messaging
Requesting a Certificate from the Certificate Authority
Installing the Certificate
Enabling SSL Between the Multiplexor and Instant Messenger
Invoking the Secure Version of Instant Messenger
To Activate SSL for Server to Server Communication
Enabling SSL between two servers
Managing Instant Messaging's LDAP Configuration
Searching the Directory as Anonymous Users
To Enable the Server to Conduct Directory Searches as a Specific End User
Configuring Dynamic LDAP Server Group
Backing Up Instant Messaging Data
Backup Information
Performing Backup
Restoring the Back Up Information

Chapter 3   Managing Instant Messenger
Configuring Sun Java System Instant Messenger
Invoking Instant Messenger
To Invoke Sun Java System Instant Messenger
Solving Web Server Issues
Changing Web Server Port
Customizing Sun Java System Instant Messenger
Instant Messenger Resource Files
Customizing the index.html and im.html Files (Only LDAP Deployments)
Launching Instant Messenger Using Sun Java System 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 Conference Rooms and News Channels
Granting End Users the Privilege to Create Conference Rooms and News Channels
Modifying Instant Messenger Proxy Settings
To Modify 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
Overview of Privacy, Security, and Site Policies
Site Policies
Conference Room and News Channel Access Controls
User Privacy
Methods for Controlling End User and Administrator Privileges
Introduction to Managing Policies Using Access Control Files
Introduction to Managing Policies Using Sun Java System 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 Java System 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 Instant Messaging 6.0
Non-Migration Option
Migration Option
Migrating Access Control Files
Migrate Access Control File Information Manually
Migrate Access Control File Information Automatically
Migrate Sun Java System 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 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

Chapter 6   Troubleshooting Instant Messaging
Problems and Solutions
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 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 imadmin Tool Reference
imadmin
Synopsis
Options
Actions
Components

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

Appendix D   Legacy Instant Messaging 6.0
Index


Copyright      Index      Next     

Copyright 2004 Sun Microsystems, Inc. All rights reserved.