GroupWise is a cross-platform, corporate email system that provides secure messaging, calendaring, and scheduling. GroupWise also includes task management, contact management, document management, and other productivity tools. Companion products provide secure instant messaging (GroupWise Messenger), synchronization with mobile devices (GroupWise Mobility Service), and teaming workspaces (Micro Focus Vibe) for robust enterprise connectivity and collaboration.
Your GroupWise system can run on Linux or Windows, or a combination of these operating systems. GroupWise users can access their mailboxes from their Windows desktops, in a web browser anywhere an Internet connection is available, on tablet devices such as the Apple iPad, and on mobile devices.
This Quick Start provides a high-level road map for novice GroupWise administrators and a concise checklist of essentials for experienced GroupWise administrators. For complete system requirements and installation instructions, see the GroupWise 18 Installation Guide.
All GroupWise documentation is available on the sites below. For the latest version of this Quick Start, see GroupWise 23.4 Administrator Quick Start.
Known issues and new release features for GroupWise base components (client and administration).
Detailed system requirements and installation instructions for GroupWise system creation and for installation of all additional GroupWise components.
Creation and management of GroupWise domains, post offices, users, and all other GroupWise objects; configuration and optimization of all GroupWise agents and web applications; rollout strategies for the GroupWise Windows client.
How to use GroupWise in the context of other products, such as OES Cluster Services, Microsoft Failover Clustering, GroupWise Messenger, Micro Focus Vibe, and Micro Focus ZENworks.
Complete instructions for using the GroupWise client; also available in the client by clicking> , or by simply pressing F1 with the Client in focus.
Complete instructions for using GroupWise Web in a desktop web browser.
A GroupWise system consists of domains, post offices, users, and agents.
The Post Office Agent (POA) delivers messages between users’ mailboxes in each post office.
The Message Transfer Agent (MTA) routes messages between post offices and domains.
The Internet Agent (GWIA) transfers messages to and from the Internet.
The Document Viewer Agent (DVA) converts attached document files into HTML format for indexing by the POA and for display in the GroupWise Client and in GroupWise Web.
A snapshot of GroupWise system requirements are provided below. For comprehensive requirements, see the GroupWise 18 Installation Guide.
Base server requirements can be found in the GroupWise 18 Installation Guide.
One or more of the following directories:
Micro Focus eDirectory 9.1 or later, with LDAP enabled (optional)
You can download eDirectory from the Micro Focus Downloads site.
Microsoft Active Directory (optional)
Native GroupWise directory (internal; required)
Any of the following web browsers for the GroupWise Administration console and agent consoles:
Linux: Mozilla Firefox; Google Chrome
Windows: Mozilla Firefox; Microsoft Edge with Chromium Edge; Google Chrome
Macintosh: Mozilla Firefox; Google Chrome; Safari
Adequate server memory as required by the operating system and by the GroupWise agents on the server
For details, see GroupWise 18 Installation Guide.
On a machine that meets the GroupWise system requirements:
Start the GroupWise Installation Wizard in the downloaded GroupWise 18 software image:
Follow the on-screen instructions to create your initial GroupWise system:
Create the primary domain and configure if for the Message Transfer Agent.
(Optional) Create a post office and configure the Post Office Agent.
(Optional) Set up the Internet Agent (GWIA) to provide Internet access.
(Optional) Set up the Document Viewer Agent (DVA) to provide viewing and indexing services.
After you create the primary domain, you typically create secondary domains and post offices on additional servers.
For compete setup instructions, see GroupWise 18 Installation Guide. For maintenance information, see the following sections in the in the GroupWise 18 Administration Guide:
Each GroupWise user has a mailbox in a post office. In a corporate workplace environment, users with Windows workstations can run the GroupWise client to access their mailboxes and to send and receive mail.
A snapshot of GroupWise Client requirements are provided below. Note that the OS requirements shown for the Client encompass both the latest version of GroupWise and several legacy versions and are not all applicable to every GroupWise version. To see specific supported operating systems by version, see GroupWise Installation Guide.
x86-32 processor or x86-64 processor
On a 64-bit processor, GroupWise still runs as a 32-bit application.
Any of the following desktop operating systems for the GroupWise client:
Windows 7 on a 1 GHz or higher workstation with at least 1 GB of RAM
Windows 8 or Windows 8.1 on a 1 GHz or higher workstation with at least 1 GB of RAM
Windows 10 on a 1 GHz or higher workstation with at least 1 GB of RAM
Windows 11 on a 1 GHz or higher workstation with at least 1 GB of RAM
Approximately 200 MB of free disk space on each user’s workstation to install the GroupWise client.
At a Windows workstation that meets the client requirements:
Run the GroupWise Installation Wizard (gw18.x.x_client_win_multi.exe).
Clickto start the GroupWise Client Setup Wizard.
Follow the on-screen instructions to install the GroupWise client software on your workstation.
The Installation Wizard adds a GroupWise client icon to your desktop.
Double-click the GroupWise client icon to start the GroupWise client.
For system-wide rollout of the GroupWise Client software, you will probably not provide the downloaded software image to each GroupWise user. See GroupWise 18 Administration Guide for various client rollout alternatives, including the use of Micro Focus ZENworks.
GroupWise Web enables GroupWise users to access their GroupWise mailboxes through web browsers, on tablet devices, and on mobile phones.
GroupWise Web integrates into your web server so that GroupWise mailbox information can be displayed in your web browser or on your tablet device or mobile device. The application communicates with the POA to obtain the mailbox information and with the DVA to convert documents into HTML format for viewing in your mobile environment.
GroupWise Web is delivered via Docker containers to our customers, enabling them to install and manage their Web installations on any Docker supported platform. For detailed instructions to install Docker and GroupWise Web, see GroupWise Installation Guide.
NOTE:GroupWise Web replaced GroupWise WebAccess in GroupWise 18.2 and later and is regularly enhanced and updated. WebAccess is no longer maintained or supported as of GroupWise 18.3. However, setup instructions for WebAccess are still available in GroupWise Installation Guide.
The GroupWise Calendar Publishing Host enables GroupWise users to publish their GroupWise Calendars and free/busy status on the Internet, so that non-GroupWise users can see their schedules and availability. This helps non-GroupWise users schedule convenient appointments with GroupWise users.
For installation instructions, see GroupWise 18 Installation Guide. For maintenance instructions, see GroupWise 18 Administration Guide.
You can use the GroupWise Mobility Service to synchronize email and other personal information manager (PIM) data from GroupWise to mobile devices that support Microsoft ActiveSync protocol 12.x.
Supported mobile device operating systems include:
Android 3.x and 4.x
Apple iOS 5.x, 6.x, and 7.x
Windows Phone 7
Windows 8 (Phone, Tablet, and Desktop)
For installation instructions, see the GroupWise Mobility Service 18 Installation Guide. For maintenance instructions, see the GroupWise Mobility Service 18 Administration Guide.
GroupWise Messenger is a cross-platform, corporate-based, secure instant messaging solution that supports instant messaging, presence, chat rooms, broadcasts, and archiving of conversations for GroupWise users. Messenger runs on Linux and Windows.
For basic instructions, see the GroupWise and Messenger Quick Start. For more detailed information, see the GroupWise Messenger 18 Installation Guide and the GroupWise Messenger 18 Administration Guide.
Micro Focus Vibe enhances GroupWise by providing easy document management and sharing, team calendars and task lists, workflows, discussion threads, wikis, blogs, RSS feeds, and more.
GroupWise Monitor is a monitoring and management tool that allows you and other GroupWise administrators to monitor GroupWise agents from any location where you are connected to the Internet and have access to a web browser. Some agent administration can also be performed from your web browser.
More detailed Monitor requirements are listed in the GroupWise 18 Installation Guide.
Start the GroupWise Installation Wizard, as described in GroupWise System Creation.
On Linux, enter> .
On Windows, click.
Follow the on-screen instructions to install the Monitor Agent to a Linux or Windows server.
(Optional) Install the Monitor Application to the web server of your choice, if you want to be able to monitor the agents from outside your firewall.
On Windows, the Installation Wizard can immediately start the Monitor Agent and web server for you.
(Conditional) On Linux, restart Apache and Tomcat if you installed the Monitor Application.
(Optional) To display the main Monitor web console in your web browser either inside or outside your firewall, use the following URL:
Replace web_server_address with the IP address or DNS hostname of your web server.
To display the more full-featured Monitor Agent console in your web browser, use the following URL:
The Monitor Agent console, provided by the Monitor Agent itself, can be accessed only from behind your firewall.
Clustering ensures high availability and manageability of critical network resources by providing failover, failback, and migration (load balancing) capabilities for clustered resources. By setting up post offices in a cluster, you ensure that GroupWise users can always access their mailboxes. By setting up the Internet Agent (GWIA) in a cluster, you ensure that GroupWise users can always send mail across the Internet.
GroupWise can be installed in clusters on Linux and Windows. For more information, see GroupWise 18 Interoperability Guide.
Updates to your GroupWise software are provided on the Micro Focus Downloads page.
Follow the installation instructions in the Readme for each GroupWise Support Pack, keeping in mind the following important guidelines:
Always update your primary domain first.
When you update any domain, always start the MTA first (before any updated POAs) so that the domain database is fully updated.
After you update a domain and start the MTA for it, start the updated POAs for the post offices that belong to the updated domain.
© Copyright 1993 - 2023 Micro Focus or one of its affiliates.
The only warranties for products and services of Micro Focus and its affiliates and licensors (“Micro Focus”) are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. Micro Focus shall not be liable for technical or editorial errors or omissions contained herein. The information contained herein is subject to change without notice.