About This Guide


This manual describes how to install iPlanet^TM Portal Server: Instant Collaboration Pack Release 3.0 (also referred to as iPlanet^TM Instant Messaging Server Release 3.0) and its accompanying software components. For the most recent information about known problems with this release, see the iPlanet Instant Messaging Server release notes at:

http://docs.iplanet.com/docs/manuals/portal.html

This preface contains the following sections:

• Who Should Read This Book

• What You Need to Know

• How This Book is Organized

• Conventions Use in This Manual

Who Should Read This Book

---

You should read this manual if you are responsible for installing and deploying iPlanet Instant Messaging Server Release 3.0 at your site.

What You Need to Know

---

This book assumes that you are responsible for configuring, administering, and maintaining the iPlanet Instant Messaging Server software and that you have a general understanding of the following:

• The Internet and the World Wide Web

• iPlanet Portal Server

• iPlanet Web Server

• iPlanet Directory Server

• iPlanet Delegated Administrator

How This Book is Organized

---

This book contains the following chapters and appendices:

• "About This Guide" (this chapter)

• Chapter 1 "Preparing for Installing iPlanet Instant Messaging Server"

  This chapter describes the requirements needed for planning your installation, and what information you will need to gather before installing iPlanet Instant Messaging Server.

• Chapter 2 "Installing iPlanet Instant Messaging Server on Solaris"

  This chapter describes how to install the iPlanet Instant Messaging Server on the Solaris^TM operating environment.

• Chapter 3 "Installing iPlanet Instant Messaging Server on Windows NT"

  This chapter describes how to install the iPlanet Instant Messaging Server on the Windows NT platform.

• Chapter 4 "Configuring iPlanet Instant Messenger"

  This chapter describes how to install the iPlanet Instant Messenger client on both Solaris and Windows.

• Appendix A "Uninstalling iPlanet Instant Messaging Server"

  This appendix describes how to uninstall iPlanet Instant Messaging Server components.

• Appendix B "Upgrading iPlanet Instant Messaging Server"

  This appendix describes how to upgrade an iPlanet Instant Messaging Server standalone installation from 3.0 Beta Refresh to 3.0.

• "Glossary"

Conventions Use in This Manual

---

Monospaced Font

Monospaced font is used for any text that appears on the computer screen or text that you should type. It is also used for file names, distinguished names, functions, and examples.

Bold Monospaced Font

Bold monospaced font is used to represent text within a code example that you should type. For example, you might see something like this:

./setup
Copyright (c) 2001 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Sun, Sun Microsystems, the Sun logo, Java, Solaris and iPlanet are trademarks or registered trademarks of Sun Microsystems, Inc.in the U.S. and other countries. Federal Acquisitions: Commercial Software - Government Users Subject to Standard License Terms and Conditions.

Copyright (c) 2001 Sun Microsystems, Inc. Tous droits réservés. Distribué par des licences qui en restreignent l'utilisation. Sun, Sun Microsystems, le logo Sun, Java, Solaris et iPlanet sont des marques de fabrique ou des marques déposées de Sun Microsystems, Inc. aux Etats-Unis et dans d'autres pays.

===================================================================

Verifying permissions
Verifying java available
Found java (/usr/j2se/bin/java) version (1.3.0) in the system.
Verifying installation components available
Verifying directories available
Verifying files available
Starting install wizard in graphical mode

In this example, ./setup is what you would type from the command line and the rest is what would appear as a result.

Italicized Font

Italicized font is used to represent text that you enter using information that is unique to your installation (for example, variables). It is used for server paths and names and account IDs.

For example, this document uses URLs such as:

http://webserver:webserverport

When you are entering your actual information, you substitute your actual web server name and web server port where the words webserver and webserverport appear italicized. For example, if your web server name is i-zed, and the web server port is 9980, then the actual URL you would enter is:

http://i-zed:9980

Square or Straight Brackets

Square (or straight) brackets [] are used to enclose optional parameters. For example, in this document you will see the usage for the setup command described as follows:

./setup [options] [argument]

It is possible to run the setup command by itself as follows to start the iPlanet Instant Messaging Server installation:

./setup

However, the presence of [options] and [arguments] indicates that there are additional optional parameters that may be added to the setup command. For example, you could use setup command with the -nodisplay option to do a command-line install:

./setup -nodisplay

Command-Line Prompts

Command-line prompts (for example, % for a C-Shell, or $ for a Korn or Bourne shell) are not displayed in the examples. Depending on which operating system environment you are using, you will see a variety of different command-line prompts. However, you should enter the command as it appears in the document unless specifically noted otherwise.