Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java System Instant Messaging 7 2005Q1 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.

This preface contains the following sections:

Who Should Use This Book

You should read this book if you are responsible for administering, configuring, and deploying Instant Messaging.

Before You Read This Book

This book assumes that you are responsible for configuring, administering, and maintaining Instant Messaging, and you have an understanding of JavaScript™, HTML, and any of the following servers in your deployment:

How This Book Is Organized

The first chapter of this book provides an overview of the entire Instant Messaging product. The following table summarizes the content of this book in three parts.

Table 1  How This Book Is Organized 




(This chapter)

Part I, "Postinstallation Configuration"

Chapter 1, "Configuring Instant Messaging After Installation"

Contains instructions on 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.

Part II, "Administering Instant Messaging"

Chapter 3, "Configuration File and Directory Structure Overview"

This chapter provides information about the configuration files you use to administer Instant Messaging.

Chapter 4, "Administering Instant Messaging Components"

This chapter describes how to administer Sun Java System Instant Messaging server and multiplexor.

Chapter 5, "Managing Instant Messenger"

This chapter describes how to customize and administer the Sun Java System Instant Messenger.

Chapter 6, "Managing Instant Messaging and Presence Policies"

This chapter describes how to manage administrator and end user privileges, especially with policies set in the Sun Java System Access Manager.

Chapter 7, "Managing The Instant Messaging Archive"

This chapter explains how to manage and configure the Instant Messaging Archive.

Chapter 8, "Troubleshooting and Monitoring Instant Messaging"

This appendix lists the common problems that might occur during installation and deployment of the Sun Java System Instant Messaging server.

Part III, "Reference Information"

Appendix A, "Instant Messaging Configuration Parameters"

This appendix describes the settings you can configure for Instant Messaging.

Appendix B, "Instant Messaging imadmin Tool Reference"

This appendix describes the imadmin command used to administer Instant Messaging.

Appendix C, "Instant Messaging APIs"

This appendix explains the APIs used by Instant Messaging.

Conventions Used in This Book

The tables in this section describe the conventions used in this book.

Typographic Conventions

The following table describes the typographic changes used in this book.

Table 2  Typographic Conventions 





API and language elements, HTML tags, web site URLs, command names, file names, directory path names, onscreen computer output, sample code.

Edit your.login file.

Use ls -a to list all files.

% You have mail.

(Monospace bold)

What you type, when contrasted with onscreen computer output.

% su


Book titles, new terms, words to be emphasized.

A placeholder in a command or path name to be replaced with a real name or value.

Read Chapter 6 in the User’s Guide.

These are called class options.

Do not save the file.

The file is located in the install-dir/bin directory.


The following table describes the symbol conventions used in this book.

Table 3  Symbol Conventions 





[ ]

Contains optional command options.

ls [-l]

The -l option is not required.

{ | }

Contains a set of choices for a required command option.

-d {y|n}

The -d option requires that you use either the y argument or the n argument.


Joins simultaneous multiple keystrokes.


Press the Control key while you press the A key.


Joins consecutive multiple keystrokes.


Press the Control key, release it, and then press the subsequent keys.


Indicates menu item selection in a graphical user interface.

File > New > Templates

From the File menu, choose New. From the New submenu, choose Templates.

Shell Prompts

The following table describes the shell prompts used in this book.

Table 4  Shell Prompts



C shell


C shell superuser


Bourne shell and Korn shell


Bourne shell and Korn shell superuser


Windows command line


Related Documentation

The http://docs.sun.comSM web site enables you to access Sun technical documentation online. You can browse the archive or search for a specific book title or subject.

Java Enterprise System Documentation

Other Server Documentation

For other server documentation, go to the following:

This includes documentation sets for the following products:

Accessing Sun Resources Online

For product downloads, professional services, patches and support, and additional developer information, go to the following:

Contacting Sun Technical Support

If you have technical questions about this product that are not answered in the product documentation, go to

Related Third-Party Web Site References

Third-party URLs are often referenced in Sun documentation to provide additional, related information.

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.

Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions.

To share your comments, go to and click Send Comments. In the online form, provide the document title and part number. The part number is a seven-digit or nine-digit number that can be found on the title page of the book or at the top of the document. For example, the title of this book is Sun Java System Instant Messaging 7 2005Q1 Administration Guide, and the part number is 819-0430-10.

Previous      Contents      Index      Next     

Part No: 819-0430-10.   Copyright 2005 Sun Microsystems, Inc. All rights reserved.