GroupWise® 6.5 for Linux is GroupWise 6.5 Support Pack 1 running on Linux*. It includes all the standard GroupWise components, plus a new client:
For ease of installation, make sure that ConsoleOne is installed on the Linux server where you want to create your GroupWise system.
ConsoleOne is located in /usr/ConsoleOne/bin.
At the server where you want to create your GroupWise system, open a new terminal window, then enter the following command:
xhost + localhost
When creating your GroupWise system, you must run the GroupWise Installation Advisor in an environment where The X Window System* is running and where your DISPLAY environment variable is set correctly.
In the same window, become root by entering su and the root password.
Change to the root of the GroupWise 6.5 for Linux Administrator CD.
Start the GroupWise Installation Advisor:
./install
Click Create or Update a GroupWise System.
Follow the on-screen instructions.
After installation, when you start any of the GroupWise agents, you must include the --show startup switch on the command line in order to display a user interface on the server where the agents run. The X Window System and OpenMotif are required in order to use the --show switch. By default (without --show), the Linux GroupWise agents run as daemons in the background.
All of the agents write log files located in subdirectories of /var/log/novell/groupwise. The subdirectories are named after the associated domain, post office, and/or agent. In addition, all of the agents can be monitored in your Web browser from their agent Web consoles.
For more information, see the GroupWise 6.5 Installation Guide to determine the system requirements for GroupWise 6.5 for Linux, create a basic GroupWise system on Linux, install the Linux GroupWise agents, and install the GroupWise Cross-Platform client on Linux and Macintosh.
The GroupWise 6.5 Installation Guide (GroupWiseInstallationGuide.pdf) is located in the /docs/us subdirectory of the CD. For experienced GroupWise users, a Quick Start (GroupWiseQuickStart.pdf) is also provided.
When you view the GroupWise 6.5 Installation Guide or GroupWise Quick Start, you might initially see the Adobe* Acrobat* License Agreement. Close the License Agreement window to view the GroupWise documentation.
For information about the latest GroupWise 6.5 for Linux issues, see TID 10092069 at the Novell Support Web site .
Because of long-standing file lock issues with NFS, you cannot use an NFS mount to mount a server file system where your GroupWise system is located to a workstation where you are running ConsoleOne. We recommend using an SMB mount instead.
Do not use extended characters in pathnames for domains, post offices, libraries, software distribution directories, and so on. Do not use extended characters in filenames such as agent startup files, certificate files, key files, and so on.
If you run ConsoleOne on SUSE® LINUX 9 with Ximian® Desktop 2 installed, the label text on the property tabs does not display. As a workaround, click the tab to select it, then use the up-arrow and down-arrow keys to display each property page until you reach the one you want.
Shortly after release, an updated version of the Database Copy Utility (dbcopy) will be available at the following URL:
http://support.novell.com/cgi-bin/search/searchtid.cgi?/2968456.htm
The shipping version of dbcopy provides a full file copy. The updated version provides a differential file copy, so that you back up only files that have changed since the last backup. For more information about backing up your Linux GroupWise system, see Databases in the GroupWise 6.5 Administration Guide.
GroupWise 6.5 for Linux does not include the following administration features that are available in GroupWise 6.5 SP1:
On Red Hat* 8, you cannot use the main GroupWise Installation Advisor (the install executable at the root of the CD) to install the Cross-Platform client. Instead, you can run the install executable located in /client/linux or you can install the novell-groupwise-gwclient-6.5.1 RPM located in the same directory.
The Cross-Platform client installation in the Installation Advisor is for Linux only. To install the Cross-Platform client on Macintosh:
Browse to the GroupWise.sit file in the /client/linux directory on the GroupWise 6.5 for Linux Cross-Platform Client CD.
Double-click the GroupWise.sit file to install the Macintosh Cross-Platform client software.
For best performance, run the Cross-Platform client in Caching mode. It is noticeably faster than Online mode.
If you have installed Microsoft* Office or Internet Explorer on your Macintosh, new messages do not display as bold in your mailbox. To resolve the problem, disable your user fonts, which are typically duplicates of your system fonts.
If you run the Cross-Platform client in Caching mode as root on Linux, you might encounter synchronization problems with your master mailbox when you next run as a regular user. To resolve any problems, run the client as root so that all messages get synchronized, then run as a regular user thereafter to prevent further problems.
When you read a message and then click Reply with the message text included, the cursor does not automatically appear in the message window. Click in the message window, then start typing your reply.
Some HTML-formatted messages are not rendered correctly in the Cross-Platform client.
In Online mode, custom column sort settings are not saved unless the Cross-Platform client is connected to a GroupWise 6.5 for Linux POA. The problem will be resolved for NetWare and Windows POAs in a future Support Pack.
This is a Java error. A newer version of the JVM* resolves it. The print jobs prints successfully in spite of the error message.
The Cross-Platform client does not respect the mailbox size limits set in ConsoleOne (Tools > GroupWise Utilities > Client Options > Send > Disk Space Management).
Some information in the About Startup Options help topic is incorrect.
The Cross-Platform client startup options use a hyphen (-) instead of a slash (/) as an opening character and an equals sign (=) instead of a hyphen (-) to separate the startup option from the associated setting:
Incorrect Format: /switch-setting
Correct Format: -switch=setting
The following switches listed in the Cross-Platform client Help are not actually valid in the Cross-Platform client:
-bl
-c
-cm
-iabs
-la
-nu
The following language codes are incorrect:
EN should be US
FI should be SU
PT should be BR
The GroupWise Cross-Platform client does not currently provide some functionality that is available in the GroupWise Windows* client, including:
Additional functionality will be available in future releases.
On Red Hat Enterprise Linux 3 and Red Hat Advanced Server 3, starting the POA might result in a "floating point exception" error. If this occurs, you must enter the following prior to starting the POA:
export LD_ASSUME_KERNEL=2.4.0
If you start the POA using the grpwise startup script in /etc/init.d, this error does not occur because the script sets the LD_ASSUME_KERNEL environment variable for you.
If you try to start the POA on a server where The X Window System and OpenMotif are not running, you receive the following error:
libXm.so.3: cannot open shared object file
: no such file or directory
To resolve the error, start The X Window System and OpenMotif before starting the POA with the --show switch. If you start the POA without the --show switch, you can use the POA Web console to monitor the POA from your Web browser.
On Red Hat Enterprise Linux 3 and Red Hat Advanced Server 3, starting the MTA might result in a "floating point exception" error. If this occurs, you must enter the following prior to starting the MTA:
export LD_ASSUME_KERNEL=2.4.0
If you start the MTA using the grpwise startup script in /etc/init.d, this error does not occur because the script sets the LD_ASSUME_KERNEL environment variable for you.
If you try to start the MTA on a server where The X Window System and OpenMotif are not running, you receive the following error:
libXm.so.3: cannot open shared object file
: no such file or directory
To resolve the error, start The X Window System and OpenMotif before starting the MTA with the --show switch. If you start the MTA without the --show switch, you can use the MTA Web console to monitor the MTA from your Web browser.
During installation, the Internet Agent Installation program requires access to Novell® eDirectoryTM by way of LDAP authentication or an SSL connection. If you want to use LDAP, your LDAP server must be configured to accept clear text passwords. If you want to use SSL, you must be able to provide an SSL certificate file. The installation cannot proceed without one of these security methods being used.
On Red Hat Enterprise Linux 3 and Red Hat Advanced Server 3, starting the Internet Agent might result in a "floating point exception" error. If this occurs, you must enter the following prior to starting the Internet Agent:
export LD_ASSUME_KERNEL=2.4.0
If you start the Internet Agent using the grpwise-ia startup script in /etc/init.d, this error does not occur because the script sets the LD_ASSUME_KERNEL environment variable for you.
If you try to start the Internet Agent on a server where The X Window System and OpenMotif are not running, you receive the following error:
libXm.so.3: cannot open shared object file
: no such file or directory
To resolve the error, start The X Window System and OpenMotif before starting the Internet Agent with the --show switch. If you start the Internet Agent without the --show switch, you can use the Internet Agent Web console to monitor the Internet Agent from your Web browser.
GroupWise 6.5 for Linux includes a Novell distribution of Apache and Tomcat that you can install along with the WebAccess Application if you do not already have Apache and Tomcat running on that server. The Novell distribution is installed in the following directories:
Apache: /var/opt/novell/http and /etc/opt/novell/http
Tomcat: /var/opt/novell/tomcat4 and /etc/opt/novell/tomcat4
and is started using the following customized commands:
Tomcat: /etc/init.d/novell-tomcat4 start
Apache: /etc/init.d/novell-httpd start
The WebAccess Installation program lets you choose whether you want to install the Novell distribution. During installation, select Install WebAccess Application with Apache and Tomcat if you want to install the Novell distribution. Select Install WebAccess Application if you do not want to install the Novell distribution of Apache and Tomcat because you have an existing Apache and Tomcat installation that you want to use with WebAccess.
If you install the Novell distribution on a server where a standard distribution of Apache and Tomcat is already installed and running, you will encounter a port conflict on port 80. You can resolve the port conflict by choosing to run one distribution or the other, or you can reconfigure one distribution or the other.
To reconfigure the Novell distribution to use a different port number, edit the httpd.conf file in the /etc/opt/novell/httpd/conf directory. Locate the following line:
Listen 80
Change the port number to a something that is not already being used on the server, then save and exit the file.
On slower machines, if you select Install WebAccess Application with Apache and Tomcat, your machine might appear to hang on the "Please Wait" message. Apache and Tomcat are being installed while the "Please Wait" message is displayed, before the WebAccess Application installation begins.
During installation, the WebAccess Installation program requires access to eDirectory by way of LDAP authentication or an SSL connection. If you want to use LDAP, your LDAP server must be configured to accept clear text passwords. If you want to use SSL, you must be able to provide an SSL certificate file. The installation cannot proceed without one of these security methods being used.
If you install WebAccess in an eDirectory context where the WebAccess objects already exist, a message informs you that you can "use the existing objects." In actuality, the objects are deleted and re-created, so if you have customized the properties of the existing objects, you must customize the objects again after installing WebAccess.
On Red Hat Enterprise Linux 3 and Red Hat Advanced Server 3, starting the WebAccess Agent might result in a "floating point exception" error. If this occurs, you must enter the following prior to starting the WebAccess Agent:
export LD_ASSUME_KERNEL=2.4.0
If you start the WebAccess Agent using the grpwise-wa startup script in /etc/init.d, this error does not occur because the script sets the LD_ASSUME_KERNEL environment variable for you.
Existing users of the WebAccess are accustomed to accessing the following URLs:
Web Services page: Default index.html file of Web server
WebAccess: http://web_server_address/servlet/webacc
WebPublisher: http://web_server_address/servlet/webpub
On Linux, use the following URLs:
GroupWise Web Services page: http://web_server_address/gw/index.html
WebAccess: http://web_server_address/gw/webacc
WebPublisher: http://web_server_address/gw/webpub
As an added benefit, GroupWise 6.5 for Linux configures SSL for you, so that the following URLs provide SSL security without additional configuration on your part:
GroupWise Web Services page: https://web_server_address/gw/index.html
WebAccess: https://web_server_address/gw/webacc
WebPublisher: https://web_server_address/gw/webpub
The WebAccess Installation program does not configure WebPublisher for you. Some manual configuration is required. For instructions, see the GroupWise 6.5 Installation Guide (/docs/us/GroupWiseInstallationGuide.pdf).
Changes to the settings on the Templates page of the GroupWiseWebPublisher object in ConsoleOne are not saved to the webpub.cfg file. To work around this, after making changes on the Templates page, select a different property page on the GroupWiseWebPublisher object, then click OK or Apply to save the template settings correctly.
Monitor and WebAccess share a substantial amount of functionality. The following WebAccess issues pertain to Monitor as well:
3.6.1 Novell Distribution of Apache and Tomcat
3.6.2 Prolonged "Please Wait" Message during Installation
3.6.3 Installation Security
3.6.4 Re-installation Issue
3.6.5 Floating Point Exception Error
If you encounter problems starting the Monitor Agent on Red Hat 3 AS, set the LC_ALL environment variable using one of the following commands:
export LC_ALL=C
export LC_ALL=POSIX
If you've used Monitor on Windows, you are used accustomed to accessing the following URLs:
Web Services page: Default index.html file of Web server
Monitor Web Console: http://web_server_address/servlet/gwmonitor
On Linux, use the following URLs:
GroupWise Web Services page: http://web_server_address/gw/index.html
Monitor Web Console: http://web_server_address/gwmon/gwmonitor
The localized versions of the GroupWise for Linux Installation Guide are not included on the GroupWise for Linux media. Installation Guides in French, German, Portuguese, and Spanish will soon be available at the GroupWise 6.5 Documentation Web site.
If you are using the WebAccess client in the Konqueror browser, you cannot attach files that have names including accented characters. Konqueror does not send the filenames back in UTF-8 format.
If you have a domain name that includes extended characters, the MTA cannot process its log file for the domain. This seems to occur on SUSE but not Red Hat Linux.
The Linux GroupWise agent user interfaces display correctly if the Linux environment is using the ISO-8859-1 character set, which is the default for the GroupWise administration languages and locales.
French: fr_FR
German: de_DE
Portuguese: pt_BR
Spanish: es_ES
If the Linux environment is using a different character set encoding such as UTF-8 (for example, fr_FR.UTF-8), then the localized agent user interfaces do not display correctly.
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.
If you display help from an agent Web console on a server where Novell iChain® is installed, and if iChain is configured to use the Path-Based Multihoming option, the image at the top of the help topic does not display.
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 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.
Copyright © 2004 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.
U.S. Patent Nos. 5,412,772; 5,701,459; 5,717,912; 5,760,772; 5,870,739; 5,873,079; 5,884,304; 5,903,755; 5,913,209; 5,924,096; 5,946,467; 5,963,938; 6,081,804; 6,138,170; 6,167,393; and 6,192,405; 6,216,123; 6,546,433; 6,584,458; D393,457; Patents Pending.
ConsoleOne, GroupWise, iChain, Novell, and Ximian are registered trademarks of Novell, Inc. in the United States and other countries.
SUSE is a registered trademark of SUSE AG, a Novell company.
eDirectory is a trademark of Novell, Inc.
All third-party trademarks are the property of their respective owners.
Third-party materials used in this software are listed in Appendix B: Third-Party Materials in the GroupWise 6.5 Installation Guide.