The information in this Readme file pertains to Novell® GroupWise® Messenger 1.0 Support Pack 5. You must have GroupWise Messenger 1.0 installed before you install Support Pack 5.
GroupWise Messenger 1.0 Support Pack 5 brings together all three supported Messenger platforms (NetWare®, Linux*, and Windows*) into a single Support Pack. The NetWare and Windows software is provided in one set of downloads; the Linux software is provided in a separate set of downloads.
For information on the latest Support Pack issues, see the Messenger 1.0 Support Pack 5 Readme Addendum.
Messenger 1.0 Support Pack 5 can be applied to the following Messenger versions:
Before installing Messenger 1.0 Support Pack 5:
Messenger 1.0 Support Pack 5 is available in English or multilingual format for installing from a local or network drive. You can download the Support Pack from the GroupWise Messenger Product Updates page.
In the list of Support Packs, click GW Messenger SP 5.
Click the filename (gwm105e.exe for English only or gwm105m.exe for multilingual), then follow the instructions to download the file into a temporary directory.
Extract the .exe file into a directory at the root of your local drive or to a network server drive that can handle long pathnames.
The compressed file contains directory paths that could exceed DOS limits.
Continue with Installing the Windows/Netware Full Support Pack Version.
In the list of Support Packs, click GW Messenger SP5.
Click the filename (gwm105ce.exe for English only or gwm105cm.exe for multilingual), then follow the instructions to download the file into a temporary directory.
Extract the .exe file into a directory at the root of your local drive or to a network server drive that can handle long pathnames.
The compressed file contains directory paths that could exceed DOS limits.
Continue with Installing the Windows Client Version.
Use Windows to run the Messenger Installation program (setup.exe).
Click Start > Run > Browse.
Select the setup.exe file on the local or network drive.
Click OK to run the Messenger Installation program.
Follow the on-screen instructions provided in the Messenger Installation program to update the software.
After applying the Support Pack on NetWare servers where Messenger agents are running, restart the servers to ensure that all updated NLMTM programs are loaded.
This resolves any errors you might see during the update process.
For complete installation instructions, see the Novell Messenger 1.0 Installation Guide (NovellMessengerInstallationGuide.pdf), located in the /server/docs/en subdirectory of the Support Pack.
Use Windows to run the Messenger Installation program (setup.exe).
Click Start > Run > Browse.
Select the setup.exe file on the local or network drive.
Click OK to run the Messenger Installation program.
Follow the on-screen instructions provided in the Messenger Installation program to update the software.
For complete installation instructions, see the Novell Messenger 1.0 Installation Guide (NovellMessengerInstallationGuide.pdf), located in the /server/docs/en subdirectory of the Support Pack.
Messenger 1.0 for Linux Support Pack 5 can be applied to the following Messenger versions:
Messenger 1.0 Support Pack 5 is available as compressed tar files. You can download the full Support Pack as a single download. You can also download the Messenger Cross-Platform clients for Linux* and Macintosh* as separate downloads. You can download the Support Pack from the GroupWise Messenger Product Updates page.
The full Support Pack includes both administrative and client files.
Download the compressed tar file (gwm105lnx.tar.gz ) to a temporary directory on your Linux server.
In a terminal window at your Linux server, change to the temporary directory, then use the following commands to uncompress and untar the downloaded file:
gzip -d gwm105lnx.tar.gz
tar -xvf gwm105lnx.tar
The result is a directory named gwm105lnx.
Change to the gwm105lnx/server.
Become root by entering su and the root password.
Start the Messenger Installation program:
./install.sh
Follow the on-screen instructions to create your Messenger system.
For complete installation instructions, see the Novell Messenger 1.0 Installation Guide (NovellMessengerInstallationGuide.pdf), located in the /server/docs/en subdirectory of the Support Pack.
Download the compressed tar file (gwm105clnx.tar.gz) to a temporary directory on your Linux workstation.
In a terminal window at your Linux workstation, change to the temporary directory, then use the following commands to uncompress and untar the downloaded file:
gzip -d gwm105clnx.tar.gz
tar -xvf gwm105clnx.tar
The result is a directory named gwm105clnx.
Change to the gwm105105clnx/client directory.
Become root by entering su and the root password.
Enter the following command:
sh ./nvlmsgr.bin
To start the Cross-Platform client after installation, click the Messenger icon on your Linux desktop.
Download the StuffIt file (gwm105cmac.sit) to a temporary directory on your Macintosh workstation.
At your Macintosh workstation, browse to the gwm105cmac.sit file.
Double-click gwm105cmac.sit to start the Messenger Cross-Platform client installation.
To start the Cross-Platform client after installation, click the Messenger icon on your Macintosh dock.
Because Messenger is based on Novell® eDirectoryTM, the Messenger agents must be able to access eDirectory with the rights necessary to perform their tasks. The simplest way to accomplish this is to let the Messenger agents log in to eDirectory as an Admin equivalent user.
If you do not want to let the Messenger agents log in to eDirectory as an Admin equivalent user, you must set up an eDirectory user for them that has the rights detailed in "eDirectory Access and Authentication" in "Installing a Messenger System" in the eDirectory 8.7.3 Installation Guide.
When you change Messenger system and agent configuration settings in ConsoleOne®, you must restart the Messenger agents in order to put the new settings into effect.
When you change user-related settings, such as policy settings, users must log in again in order to put the new settings into effect. In the GroupWise® Messenger client, users can click File > Log Out to log out and back in again easily.
The Messenger information list defines what user information is displayed when a user displays the properties of a contact in the GroupWise Messenger client. ConsoleOne lists eDirectory attributes of type STRING and DN when you are configuring the information list. However, if you are using LDAP access to eDirectory, the LDAP attributes telephoneNumber and faxNumber can be manually added to the list, even though the eDirectory equivalent of these attributes is not of type STRING or DN.
Other LDAP attributes that do not correspond to eDirectory attributes can also be manually added to the information list.
Versions of eDirectory earlier than 8.5 do not have the ability to recognize all NDS® attributes. If you are using such a version of eDirectory and want to implement LDAP access to eDirectory, you need to manually add all the Messenger attributes in the nmschema.sch file to the LDAP attribute mapping table, located on the LDAP Group object in eDirectory.
In ConsoleOne, right-click the LDAP Group object for the server you want to update, then click Properties.
Click Attribute Mappings > Add.
Select the NDS attribute drop-down list and scroll down until the attributes with the nnm prefix are found (for example, nnmAgentSettings).
Attributes names that start with lowercase letters sort after all attribute names that start with uppercase letters.
Select one of the nnm-prefixed attributes (for example, nnmAgentSettings).
In the Primary LDAP attribute edit box, type the name of the nnm-prefixed attribute (for example, nnmAgentSettings).
Click OK.
Repeat step 3 through step 6 for each nnm-prefixed attribute in the NDS Attribute list (through nnmWorkPath).
Click Apply or OK to save the Messenger attributes.
At the NetWare server console, enter unload nldap.
At the NetWare server console, enter load nldap.
If you install the Messenger agents on NetWare®, the path to the installation directory must use directory names that do not exceed the 8.3 naming convention. This naming convention must also be used for all files used by the Messenger agents, such as startup files, certificate files, and key files.
If you install the Messenger agents in a NetWare cluster, you must install them on every node in the cluster. Some files are automatically installed to the current sys:\system location, rather than to the shared cluster volume. By installing to every node, you ensure that the proper files are available no matter which cluster node the Messenger agents fail over to.
Because of long-standing file lock issues with NFS, you cannot use an NFS mount to mount a server file system where ConsoleOne is installed. We recommend using an SMB mount instead.
The Messenger Cross-Platform client requires an SSL connection with the Messenger agents. If the Messenger agents are not configured for SSL, Messenger client users receive an 8922 error.
Use ConsoleOne to configure the Messenger agents for SSL. Provide an SSL certificate, key file, and password on the Security page of the Messenger Server object. For more information, see "Configuring the Messenger Agents for SSL" in "Setting Up a Messenger System on Linux" in the Messenger 1.0 Installation Guide.
If you use Cerulean Trillian Pro to communicate between instant messaging systems, a GroupWise Messenger plug-in is available at the following URL:
http://www.ceruleanstudios.com/downloads/
An open source instant messaging connector called Gaim is available at the following URL:
http://gaim.sourceforge.net/downloads.php
When you run the GroupWise Messenger client on Windows* 98, you need to have Internet Explorer 5 or higher installed.
When you run the GroupWise Messenger client on Windows NT* 4, status images do not appear next to status items in the menus.
In the GroupWise Messenger client, you can click View > Text Size to select a larger or smaller text size in the Conversation window. Unless your workstation has RichEdit 3.0 installed, selecting a text size does not change the size of the text in the Conversation window.
RichEdit 3.0 is part of newer Windows operating systems. If your Windows operating system is still using RichEdit 2.0, you can update to RichEdit 3.0 by installing the Microsoft* Windows Installer Redistributable.
Languages that display right-to-left display left-justified rather than right-justified. See "Cross-Platform Client Fixes" on page 5 for additional information.
The link from the ConsoleOne help to the Novell GroupWise documentation Web site does not work. This problem will be addressed in a future version of ConsoleOne. In the meantime, you can copy the URL from the ConsoleOne help topic into your browser window in order to access the GroupWise documentation Web site.
In addition to this Support Pack Readme file, the following sources give information about the Support Pack:
NOTE: The Readmes available from the Messenger Installation program are the original Messenger 1.0 Readmes. They do not contain Support Pack issues.
In this documentation, a greater-than symbol (>) is used to separate actions within a step and items in a cross-reference path.
A trademark symbol (®, TM, etc.) denotes a Novell trademark; an asterisk (*) denotes a third-party trademark.
Novell, Inc. makes no representations or warranties with respect to the contents or use of this documentation, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to revise this publication and to make changes to its content, at any time, without obligation to notify any person or entity of such revisions or changes.
Further, Novell, Inc. makes no representations or warranties with respect to any software, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to make changes to any and all parts of Novell software, at any time, without any obligation to notify any person or entity of such changes.
You may not use, export, or re-export this product in violation of any applicable laws or regulations including, without limitation, U.S. export regulations or the laws of the country in which you reside.
Novell, Inc. has intellectual property rights relating to technology embodied in the product that is described in this document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S. patents listed at http://www.novell.com/company/legal/patents/ and one or more additional patents or pending patent applications in the U.S. and in other countries.
Copyright © 2005 Novell, Inc. All rights reserved. No part of this publication may be reproduced, photocopied, stored on a retrieval system, or transmitted without the express written consent of the publisher.
GroupWise, NetWare, and Novell are registered trademarks of Novell, Inc. in the United States and other countries.
NLM is a trademark of Novell, Inc.
All third-party trademarks are the property of their respective owners.