Sun Java System Instant Messaging 7.2 Administration Guide

Registering New Instant Messaging Users

You can customize Instant Messenger to allow new user registration. When a user registers, the Instant Messaging server uses the information provided during registration to perform an ldapadd operation to create a user entry in the directory.

Note –

If you are using Instant Messaging with Sun Java System Access Manager, you should not allow users to register using this method. Instead, you should use the provisioning tools provided with Access Manager.

To allow new user registration, you need to configure the server to allow registration and then customize Instant Messenger resources by adding an argument to the im.jnlp.template and im.html.template files, running the configure utility, then (if necessary) redeploying the resource files.

This section describes:

See Chapter 15, Managing Instant Messenger for more information about customizing resource files.

Configuring the Instant Messaging Server to Allow New User Registration

In order to configure the Instant Messaging server to allow new user registration you need to add configuration parameters to iim.conf. Table 14–1 lists the parameters you need to add and a brief description of each.

Table 14–1 Instant Messaging Server New User Registration Configuration Parameters




If TRUE, the server allows new Instant Messaging end users to register themselves (add themselves to the directory) using Instant Messenger.


If self-registration is enabled, the value of this parameter is the DN of the location in the LDAP directory in which person entries are stored. For example:



The domain to which new users will be added. For example,

ProcedureTo Configure the Instant Messaging Server to Allow New User Registration

  1. Open iim.conf.

    See iim.conf File Syntax for instructions on locating and modifying iim.conf.

  2. Add the configuration parameters and appropriate values as described in Table 14–1.

  3. Save and close iim.conf.

  4. Refresh the server configuration using the imadmin command.

    imadmin refresh server

Customizing Instant Messenger to Allow New User Registration

When you customize the resource files to allow new user registration, a new button appears on the Login dialog box. Users click this button to access the New User Registration dialog box where they can register. When a user registers, their information is added to the LDAP directory.

ProcedureTo Customize Instant Messenger to Allow New User Registration

  1. Open the im.jnlp.template file in a text editor.

    By default this file is stored in im-svr-base/html.

  2. Search for the line:

    <application-desc main-class="">
  3. Add the following argument to the end of the section:

  4. Save and close im.jnlp.template.

  5. Open the im.html.template file in a text editor.

    By default this file is stored in im-svr-base/html.

  6. Add the register parameter to the file:

    <PARAM NAME="register" VALUE="true">
  7. Add the following parameter to the EMBED tag:

  8. Save and close im.html.template.

  9. Run the configure utility, selecting the “Messenger Resources” component only when prompted for which components you want to configure.

    See Configuring Instant Messaging After Installing or Upgrading for instructions.

  10. If you are usingSun Java System Application Server or Sun Java System Web Server, redeploy the resource files.

    See Redeploying Resource Files for instructions.

  11. Launch Instant Messenger.

    The I am a New User button should appear on the Login dialog box.

Registering as a New Instant Messaging User

Once you have added the new user registration argument to the im.jnlp and im.html files and redeployed the resource files users can register themselves.

ProcedureTo Register as a New Instant Messaging User

  1. In a web browser, go to the Instant Messaging home page.

  2. Click Start or click Use Java Plug-in.

    The Login dialog box appears, displaying the I am a New User button.

  3. Click I am a New User.

    The New User Registration dialog box appears.

  4. Enter the information in the fields provided and click OK.

    The information is stored in the directory.