i-Planet Release Notes

Integrating Non-Applet Clients

Non-applet clients, such Lotus Notes or Microsoft Exchange, must be directed to connect to the client machine on which they are running. You can do this in two ways. You can either:

  1. Have each user configure the client to use localhost as the server.

    or

  2. Have DNS resolve the destination server's host name to 127.0.0.1 for external queries and to the actual IP address for internal lookups.

The second choice is the recommended solution because it requires no changes to the client configuration, and client will work correctly from the Internet and the intranet.

Use the following procedure to integrate non-applet clients.

To Integrate Non-Applet Clients
  1. On the Netlet Administration page of the Administration Console, create a user-defined Netlet rule to map the application's TCP port over the Netlet.

    The Netlet rule must be in the form: name^client-listen-port^destination-host^destination-host-port


    Netlet-1^20000^appletserver^2000


    Note -

    The client-listen-port is arbitrary, but it must be a port that is not used by your client or any other Netlet rule. Ideally, the client-listen-port and the destination-host-port should be the same. You should use a value above 2048 for the client-listen-port because certain operating systems require the end user to be root with a client-listen-port below 2048. Table 1-2 shows the ports that are reserved for the predefined Netlet rules.


  2. Repeat Step 1 for each port that the application uses for connection.

  3. Click Enter at the bottom of the Netlet Administration frame to save the new Netlet rule or rules.

  4. As root on the i-Planet server, type the following to stop and restart the web server so that the Netlet rule you just defined will take effect.


    # /opt/SUNWjeev/bin/iplanet_serv stop
    # /opt/SUNWjeev/bin/iplanet_serv start

  5. At runtime, the end user must first start the Netlet by clicking the NetFile link on the i-Planet Desktop.

    The only way that an end user will know that the Netlet is running is to check in the browser's Java Console.

  6. Once the Netlet is running, the end user must start the client software.

    The destination host must be localhost and the port must be the port specified in Step 1 of this procedure.