The main emphasis of GroupWise® Messenger 2 is the enhancement of functionality for GroupWise Messenger.
Some feature enhancements in the area of GroupWise Messenger administration are also included in GroupWise Messenger 2.
For a complete listing of all major enhancements and new features in the GroupWise Messenger components, See What's New in Update in the GroupWise Messenger 2 Installation Guide.
To install GroupWise Messenger 2 on NetWare® or Windows:
Run setup.exe at the root of the GroupWise Messenger 2 (NetWare/Windows) CD.
The GroupWise Installation program lets you view the Readme, the Quick Start, and the Installation Guide before you start installing GroupWise Messenger.
Click Install Server.
Follow the on-screen instructions.
For detailed system requirements, installation and update instructions, and a complete list of new features, see the GroupWise Messenger 2 Installation Guide (NovellMessengerInstallationGuide.pdf) in the \server\docs\us directory on the GroupWise Messenger 2 (NetWare/Windows) CD or on the GroupWise Messenger 2 Documentation Web site.
At the server where you want to create your GroupWise Messenger system, open a new terminal window, then become root by entering sux and the root password.
Change to the \server directory of the GroupWise Messenger 2 (Linux) CD.
Start the GroupWise Messenger installation:
Follow the on-screen instructions.
For detailed system requirements, installation and update instructions, and a complete list of new features, see the GroupWise Messenger 2 Installation Guide (NovellMessengerInstallationGuide.pdf) in the \server\docs\us directory on the GroupWise Messenger 2 (Linux) CD or on the GroupWise Messenger 2 Documentation Web site.
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 Rights in the eDirectory 8.7.3 Installation Guide.
The GroupWise distinguished name must be part of the address in the GroupWise address book for GroupWise Messenger presence to work properly.
To add the distinguished name to the address book:
In ConsoleOne, right-click the Domain object and select Properties.
Click GroupWise > Address Book. Select the Distinguished Name in the Available Fields section, then click the left-arrow to move it to the Address Book Fields section.
Click OK to save the changes. Repeat the steps for every Domain object in your eDirectory tree.
The Messenger information list defines what user information is shown when a user displays 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.
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).
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.
In the NetWare server console, enter unload nldap.
In 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, Gaim, and Kopete all require an SSL connection with the Messenger agents. If the Messenger agents are not configured for SSL, Messenger client users receive an error reading, "The client is unable to establish a secure connection witht eh specified server; a secure connection is required".
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:
An open source instant messaging connector called Gaim is available at the following URL:
An open source instant messaging plugin called Kopete is available at the following URL:
Languages that display right-to-left are left-justified rather than right-justified.
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 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.
ConsoleOne, GroupWise, NDS, NetWare, and Novell are registered trademarks of Novell, Inc. in the United States and other countries. eDirectory is trademarks of Novell, Inc.
All third-party trademarks are the property of their respective owners.