Sun Java System Instant Messaging 7.2 Administration Guide


Instant Messaging enables end users to participate in real-time interactive messaging and discussions. Sun Java System Instant Messaging allows end users to participate in Instant Messaging and chat sessions, send alert messages to each other, and share group news instantly. It is suitable for both intranets and the Internet. The Sun JavaTM System Instant Messaging 7.2 Administration Guide explains in detail how to perform the basic duties of administrating the Instant Messaging system.

Who Should Use This Book

Read this book if you are responsible for administering, configuring, and deploying Instant Messaging. This book assumes that you have an understanding of JavaScriptTM, HTML, and any of the following servers in your deployment:

Before You Read This Book

You must be familiar with the following books and release notes before reading this book:

Before performing the tasks in this book, you should have already installed Instant Messaging.

How This Book Is Organized

This book contains the following sections:

Chapter 1, Configuring Instant Messaging After Installation contains configuration steps you need to complete after you install or upgrade, before you can use Instant Messaging.

Chapter 2, Setting up and Launching Instant Messenger provides information about configuring client systems, enabling Java Web Start, and adding additional localization client files. Also explains how to launch the client.

Chapter 3, Instant Messaging Configuration File and Directory Structure Overview provides information about the configuration files you use to administer Instant Messaging.

Chapter 4, Configuring Instant Messaging for High Availability (Solaris Only) describes how to install and configure a highly available Instant Messaging service with Sun Cluster.

Chapter 5, Enabling Single Sign-On (SSO) for Instant Messaging describes SSO and how to configure it for Instant Messaging.

Chapter 6, Scaling an Instant Messaging Deployment Using Server Pooling gives instructions on creating a server pool for a single domain to increase horizontal scalability.

Chapter 7, Optimizing an Instant Messaging Server Pool Using the Redirect Server describes using the redirect server to optimize performance in an Instant Messaging server pool.

Chapter 8, Federating Deployment of Multiple Instant Messaging Servers details how to support multiple domains in your Instant Messaging deployment.

Chapter 9, Administering Instant Messaging Components describes how to administer the Instant Messaging server, multiplexor, Calendar agent, cluster agent, and watchdog.

Chapter 10, Using the Instant Messaging XMPP/HTTP Gateway provides instructions on setting up and using the gateway.

Chapter 11, Managing Instant Messaging's LDAP Access Configuration contains information on configuring LDAP for use with Instant Messaging.

Chapter 12, Securing Instant Messaging Using TLS and Legacy SSL provides information about and how Instant Messaging uses legacy SSL and TLS to ensure security.

Chapter 13, Managing Logging for Instant Messaging describes configuring logging for Instant Messaging components and XMPP.

Chapter 14, Administering Instant Messaging End Users provides instructions for disabling end user access to Instant Messenger, registering new users, using LDAP to store user properties, and assigning Instant Messaging and presence services to end users.

Chapter 15, Managing Instant Messenger describes how to customize and administer Instant Messenger.

Chapter 16, Using Calendar Pop-up Reminders describes how to configure the Instant Messaging server, Calendar agent, Calendar Server, and Instant Messenger to enable Calendar pop-up reminders.

Chapter 17, Managing Instant Messaging and Presence Policies describes how to manage administrator and end user privileges, especially with policies set in Sun Java System Access Manager.

Chapter 18, Managing Archiving for Instant Messaging explains how to manage and configure the Instant Messaging archive.

Chapter 19, Troubleshooting and Monitoring Instant Messaging lists the common problems that might occur during installation and deployment of Instant Messaging and provides instructions for using the monitoring agent.

Appendix A, Instant Messaging Configuration Parameters in iim.conf describes the settings you can configure for Instant Messaging components.

Appendix B, Instant Messaging XMPP/HTTP Gateway Configuration Parameters in httpbind.conf describes the settings you can configure for the XMPP/HTTP Gateway.

Appendix C, Instant Messaging imadmin Tool Reference describes the imadmin command used to administer Instant Messaging.

Appendix D, Instant Messaging APIs provides an overview of the APIs used by Instant Messaging.

Appendix E, Instant Messaging LDAP Schema defines modifications made to the LDAP schema for Instant Messaging.

Related Third-Party Web Site References

Third-party URLs are referenced in this document and provide additional, related information.

Note –

Sun is not responsible for the availability of third-party web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused or alleged to be caused by or in connection with use of or reliance on any such content, goods, or services that are available on or through such sites or resources.

Documentation, Support, and Training

The Sun web site provides information about the following additional resources:

Typographic Conventions

The following table describes the typographic conventions that are used in this book.

Table P–1 Typographic Conventions





The names of commands, files, and directories, and onscreen computer output 

Edit your .login file.

Use ls -a to list all files.

machine_name% you have mail.


What you type, contrasted with onscreen computer output 

machine_name% su



Placeholder: replace with a real name or value 

The command to remove a file is rm filename.


Book titles, new terms, and terms to be emphasized 

Read Chapter 6 in the User's Guide.

A cache is a copy that is stored locally.

Do not save the file.

Note: Some emphasized items appear bold online.

Shell Prompts in Command Examples

The following table shows the default UNIX® system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.

Table P–2 Shell Prompts



C shell 


C shell for superuser 


Bourne shell and Korn shell 


Bourne shell and Korn shell for superuser