Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java System Instant Messaging 7 2005Q1 Administration Guide 

Chapter 2
Setting up and Launching Instant Messenger

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


Enabling Java™ Web Start

To use Instant Messenger with Java Web start, you need to install the software, then configure your web container 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 container, you need to edit the web container’s mime.types file to include the following definition for JNLP:

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

Suffix: jnlp

On Sun Java System Web Server Enterprise Edition

    To Add the MIME Type to Sun Java System Web Server
  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 Java System Web Server displays a window prompting you for a user name and password.

  3. Type the administration user name and password you specified during the web container installation.
  4. The web container displays the Administration Server page.

  5. On the Manage Servers page, click Manage.
  6. The web container displays the Server Manager page.

  7. Click the MIME Types link.
  8. From the MIME file drop-down list, choose a MIME type to edit and click OK.
  9. In the Global MIME Types page, select type from the Category drop-down list.
  10. In the Content-Type text box, type:
  11. application/x-java-jnlp-file

  12. In the File-Suffix text box, type:
  13. jnlp

  14. Click New Type to create the MIME type.
  15. Restart the web container for this change to take effect.

On Apache Web Container

    To Add the MIME Type to Apache Web Container


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 Java System 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 Instant Messenger

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 Java System Instant Messaging Release Notes.

  3. Go to the 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:
  4. http://codebase/index.html

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

  5. Click Use Java Plug-In.
  6. 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).

    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.

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 Java System Instant Messaging Release Notes.

  3. Go to the 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:
  4. http://codebase/index.html

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

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

    See Customizing Instant Messenger for information on customizing the resource pages.



Previous      Contents      Index      Next     


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