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.
Any products or technical information provided under this Agreement may be subject to U.S. export controls and the
trade laws of other countries. You agree to comply with all export control regulations and to obtain any required
licenses or classification to export, re-export, or import deliverables. You agree not to export or re-export to entities
on the current U.S. export exclusion lists or to any embargoed or terrorist countries as specified in the U.S. export
laws. You agree to not use deliverables for prohibited nuclear, missile, or chemical biological weaponry end uses. See
the Novell International Trade Services Web page (http://www.novell.com/info/exports/) for more information on
exporting Novell software. Novell assumes no responsibility for your failure to obtain any necessary export
approvals.
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 on the Novell Legal Patents Web page (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.
Novell, Inc.
404 Wyman Street, Suite 500
Waltham, MA 02451
U.S.A.
www.novell.com
Online Documentation: To access the online documentation for this and other Novell products, and to get updates,
see the Novell Documentation Web site (http://www.novell.com/documentation).
Novell Trademarks
For Novell trademarks, see the Novell Trademark and Service Mark list (http://www.novell.com/company/legal/
trademarks/tmlist.html).
Third-Party Materials
All third-party trademarks are the property of their respective owners.
This Novell® GroupWise® 8 Installation Guide helps you install a new GroupWise system or update
an existing GroupWise 5.x/6.x/7 system. The guide is divided into the following sections:
“Installation” on page 13
Chapter 1, “What Is GroupWise?,” on page 15
Chapter 2, “GroupWise System Requirements,” on page 19
Chapter 3, “Installing a Basic GroupWise System,” on page 25
Chapter 4, “Installing the GroupWise Internet Agent,” on page 73
Chapter 5, “Installing GroupWise WebAccess,” on page 101
Chapter 6, “Installing the GroupWise Calendar Publishing Host,” on page 133
Chapter 7, “Installing GroupWise Monitor,” on page 155
Chapter 8, “Installing GroupWise Agents,” on page 177
Chapter 9, “Installing the GroupWise Clients,” on page 225
novdocx (en) 22 June 2009
Chapter 10, “Installing GroupWise Messenger,” on page 235
Chapter 11, “Installing GroupWise Mobile Server,” on page 237
Chapter 12, “Installing Novell Teaming and Conferencing,” on page 239
“Update” on page 241
Chapter 13, “What’s New in GroupWise 8,” on page 243
Chapter 14, “Understanding the Update Process,” on page 249
Chapter 15, “Preparing Your GroupWise System for Update,” on page 255
Chapter 16, “Updating Your GroupWise 7 System to Version 8,” on page 257
Chapter 17, “Updating Your GroupWise 5.x or 6.x System to Version 8,” on page 271
“Appendixes” on page 273
Appendix A, “GroupWise Version Compatibility,” on page 275
Appendix B, “GroupWise Linux Executables,” on page 287
Appendix C, “Third-Party Materials,” on page 321
For troubleshooting assistance, see:
GroupWise 8 Troubleshooting 1: Error Messages
GroupWise 8 Troubleshooting 2: Solutions to Common Problems
GroupWise 8 Troubleshooting 3: Message Flow and Directory Structure
Novell Support and Knowledgebase (http://www.novell.com/support)
To search the GroupWise documentation from the Novell Support Web site, click Advanced
Search, select Documentation in the Search In drop-down list, select GroupWise in the
Products drop-down list, type the search string, then click Search.
GroupWise 8 Support Forums (http://forums.novell.com/novell-product-support-forums/
groupwise)
About This Guide11
GroupWise Support Community (http://www.novell.com/support/products/groupwise)
This guide is intended for network administrators who install and administer GroupWise.
Feedback
We want to hear your comments and suggestions about this manual and the other documentation
included with this product. Please use the User Comment feature at the bottom of each page of the
online documentation, or go to www.novell.com/documentation/feedback.html and enter your
comments there.
Documentation Updates
For the most recent version of the GroupWise 8 Installation Guide, visit the Novell GroupWise 8
Documentation Web site (http://www.novell.com/documentation/gw8).
novdocx (en) 22 June 2009
Additional Documentation
For additional GroupWise documentation, see the following guides at the Novell GroupWise 8
Documentation Web site (http://www.novell.com/documentation/gw8):
In Novell 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.
When a single pathname can be written with a backslash for some platforms or a forward slash for
other platforms, the pathname is presented with a backslash. Users of platforms that require a
forward slash, such as Linux*, should use forward slashes as required by your software.
When a startup switch can be written with a forward slash for some platforms or a double hyphen for
other platforms, the startup switch is presented with a forward slash. Users of platforms that require
a double hyphen, such as Linux, should use double hyphens as required by your software.
12GroupWise 8 Installation Guide
I
Installation
Chapter 1, “What Is GroupWise?,” on page 15
Chapter 2, “GroupWise System Requirements,” on page 19
Chapter 3, “Installing a Basic GroupWise System,” on page 25
Chapter 4, “Installing the GroupWise Internet Agent,” on page 73
Chapter 5, “Installing GroupWise WebAccess,” on page 101
Chapter 6, “Installing the GroupWise Calendar Publishing Host,” on page 133
Chapter 7, “Installing GroupWise Monitor,” on page 155
Chapter 8, “Installing GroupWise Agents,” on page 177
Chapter 9, “Installing the GroupWise Clients,” on page 225
Chapter 10, “Installing GroupWise Messenger,” on page 235
Chapter 11, “Installing GroupWise Mobile Server,” on page 237
novdocx (en) 22 June 2009
Chapter 12, “Installing Novell Teaming and Conferencing,” on page 239
For additional assistance in planning your GroupWise installation, see GroupWise Best Practices
(http://wiki.novell.com/index.php/GroupWise).
InstallationI13
novdocx (en) 22 June 2009
14GroupWise 8 Installation Guide
1
What Is GroupWise?
Novell® GroupWise® is an enterprise collaboration system that provides secure e-mail, calendaring,
scheduling, and secure instant messaging. GroupWise also includes task management, contact
management, document management, and other productivity tools. Companion products provide
synchronization with mobile devices, teaming, and telephone and soft phone conferencing for
complete enterprise connectivity and collaboration.
GroupWise can be used on your desktop on Linux, Windows*, or Macintosh*; in a Web browser
anywhere you have an Internet connection; and on mobile devices. Your GroupWise system can be
set up on NetWare
The following sections include more details about what GroupWise provides and what you need to
do to set up GroupWise to best meet your needs.
Section 1.1, “What GroupWise Provides,” on page 15
Section 1.2, “What You Need to Install,” on page 17
®
, Linux, Windows, or any combination of these operating systems.
novdocx (en) 22 June 2009
1
1.1 What GroupWise Provides
GroupWise provides communication and collaboration services that are secure, highly available,
and easily accessible:
Section 1.1.1, “Essential Communication and Collaboration Services,” on page 15
Section 1.1.2, “Available Anytime,” on page 16
Section 1.1.3, “Accessible Anywhere,” on page 16
Section 1.1.4, “Always Secure,” on page 17
1.1.1 Essential Communication and Collaboration Services
GroupWise provides a variety of tools to enable users to work together and work smarter.
Messaging: Send and receive mail messages, phone messages, and reminder notes. A mail
message is for general correspondence. A phone message is designed for those who take phone
messages for others. A reminder note includes a start date and, when accepted by the recipient,
is posted to the recipient’s Calendar.
Scheduling: Schedule both appointments and tasks. When you schedule an appointment, you
can search other users’ Calendars to find free times for the appointment. When you schedule a
task, you can assign a priority and due date to the task. If the recipient accepts an appointment
or task, it is automatically added to his or her Calendar.
Calendaring: View and manage your appointments, tasks, and reminder notes in a Calendar
view. You can create multiple calendars. You can also publish personal calendars and free/busy
status so that non-GroupWise users can conveniently schedule meetings with you.
Task Management: Accept or decline the tasks you are sent, and track accepted tasks through
to completion. You can turn any message into a task. You can also organize, schedule, and
monitor tasks in your Tasklist folder.
What Is GroupWise?
15
Contact Management: Manage information for your contacts, groups, resources, and
organizations, including being able to view, update, delete, and add information to the contacts
in your address books and Contacts folders. In addition, you can view a history of messages
sent to and received from individual contacts and compile notes on interactions with contacts.
Document Management: Store documents in GroupWise libraries. In a library, documents are
compressed to save disk space and encrypted to maintain security. With document
management, you can check in, check out, share, and version documents.
Instant Messaging: Communicate in real time with other GroupWise users through
GroupWise Messenger. GroupWise Messenger lets you know when other users are online,
busy, or away from their desks. It also allows you to save conversations.
Teaming: Collaborate on a teaming Web site where personal, team, and global workspaces can
include discussion folders, shared calendars, shared documents, blogs, wikis, surveys, and
more. Powerful search capabilities make finding information quick and easy.
Conferencing: Conduct telephone conferences with the convenience of communities, contacts,
and buddies for conference calls; phone presence and participation indicators; meeting setup;
instant chat; whiteboarding; desktop sharing; and more.
novdocx (en) 22 June 2009
1.1.2 Available Anytime
GroupWise ensures that your essential communication tools are always available:
Caching: The GroupWise Windows, Linux, and Mac* clients include a Caching mode that
allows you to cache GroupWise information to your local drive and continue to work even
when you aren’t logged into your network mailbox.
LDAP Pooling: If you are using LDAP authentication for GroupWise mailbox authentication,
LDAP pooling ensures that there is always an LDAP server through which authentication can
be performed.
Clustering: To ensure that GroupWise data is always available and GroupWise components
are always running, you can install GroupWise in a cluster on NetWare, Linux, or Windows.
1.1.3 Accessible Anywhere
GroupWise lets you communicate and collaborate with other people by using the device that is most
convenient:
Personal Computers: To access your mailbox, you can run the GroupWise Windows client on
any workstation that uses Windows XP or higher. On Linux workstations, you can run the
GroupWise Linux client. On Macintosh workstations, you can run the GroupWise Mac client.
Web Browsers and Mobile Devices: With GroupWise WebAccess installed, you can also
access your mailbox through a Web browser, a cellular phone, or a PDA (personal digital
assistant) such as Pocket PC*. The GroupWise WebAccess client formats information to best
accommodate the type of device on which it is being displayed.
You can use GroupWise Mobile Server to synchronize e-mail and other Personal Information
Manager (PIM) data from GroupWise to Windows CE devices, Windows Mobile*-based
Smartphones, Symbian* OS devices, Palm OS* devices, and SyncML* devices. GroupWise
Mobile Server is available on Linux and Windows.
16GroupWise 8 Installation Guide
You can synchronize GroupWise with your BlackBerry* device by using BlackBerry
Enterprise Server for GroupWise. You can synchronize your Apple* iPhone* and many other
devices with GroupWise by using NotifyLink* Enterprise Edition for Novell GroupWise.
Other E-Mail Clients: GroupWise enables you to access your mailbox with any POP3,
IMAP4, or SOAP e-mail client.
1.1.4 Always Secure
GroupWise provides extensive security measures to protect your information.
Encryption: To protect your information as it is stored in the various GroupWise databases
and moved across the network, GroupWise encrypts the information. Each piece of information
is encrypted differently through the use of randomly-generated encryption keys.
Open Security Standards: To further ensure that your information is secure while moving
across your internal network or across the Internet, GroupWise supports open security
standards such as Secure Sockets Layer (SSL), Secure Multipurpose Internet Mail Extension
(S/MIME), Public Key Infrastructure (PKI), and Transport Layer Security (TLS).
Spam Protection: To protect you from seeing unwanted messages, the GroupWise Windows
client includes a Junk Mail Handling feature that lets you control unwanted Internet e-mail
messages. In addition, you can configure the Internet Agent (the GroupWise component
responsible for sending and receiving Internet e-mail messages) to reject messages from known
open relay hosts and spam hosts. GroupWise also works with partner products that provide
additional anti-spam solutions.
Virus Protection: GroupWise works with partner products to provide solutions that detect and
eliminate viruses.
novdocx (en) 22 June 2009
For information about additional security solutions available for GroupWise through GroupWise
partners, see the Novell Partner Product Guide (http://www.novell.com/partnerguide).
1.2 What You Need to Install
GroupWise includes multiple components that you need to install to realize the full benefits of
GroupWise. However, some components might not be necessary, depending on your needs. The
following table outlines the components, what they provide, and where to find instructions for
installing them.
Table 1-1 Components of Your GroupWise System
ComponentWhat it doesGo to
Administration, Agents,
and Client (Windows,
Linux, or Mac)
Internet AgentProvides Internet e-mail
Necessary for a basic GroupWise
system. These components are
required and must be installed
before any other components.
communication, POP3/IMAP4/
SOAP client access, and paging
services.
Chapter 3, “Installing a Basic
GroupWise System,” on page 25
Chapter 4, “Installing the GroupWise
Internet Agent,” on page 73
What Is GroupWise?17
ComponentWhat it doesGo to
novdocx (en) 22 June 2009
WebAccessProvides access to mailboxes
through a Web browser or mobile
device.
MonitorProvides administrative monitoring
of the GroupWise agents.
AgentsNecessary for each new domain and
post office that you create.
Calendar Publishing
Host
GroupWise Clients
(Windows, Linux, and
Mac)
Provides public access to personal
GroupWise calendars and free/busy
availability to Internet users.
Can be rolled out to all GroupWise
users on a convenient schedule.
Chapter 5, “Installing GroupWise
WebAccess,” on page 101
Chapter 7, “Installing GroupWise
Monitor,” on page 155
Chapter 8, “Installing GroupWise
Agents,” on page 177
Chapter 6, “Installing the GroupWise
Calendar Publishing Host,” on page 133
Chapter 9, “Installing the GroupWise
Clients,” on page 225
In addition to the sections referenced in the above table, this Installation Guide includes the
following supplemental sections:
Chapter 10, “Installing GroupWise Messenger,” on page 235
Chapter 11, “Installing GroupWise Mobile Server,” on page 237
Chapter 12, “Installing Novell Teaming and Conferencing,” on page 239
The information in these sections is provided as a reference for installing additional components
after you’ve created your basic GroupWise system.
18GroupWise 8 Installation Guide
2
GroupWise System Requirements
You, as a GroupWise® administrator, must ensure that your system meets GroupWise system
requirements, so that your GroupWise system can be set up successfully. After your GroupWise
system is set up, you must ensure that users’ workstations meet GroupWise client requirements, so
that users can run the GroupWise clients successfully.
Section 2.1, “GroupWise Administration Requirements,” on page 19
Section 2.2, “GroupWise Client Requirements,” on page 21
Section 2.3, “Supported Environments,” on page 22
2.1 GroupWise Administration Requirements
32-bit/x86 processor or 64-bit/x86
On a 64-bit processor, GroupWise still runs as a 32-bit application.
Any of the following server operating systems for the GroupWise agents (Post Office Agent,
Message Transfer Agent, Internet Agent, WebAccess Agent, Monitor Agent):
Novell
NetWare 6.5, plus the latest Support Pack
®
Open Enterprise Server (OES) 2 (NetWare® or Linux version), plus the latest
Support Pack
novdocx (en) 22 June 2009
2
NOTE: The Monitor Agent is not available for NetWare.
SUSE
Windows Server* 2003, Windows Server 2003 R2, Windows Server 2008, or Windows
Adequate server memory as required by the operating system
eDirectory
ConsoleOne
GroupWise 8 includes ConsoleOne 1.3.6h for Windows and for Linux on the GroupWise 8
DVD or downloaded GroupWise 8 image.
ConsoleOne requires Java* Virtual Machine (JVM*) 1.5.11 or later.
On Windows, ConsoleOne also requires the Novell Client
version 4.91 SP3 or later of the Novell Client. If necessary, you can download the latest Novell
Client from the Novell Product Downloads site (http://download.novell.com).
On Linux, ConsoleOne also requires the X Window System, version X11R6 or later.
Any of the following environments for running ConsoleOne and the GroupWise Installation
program:
Windows XP, Windows Vista*, or Windows 7, plus the latest Service Pack, plus the
®
Linux Enterprise Server (SLES) 10 or SLES 11, plus the latest Support Pack
The X Window System* and Open Motif* are required by the GUI GroupWise agent
server consoles for the Post Office Agent, the Message Transfer Agent, and the Internet
Agent. By default, the GroupWise agents run as daemons without user interfaces.
Server 2008 R2, plus the latest Service Pack
TM
8.7 or later, plus the latest Support Pack, with LDAP enabled
®
1.3.6h or later, with the LDAP snap-in installed
TM
. ConsoleOne 1.3.6h requires
Novell Client
GroupWise System Requirements
19
Windows Server 2003, Windows Server 2003 R2, Windows Server 2008, or Windows
Server 2008 R2, plus the latest Service Pack, plus the Novell Client
Novell Open Enterprise Server (OES) 2 (Linux version), plus the latest Support Pack
SUSE Linux Enterprise Server (SLES) 10 or SLES 11, plus the latest Support Pack
The X Window System is required by the GUI GroupWise Installation program that steps
you through the process of creating a new GroupWise system. A text-based Installation
program is also available.
Adequate server disk space:
Software distribution directory: 500 MB for all GroupWise components in one language
Domain directory: 100-200 MB for the domain database, plus 1 GB or more for message
queues when links are down
Post office directory: 5 MB per user (minimum); 100 MB or more per user
(recommended); plus 100-300 MB for the post office database; plus 500 MB or more for
message queues when links are down
MTA/POA installation: approximately 25 MB (varies by platform)
Internet Agent installation: approximately 37 MB (varies by platform)
WebAccess installation: approximately 215 MB (111 MB shared with Monitor; varies by
platform)
novdocx (en) 22 June 2009
Monitor installation: approximately 140 MB (111 MB shared with WebAccess; varies by
platform)
Calendar Publishing Host installation: approximately 7 MB, plus 50 KB per published
calendar and 50 KB per user for free/busy searching
Internet connectivity for the Internet Agent
Internet domain name for your company
Internet Service Provider (ISP) or in-house DNS address resolution
Any of the following Web servers for WebAccess, Monitor, and the Calendar Publishing Host:
NetWare 6.5: Apache 2.0 plus:
Tomcat 4.1 or later
JVM 1.4.2 or later
Jakarta Connector 1.2 or later
Linux: Apache 2.2 plus:
Tomcat 5.0 or later
JVM 1.4.2 or later
ModProxy Module
Windows Server 2003/2003 R2: Microsoft Internet Information Server (IIS) 6 or later
plus:
Tomcat 5.5 or later
JVM 1.5 or later
Jakarta Connector 1.2 or later
20GroupWise 8 Installation Guide
Windows Server 2008/2008 R2: Microsoft Internet Information Server (IIS) 7 or later
plus:
Tomcat 5.5 or later
JVM 1.5 or later
Jakarta Connector 1.2 or later
Any of the following Web browsers for the agent Web consoles:
Linux: Mozilla* Firefox*
Windows: Microsoft Internet Explorer* 6.0 or later; Mozilla Firefox
Macintosh: The latest version of Safari* for your version of Mac OS*; Mozilla Firefox
2.2 GroupWise Client Requirements
Section 2.2.1, “Windows Client,” on page 21
Section 2.2.2, “Linux Client,” on page 21
Section 2.2.3, “Mac Client,” on page 21
Section 2.2.4, “WebAccess Client,” on page 22
novdocx (en) 22 June 2009
2.2.1 Windows Client
32-bit/x86 processor or 64-bit/x86 processor
On a 64-bit processor, GroupWise still runs as a 32-bit application.
Any of the following desktop operating systems for the GroupWise Windows client:
Windows XP on a 300 MHz or higher workstation with at least 128 MB of RAM
Windows Vista* on a 1 GHz or higher workstation with at least 1 GB of RAM
Windows 7 on a 1 GHz or higher workstation with at least 1 GB of RAM
200 MB of free disk space on each user’s workstation to install the Windows client
2.2.2 Linux Client
32-bit/x86 processor or 64-bit/x86 processor
On a 64-bit processor, GroupWise still runs as a 32-bit application.
SUSE Linux Enterprise Desktop (SLED) 10 or SLED 11, plus the KDE* desktop or the
GNOME* desktop
200 MB of free disk space on each user’s workstation to install the Linux client
2.2.3 Mac Client
32-bit/x86 processor or 64-bit/x86 processor; PowerPC
On a 64-bit processor, GroupWise still runs as a 32-bit application.
Any of the following desktop operating systems:
Mac OS 10.4 (Tiger*), Mac OS 10.5 (Leopard)
GroupWise System Requirements21
Mac OS X for Intel*
Mac OS X for PowerPC
Apple Java Virtual Machine (JVM) 1.5 or later
75 MB of free disk space on each user’s workstation to install the Mac client
2.2.4 WebAccess Client
Any of the following Web browsers:
Linux: Mozilla Firefox
Windows: Microsoft Internet Explorer 6.0 or later; Mozilla Firefox
Macintosh: The latest version of Safari for your version of Mac OS; Mozilla Firefox
Any mobile device that supports Wireless Access Protocol (WAP) and has a microbrowser that
supports Hypertext Markup Language (HTML) 4.0 or later, or Wireless Markup Language
(WML) 1.1 or later
2.3 Supported Environments
novdocx (en) 22 June 2009
Section 2.3.1, “IPV6 Support,” on page 22
Section 2.3.2, “Clustering Support,” on page 22
Section 2.3.3, “Xen Virtualization Support,” on page 23
Section 2.3.4, “VMware Support,” on page 23
Section 2.3.5, “Citrix Support,” on page 23
Section 2.3.6, “Domain Services for Windows Support,” on page 23
Section 2.3.7, “Linux File System Support,” on page 24
2.3.1 IPV6 Support
The POA, the MTA, the Internet Agent, and the Monitor Agent support the IPV6 protocol when it is
available on the server. If it is available, the agent detects it and supports IPV6 by default, along with
IPV4. The WebAccess Agent and its accompanying Viewer Agent do not support IPV6.
As you configure your GroupWise system and specify the network address of an IPV6 server in
ConsoleOne, you must specify its DNS hostname. IP Address fields in ConsoleOne do not
accommodate IPV6 address format.
IPV6 support is available on Linux and Windows. IPV6 support is not currently available on
NetWare.
2.3.2 Clustering Support
You can set up your GroupWise system in any of the following clustering environments, as
described in the GroupWise 8 Interoperability Guide:
“Novell Cluster Services on NetWare”
“Novell Cluster Services on Linux”
“Microsoft Clustering Services on Windows”
22GroupWise 8 Installation Guide
If you are using one of these clustering environments, follow the installation instructions in the
GroupWise 8 Interoperability Guide, rather than the installation instructions in this guide.
2.3.3 Xen Virtualization Support
You can install components of your GroupWise system in virtual environments where a software
program enables one physical server to function as if it were two or more physical servers. Xen*
virtualization technology in Novell Open Enterprise Server (Linux version) and SUSE Linux
Enterprise Server is supported. For more information, see:
Open Enterprise Server 2 Virtualization Documentation Web site (http://www.novell.com/
SLES Virtualization Technology Documentation Web site (http://www.novell.com/
documentation/vmserver).
Large post offices with busy POAs are not good candidates for virtualization. Specialized POAs,
such as an indexing POA with no mailboxes and users, could be virtualized. Other GroupWise
components such as the MTA, Internet Agent, and WebAccess Agent do well when virtualized.
novdocx (en) 22 June 2009
2.3.4 VMware Support
GroupWise is supported on the following versions of VMware*:
VMware Server (formally GSX Server), an enterprise-class virtual infrastructure for x86-based
servers
VMware ESX Server, a data center-class virtual infrastructure for mission-critical
environments
For more information, see the VMWare Web site (http://www.vmware.com).
2.3.5 Citrix Support
Any version of the GroupWise client runs successfully on any 32-bit version of Citrix* terminal
services.
The GroupWise agents run successfully on Citrix XenServer*.
For more information, see the Citrix Web site (http://www.citrix.com).
2.3.6 Domain Services for Windows Support
Starting in GroupWise 8 SP1, GroupWise can be installed on the same server with Novell Domain
Services for Windows (DSfW), and GroupWise objects can be created in a DSfW partition. DSfW
uses ports 1389 and 1636 instead of the typical default ports of 389 and 636 for LDAP. The
GroupWise 8 SP1 Installation program detects the presence of DSfW and automatically adjusts the
LDAP port numbers that are used when installing the Internet Agent, WebAccess, and Monitor.
NOTE: Earlier versions of GroupWise cannot be installed on a DSfW server, nor can earlier
versions of GroupWise eDirectory objects be created in a DSfW partition. However, GroupWise
objects can still be created in an eDirectory tree that has a DSfW partition, as long as you do not try
to create the GroupWise objects in the DSfW partition.
GroupWise System Requirements23
2.3.7 Linux File System Support
novdocx (en) 22 June 2009
For best GroupWise performance on Linux, the
running OES Linux and need the feature-rich environment of the NSS file system, GroupWise is
also supported there. The
reiser3
file system is also supported.
ext3
file system is recommended. If you are
24GroupWise 8 Installation Guide
3
Installing a Basic GroupWise
novdocx (en) 22 June 2009
System
Every Novell® GroupWise® system, whether it services five users or 50,000 users, starts as a basic
GroupWise system. The following sections present the background information and installation
instructions you need to successfully implement your basic GroupWise system.
Section 3.1, “Basic System Overview,” on page 25
Section 3.2, “Planning a Basic GroupWise System,” on page 26
Section 3.3, “Setting Up a Basic GroupWise System,” on page 48
Section 3.4, “What’s Next,” on page 68
Section 3.5, “Basic GroupWise System Summary Sheet,” on page 69
IMPORTANT: If you plan to install GroupWise in a clustered server environment, see the
GroupWise 8 Interoperability Guide before starting to set up your GroupWise system.
3.1 Basic System Overview
A basic GroupWise system consists of a single domain (the primary domain) with one post office, a
document library, and one or more users, as shown below.
3
Figure 3-1 Basic GroupWise System
Each GroupWise user has a mailbox in the post office; users run the GroupWise client (Windows,
Linux, Mac, or WebAccess) in order to access their mailboxes and to send and receive mail.
The GroupWise Post Office Agent (POA) responds to the GroupWise clients’ requests for mailbox
data and delivers messages between users’ mailboxes in a post office. The GroupWise Message
Transfer Agent (MTA) routes messages between post offices (if there is more than one post office in
the domain) and between domains (if there is more than one domain in the system).
Installing a Basic GroupWise System
25
After you finish setting up your basic GroupWise system, you can review Section 3.4, “What’s
Next,” on page 68 to learn how you can expand your GroupWise system.
3.2 Planning a Basic GroupWise System
The GroupWise Installation program helps you install the GroupWise software to the appropriate
locations and helps you create and configure your basic GroupWise system (primary domain, post
office, and agents).
If you are comfortable with your knowledge of GroupWise, you can skip this planning section and
continue with Section 3.3, “Setting Up a Basic GroupWise System,” on page 48. Otherwise, you
should use the “Basic GroupWise System Summary Sheet” on page 69 to record your decisions
about how to set up your basic GroupWise system. The topics in this section present the required
information in a convenient planning sequence. The Installation Summary Sheet organizes the
information in the order in which you need it during installation and setup.
Section 3.2.1, “Determining Installation Locations,” on page 26
Section 3.2.2, “Planning Your Primary Domain,” on page 30
Section 3.2.3, “Planning Your Post Office,” on page 36
Section 3.2.4, “Planning Your GroupWise Agents,” on page 39
novdocx (en) 22 June 2009
Section 3.2.5, “Sample GroupWise Configurations,” on page 45
For additional assistance in planning your GroupWise installation, see GroupWise Best Practices
(http://wiki.novell.com/index.php/GroupWise).
IMPORTANT: If you plan to install GroupWise in a clustered server environment, refer to the
GroupWise 8 Interoperability Guide as you plan your GroupWise system.
3.2.1 Determining Installation Locations
The GroupWise Installation program prompts you for information about the Novell eDirectoryTM
tree where you plan to create GroupWise objects and the network server locations where you plan to
create GroupWise directories and install software.
“Novell eDirectory” on page 26
“ConsoleOne” on page 27
“GroupWise Software Distribution Directory” on page 28
“Agent Platform” on page 30
Novell eDirectory
GroupWise is administered through eDirectory, the directory service provided by Novell. All
components, such as domains, post offices, libraries, and agents, as well as all users’ GroupWise
accounts, are configured through objects in eDirectory. You need to make sure that you have
eDirectory installed in your environment. eDirectory can be installed on NetWare
Windows.
®
, Linux, or
26GroupWise 8 Installation Guide
GroupWise 8 includes the Novell eDirectory CD or downloadable ISO image to assist those who do
not already have eDirectory installed and want to install it on Linux or Windows. Follow the
instructions in the Novell eDirectory Installation Guide (http://www.novell.com/documentation/
®
edir88) to install eDirectory, along with its latest Support Pack, and ConsoleOne
before proceeding
to install your basic GroupWise system.
“Accessing the eDirectory Tree” on page 27
“Making Sure Users Exist in eDirectory” on page 27
Accessing the eDirectory Tree
In order to access the eDirectory tree, the GroupWise Installation program needs the IP address or
DNS hostname of a server where a replica of the tree can be found. It also needs an eDirectory
username with Admin-equivalent rights, the password for the username, and the eDirectory context
where the User object can be found. Some parts of the installation process require LDAP
authentication to eDirectory, so LDAP must be enabled on your eDirectory server.
The GroupWise Installation program must extend the schema of the eDirectory tree where you plan
to create your GroupWise system. Because all objects for a single GroupWise domain must reside in
the same eDirectory tree, installing a basic system (one domain) requires you to extend one tree
only.
novdocx (en) 22 June 2009
BASIC GROUPWISE SYSTEM SUMMARY SHEET
Under eDirectory Settings, specify the IP address or DNS hostname of a server where a replica of the
eDirectory tree resides. Also provide the authentication information so that the GroupWise Installation
program can access the eDirectory tree and extend the schema.
Making Sure Users Exist in eDirectory
You must make sure all users who will use GroupWise exist in eDirectory. GroupWise accounts can
only be assigned to eDirectory User objects and GroupWise External Entity objects.
NOTE: GroupWise external entities represent non-eDirectory users and are added to eDirectory for
the sole purpose of assigning GroupWise accounts to these users. GroupWise external entities
require GroupWise licenses but not eDirectory licenses. You can add GroupWise external entities
only after you have installed GroupWise.
ConsoleOne
GroupWise administration is performed through ConsoleOne, using the version listed in
Section 2.1, “GroupWise Administration Requirements,” on page 19. When you install GroupWise,
the GroupWise Administrator snap-ins are copied into an existing ConsoleOne installation. The
GroupWise Administrator snap-ins extend the functionality of ConsoleOne to let you administer
GroupWise. ConsoleOne considerations differ by platform:
Installing a Basic GroupWise System27
novdocx (en) 22 June 2009
NetWare and
Windows:
For a GroupWise system on NetWare or Windows, you need to decide which
ConsoleOne location you want to use to administer GroupWise. This can be a
ConsoleOne location on a network server, or it can be on a local workstation. If you plan
to use ConsoleOne on a local workstation, you need to perform the GroupWise
installation from that workstation.
For your convenience, ConsoleOne is included on the GroupWise 8 DVD or
downloaded GroupWise 8 image. The GroupWise Installation program lets you install
ConsoleOne if necessary. You can also use the GroupWise Installation program at a
later time to install ConsoleOne and the GroupWise Administrator snap-ins to additional
locations.
The default ConsoleOne installation directory is:
drive:\Novell\ConsoleOne
IMPORTANT: For a GroupWise system on NetWare, you cannot run ConsoleOne to
administer GroupWise at the NetWare server console. The GroupWise Administrator
snap-ins to ConsoleOne do not run in that environment.
Linux:For a GroupWise system on Linux, ConsoleOne must already be installed before you
set up your GroupWise system.
For your convenience, ConsoleOne is included on the GroupWise 8 DVD or
downloaded GroupWise 8 image in the
ConsoleOne, copy the ConsoleOne
contents of the file, change to the
time, you can install ConsoleOne to additional Linux locations.
/linux/consoleone
.tar.gz
Linux
file to a temporary location, extract the
subdirectory, then run
directory. To install
c1-install
. At a later
The required ConsoleOne installation directory is:
/usr/ConsoleOne
BASIC GROUPWISE SYSTEM SUMMARY SHEET
Under ConsoleOne Directory, specify the path for the ConsoleOne location you want to use to administer
GroupWise.
For more information about ConsoleOne, see “ConsoleOne Administration Tool” in “System” in the
GroupWise 8 Administration Guide.
GroupWise Software Distribution Directory
During installation, you are prompted to create a GroupWise software distribution directory on a
network server and then copy selected GroupWise software components to the directory.
You should consider the following when deciding where to create the software distribution
directory:
“User Access to the Directory” on page 29
“Disk Space Required for the Software” on page 29
“Default Software Distribution Directory Location” on page 29
28GroupWise 8 Installation Guide
User Access to the Directory
User access considerations depend on which GroupWise client users are running:
novdocx (en) 22 June 2009
Windows
Client:
Linux/Mac
Client:
WebAccess
Client:
Users can install the GroupWise Windows client through a TCP/IP or mapped connection
to the software distribution directory. If you want users to install via a mapped connection,
you should create the software distribution directory on a server where you can provide
appropriate user access.
Users can install the GroupWise Linux/Mac client from the GroupWise 8 DVD, from the
downloaded GroupWise 8 image, or from the software distribution directory, which requires
user access to the file system where the software distribution directory is located.
The GroupWise WebAccess client does not require that users install any GroupWise
software on their workstations.
Disk Space Required for the Software
The disk space required for the directory depends on which software components you copy to the
directory. The maximum disk space required to store all the GroupWise software components for
one language is approximately 500 MB. For a breakdown by component, see Section 2.1,
“GroupWise Administration Requirements,” on page 19.
We recommend that you copy at least the GroupWise client files to the directory. This enables users
to install the GroupWise client from the distribution directory. Otherwise, you need to mount the
GroupWise 8 DVD or downloaded GroupWise 8 image as a network volume or file system, or
distribute the DVD to individual users, unless you use one of the software distribution methods
described in “Distributing the GroupWise Client” in “Client” in the GroupWise 8 Administration
Guide.
NOTE: On Linux, you should install the GroupWise Administration component to your software
distribution directory. It includes the RPMs for GroupWise Check (GWCheck) and the GroupWise
Database Copy utility (DBCopy). These RPMs are not installed by the GroupWise Installation
program. For more information about these utilities, see “Standalone Database Maintenance
Programs” in “Databases” in the GroupWise 8 Administration Guide.
Default Software Distribution Directory Location
The default location for the software distribution directory varies by platform:
NetWare:
Linux:
Windows:
BASIC GROUPWISE SYSTEM SUMMARY SHEET
Under Software Distribution Directory, specify the path for the software distribution directory.
Under Software Selection, mark the software components that you want to copy there.
drive:\grpwise\software
/opt/novell/groupwise/software
drive:\grpwise\software
Installing a Basic GroupWise System29
The GroupWise Installation program lets you create one software distribution directory. After you
set up your basic GroupWise system, you can create additional software distribution directories if
needed. For example, if not all users can access a single software distribution directory to run the
GroupWise Windows client Setup program, you can create an additional software distribution
directory on a server they can access. For information about creating additional software distribution
directories, see “Software Directory Management” in “System” in the GroupWise 8 Administration
Guide.
Agent Platform
The Message Transfer Agent (MTA) and the Post Office Agent (POA) are available as NetWare
TM
NLM
programs, Linux executables, and Windows executables.
In general, GroupWise is most efficient if you match the agent platform with the network operating
system where the domain and post office are located. For example, if a domain and post office are
located on a NetWare server, then you would install the NetWare agents for them. However, this is
not required. For configuration examples, see Section 3.2.5, “Sample GroupWise Configurations,”
on page 45.
novdocx (en) 22 June 2009
BASIC GROUPWISE SYSTEM SUMMARY SHEET
Under Agent Software Platform, specify the type of agents (NetWare, Linux, or Windows) you want to
use.
3.2.2 Planning Your Primary Domain
The primary domain functions as the main administration unit for the GroupWise system. Domains
that you create after the first domain are secondary domains.
When you configure GroupWise information in eDirectory, it is also stored in the GroupWise
domain database. From the domain database, the GroupWise agents distribute the information to
each post office database. Users then get the information, such as user addresses, from the post
office database. Domains can be located on NetWare, Linux, and Windows servers.
In a multiple-post-office system, the domain also organizes post offices into a logical grouping for
addressing and routing purposes, and enables you to scale your GroupWise system to meet your
current and future needs.
As you create your basic GroupWise system, the Installation program prompts you for information
about the primary domain.
“System and Domain Names” on page 30
“Domain Directory” on page 31
“Domain Context” on page 32
“Domain Language” on page 35
“Domain Time Zone” on page 36
System and Domain Names
Each domain requires a unique name. The name is used as the Domain object’s name in eDirectory.
It is also used for addressing and routing purposes within GroupWise, and can appear in the
GroupWise Address Book. The domain name can reflect a location, company name or branch name,
30GroupWise 8 Installation Guide
Loading...
+ 304 hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.