Sun logo      Previous      Contents      Index      Next     

Sun ONE Instant Messaging 6.1 Installation Guide

Chapter 3
Setting up and Launching Instant Messenger

This chapter contains information about configuring the web server and client systems to support Instant Messenger in the following sections:

Enabling JavaTM Web Start

To use Instant Messenger with Java Web start, you need to install the software, then configure your web server to work with Java Web Start. For instructions on installing Java Web Start, go to the following location:

http://java.sun.com/products/javawebstart

To enable Java Web Start support in your web server, you need to edit the web server’s mime.types file to include the following definition for JNLP:

Content Type: application/x-java-jnlp-file

Suffix: jnlp

On Sun ONE Web Server Enterprise Edition

To add the MIME type to Sun ONE Web Server, complete the following:

  1. Type the following URL to access the administration server in your browser:

    2. http://hostname.domain-name:administration_port

    For example: http://budgie.siroe.com:8888

    Sun ONE Web Server displays a window prompting you for a user name and password.

  2. Type the administration user name and password you specified during the web server installation.

    3. The web server displays the Administration Server page.

  3. On the Manage Servers page, click Manage.

    4. The web server displays the Server Manager page.

  4. Click the MIME Types link.
  5. From the MIME file drop-down list, choose a MIME type to edit and click OK.
  6. In the Global MIME Types page, select type from the Category drop-down list.
  7. In the Content-Type text box, type:

    8. application/x-java-jnlp-file

  8. In the File-Suffix text box, type:

    9. jnlp

  9. Click New Type to create the MIME type.
  10. Restart the web server for this change to take effect.

On Apache Web Server

Add the following line to the mime.types file:

application/x-java-jnlp-file jnlp

By default, this file is located in the Apache Web Server configuration directory.

Configuring Client Systems

If the client machine has the appropriate version of Java installed, there are no additional requirements to use either Java Plug-in or Java Web Start. Netscape Navigator v7 as well as the recent versions of the Mozilla browser include the latest version of Java, while Internet Explorer does not. See the Sun ONE Instant Messaging Release Notes for version requirements.

If the client machine does not have the required version of Java installed, you need to install Java Web Start. You can download and Install Java from the following location:

http://www.java.sun.com/j2se

You can download and install Java Web Start from the following location:

http://www.java.sun.com/products/javawebstart

Launching Sun One Instant Messaging

This chapter provides instructions on launching Instant Messenger, the Instant Messaging client application.

You can run Instant Messenger as an applet within a web browser, or as a standalone application as described in the following sections:

Running Instant Messenger From a Web Browser

To run Instant Messenger as an applet within a web browser:

  1. Start the web browser.

    2. For information on supported browsers, see the Sun ONE Instant Messaging Release Notes.

  2. Go to the Sun ONE Instant Messaging home page. By default, the home page is stored as index.html. Use the following format to locate the Instant Messaging home page:

    3. http://codebase/index.html

    Where codebase is the URL that corresponds to the location of the resource files on the web server.

  3. Click Use Java Plug-In.

    4. If you customized the home page and changed the link text, click the link that corresponds to running Instant Messenger as an applet within a browser. The link points to either im.jnlp (standard) or imssl.jnlp (secure mode).

Running Instant Messenger as a Standalone Application

To run Instant Messenger as a standalone application:

  1. Start the web browser.

    2. For information on supported browsers, see the Sun ONE Instant Messaging Release Notes.

  2. Go to the Sun ONE Instant Messaging home page. By default, the home page is stored as index.html. Use the following format to locate the Instant Messaging home page:

    3. http://codebase/index.html

    Where codebase is the URL that corresponds to the location of the resource files on the web server.

  3. Click Use Java Web Start.

    4. If you customized the home page and changed the link text, click the link that corresponds to running Instant Messenger using JavaTM Web Start. The link points to either im.html (standard) or imssl.html (secure mode).

    When the Instant Messenger session is established using the Java Plug-in, the browser window must be dedicated to its use.

    You cannot locate any other URLs with this browser window, nor can you close the browser window without terminating the Instant Messenger session.

See Sun ONE Instant Messaging Administrator’s Guide for information on customizing the resource pages.



Previous      Contents      Index      Next     

Copyright 2004 Sun Microsystems, Inc. All rights reserved.