3.4 Distributing the Messenger Client Software

3.4.1 Using the GroupWise Messenger Download Page

The GroupWise Messenger download page is available to users as soon as you finish running the Messenger Installation program (as described in the GroupWise Messenger Installation Guide) and start the Messaging Agent (as described in Starting the Messaging Agent).

In order for users to access the GroupWise Messenger download page in their browsers, you need to tell them the IP address or DNS hostname of the server where the Messaging Agent is running and the port number (8300 by default). For example, if you installed the Messaging Agent on a server with an IP address of 172.16.5.18, the GroupWise Messenger download page is:

http://172.16.5.18:8300

When users click the GroupWise Messenger link, they download the gwmsgr.exe file from the \novell\nm\ma\software\client\win32 directory. By following the instructions on the download page, users can install and start the Messenger client quickly and easily.

3.4.2 Setting Up Auto-Update

You can require Messenger users to update their Messenger client software whenever a new version of the client is available.

  • In the GroupWise Admin console, navigate to Messenger > MessengerService > Settings > Client Settings, and configure the following information:

    Enable Client Download Through a Browser: Select this option so that users can download the updated Messenger client software from the GroupWise Messenger download page, as described in Using the GroupWise Messenger Download Page.

    Version: Specify the minimum acceptable version number for the Messenger client software.

    Date: Click the Calendar button to specify the earliest acceptable date for the Messenger client software.

    If you fill in the Version and/or Date fields, users cannot run the Messenger client until they update their software, unless you allow grace logins.

    Grace Logins: Specify the number of times users can log in to the Messenger system without updating their Messenger client software.

    If you leave the Date and Version fields blank, users can choose whether to update their Messenger client software when they are notified that a new version is available.

    Client version information is stored on each user's workstation in the nmcl32.ver file.

    Update Message: If desired, type the message that you want Messenger users to see when they are notified about the Messenger client update.

    Client Download URLs: Click Add to specify each URL where the user's browser or the Messenger client are redirected when attempting to download the updated client software.

    The URLs in the list you create are tried in the order you list them. Ensure that the Messenger gwmsgr.exe file is available for download from each URL in the list. For more information, see Configuring Your Web Server to Download the Messenger Client.

  • Click Save.

When Messenger users start the Messenger client, they are notified whenever updated client software is available.

3.4.3 Configuring Your Web Server to Download the Messenger Client

By default, the Messaging Agent handles downloading Messenger client software to Messenger users. If this activity seems to interfere with its ability to handle its instant messaging functions in a timely manner, you can configure your web server to download the client software instead. Before performing the following steps, you should already have created your Messenger system and have the Messenger agents running.

  • In the GroupWise Admin console, navigate to Messenger > MessengerService > Settings > Client Settings, and then in the Client Download URLs list, click Add.

  • Specify the URL of your web server. For example:

    http://nm.novell.com:80

    Be sure to include both the http:// and the port number where your web server listens for service requests.

  • Click OK to close the Download URL dialog box, and then click Save.

  • From the Messenger software subdirectory(/opt/novell/messenger/software), copy the index.htm file and the msgricon.gif file to the primary document directory of your web server.

    If you want to provide the GroupWise Messenger download page in a language other than English, copy the index.htm file from the appropriate language subdirectory beneath the Messenger software directory.

  • Edit the index.htm file to remove all instances of ~down. For example:

    Before: /~down/client/win32/gwmsgr.exe /~down/client/linux/gwmsgr.bin /~down/client/mac/nvlmsgr.sit

    After: /client/win32/gwmsgr.exe /client/xplat/linux/gwmsgr.bin /client/xplat/mac/nvlmsgr.sit

  • Depending on the requirements of your web server, save the file as either index.htm or index.html.

  • Under the primary document directory of your web server, create a client subdirectory, and then create a platform-specific subdirectory in it, to create the following directory structure:

    primary_doc_dir/client/win32 primary_doc_dir/client/xplat/linux primary_doc_dir/client/xplat/mac

  • From the platform-specific subdirectory (win32, linux, or mac) of the Messenger software directory, copy the appropriate Messenger file (gwmsgr.exe, gwmsgr.bin, or nvlmsgr.sit) into the corresponding primary_doc_dir platform-specific subdirectory.

  • In the platform-specific primary_doc_dir subdirectory, create an ASCII text file named files.txt with one of the following lines depending on your client platform:

    client/win32/gwmsgr.exe client/xplat/linux/gwmsgr.bin client/xplat/mac/nvlmsgr.sit

  • After typing the appropriate platform-specific line, press Enter so that there is an empty line at the end of the file.

  • Save the updated files.txt file.

  • Repeat the previous steps for each platform-specific subdirectory you created

  • so that you have three files.txt files, one for each platform.

  • Restart the Messenger agents to put the list of client download URLs into effect.

You do not need to restart the web server in order for Messenger users to be able to download the Messenger client software.