Installation Directory

instant-messaging-install-dir or installation directory.

Directory in which Instant Messaging is installed.

Defaults:

Solaris system: /opt/SUNWiim

Linux system: /opt/sun/im

Instant Messaging Server Host and Domain Name

Host name on which Instant Messaging is installed and the domain name associated with the host. For example:

Host Name: instantmessaging.siroe.com

Domain Name: siroe.com

Instant Messaging Server Port Number

The port number on which the Instant Messaging server listens for incoming requests other than those sent by Instant Messenger clients.

Default: 49999

Multiplexor Port Number (Multiplexor Configuration Only)

The port number on which the Instant Messaging server listens for incoming requests from Instant Messenger clients.

Default: 49909

Disable Server

Select this option if the instance you installed will act as a multiplexor and not a server. If you select this option, you must provide a value for Remote Instant Messaging Server Host Name (Multiplexor Configuration Only)

Remote Instant Messaging Server Host Name (Multiplexor Configuration Only)

The host name of the Instant Messaging server for which this multiplexor routes messages. Do not enter a value for this parameter if the installed instance you are configuring is an Instant Messaging server and not a multiplexor.

Dependencies: The Disable Server parameter must be selected, that is, server functionality is disabled.

Assign Instant Messaging Services to existing users (Optional)

If selected, this option enables Instant Messaging for existing Access Manager users.

Dependencies: Portal Server and Access Manager.

Secure Mode (Optional)

When selected, enables integration with Secure Remote Access.

Secure Remote Access provides secure access to remote users in an intranet. Users can access Secure Remote Access by logging in to the web-based Portal Server Desktop through the portal gateway.

Dependencies:

Requires Portal Server and Access Manager.

You can run Instant Messaging in secure mode only if Secure Remote Access is configured. See the Sun Java System Instant Messaging 7.2 Administration Guide and the Sun Java System Portal Server 7.1 Administration Guide for instructions.

If you enable this feature, you must provide values for the following parameters:

• Netlet Instant Messaging Port Number (Optional)

• Messenger Secure Download Port (Optional)

Netlet Instant Messaging Port Number (Optional)

If you enabled Secure Mode (Optional), this is the port number on which Netlet listens for incoming requests.

Default: 49917

Dependencies: Secure Mode (Optional) enabled, Portal Server, and Access Manager.

Messenger Secure Download Port (Optional)

If you enabled Secure Mode (Optional), this is the port number from which Instant Messenger resources will be downloaded through Netlet.

Default: 49916

Dependencies: Secure Mode (Optional) enabled, Portal Server, and Access Manager.

Enable Instant Messaging Archive (Optional)

If selected, enables Portal Server search-based archiving for Instant Messaging.

Dependencies: Portal Server and Access Manager.

LDAP Host Name

The host name of the LDAP server that contains user and group information for Instant Messaging. For example, directory.siroe.com.

Dependencies: LDAP server such as Directory Server.

LDAP Port Number

The port number on which the directory server listens for incoming requests. For example, 389.

Dependencies: LDAP server such as Directory Server.

Base DN

The base distinguished name in the directory tree that contains user and group information for Instant Messaging. For example, o=siroe.com.

Dependencies: LDAP server such as Directory Server.

Bind DN

During installation, you must use the Directory Manager Bind DN and password. The information is used to update the directory schema with the Instant Messaging and presence service templates and attributes only. This requires Directory Manager access. The Directory Manager Bind DN and password are not saved or used beyond installation and initial configuration.

For server configuration, Instant Messaging uses this Bind DN to search users and groups in the directory. Leave this blank if the directory can be searched anonymously.

Dependencies: LDAP server such as Directory Server.

Bind Password

The Bind DN password.

SMTP Server Host Name (Optional)

The host name of the SMTP server used to send email notification of messages to offline users. For example, mail.siroe.com. If the SMTP server does not use port 25, specify the port along with the host name. For example, if the SMTP server uses port 1025:

mail.siroe.com:1025

Dependencies: SMTP server such as Messaging Server.

Database, Logs, and Runtime File Pathname

The location where the runtime files, database, and logs are stored.

Defaults:

Solaris system: /var/opt/SUNWiim/default

Linux system: /var/opt/sun/im

Windows system: C:\Program Files\Sun\Instant Messaging

Resources and Help Files Pathname

instant-messaging-resource-directory or resource directory

The directory in which the resource and online help files are installed.

Defaults:

Solaris system: /opt/SUNWiim/html

Linux system: /opt/sun/im/html

Code Base

The URL from which Instant Messenger downloads resources.

You install the resources into the web server’s doc root. For example, assume that the web server www.example.com listens on port 89, the doc root for this web server is /opt/web/, and you choose to install the messenger resources in /opt/web/im, then the messenger resources codebase is as follows:

http://www.example.com:89/im/

If you do not provide the correct codebase during installation, you need to update the messenger launch pages codebase/lang/im[ssl].html and codebase/lang/im[ssl].jnlp with the correct URL.

On UNIX, it is possible to install the resources in a directory and use a symbolic link to make the resources visible to the web server.

For instance, if in the above example you installed the resources in /opt/SUNWiim/html, the messenger resources can be made visible to the web server by creating the following symbolic link.

ln -s /opt/SUNWiim/html /opt/web/im

See the Sun Java System Instant Messaging 7.2 Administration Guide, and your web server documentation for more information.