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.
Page 3
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.
Contents About This Guide Part I Installation 1 What Is GroupWise? What GroupWise Provides ........... . 17 1.1.1 Essential Communication and Collaboration Services .
Page 6
Planning the GroupWise Internet Agent......... . 84 4.3.1 Selecting the Internet Agent Platform .
Page 7
6.4.3 Completing Optional Post-Installation Tasks ......152 Using GroupWise Monitor ........... 153 6.5.1 Monitor Agent Server Console on a Windows Server .
Page 8
Improved Backup Capabilities with Novell Cluster Services on NetWare (v7.0.1) . 221 12.1.10 Simplified Installation Procedure for Novell Cluster Services on Linux (v7.0.1) . . . 221 12.1.11 PolyServe Matrix Server Support (v7.0.1) ....... . 222 12.2...
Page 9
New Novell Web Services Page (v7.0) ........
Page 11
20 Manually Migrating a Post Office and Its POA to Linux 20.1 Preparing for the Post Office Migration ......... 273 20.2 Performing the Post Office Migration .
Page 12
B.10 Python 2.2 ............. . . 322 C Documentation Updates March 14, 2008 (GroupWise 7 SP3) .
Interoperability Guide Troubleshooting Guides GroupWise Client User Guides GroupWise Client Frequently Asked Questions (FAQ) Documentation Conventions In Novell documentation, a greater-than symbol (>) is used to separate actions within a step and items in a cross-reference path. About This Guide...
Page 14
® A trademark symbol ( , 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.
Installation Chapter 1, “What Is GroupWise?,” on page 17 Chapter 2, “GroupWise System Requirements,” on page 21 Chapter 3, “Installing a Basic GroupWise System,” on page 25 Chapter 4, “Installing the GroupWise Internet Agent,” on page 79 Chapter 5, “Installing GroupWise WebAccess,” on page 103 Chapter 6, “Installing GroupWise Monitor,”...
What Is GroupWise? ® ® Novell GroupWise is an enterprise collaboration system that provides secure e-mail, calendaring, scheduling, and instant messaging. GroupWise also includes task management, contact management, document management, and other productivity tools. GroupWise can be used on your desktop on Linux, Windows*, or Macintosh*;...
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 book. In addition, you can view a history of messages sent to and received from individual contacts.
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 Do GroupWise includes multiple components that you need to install to realize the full benefits of GroupWise.
Page 20
The information in these sections is provided as a reference for installing additional components after you’ve created your basic GroupWise system. GroupWise 7 Installation Guide...
(http://download.novell.com). Windows 2000/XP/2003/2003 R2 and the Novell Client on any administrator Windows machine where you run ConsoleOne or the GroupWise Installation program If necessary, you can download the Novell Client from the Novell Product Downloads site (http://download.novell.com). GroupWise System Requirements...
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);...
2.2.2 Cross-Platform Client on Linux Any of the following desktop operating systems: Novell Linux Desktop, plus the KDE desktop or the GNOME* desktop SUSE Linux Enterprise Desktop 10, plus the KDE desktop or the GNOME desktop Red Hat* Desktop 4 or Red Hat Enterprise Linux WS 4, plus the GNOME desktop Java Virtual Machine (JVM) 1.5 or later...
2.3.2 Clustering Support You can set up your GroupWise system in any of the following clustering environments, as described in the GroupWise 7 Interoperability Guide (http://www.novell.com/documentation/gw7): “Novell Cluster Services on NetWare” “Novell Cluster Services on Linux” “Microsoft Clustering Services on Windows”...
Section 3.4, “What’s Next,” on page 72 Section 3.5, “Basic GroupWise System Worksheet,” on page 73 IMPORTANT: If you plan to install GroupWise in a clustered server environment, see the GroupWise 7 Interoperability Guide (http://www.novell.com/documentation/gw7) before starting to set up your GroupWise system.
“GroupWise Languages” on page 29 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.
Page 27
GroupWise 7 includes the Novell eDirectory CD to assist those who do not already have eDirectory installed and want to install it on Linux. Follow the instructions in the Novell eDirectory Installation Guide (http://www.novell.com/documentation/edir87) to install eDirectory, along with its latest ®...
Page 28
CD to individual users, unless you use one of the software distribution methods described in “Distributing the GroupWise Client” in “Client” in the GroupWise 7 Administration Guide (http://www.novell.com/documentation/gw7). GroupWise 7 Installation Guide...
Page 29
Installation program. For more information about these utilities, see “Standalone Database Maintenance Programs” in “Databases” in the GroupWise 7 Administration Guide (http:// www.novell.com/documentation/gw7). BASIC GROUPWISE SYSTEM WORKSHEET Under Item 3: Software Distribution Directory, specify the path for the software distribution directory.
Systems” in “System” in the GroupWise 7 Administration Guide (http://www.novell.com/documentation/gw7). 3.2.2 Planning Your Domain The domain functions as the main administration unit for the GroupWise system. When you configure GroupWise information in eDirectory, it is also stored in the GroupWise domain database.
Page 31
GroupWise system with which you might want to connect. The system name can be your company name (for example, Novell), GroupWise, or anything else that fits the naming scheme you want to use. The system name is displayed only in ConsoleOne so any characters can be used. You cannot change the name after your system is created.
Page 32
Linux: Use only lowercase characters Windows: No limitations. Choose the name and path carefully. After the directory is created, it is difficult to rename. If the directory you specify does not exist, it is created during installation. BASIC GROUPWISE SYSTEM WORKSHEET Under Item 8: Domain Directory, specify the full path for the domain directory.
Page 33
eDirectory Tree with the GroupWise Objects Mirroring the eDirectory Structure Figure 3-3 As in the previous example, this organizational structure allows you to quickly associate users with their post offices. In addition, if you have thousands of users split between the different organizational units, this method allows you to create multiple post offices with a smaller number of users on each post office.
Page 34
For information about GroupWise administrator rights, see “GroupWise Administrator Rights” in “Security Administration” in the GroupWise 7 Administration Guide (http://www.novell.com/ documentation/gw7). BASIC GROUPWISE SYSTEM WORKSHEET Under Item 9: Domain Context, specify the context where you want to create the Domain object. If the context does not already exist in your eDirectory tree, create the context now.
Systems” in “System” in the GroupWise 7 Administration Guide (http://www.novell.com/documentation/gw7). Domain Time Zone When a message is sent from a user in one time zone to a user in another time zone, GroupWise adjusts the message’s time so that it is correct for the recipient’s time zone. For example, if a user in New York (GMT -05:00, Eastern Time) schedules a user in Los Angeles (GMT -08:00, Pacific Time) for a conference call at 4:00 p.m.
Page 36
makes sense for your organization. For example, you might want the domain name to be the location (such as Provo) while the post office name is one of the company’s departments (such as Research). Name your post office carefully. After it is created, the name cannot be changed. Post office names must be a single string.
Page 37
You can reduce the amount of disk space required for the post office by forcing users to run the GroupWise Windows and Cross-Platform clients in Caching mode rather than Online mode. In Online mode, messages are stored only in the post office. In Caching mode, messages are also stored on users’...
Systems” in “System” in the GroupWise 7 Administration Guide (http://www.novell.com/documentation/gw7). Post Office Time Zone When a message is sent from a user in one time zone to a user in another time zone, GroupWise adjusts the message’s time so that it is correct for the recipient’s time zone. For example, if a user in New York (GMT -05:00, Eastern Time) schedules a user in Los Angeles (GMT -08:00, Pacific Time) for a conference call at 4:00 p.m.
Page 39
time, the MTA routes an administration message from the domain to the post office so that the POA can add the user to the post office database. After the user is added to the post office database, the post office’s users can see the newly added user’s information in the GroupWise Address Book POA: GroupWise requires one POA per post office, which means that you need to install and run one POA for your basic GroupWise system.
Page 40
NLM programs are in the server’s search path. If you use a different directory, you must add that directory to the server’s search path. Linux: The Linux agents are automatically installed to /opt/novell/groupwise/agents . On Linux, do not move the agent software to a different location. Windows:...
Page 41
MTA Link to the Post Office To route user and administration messages to the post office, the MTA requires a TCP/IP connection with the post office’s POA, or alternatively, direct access or a direct link (mapped drive, UNC path, or file system mount) to the post office directory. The following diagram illustrates the alternatives: MTA Link Alternatives Figure 3-9 Message...
Page 42
Systems” in “System” in the GroupWise 7 Administration Guide (http://www.novell.com/documentation/gw7). Windows Installation Option: Application vs. Service You can run the Windows MTA and POA as normal applications or as services. When you run the agents as Windows services, they must run under a specific user account. The user account you use...
The following diagram shows a basic GroupWise system set up on a single NetWare 6.x server. GroupWise System Installed on a Single NetWare 6 Server Figure 3-10 NetWare 6.x User running the c:\novell\consoleone ConsoleOne GroupWise Windows j:\provo client from the software...
Page 44
The following diagram shows the domain, post office, and software distribution directory on a server running the NetWare version of Novell Open Enterprise Server (OES). The MTA and POA, located on a Windows 2003 server, use a UNC path to access the domain directory and post office directory on the OES NetWare server.
GroupWise System Installed on an OES NetWare Server and Windows 2000 Server Figure 3-13 Open Enterprise Sever NetWare User running the GroupWise Windows client c:\novell\consoleone ConsoleOne from the software Administrator j:\software x:\software distribution Software Distribution Directory directory. j:\research Post Office (Research)
“Installing the GroupWise Administrator Snap-Ins to Additional Windows Machines” on page 60 IMPORTANT: If you plan to install GroupWise in a clustered server environment, see the GroupWise 7 Interoperability Guide (http://www.novell.com/documentation/gw7) before starting to set up your GroupWise system. Starting the GroupWise Installation Program on Windows...
Page 47
If the Installation program does not start automatically, run from the root of the setup.exe 3 Click Create or Update a GroupWise System, then click Yes to accept the license agreement and display the Welcome to GroupWise Install page. 4 Click Next until you reach the Administration Options page. Installing a Basic GroupWise System...
Page 48
5 Make sure that Create a New System or Update an Existing System is selected, then click Next. 6 Continue with Installing the GroupWise Software. Installing the GroupWise Software 1 Follow the prompts to provide the following information from your Basic GroupWise System Worksheet.
Page 49
4 Select Creating a New GroupWise System, then click Next to display the Run ConsoleOne page. 5 Continue with Providing System Information. Providing System Information The Installation Advisor launches ConsoleOne with the GroupWise Setup Advisor active. 1 On the Run ConsoleOne page, click Run to start ConsoleOne and the GroupWise Setup Advisor.
Page 50
2 Follow the prompts to provide the GroupWise system and domain information from your Basic GroupWise System Worksheet. Item 3: Software Distribution Directory Item 5: Tree Name Item 6: System Name Item 7: Domain Name Item 8: Domain Directory Item 9 Domain Context Item 10: Domain Language Item 11: Domain Time Zone 3 Follow the prompts to provide the GroupWise post office information from your...
Page 51
5 Add any users that you listed on your Basic GroupWise System Worksheet, then click Next. The Setup Advisor summarizes your overall progress. 6 Click Next to display a summary of the system, domain, post office, and link information you entered.
Page 52
7 Continue with the Creating Your Basic GroupWise System. Creating Your Basic GroupWise System After you have verified that the information you entered is correct, you are ready for the Setup Advisor to create your GroupWise system. 1 On the Summary page, click Next. The Setup Advisor creates the GroupWise system using the information you provided.
Page 53
Installing and Starting the GroupWise Agents At this point, the Setup Advisor has created GroupWise objects in eDirectory and directory structures on servers for your GroupWise system. You now need to install and start the MTA and POA on your NetWare or Windows server. 1 On the GroupWise Setup Progress page, click Next to have the Setup Advisor launch the Agent Installation program and display the Select Platform page.
Page 54
3 Select from the following options: Update AUTOEXEC File: Select this option to reference the file from the grpwise.ncf server’s file so that the GroupWise agents are automatically loaded whenever autoexec.ncf the server is started. Launch GroupWise Agents Now: Select this option to have the Installation program start the GroupWise agents for you immediately.
Page 55
Delete the semicolon (;) at the beginning of the line and replace the distinguished_object_name variable with the distinguished name of the MTA or POA. For example, if the MTA is for a domain named Provo that is located in a container named Novell, you would enter: /dn-mta.provo.novell 7 At the NetWare server console, enter to start the agents.
Page 56
4 Click Next to continue. 5 Select Install, then click Next to display the Select Platform page. 6 Select Windows, then click Next. 7 Follow the prompts to provide Windows Agent information from your Basic GroupWise System Worksheet in the order listed. Item 22: Installation Path Item 23: Windows Installation Options Item 24: Language...
Page 57
If you are running the Agent Installation program on the same server as the GroupWise Setup Advisor, the Setup Advisor passes the domain and post office information to the Agent Installation program so you are not prompted for it again. Skip to Step 9 To specify the location of your domain, click Add, select Domain, specify the domain name, provide the path to the domain directory, then click OK.
Page 58
14 Select from the following options: Update the AUTOEXEC File: This option does not apply to the Windows agents, so it is dimmed. Launch GroupWise Agents Now: This option applies only if you installed the agents as Windows applications, rather than services. Select this option to start the GroupWise agents as applications.
Page 59
2 When setup is finished, double-click the GroupWise shortcut on your desktop to start the GroupWise Windows client. Because the GroupWise client can get the location of your post office from eDirectory, and because you do not yet have a password on your mailbox, the GroupWise client starts without prompting you for post office and password information.
Installing the GroupWise Administrator Snap-Ins to Additional Windows Machines As part of creating your basic GroupWise system, the GroupWise Administrator snap-ins to ConsoleOne were installed in one location (worksheet item 2). If ConsoleOne is installed in multiple locations and if you want to be able to administer GroupWise from those locations, you need to install the GroupWise snap-ins to each ConsoleOne installation.
Page 61
70 “Installing the GroupWise Administrator Snap-Ins to Additional Linux Machines” on page 71 IMPORTANT: If you plan to install GroupWise in a clustered server environment, see the GroupWise 7 Interoperability Guide (http://www.novell.com/documentation/gw7) before starting to set up your GroupWise system.
Page 62
6 Continue with Installing the GroupWise Software. Installing the GroupWise Software 1 Click Create or Update a GroupWise System to start the Installation Advisor. The list on the left details the steps the Installation Advisor performs for you. 2 Follow the prompts to provide the following information from your Basic GroupWise System Worksheet.
Page 63
4 Select Creating a New GroupWise System, then click Next. You use the New System utility in ConsoleOne to create your basic GroupWise system. 5 Click Run to start ConsoleOne. 6 Continue with Selecting a Linux Mount Directory Selecting a Linux Mount Directory The first time you start ConsoleOne with the GroupWise Administrator snap-ins installed, you are prompted to specify a Linux mount directory under which you create mount points.
Page 64
If the Login dialog box does not appear automatically, select the NDS object, then click File > Authenticate. Login Name: Provide a Novell eDirectory username that has rights to create eDirectory objects. Password: Provide the password for the username. Tree: Type or select the eDirectory tree where you want to create GroupWise objects.
Page 65
Context: Provide the full context of the User object associated with the username you provided. 2 Under the NDS object, select the tree where you want to create the GroupWise system, then click Tools > GroupWise Utilities > New System. 3 Follow the prompts to provide the GroupWise system and domain information from your Basic GroupWise System...
Page 66
6 Add any users that you listed on your Basic GroupWise System Worksheet, then click Next. The Setup Advisor summarizes your overall progress. 7 Click Next to display a summary of the system, domain, post office, and link information you entered.
Page 67
After you have verified that the information you entered is correct, you are ready for the Setup Advisor to create your GroupWise system. 8 Click Next to create your GroupWise system. The Setup Advisor summarizes your overall progress. 9 Click Next to install the MTA and POA software. 10 Continue with Installing and Starting the Linux GroupWise Agents.
Page 68
X Window System, which is required for running GUI GroupWise agent server consoles. 2 Change to the GroupWise agent bin directory. cd /opt/novell/groupwise/agents/bin 3 Use one of the following commands to start the MTA: Syntax: ./gwmta --show --home domain_directory &...
Page 69
) in the directory. The log file mmddmta.nnn /var/log/novell/groupwise/domain.mta name includes the month and day when it was created, along with an incrementing extension to accommodate multiple log files on the same day. In ConsoleOne, you can see that the domain database has been updated by the MTA because the Version field on the Identification page of the Domain object shows 7 when the database update is complete.
Page 70
) in the directory. The log mmddpoa.nnn /var/log/novell/groupwise/post_office.poa file name includes the month and day when it was created, along with an incrementing extension to accommodate multiple log files on the same day. In ConsoleOne, you can see that the post office database has been updated by the POA because the Version field on the Identification page of the Post Office object shows 7 when the database update is complete.
Page 71
2 When the Cross-Platform client files have been copied, click OK. To start the Cross-Platform client, click its icon on your desktop. 3 Specify your GroupWise user ID, password, and the required information about the server where the POA is running (worksheet item 18), then click OK.
Messenger,” on page 213. After your GroupWise system is fully installed, you can refer to sections of the GroupWise 7 Administration Guide (http://www.novell.com/documentation/gw7) as you maintain your GroupWise system by: Adding more users to the post office. See “Users”. Defining resources that users can schedule. See “Resources”.
Connecting to other GroupWise 5.x, 6.x, or 7.x systems. See the GroupWise 7 Multi-System Administration Guide (http://www.novell.com/documentation/gw7). 3.5 Basic GroupWise System Worksheet The GroupWise Installation Advisor helps you install the GroupWise software. It then launches the GroupWise Setup Advisor, which helps you set up your first domain and post office. The Advisors prompt you for the information in this worksheet.
Page 74
Specify the name of the eDirectory tree where your domain and post office will be created. Because GroupWise introduces new objects into the tree, the eDirectory schema must be extended. “Novell eDirectory” on page 6) System Name: Specify a one-word name. Names can reflect companies, locations, and so forth.
Page 75
Item Explanation 13) Post Office Directory: Specify the path for the post office directory. If the directory does not exist, it is created. The path should be from the perspective of the machine you plan to use to install GroupWise. “Post Office Directory”...
Page 76
Item Explanation 18) POA Network Address: This item applies only if you selected TCP/IP as the post office link type (worksheet item 17). IP address or DNS hostname: Specify the IP address or DNS hostname of the POA’s server. Client/Server port: (default = 1677) By default, the POA listens for the GroupWise client on Client/ Server port 1677.
Page 77
Linux default: ensure that dependent NLM programs load properly. /opt/novell/groupwise/agents The Linux agents are automatically installed into /opt/novell/ Windows default: groupwise/agents. c:\grpwise You can install the Windows agents to any directory on the Windows server.
Section 4.5, “What’s Next,” on page 100. IMPORTANT: If you plan to install the Internet Agent in a clustered server environment, see the GroupWise 7 Interoperability Guide (http://www.novell.com/documentation/gw7) before you install the Internet Agent. 4.1 GroupWise Internet Agent Overview The Internet Agent allows communication between GroupWise users and users of other messaging systems who send e-mail across the Internet.
Page 80
GroupWise Internet Agent Connecting a GroupWise System to the Internet Figure 4-1 Internet Domain GWIA Domain Domain Domain Choose from the following list of topics to learn more about the capabilities of the GroupWise Internet Agent. “SMTP/MIME Service” on page 81 “POP3 Service”...
Page 81
SMTP/MIME Service The SMTP/MIME service in the Internet Agent allows you to send and receive e-mail with standard encoding on attachments, international character sets, and multipart messages. Multimedia e-mail with images, sound, and video can also be exchanged. The service also includes these additional features: SMTP Dial-Up Service: The Internet Agent includes SMTP dial-up functionality.
Page 82
The number of thread switches are set separately for the SMTP/MIME service, POP3 service, IMAP4 service, and LDAP service. SNMP-Compliant The Internet Agent can be managed by any SNMP-compliant network manager, such as the alarm ® management features of Novell ZENworks Server Management. GroupWise 7 Installation Guide...
Any of the following server operating systems for the GroupWise agents (Post Office Agent, Message Transfer Agent, Internet Agent, WebAccess Agent, Monitor Agent): Novell Open Enterprise Server 1 or Open Enterprise Server 2 (NetWare or Linux version), plus the latest Support Pack NetWare 5.1, NetWare 6.0, or NetWare 6.5, plus the latest Support Pack for your version...
4.2.2 GroupWise System Requirements The GroupWise system in which you install the Internet Agent must meet the following requirements: The domain’s version must be equal to or later than the Internet Agent’s version. The domain’s version is determined by the Message Transfer Agent (MTA) version running for it. The versions of any post offices that the Internet Agent will access on behalf of POP3 or IMAP4 clients must be equal to or later than the Internet Agent’s version.
GroupWise Wiki (http://wiki.novell.com/ index.php/GroupWise), which includes a Best Practices section. IMPORTANT: If you plan to install the Internet Agent in a clustered server environment, refer to GroupWise 7 Interoperability Guide (http://www.novell.com/documentation/gw7) as you plan your Internet Agent installation. 4.3.1 Selecting the Internet Agent Platform...
NLM program is in the server’s search path. If you use a different directory, you must add that directory to the server’s search path. Linux: The Linux Internet Agent is automatically installed to /opt/novell/groupwise/ agents Windows: The default installation directory is c:\grpwise\gwia .
4.3.5 Selecting the Gateway Object Name The Internet Agent also requires a GroupWise Gateway object in Novell eDirectory. By default, it is named the same as the gateway directory and is referred to as the Internet Agent object. This object stores the Internet Agent’s information and enables configuration of the agent through...
(where GroupWise domains reside) and applications (such as the Internet Agent). Novell Cluster Services supports failover, failback, and migration of individually managed cluster resources.
The NetWare Internet Agent can be configured to take advantage of the fault-tolerant environment provided by Novell Cluster Services if the following requirements are met: The domain where the Internet Agent is installed has already been created on a shared NSS volume in the cluster.
Linux” “Heartbeat on Linux” If you are using Novell Cluster Services, the Linux GroupWise Installation program provides a Configure GroupWise for Clustering option that simplifies the process of installing the Linux Internet Agent on multiple nodes in the cluster. GROUPWISE INTERNET AGENT INSTALLATION WORKSHEET...
If you want to use an SNMP manager program, such as the Management and Monitoring Services component of Novell ZENworks Server Management, to monitor the Windows Internet Agent, you must install some SNMP components along with the Internet Agent software.
“NetWare and Windows: Installing the Internet Agent Software” on page 92 “Linux: Installing the Internet Agent Software” on page 94 IMPORTANT: If you plan install the Internet Agent in a clustered server environment, see the GroupWise 7 Interoperability Guide (http://www.novell.com/documentation/gw7) before you install the Internet Agent.
Page 93
6 Follow the prompts, using the following information from the GroupWise Internet Agent Installation Worksheet. Item 1: Software Platform Item 2: Installation Options Item 3: Server Information Item 4: Web Console Information Item 5: Relay Host Item 6: GroupWise Domain Item 7: GroupWise Internet Agent Name Item 8: Internet Mail Domain Name Item 10: Windows Service Information...
Page 94
“Installing the Internet Agent” on page 94 “Configuring the Internet Agent” on page 95 IMPORTANT: If you plan to install the Internet Agent in a clustered server environment, see the GroupWise 7 Interoperability Guide (http://www.novell.com/documentation/gw7) before you install the Internet Agent.
Page 95
6 Click Install Products > GroupWise Internet Agent > Install Internet Agent 7 When the installation is complete, click OK. The Internet Agent software is installed to /opt/novell/groupwise/agents 8 Continue with Configuring the Internet Agent. Configuring the Internet Agent 1 After the Internet Agent files have been installed, click Configure Internet Agent.
Starting the Internet Agent. The Internet Agent can also be configured to send problem messages to the Postmaster. For instructions, see “Determining What to Do with Undeliverable Messages” in “Internet Agent” in the GroupWise 7 Administration Guide (http://www.novell.com/documentation/gw7). GroupWise 7 Installation Guide...
“Using the Internet Agent Web Console” in “Internet Agent” in the GroupWise 7 Administration Guide (http://www.novell.com/documentation/gw7). 3 Skip to with Section 4.4.4, “Testing the Internet Agent,” on page Linux: Starting the Internet Agent To start the Linux Internet Agent with a user interface: 1 If Sendmail, Postfix, or any other SMTP daemon is enabled on your Linux server, disable it before starting the Internet Agent.
Page 98
X Window System, which is required for running the GUI Internet Agent server console. 5 Change to the directory. /opt/novell/groupwise/agents/bin 6 Enter the following command to start the Internet Agent: ./gwia --show @gwia.cfg & The --show switch starts the Internet Agent with a server console interface similar to that provided for the NetWare and Window Internet Agent.
“Using the Internet Agent Web Console” in “Internet Agent” in the GroupWise 7 Administration Guide (http://www.novell.com/documentation/gw7). 4 Continue with Testing the Internet Agent. 4.4.4 Testing the Internet Agent After you’ve started the Internet Agent, you should send a message to ensure that the system is working properly.
Next. 4.5 What’s Next “Internet Agent” section of the GroupWise 7 Administration Guide (http://www.novell.com/ documentation/gw7) provides information to help you further configure and maintain the Internet Agent, including how to: Configure addressing options. By default, your GroupWise system is set up to use the standard GroupWise address format (user_id.post_office.domain).
Page 101
Item Explanation 2) Installation Options Specify the server path where you want the Internet Agent files installed. Path: For more information, see Section 4.3.3, “Selecting the Internet Agent Installation Directory,” on page NetWare Options: If you selected NetWare as the Internet Agent’s platform under item 1, Section 4.3.9, “NetWare Installation Options: Automatic Startup Update AUTOEXEC File and Clustering,”...
Page 102
Item Explanation 6) GroupWise Domain Specify the domain name and the domain directory where you want to create a subdirectory for the Internet Agent. Domain Name: On Linux, specify the eDirectory context of the Domain object. Domain Directory: For more information, see Section 4.3.4, “Gathering Domain and Gateway Subdirectory: Gateway Information,”...
Section 5.5, “What’s Next,” on page 131 Section 5.6, “GroupWise WebAccess Installation Worksheet,” on page 131 IMPORTANT: If you plan to install WebAccess in a clustered server environment, see the GroupWise 7 Interoperability Guide (http://www.novell.com/documentation/gw7) before you install WebAccess. 5.1 GroupWise WebAccess Overview Section 5.1.1, “GroupWise WebAccess Introduction,”...
GroupWise WebAccess Requires the User to Log in to a GroupWise Mailbox, but GroupWise Figure 5-1 WebPublisher Does Not Login GroupWise Mailbox WebAccess Browser GroupWise Library WebPublisher Documents No Login Internet Intranet As shown above, GroupWise WebAccess requires users to have a mailbox in a GroupWise post office.
5.1.3 One WebAccess Server vs. Two The WebAccess Application and WebPublisher Application can be installed to a NetWare, Linux, Windows, or UNIX Web server. If desired, you can install the WebAccess Agent and the Viewer Agent on the same server with the Web server. The GroupWise WebAccess Application, WebPublisher Application, WebAccess Agent, and Viewer Figure 5-3 Agent Are All Installed on the Web Server...
Page 106
If you plan to use WebAccess to provide users with access to their mailboxes from anywhere on the Internet (rather than simply within a secured intranet), and you already have a firewall in place to provide security, you have the following options for configuring WebAccess: Install all WebAccess components inside your firewall and use a proxy service.
Any of the following server operating systems for the WebAccess Agent and the Viewer Agent: Novell Open Enterprise Server 1 or Open Enterprise Server 2 (NetWare or Linux version), plus the latest Support Pack NetWare 5.1, NetWare 6.0, or NetWare 6.5, plus the latest Support Pack for your version of NetWare Domains and post offices can be located on NetWare 3.12 and NetWare 4.2 servers,...
“Configuring the Document Viewer Agent” in “WebAccess” in the GroupWise 7 Administration Guide (http:// www.novell.com/documentation/gw7) 5.3 Planning GroupWise WebAccess Before installing GroupWise WebAccess, you should complete the planning tasks listed below. The planning tasks help you gather information you will need as you install and set up GroupWise WebAccess.
GroupWise Wiki (http://wiki.novell.com/ index.php/GroupWise), which includes a Best Practices section. IMPORTANT: If you plan to install WebAccess in a clustered server environment, refer to the GroupWise 7 Interoperability Guide (http://www.novell.com/documentation/gw7) as you plan your WebAccess installation. 5.3.1 Deciding Where to Install the GroupWise WebAccess...
Page 110
Gateway Object Name The WebAccess Agent also requires a GroupWise Gateway object in Novell eDirectory. By default, it is named the same as the gateway directory and is referred to as the WebAccess Agent object. This object stores the WebAccess Agent’s information and enables configuration of the agent through ®...
Page 111
GROUPWISE WEBACCESS INSTALLATION WORKSHEET Under Item 6: Gateway Object, specify the name you want to give the WebAccess Agent object. The default name is the same as the gateway directory name you chose for Item Domain and Post Office Access The WebAccess Agent requires access to the domain.
Page 112
Web browser and the WebAccess Agent. Therefore, do not use an existing eDirectory username and password unless you secure this connection using SSL. For information about securing the WebAccess Agent’s connections, see “WebAccess” in the GroupWise 7 Administration Guide (http://www.novell.com/documentation/gw7). GROUPWISE WEBACCESS INSTALLATION WORKSHEET Under Item 10: Web Console, select Yes if you want to enable the Web console.
Page 113
(http://www.novell.com/documentation/gw7). NetWare Installation Option: Novell Cluster Services Novell Cluster Services is a server clustering system that ensures high availability and manageability of critical network resources including volumes (where GroupWise domains and post offices reside) and applications (such as the GroupWise WebAccess Agent). Novell Cluster Services supports failover, failback, and migration of individually managed cluster resources.
Page 114
Under Item 2: Installation Options, mark whether or not you want to configure the Linux WebAccess Agent for clustering using Novell Cluster Services. If you do, follow the installation instructions in “Implementing WebAccess in a Linux Cluster” in Novell Cluster Services on Linux...
The WebAccess Installation program installs all available languages. You need to specify which language should be used when displaying the Novell Web Services page. When users access the Novell Web Services page, they can use the default language for WebAccess or WebPublisher, or they can select another language.
Web server’s webacc.cfg webpub.cfg novell directory (worksheet item The WebAccess Application object and WebPublisher Application object allow you to easily modify configuration information in ConsoleOne. The eDirectory information is the master information;...
Page 117
IMPORTANT: If you plan to install GroupWise WebAccess in a clustered server environment, see GroupWise 7 Interoperability Guide (http://www.novell.com/documentation/gw7) before you install WebAccess. Installing the WebAccess Agent The following steps provide instructions for installing the WebAccess Agent. For information about installing the WebAccess and WebPublisher Applications to a Web server, see “Installing the...
Page 118
7 Select GroupWise WebAccess Agent and deselect the GroupWise WebAccess Application and GroupWise WebPublisher Application options (worksheet item NOTE: You can also install the WebAccess Application and WebPublisher Application to your Web server at this time, if you have the appropriate Web server file system access and eDirectory access, as described in “Installing the WebAccess Application and WebPublisher Application”...
Page 119
Linux: GroupWise installation of Apache: /etc/init.d/novell-httpd stop /etc/init.d/novell-tomcat4 stop Novell Open Enterprise Server Linux installation of Apache: /etc/init.d/apache2 stop /etc/init.d/novell-tomcat4 stop SUSE Linux Enterprise Server 10 installation of Apache: /etc/init.d/apache2 stop /etc/init.d/tomcat stop SLES 9 installation of Apache: apachectl stop CATALINA_HOME/bin/shutdown.sh...
Page 120
GroupWise WebAccess Installation Worksheet. Item 13: Web Server Type and Root Directory Item 14: Novell Root Directory Item 15: Java Servlet Engine (NetWare only) Item 16: Default Language Item 17: eDirectory Object Configuration...
Page 121
-xvf webaccess.tar: Extract to the root of the UNIX server. A directory is created for /novell the files. webaccessdocs.tar: Extract to the Tomcat GroupWise document root directory (for example, /usr/local/tomcat4/webapps/gw webaccessservlets.tar: Extract to the Tomcat GroupWise classes directory (for example,...
Page 122
Linux: GroupWise installation of Apache: /etc/init.d/novell-tomcat4 start /etc/init.d/novell-httpd start Novell Open Enterprise Server Linux installation of Apache: /etc/init.d/novell-tomcat4 start /etc/init.d/apache2 start SUSE Linux Enterprise Server 10 installation of Apache: /etc/init.d/tomcat start /etc/init.d/apache2 start SLES 9 installation of Apache: CATALINA_HOME/bin/startup.sh...
Windows: To run as an application, click Start > Programs > Novell GroupWise WebAccess > GroupWise WebAccess. To run as a service, from the Control Panel click Administrative Tools > Services. Right-click the WebAccess service, then click Start. NOTE: When you start the WebAccess Agent, the Document Viewer Agent also starts.
Page 124
6 Click Install Products > GroupWise WebAccess > Install WebAccess Agent. 7 When the installation is complete, click OK. The WebAccess Agent software is installed to /opt/novell/groupwise/agents 8 Continue with Configuring the Linux WebAccess Agent. Configuring the Linux WebAccess Agent 1 After the WebAccess Agent files have been installed, click Configure WebAccess Agent.
Page 125
IMPORTANT: If you are installing GroupWise WebAccess on SUSE Linux Enterprise Server 10, refer to TID 3248145 in the Novell Support Knowledgebase (http://www.novell.com/support) installation instructions. 1 After installing and configuring the WebAccess Agent, if you want to use an existing Apache and Tomcat installations, click Install GroupWise WebAccess Application.
Page 126
WebPublisher using an SSL connection. NOTE: The option to install Apache and Tomcat along with the WebAccess Application is not available if you are installing to Novell Open Enterprise Server Linux because Apache and Tomcat are already installed and configured correctly in that environment.
Page 127
If you installed the Novell version of Apache and Tomcat along with the WebAccess Application, follow the instructions below to start your Web server. If you did not install the Novell version of Apache and Tomcat along with the WebAccess Application, restart Apache and Tomcat as you usually would.
Page 128
./novell-tomcat4 start 5 Wait until Tomcat is all the way up. 6 Start Apache. ./novell-httpd start 7 Continue with Starting the Linux WebAccess Agent. Starting the Linux WebAccess Agent To start the Linux WebAccess Agent with a user interface: 1 Make sure you are logged in as root 2 Make sure that the MTA for the domain is running.
Novell Web Services page is located:. http://web_server_address/gw 2 Select a GroupWise WebAccess language and service, then click Go to display the Login page. You can bypass the Novell Web Services page to go directly to the Login page by using the following URL: http://web_server_address/gw/webacc...
Page 130
GroupWise WebPublisher only supports access through a Web browser on a computer. Mobile devices are not supported. 1 To access the WebPublisher client, enter the IP address or hostname of the Web server plus the directory where the Novell Web Services page is located: http://web_server_address/gw 130 GroupWise 7 Installation Guide...
2 Select a GroupWise WebPublisher language, then click Go to display GroupWise WebPublisher. You can bypass the Novell Web Services page to go directly to WebPublisher by using the following URL: http://web_server_address/gw/webpub where web_server_address is the IP address or DNS hostname of your Web server. If the Web...
The default installation directories are: Platform: NetWare, NetWare: sys:\system Linux, or Windows Linux: /opt/novell/groupwise/agents Installation Windows: c:\webacc directory: The directory path you specify must be from the perspective of the installation workstation. For details, see Section 5.3.1, “Deciding Where to Install the GroupWise WebAccess Components,”...
Page 133
Mark whether or not you want to configure the WebAccess Agent for clustering on Clustering: Novell Cluster Services. Yes | No For details, see “NetWare Installation Option: Novell Cluster Services” on page 113 “Linux Installation Options: LDAP Information and Clustering” on page 113.
Page 134
Item Explanation 9) Windows Service This item applies only if you are installing the Windows WebAccess Agent and User plan to run it as a Windows service rather than a Windows application. Enter the username and password for a user account that provides the service Username: with access to the domain and post office directories.
Specify a directory on the Web server where you want to install the configuration Directory files for the WebAccess Application and/or WebPublisher Application. For NetWare and Windows, the default is the novell directory on the root of the server volume. For Linux, the default is /opt/novell/groupwise/webaccess...
Page 136
Item Explanation 17) eDirectory Specify the tree where you are installing WebAccess. Object Configuration Specify the context where the WebAccess Installation program should create the WebAccess Application and/or WebPublisher Application objects. The default Tree: context is below the Domain object. Context: For details, see “eDirectory Objects and Configuration Files”...
Section 6.5, “Using GroupWise Monitor,” on page 153 Section 6.6, “GroupWise Monitor Installation Worksheet,” on page 155 IMPORTANT: If you plan to install GroupWise Monitor in a clustered server environment, see the GroupWise 7 Interoperability Guide (http://www.novell.com/documentation/gw7) before you install Monitor.
The Monitor Agent and the Monitor Application can run on the same server or on different servers, depending on the needs of your system. “One Monitor Server vs. Two” on page 138 “Monitor Security Requirements” on page 138 6.1.1 One Monitor Server vs. Two The Monitor Agent and the Monitor Application can run together on a Linux server or a Windows server, as illustrated below: Monitor Agent and Application Installed on the Same Machine...
Page 139
If you plan to use Monitor to provide GroupWise administrators with access to your GroupWise system from anywhere on the Internet (rather than simply within a secured intranet), and you already have a firewall in place to provide security, you have the following options for configuring Monitor: Install both Monitor components inside your firewall and use a proxy service.
6.2 Monitor System Requirements 32-bit/x86 processor or 64-bit/x86 processor Any of the following server operating systems for the Monitor Agent: Novell Open Enterprise Server 1 or Open Enterprise Server 2 (Linux version), plus the latest Support Pack ® SUSE Linux Enterprise Server 9 or SUSE Linux Enterprise Server 10, plus the latest...
GroupWise Wiki (http://wiki.novell.com/ index.php/GroupWise), which includes a Best Practices section. IMPORTANT: If you plan to install GroupWise Monitor in a clustered server environment, refer to GroupWise 7 Interoperability Guide (http://www.novell.com/documentation/gw7) as you plan your Monitor installation. 6.3.1 Deciding Where to Install the GroupWise Monitor...
It is not necessary to have an entire GroupWise system installed in order for the Monitor Agent to monitor Messenger agents. For more information, see “Setting up the High Availability Service” in “Installing a Novell Messenger System” in the Messenger 2 Installation Guide (http:// www.novell.com/documentation/nm2).
Page 143
“Multilingual GroupWise Systems” in the GroupWise 7 Administration Guide (http://www.novell.com/documentation/gw7). Linux Installation Option: LDAP Information If you are installing the Linux Monitor Agent and Monitor Application, the Installation program needs to access eDirectory through LDAP. eDirectory access is required in order to create the Monitor Application objects.
“Default Monitor Web Console Language” on page 145 eDirectory Objects and Configuration File Monitor Application configuration information is stored in two places: In Novell eDirectory In a configuration file ( gwmonitor.cfg You can easily modify the configuration information in ConsoleOne by editing the properties of the GroupWise Monitor Application object (named GroupWiseMonitor).
GROUPWISE MONITOR INSTALLATION WORKSHEET If you are installing the Windows Monitor, under Item 10: Novell Root Directory, specify the directory on the Web server where you want to create the Monitor Application configuration file. On Linux, the Monitor software is automatically installed in subdirectories under...
7 Follow the prompts to provide information about Monitor Application configuration, using the following information from the GroupWise Monitor Installation Worksheet. Item 8: Web Server Item 9: Web Server Path Item 10: Novell Root Directory Item 11: Java Servlet Engine 146 GroupWise 7 Installation Guide...
“Restarting the Web Server” on page 150 “Starting the Linux Monitor Agent as a Daemon” on page 151 IMPORTANT: If you plan to install GroupWise Monitor in a clustered server environment, see the GroupWise 7 Interoperability Guide (http://www.novell.com/documentation/gw7) before you install Monitor.
Page 148
7 Click Install Products > GroupWise Monitor > Install GroupWise Monitor Agent. 8 When the installation is complete, click OK. The Monitor Agent software is installed to /opt/novell/groupwise/agents 9 Continue with Configuring the Linux Monitor Agent. Configuring the Linux Monitor Agent 1 After the Monitor Agent files have been installed, click Configure Monitor.
Page 149
/etc/opt/novell/tomcat4 NOTE: The option to install Apache and Tomcat along with the Monitor Application is not available if you are installing to Novell Open Enterprise Server Linux because Apache and Tomcat are already installed and configured correctly in that environment.
Page 150
If you installed the Novell version of Apache and Tomcat along with the Monitor Application, follow the instructions below to start your Web server. If you did not install the Novell versions of Apache and Tomcat along with the Monitor Application, restart Apache and Tomcat as you usually would.
Page 151
IP address of a server where the MTA is running. 2 Change to the GroupWise agent directory. cd /opt/novell/groupwise/agents/bin 3 Use one of the following commands to start the Monitor Agent: ./gwmon --home /domain_directory & ./gwmon --ipa IP_address --ipp port_number &...
Monitor Web Console” in “Monitor” in the GroupWise 7 Administration Guide (http:// www.novell.com/documentation/gw7). If you are installing to the Apache Web Server for UNIX Solaris, continue with “Completing the Monitor Installation on a UNIX Apache Web Server” on page 152.
Typically, these directories reside in the directory, but you /novell/gwmonitor can relocate them if desired. Refer to the comments in the file for gwmonitor.cfg explanations of each of these settings.
For more information about using the Monitor Agent server console, see “Monitor” in the GroupWise 7 Administration Guide (http://www.novell.com/documentation/gw7). 6.5.2 Monitor Web Consoles in Your Web Browser Monitor has two different Web consoles. The Monitor Web console uses the capabilities of your Web server to provide access from outside your firewall.
For instructions on protecting the Monitor Agent Web console with a password, see “Configuring Authentication and Intruder Lockout for the Monitor Web Console” in “Monitor” in the GroupWise 7 Administration Guide (http://www.novell.com/documentation/gw7). 6.6 GroupWise Monitor Installation Worksheet Item Explanation 1) Platform Mark the platform where you want to install the Monitor Agent.
Page 156
Item Explanation 4) Monitor Agent Specify the IP address or DNS hostname of the server where you plan to install Network Address: the Monitor Agent. Specify the port number for the Monitor Agent to listen on. The Monitor Agent IP address: must use a unique port number.
Page 157
Item Explanation 10) Novell Root Specify the directory path where you want the Monitor configuration file installed. Directory: The default directory is: Linux: /opt/novell/groupwise Windows: c:\novell For more information, see “eDirectory Objects and Configuration File” on page 144. 11) Java Servlet This item applies only on Windows.
Routing administration messages throughout the GroupWise system so that databases are kept in sync Synchronizing GroupWise user information with Novell eDirectory user information The POA requires direct access to the post office directory so that it can write to the post office database.
7.1.1 Local Access to Databases The preferred way to fulfil this requirement is to install each agent on the same server with its directory. Running an agent locally on the same server where its directory and database are located simplifies network connections, because no remote login is required. In addition, it reduces network traffic and protects database integrity.
32-bit/x86 processor or 64-bit/x86 processor Any of the following server operating systems for the POA and the MTA: Novell Open Enterprise Server 1 or Open Enterprise Server 2 (NetWare or Linux version), plus the latest Support Pack NetWare 5.1, NetWare 6.0, or NetWare 6.5, plus the latest Support Pack for your version of NetWare ®...
Best Practices section. IMPORTANT: If you plan to install the GroupWise agents in a clustered server environment, refer to the GroupWise 7 Interoperability Guide (http://www.novell.com/documentation/gw7) as you plan your agent installation. 7.3.1 Selecting the Agent Platform...
If you use a different directory, you must add that directory to the server’s search path. Linux: The Linux agents are automatically installed to /opt/novell/groupwise/agents Windows: The default installation directory is c:\grpwise . However, you can install the agents to any directory you want.
7.3.6 NetWare Installation Options: Automatic Startup and Clustering When you install the NetWare GroupWise agents, the following options specific to NetWare are available in the Agent Installation program: “Automatic Startup” on page 165 “Novell Cluster Services” on page 165 164 GroupWise 7 Installation Guide...
GroupWise agents automatically. Novell Cluster Services Novell Cluster Services is a server clustering system that ensures high availability and manageability of critical network resources including volumes (where GroupWise domains and post offices reside) and applications (such as the GroupWise agents). Novell Cluster Services supports failover, failback, and migration of individually managed cluster resources.
Item 4: Configure GroupWise Agents for Clustering, mark whether or not you want to configure the Linux GroupWise agents for clustering using Novell Cluster Services. If you do, follow the installation instructions provided in “Setting Up a Domain and a Post Office in a Linux Cluster”...
SNMP Traps If you want to use an SNMP manager program, such as the Management and Monitoring Services ® component of Novell ZENworks Server Management, to monitor the agents, you must install some SNMP components along with the Windows agent software.
“Installing the NetWare Agent Software” on page 170 “Editing the NetWare Agent Startup Files” on page 172 IMPORTANT: If you plan to install the GroupWise agents in a clustered server environment, see GroupWise 7 Interoperability Guide (http://www.novell.com/documentation/gw7) before you install the agents.
Page 169
TCP Nagle Algorithm Setting Recommended NSS Parameters for the NetWare POA If you run the NetWare POA on NetWare 5.1 or 6.x Novell Storage Services (NSS) volumes, you can significantly improve GroupWise performance by using the following parameters and settings...
Page 170
The following TID, although originally written for GroupWise 5.x and NetWare 5.x, applies to GroupWise 7 and NetWare 6.x as well: TID 10065215: Resolving GroupWise Performance Issues with NSS Volumes (http:// www.novell.com/support/ search.do?cmd=displayKC&docType=kc&externalId=10065215&sliceId=&dialogID=903280 5&stateId) Setting Recommended NetWare Server Parameters for the NetWare MTA The default Maximum Packet Receive Buffers setting on a NetWare server is inadequate for the NetWare MTA in configurations that include numerous TCP/IP and remote file connections.
Page 171
2 Make sure you have sufficient rights to install software in the desired directory. 3 Insert the GroupWise 7 Administrator for NetWare/Windows CD into the CD drive to start the GroupWise Installation program, then click Install Products > Install GroupWise Agents. If the Installation program does not start automatically, run from the root of the CD.
Page 172
The Agent Installation program has created a file that contains the commands to grpwise.ncf start the GroupWise agents on the NetWare server whenever the server starts. Here at the end of the Agent Installation program, you can select how you want to start the agents. Update AUTOEXEC File: Select this option if you want the Agent Installation program to add the file to the NetWare...
Page 173
(;) at the beginning of the line and replace the distinguished_object_name variable with the distinguished name of the MTA or POA. For example, if the MTA is for a domain named Provo that is located in a container named Novell, you would enter: /dn-mta.provo.novell...
Page 174
When you are not at the NetWare server console, you can monitor the GroupWise agents from their Web consoles described in the GroupWise 7 Administration Guide (http://www.novell.com/ documentation/gw7): “Using the POA Web Console” “Using the MTA Web Console”...
“NetWare Installation Directory” in “Directory Structure Diagrams” in GroupWise 7 Troubleshooting 3: Message Flow and Directory Structure (http://www.novell.com/ documentation/gw7). If you want to delete the WebAccess Application from your Apache Web server, locate the WebAccessUninstall.ini file under the Tomcat root directory (for example, under \tomcat\4 ).
Page 176
5 Click Install Products > GroupWise Agents > Install Agents. 6 When the installation is complete, click OK. The GroupWise agent software is installed to /opt/novell/groupwise/agents 7 Click Configure GroupWise Agents. The agent installation and configuration steps are separate so that you can install updated agent software without repeating the agent configuration steps.
Page 177
Item 7: Post Office Information On the Configuration Complete page, Launch GroupWise Agents on System Startup is selected by default. IMPORTANT: If you want to configure the agents for high availability, as described in “Enabling the High Availability Service for the Linux GroupWise Agents” on page 185, they must be configured to start automatically on system startup.
Page 178
X Window System, which is required for running the GUI GroupWise agent server consoles. 2 Change to the GroupWise agent directory. cd /opt/novell/groupwise/agents/bin 3 Enter one of the following commands to start the MTA: Syntax: ./gwmta --show --home domain_directory &...
Page 179
The POA startup file is named after the post office that the POA services. The Installation program created the POA startup file in the /opt/novell/groupwise/agents/ directory. Because the Installation program prompted you for the post office directory, it share set the --home switch for you in the startup file.
Page 180
Console” in “Message Transfer Agent” in the GroupWise 7 Administration Guide (http:/ /www.novell.com/documentation/gw7). Starting the Linux GroupWise Agents as Daemons All of the Linux GroupWise agents except the Monitor Agent can be started using the grpwise script. The Monitor Agent uses its own customized...
Page 181
Figure 7-4 For more information about the agent Web consoles, including instructions on protecting the agent Web consoles with passwords see the following sections in the GroupWise 7 Administration Guide (http://www.novell.com/documentation/gw7). “Using the POA Web Console” “Using the MTA Web Console”...
Page 182
“Setting Up Typical Non-root Access” on page 182 “Setting Up Non-root Access on an NSS Volume on Novell Open Enterprise Server Linux” on page 183 “Changing the Non-root User” on page 184 NOTE: You can configure the POA, the MTA, and the Internet Agent to run as a non- user.
Page 183
When your domains, post offices, libraries, and software distribution directories are located on a Novell Open Enterprise Server (OES) Linux NSS volume, you must set up an eDirectory user for the agents to run as and you must LUM-enable that user. On OES Linux, you can use Novell iManager to accomplish these tasks.
Page 184
/etc/opt/novell/groupwise 4 Create a new directory, then change to that directory. agents mkdir agents cd agents 5 Create a file named uid.conf 6 Type the selected username in the file, for example: gwagents 7 Use the following command to grant the user the required rights to the directories that the agents need to access on the local server: rights -f /directory -r rwcemf trustee user.context.tree...
Page 185
“Starting the Linux GroupWise Agents as Daemons” on page 180. [gwha] = no cert password [domain_name] server = /opt/novell/groupwise/agents/bin/gwmta command = /etc/init.d/grpwise startup = domain_name.mta delay wait = 10 [post_office_name.domain_name] server = /opt/novell/groupwise/agents/bin/gwpoa...
Page 186
2b Start the GroupWise agents manually, including providing the full path to the executable and including the --show switch, to make sure that they are set up and configured correctly. /opt/novell/groupwise/agents/bin/gwpoa --show @post.poa /opt/novell/groupwise/agents/bin/gwmta --show @dom.mta /opt/novell/groupwise/agents/bin/gwia --show @gwia.cfg /opt/novell/groupwise/agents/bin/gwinter --show @webac70a.waa 2c After verifying that the agents start correctly, stop the agents.
Page 187
/etc/opt/novell/groupwise 4b Edit the file in a text editor gwha.conf Each agent has its own section in the file, for example: [Waltham2] server = /opt/novell/groupwise/agents/bin/gwmta command = /etc/init.d/grpwise startup = waltham2.mta delay = 2 wait = 10 4c Change the settings as needed.
Page 188
If you need to eliminate the user interface, use or delete the line from show = no show = the file. 5d Save the file, then exit the text editor. 6 Enable the High Availability service: 6a In YaST, click Network Services > Network Services (inetd). 6b If necessary, select Enable to activate the list of services.
Page 189
Monitor Agent startup switches, see “Using Monitor Agent Switches” in “Monitor” in the GroupWise 7 Administration Guide (http://www.novell.com/documentation/gw7). 1e Save the file, then exit the text editor. 2 Change to the directory. /etc/init.d 3 Stop one of the agents.
Page 190
Agent status is displayed in terms of the names of the domain and post office associated with each agent. It lists the agent locations in the following format: [post_office.domain] MTA: [domain] Internet Agent: [domain.GWIA] WebAccess: [WEBAC70A] [gwdva.hostname] 5 Use the following set of commands as needed to stop the agents as daemons and verify their status: Stops the GroupWise agents that ./grpwise stop...
Page 191
RPM. WebAccess and Monitor have two RPMs each, one for the agent software and one for the application software. The following list provides the list of all GroupWise agent and administration RPMs that you might need to uninstall from a server: POA and MTA novell-groupwise-agents-version-date Internet Agent: novell-groupwise-gwia-version-date WebAccess:...
To see what GroupWise files are created in locations other than under /opt/novell/groupwise and its subdirectories, see the Linux sections of “Agent Installation Directories” in the GroupWise 7 Troubleshooting 3: Message Flow and Directory Structure (http://www.novell.com/documentation/ gw7): POA and MTA: “Linux Installation Directory” Internet Agent: “Linux Installation...
Page 193
If you want to monitor the GroupWise Windows agents from an SNMP manager program, such as ® the Management and Monitoring Services component of Novell ZENworks Server Management, SNMP must be enabled on the Windows server where the agents are installed. If it is not already enabled, you should enable it before you run the Agent Installation program.
Page 194
3 Follow the prompts to provide the Windows Agent information from your GroupWise Agent Installation Worksheet. Item 3: Installation Path Item 5: Language Item 6: Domain Information Item 7: Post Office Information Item 8: Installation Options Item 9: Windows Service Information 4 On the Installation Complete page, choose whether or not you want the Agent Installation program to start the agents for you immediately, then click Finish.
Page 195
“Manually or Automatically as Services” on page 196 If you encounter any problems starting the GroupWise agents, see “Strategies for Agent Problems” GroupWise 7 Troubleshooting 2: Solutions to Common Problems (http://www.novell.com/ documentation/gw7) for assistance. Manually As Applications On the Windows desktop, click Start > Programs, select the GroupWise agent, then start the GroupWise agent.
Page 196
When running as services, the GroupWise agents do not display an agent console on the Windows server where they are running. Instead, you can monitor the GroupWise agents using their Web consoles described in the GroupWise 7 Administration Guide (http://www.novell.com/ documentation/gw7): “Using the POA Web Console”...
Page 197
“Using the Internet Agent Web Console” “Using the WebAccess Agent Web Console” Stopping the Windows GroupWise Agents “As Applications” on page 197 “As Services” on page 197 As Applications When the GroupWise agents run as applications, you can stop them from their server consoles. POA: At the POA server console, click File >...
After you have created new domains and post offices, and installed the agents for them, you can complete their configuration by referring to the following sections of the GroupWise 7 Administration Guide (http://www.novell.com/documentation/gw7): Refining the configuration of the agents to meet the specific needs of the new domains and post offices. See “Post Office Agent”...
Page 199
This item applies to the NetWare and Linux agents. for Clustering: Mark whether or not you want to configure the agents for clustering on Yes | No Novell Cluster Services. For more information, see Section 7.3.6, “NetWare Installation Options: Automatic Startup and Clustering,” on page 164 Section 7.3.7, “Linux Installation Option: Clustering,”...
Page 200
Item Explanation 9) Windows Service Information: This item applies only if you are installing the Windows agents. Account type: If you are installing the Windows agents as services, mark the type of account they can use to log in. Use local system account If needed, specify the Windows user account they can run under.
The following sections assist you with assigning GroupWise accounts to users and with installing ® the Novell GroupWise 7 Windows client and the GroupWise 7 Cross-Platform client. Section 8.1, “GroupWise Client Overview,” on page 201 Section 8.2, “GroupWise Client Workstation Requirements,” on page 201 Section 8.3, “Planning Your GroupWise Client Installation,”...
8.2.2 GroupWise Cross-Platform Client on Linux Any of the following desktop operating systems: Novell Linux Desktop, plus the KDE desktop or the GNOME desktop SUSE Linux Enterprise Desktop 10, plus the KDE desktop or the GNOME desktop Red Hat Desktop 4 or Red Hat Enterprise Linux WS 4, plus the GNOME desktop Java Virtual Machine (JVM) 1.5 or later...
For a system-wide rollout of the GroupWise client software, you might want to consider alternatives to each user installing from the CD or the software distribution directory. For the GroupWise Cross-Platform client, you can use Novell ZENworks Linux Management for a system-wide rollout.
® For the GroupWise Windows client, if you have Novell ZENworks Desktop Management, you can use it, along with the files included with GroupWise 7, to distribute the client. Or, you can .msi have a login script run the client setup program with a response file to perform a silent install on workstations.
Page 205
Upgrade: Installs GroupWise 7 over your existing installation of GroupWise with the same components you already had installed. The installation directory is also the same as your previous installation of GroupWise. See “Client” in the GroupWise 7 Administration Guide (http://www.novell.com/ documentation/gw7) for more information about setting up GroupWise Remote and Caching modes.
GroupWise name server, see “Post Office Agent” in the GroupWise 7 Administration Guide (http://www.novell.com/documentation/gw7). The user can provide the post office location when prompted. To start the GroupWise client for the first time: 1 Double-click the GroupWise icon on the Windows desktop.
For information about using the features in the GroupWise Windows and GroupWise Cross- Platform clients, click Help > Help Topics, or Help > User Guide in the client. The user guides are both available at the GroupWise 7 Documentation Web site (http://www.novell.com/documentation/ gw7). Installing the GroupWise Windows and Cross-Platform Clients 207...
The GroupWise Connector for Outlook is installed separately from GroupWise. For information, see the GroupWise Connector for Microsoft Outlook Quick Start and the GroupWise Connector for Microsoft Outlook Readme at the GroupWise 7 Documentation Web site (http://www.novell.com/ documentation/gw7). Installing the GroupWise Connector for Microsoft Outlook...
Using GroupWise Mobile Server, Powered by Intellisync, you can synchronize Personal ® Information Manager (PIM) and e-mail data from Novell GroupWise to Windows CE, Windows Mobile*-based Smartphones, Symbian* OS, Palm OS* handheld devices, and SyncML* devices. For information, see the GroupWise Mobility Documentation Web site (http://www.novell.com/...
Installing GroupWise Messenger ® ® Novell GroupWise Messenger is a corporate-based, secure instant messaging solution that supports instant messaging, presence, and archiving of conversations. The Messenger client integrates with the GroupWise client to provide access to instant messaging features from with the GroupWise client.
Update Chapter 12, “What’s New in GroupWise 7,” on page 217 Chapter 13, “Understanding the Update Process,” on page 243 Chapter 14, “Preparing Your GroupWise System for Update,” on page 249 Chapter 15, “Updating Your GroupWise 6.x System to Version 7,” on page 251 Chapter 16, “Updating Your GroupWise 5.x System to Version 7,”...
What’s New in GroupWise 7 ® ® Novell GroupWise 7 provides substantial improvements over GroupWise 6.x in five areas: Windows Client Enhancements: The Windows client has a new look and feel that includes the Nav Bar, Panels, Home Folder, color schemes, and new icons. In addition to the new look...
Section 12.1.7, “Gateway Alias Migration (v7.0.1),” on page 220 Section 12.1.8, “Refresh Views (v7.0),” on page 221 Section 12.1.9, “Improved Backup Capabilities with Novell Cluster Services on NetWare (v7.0.1),” on page 221 Section 12.1.10, “Simplified Installation Procedure for Novell Cluster Services on Linux (v7.0.1),”...
For additional information about Client Options, see “Setting Defaults for the GroupWise Client Options” in “Users” in the GroupWise 7 Administration Guide (http://www.novell.com/ documentation/gw7). Windows Client Appearance Defaults In ConsoleOne, you can preset the appearance of the GroupWise Windows client. You can choose between Default, GroupWise 6.5 and Simplified.
User’s Internet Addressing Settings” in “Users” in the GroupWise 7 Administration Guide (http://www.novell.com/ documentation/gw7). The Gateway Alias Migration utility can also update users’ preferred Internet domain names based on their existing gateway aliases.
Offices” in GroupWise 7 Administration Guide (http://www.novell.com/documentation/gw7). 12.1.9 Improved Backup Capabilities with Novell Cluster Services on NetWare (v7.0.1) On NetWare and Linux, for each /home switch that specifies a GroupWise domain or post office directory, TSAFSGW can now determine what types of GroupWise objects are available at that location.
A PolyServe matrix is similar in purpose and function to the clustering technology provided by Novell and Microsoft. A virtual host is a hostname/IP address configured on one or more servers in the matrix. For a detailed description of installing PolyServe Matrix Server, refer to the PolyServe Matrix Server Administration Guide for Linux that accompanies the PolyServe software.
Agent” in the GroupWise 7 Administration Guide (http://www.novell.com/documentation/gw7). 12.2.6 Agent Exclusive Bind (v7.0) You can now cause the POA and the MTA to bind to a specified IP address when the server where they run uses multiple IP addresses. The specified IP address is associated with all ports used by the agent.
“Message Transfer Agent” in the GroupWise 7 Administration Guide (http://www.novell.com/documentation/gw7). 12.2.7 Disable Administration Task Processing for the POA (v7.0) You can now disable administration task processing for the POA on the Agent Settings page of the POA object in ConsoleOne, as well as using the /noada startup switch in the POA startup file.
For information about using new features, from the GroupWise Windows client, click Help > What’s New. For additional information about using the GroupWise Windows client, see the GroupWise 7 Windows Client Guide (http://www.novell.com/documentation/gw7). 12.3.1 Appearance Schemes (v7.0) The appearance schemes allow you to select between Default, GroupWise 6.5 and Simplified. Each of these schemes have default appearance settings.
12.3.5 Quick Filter (v7.0) The Quick Filter lets you perform a filter on the panel or folder that is selected. The filter searches on most fields that are available in the selected panel or folder, but it does not search message bodies or attachments.
Now you can also create multiple HTML signatures. When you select to use an HTML signature, you have a basic editor that you can use to create the signature. You can select a background, add a picture, add a table, and perform formatting using an HTML Signature. 12.3.12 Global Signatures (v7.0) In addition to personal signatures, your system administrator can create a global signature for everyone to use.
12.3.18 All Day Events (v7.0) GroupWise now has support for all day events. All day events are displayed at the top of the calendar view. When you create an all day event, by default it does not mark the time as busy. 12.3.19 Edit Corporate Distribution Lists (v7.0) End users can now edit a corporate distribution list if they have been granted access.
Help Topics. For additional information about using the GroupWise Cross-Platform client, see the GroupWise 7 Cross-Platform Client Guide (http://www.novell.com/documentation/gw7). 12.4.1 All Day Events (v7.0) GroupWise now has support for all day events. All day events are displayed at the top of the calendar view.
12.4.4 Reply Text Format (v7.0) When you reply to a message, you can select how the reply text should appear. You can select from three settings for the reply text format: GroupWise classic, which shows the date before the original message;...
12.4.11 Filters (v7.0) If your Mailbox or Calendar contains many items, you might have a difficult time finding just one of them. Filter lets you display items according to specific criteria. For example, a filter can display only items that have a certain word in the subject. You can also use a filter to hide items that you want to get out of your way.
12.4.13 Backup and Restore (v7.0) Your system administrator typically backs up your network mailbox on a regular basis. You can back up your local mailbox if you want to have an additional copy of your mailbox, or if you want to back up information that is no longer in your network mailbox.
Section 12.5.3, “Internet Agent High Availability (v7.0),” on page 233 Section 12.5.4, “Internet Agent Runs as Non-root User (v7.0),” on page 233 Section 12.5.5, “Internet Agent Exclusive Bind (v7.0),” on page 233 Section 12.5.6, “TCP/IP Links between the Internet Agent and the MTA (v7.0),” on page 234 Section 12.5.7, “Alternate Internet Agents (v7.0),”...
To see how this message flow works for GroupWise 7, see “Message Delivery to and from the Internet” in Troubleshooting 3: Message Flow and Directory Structure (http://www.novell.com/ documentation/gw7). If, for some reason, you want to use message files instead of a TCP/IP link, set the Message Transfer Port field to 0 (zero) on the Network Address page of the Internet Agent object in ConsoleOne.
“Global Signatures” in “System” in the GroupWise 7 Administration Guide (http://www.novell.com/documentation/gw7). 12.5.11 iCal Support (v7.0.1) The Internet Agent supports iCalendar (iCal), the Internet Calendaring and Scheduling core object specification (RFC 2445), and iMIP, the iCalendar Message-based Interoperability Protocol (RFC 2447). When a GroupWise user sends an appointment to an external Internet user, the Internet agent converts the appointment into an iMIP message that can be read and accepted or declined in compatible e-mail systems such as Microsoft Exchange and Lotus Notes.
WebAccess Installation program can install and configure Tomcat 5.5 into an existing Microsoft Internet Information Server. NOTE: The Novell Servlet Gateway is no longer shipped or supported with WebAccess. 12.6.2 WebAccess Agent High Availability (v7.0.1) Like the POA, the MTA, and the Internet Agent, the WebAccess Agent can be configured for high availability, as described in Section 12.2.3, “GroupWise High Availability Service (v7.0),”...
12.6.7 New Document Viewer Agent Startup Switch (v7.0.1) On NetWare, you can run each worker thread in its own namespace. Use the /addrspacename startup switch in the file to specify the base name for the series of address space names that are gwdva.dva created for the worker threads.
For information about using new features, from the GroupWise WebAccess client, click Help. For additional information about using the GroupWise WebAccess client, see the GroupWise 7 WebAccess Client Guide (http://www.novell.com/documentation/gw7). 12.6.10 Improved Performance for Low-Bandwidth WebAccess Client Users (v7.0.1) All users of GroupWise 7 SP1 WebAccess should experience some performance improvement because the amount of data downloaded when accessing the server has been reduced for nearly all requests.
Monitor Installation program can install and configure Tomcat 5.5 into an existing Microsoft Internet Information Server. NOTE: The Novell Servlet Gateway is no longer shipped or supported with Monitor. 12.7.2 IPV6 Support (v7.0) Like the POA and the MTA, the Monitor Agent now supports IPV6 on Linux and Windows, as described in Section 12.2.2, “IPV6 Support (v7.0),”...
Report” in “Monitor” in the GroupWise 7 Administration Guide (http://www.novell.com/documentation/gw7). 12.7.8 Image Map (v7.0) An image map enables you to create a visual picture of your GroupWise system, whether it resides in a single office building or spans the globe. You provide the maps; Monitor provides up-to-the- minute status information at a glance.
303. 13.1 Understanding eDirectory Schema Extensions GroupWise 7 includes new functionality that requires you to extend the schema of any Novell eDirectory trees where you have GroupWise objects. The GroupWise Setup automatically extends the schema for any trees you select.
ConsoleOne is included on the GroupWise 7 Administrator for NetWare/Windows CD. If necessary, you can install it at the same time as the other GroupWise software. Linux users can download ConsoleOne for Linux from the Novell Product Downloads site (http:// download.novell.com) and install it before starting to install GroupWise.
Agent Problems” in GroupWise 7 Troubleshooting 2: Solutions to Common Problems (http:// www.novell.com/documentation/gw7). 13.4 Understanding GroupWise Client Updates After a post office is updated to version 7, users can run the GroupWise 7 Windows client or Cross- Platform client on workstations listed in Section 2.2, “GroupWise Client Requirements,”...
13.5 Understanding Internet Agent Updates The GroupWise 7 Internet Agent is fully functional only when running against GroupWise 7 domains and post offices. If you run it against a GroupWise 5.x or 6.x domain or post office, users on GroupWise 5.x and 6.x post offices can send and receive Internet messages (SMTP support), but cannot use POP3 and IMAP4 clients to access their mailboxes.
13.6.2 WebAccess Application on the Web Server The GroupWise WebAccess Agent can communicate with the GroupWise 5.5 or newer WebAccess Applications on your Web server. If you have GroupWise 5.5 or later, you can update your WebAccess Agent independent of the WebAccess components on the Web server. The GroupWise 7 WebAccess Agent cannot communicate with pre-5.5 Web server components.
If problems exist, you should recover or rebuild the database. For information about validating, recovering, or rebuilding a database, see the documentation for your GroupWise version at the Novell Documentation Web site (http://www.novell.com/ documentation). Back up the domain or post office immediately before updating it. For information about...
Section 15.8, “Updating GroupWise Monitor,” on page 260 15.1 Installing the GroupWise 7 Software To start the GroupWise Installation program: 1 Log in as an Admin equivalent to the Novell eDirectory tree where you are installing GroupWise. 2 Insert the GroupWise 7 Administrator CD for your platform into the CD drive.
Page 252
4 Click Create or Update a GroupWise System, then click Yes to accept the license agreement and display the Welcome to GroupWise Install dialog box. 5 Click Next until you reach the Administration Options dialog box. 252 GroupWise 7 Installation Guide...
Page 253
6 Make sure that Create a New System or Update an Existing System is selected, then click Next 7 Follow the prompts to provide the following information from your Basic GroupWise System Worksheet. Not all prompts appear on all platforms Item 1: Select Languages Item 2: ConsoleOne Path Item 3: Software Distribution Directory...
9 Click Updating an Existing GroupWise System, then click Next to display the Update GroupWise System dialog box. 10 Continue with the next section, Updating the Primary Domain. 15.2 Updating the Primary Domain To update the primary domain, you need to install and start the GroupWise 7 MTA. The MTA uses the new domain dictionary file ( ) to update the domain database to version 7.
Linux: To install the MTA on a Linux server, click Finish, then click Install Products > Install GroupWise Agents to start the Agent Installation program. Windows: To install the MTA to a Windows server, click Finish, go to the Windows server, ensure that you have access to the primary domain directory, then start the Agent Installation program ( install.exe...
To install and start the POA: 1 Start the Agent Installation program. NetWare: To install the POA to a NetWare server, make sure the workstation has access to both the post office directory and the NetWare server where you want to install the POA.
“Refreshing the Client View Files in the Post Office” in “Post Offices” in the GroupWise 7 Administration Guide (http://www.novell.com/ documentation/gw7). 15.4 Updating Users’ GroupWise Clients After a post office is updated to version 7, users who have accounts in that post office can start using the GroupWise 7 clients.
Page 258
3 Select the software distribution directory you want to update, then click Update to display the Update Software Distribution Directory dialog box. 4 Click Update by Copying From. 5 Click Software Distribution Directory, then select the GroupWise 7 software distribution directory.
IMPORTANT: When you turn on auto-update (the Force Auto-Update Check by GroupWise Components option), a flag is set in each post office database. This flag instructs the GroupWise client to check for updated software. GroupWise clients using direct access mode (mapped or UNC path) read this new setting in the post office database and automatically check for updated software.
IMPORTANT: After you have updated the WebAccess software, notify your WebAccess client users that they should clear their browser caches before logging into their mailboxes with the updated WebAccess client. If old WebAccess files are pulled from users’ browser caches, they might not be compatible with the updated files pulled from the Web server.
Updating Your GroupWise 5.x System to Version 7 ® ® The process and procedures for updating a Novell GroupWise 5.x system to version 7 are the same as when updating a GroupWise 6.x system to version 7. Refer to the following sections for instructions: Chapter 13, “Understanding the Update Process,”...
Novell Product Downloads site (http:// download.novell.com), can consist of one domain, two post offices, and as many as five users in each post office. When you purchase the full GroupWise product, install the GroupWise ® Administrator snap-ins to ConsoleOne .
Migration I I I ® This section is designed for those who are moving existing GroupWise 7 users, post offices, and ® domains from NetWare or Windows to Linux. This section describes the manual steps involved in the process. As an alternative, you can use the GroupWise Server Migration Utility to perform some of the steps for you.
Transitioning Windows Users to Linux or Macintosh When users move from Windows workstations to Linux or Macintosh, they first need to install the Cross-Platform client, as described in Section 8.4, “Setting Up the GroupWise Client,” on page 204. ® They can then immediately use the Cross-Platform client to connect to their GroupWise ®...
Transitioning GroupWise Administration to Linux ® ® You migrate your GroupWise system from NetWare or Windows to Linux one post office and domain at a time. During the migration process, your system has domains and post offices on ® various platforms. You might use ConsoleOne on both Windows and Linux to administer domains and post offices located on any platform.
From a Windows workstation or server where the Novell client is installed, you can now use the Novell Map Network Drive feature to map a drive to the volume on your Linux server, and Windows-type file locking is respected by Linux.
A NetWare server full DNS name should have the format of mail2.provo.corporate.com. A fully qualified username should have the format of Admin.Users.Corporate. A typical Linux mount location would be /mnt. You can also use Novell Remote Manager (NRM) to create the NCP mount. Windows: mount -t smbfs //Windows_server_name/sharename...
Page 272
Guide, but the following documentation can provide assistance: If you are migrating to OES Linux, review Consolidating Data to OES Linux and Migrating Data from NetWare Servers in the Novell Server Consolidation and Migration Toolkit Administration Guide (http://www.novell.com/documentation/scmt/index.html). For situations not covered in the above guide, the eDirectory migration process includes...
Utility” in “Databases” in the GroupWise 7 Administration Guide (http://www.novell.com/documentation/gw7), you create a copy of the post office and then back up the copy, which requires double the post office size in disk space. If you want to use the GroupWise Target Service Agent (TSAFSGW), as described in “Target...
7 Install GroupWise Check (GWCheck) as described in “Using GWCheck on Linux” in “Databases” in the GroupWise 7 Administration Guide (http://www.novell.com/ documentation/gw7). 8 Continue with Performing the Post Office Migration. 20.2 Performing the Post Office Migration In order to reduce the amount of time during which users cannot access their GroupWise mailboxes during the post office migration process, the post office data is copied twice.
Page 275
Problems” in “Strategies for Agent Problems” in GroupWise 7 Troubleshooting 2: Solutions to Common Problems (http://www.novell.com/ documentation/gw7). 5 If you have access to a GroupWise mailbox on the post office you have migrated, start the GroupWise client to further verify the functioning of the POA.
Page 276
If you encounter problems accessing documents after the migration, refer to TID 10101095 in Novell Knowledgebase (http://www.novell.com/support). 10 Notify users that they must exit the GroupWise client unless they are running in Caching mode.
3g Make sure that the Log File Path field is empty so that the POA on Linux creates its log files in the default location ( /var/log/novell/groupwise/post_office_name.poa on the Linux server. 3h Click OK to save the new configuration information for the POA.
4e Click Run to run GWCheck. If you need to run GWCheck in a text-only environment, see “Using Text-Based GWCheck (gwcheckt)” in “Databases” in the GroupWise 7 Administration Guide (http:// www.novell.com/documentation/gw7) for additional instructions. 278 GroupWise 7 Installation Guide...
Page 279
Agent” in the GroupWise 7 Administration Guide (http://www.novell.com/documentation/gw7), users are automatically redirected to the new IP address when they start GroupWise. 9 When the Linux POA is running smoothly for the new post office location, delete the old post office directory structure from the NetWare or Windows server.
Utility” in “Databases” in the GroupWise 7 Administration Guide (http://www.novell.com/documentation/gw7), you create a copy of the domain and then back up the copy, which requires double the domain size in disk space. If you want to use the GroupWise Target Service Agent (TSAFSGW), as described in “Target...
6 Install the GroupWise Database Copy utility (DBCopy) as described in “Using DBCopy on Linux” in “Databases” in the GroupWise 7 Administration Guide (http://www.novell.com/ documentation/gw7). 7 Continue with Performing the Domain Migration. 21.2 Performing the Domain Migration 1 On the NetWare or Windows server, stop the MTA for the domain.
9 If you plan to use SSL on Linux, create new certificate and key files for the Linux server and place them in the directory, the default location /opt/novell/groupwise/agents/bin where the MTA looks for certificate and key files. For instructions on creating certificate and key files, see “Server Certificates and SSL...
4 Set up a backup procedure for the domain in its new location on Linux, as described in “GroupWise Database Copy Utility” or “Target Service Agents” in “Databases” in the GroupWise 7 Administration Guide (http://www.novell.com/documentation/gw7). 284 GroupWise 7 Installation Guide...
Page 285
5 If the domain has an Internet Agent that is running on the same NetWare or Windows server where the domain directory was previously located, migrate the Internet Agent to the Linux server where the domain directory is now located, as described in Chapter 22, “Manually Migrating the Internet Agent to Linux,”...
Linux server and placing them in filename.crt filename.key) directory, as described in Step 9 Section 21.2, /opt/novell/groupwise/agents/bin “Performing the Domain Migration,” on page 282. 2 On the Linux server, become in a terminal window. root 3 Make the Linux server visible from Windows.
Page 288
Problems” in the GroupWise 7 Troubleshooting 2: Solutions to Common Problems (http:// www.novell.com/documentation/gw7). 12 When the Linux Internet Agent is running smoothly for the new domain location, and other GroupWise agents belonging to the domain have been migrated to Linux as needed, delete the old domain directory structure from the NetWare or Windows server.
Page 289
13 If the SMTP queue directory was located outside the domain directory structure, delete this directory and its contents from the NetWare or Windows server. 14 If desired, uninstall the Internet Agent software to reclaim disk space on the NetWare or Windows server.
“Creating a New Domain” in “Domains” in the GroupWise 7 Administration Guide (http://www.novell.com/documentation/gw7). 3 If your Linux environment includes the X Window System, run the GUI GroupWise Installation program to install the Linux WebAccess Agent software, as described in “Installing the Linux WebAccess Agent”...
Page 292
WebAccess, and optionally WebPublisher, software directories: /opt/novell/groupwise/webaccess /opt/novell/groupwise/webpublisher If you plan to run multiple WebAccess Agents for the domain, this step needs to be done only for the primary WebAccess Agent, as listed on the Environment property page of the GroupWise Provider object.
“Configuring WebPublisher” on page 126. 5 In ConsoleOne, review the property pages for the old WebAccess Application objects: GroupWise WebAccess Novell Speller LDAP Provider GroupWise Provider GroupWise Document Provider 6 transfer any settings that you have customized on the old WebAccess Application objects to the new WebAccess Application objects.
Page 294
WebPublisher object to the new GroupWise WebPublisher object. 8 If you have customized any WebAccess or WebPublisher template files, copy the customized template files from the old Web server to the following directories on the Linux Web server: /var/opt/novell/gw/WEB-INF/classes/com/novell/webaccess/templates /var/opt/novell/gw/WEB-INF/classes/com/novell/webpublisher/ templates 9 Stop and then start Apache and Tomcat, as described in “Restarting the Web Server”...
Page 295
11b11 Restart the IIS Web server to put the redirections into effect. 11c If your old Web server was Netscape Enterprise Server for NetWare, search the Novell Support Web site (http://www.novell.com/support) for redirection instructions. 12 Notify users of the new WebAccess and WebPublisher URLs so that users can update their browser bookmarks if they want to.
Manually Migrating Monitor to Linux As with WebAccess, you can migrate just the Monitor Agent, just the Monitor Application, or both from Windows to Linux. The process includes accessing a domain (either local or remote), installing the Monitor software on Linux, copying the Monitor Agent configuration file ( ) from monitor.xml Windows to Linux, and modifying the configuration file.
“Strategies for Agent Problems” in the GroupWise 7 Troubleshooting 2: Solutions to Common Problems (http://www.novell.com/documentation/gw7). 9 Stop the Linux Monitor Agent, as described in “Stopping the Linux GroupWise Agents” on page 189 10 Copy the Monitor Agent configuration file ( ) from its Windows location: monitor.xml...
Page 299
4 Stop and then start Apache and Tomcat, as described in “Restarting the Web Server” on page 150. 5 Verify that the new Monitor Application is communicating successfully with the existing Monitor Agent by viewing the Monitor URL for the platform of your Web server: NetWare or Windows Web Server: http://web_server_network_address/gw Linux Web Server:...
Appendixes Appendix A, “GroupWise Version Compatibility,” on page 303 Appendix B, “Third-Party Materials,” on page 313 Appendix C, “Documentation Updates,” on page 323 Appendixes...
GroupWise Version Compatibility ® ® Use the tables in this section to determine compatibility among the following Novell GroupWise versions: Section A.1, “GroupWise 7 on NetWare and Windows,” on page 303 Section A.2, “GroupWise 7 on Linux,” on page 307 IMPORTANT: GroupWise 5.x versions have entered the end-of-life phase and are no longer...
Page 304
GroupWise 6.x Administrative Components with GroupWise 7 GroupWise 6.x GW 6.x Objects in ConsoleOne + GroupWise 7 Domain and Post Office eDirectory GW 6.x Snap-Ins Components Databases GW 7 Domain and Post Not Supported Office Databases GW 7 Objects in Not Supported eDirectory ConsoleOne +...
GroupWise 6.x Windows Client with GroupWise 7 GroupWise 7 GW 7 POA GW 7 POA GW 7 POA GroupWise 6.x Post Office Client/Server Access Client/Server Access Dial-Up Access Windows Client Direct Access Online Mode Caching Mode Remote Mode Windows Not Supported Supported Supported Supported...
Page 306
Table Summary: NetWare Administrator cannot be used to administer GroupWise 7 systems. ConsoleOne with the GroupWise 7 snap-ins can be used to administer GroupWise 5.x systems. The general rule is that later GroupWise snap-ins can administer earlier GroupWise system components, but earlier GroupWise snap-ins cannot administer later GroupWise system components.
GroupWise 7 Windows Client with GroupWise 5.x GroupWise 5.x GW 5.x POA GW 5.x POA GW 5.x POA GroupWise 7 Post Office Client/Server Access Client/Server Access Dial-Up Access Client Direct Access Online Mode Caching Mode Remote Mode Windows Not Supported Not Supported Not Supported Not Supported...
Page 308
Table Summary: On both Linux and Windows, ConsoleOne with the GroupWise snap-ins can be used to access GroupWise databases for domains and post offices and GroupWise objects in eDirectory located on NetWare, Linux, or Windows. When using Linux ConsoleOne to administer domains and post offices on NetWare or Windows, you must mount the NetWare or Windows server to your Linux machine.
Table Summary: The GroupWise 7 Linux Cross-Platform client can communicate in client/server mode with the GroupWise 7 POA on NetWare or Windows. The Cross-Platform client cannot access the post office directly, nor can it communicate with the GroupWise 7 POA across a dial-up connection over a modem.
Page 310
GroupWise 7 Linux Agents with GroupWise 6.x on NetWare or Windows GroupWise 6.x GW 6.x MTA GW 6.x POA GW 6.x GWIA GW 6.x GW 6.x Domain and on NetWare on NetWare on NetWare WebAccess Monitor Post Office or Windows or Windows or Windows on NetWare...
Page 311
GroupWise 6.5 Cross-Platform Client with GroupWise 7 on NetWare or Windows GroupWise 7 GW 7 POA GW 7 POA GW 7 POA GroupWise 6.x Post Office Client/Server Access Client/Server Access Dial-Up Access Client Direct Access on Online Mode on Caching Mode on Remote Mode on on Linux NetWare or WIndows...
Third-Party Materials ® ® The following third-party software is included in Novell GroupWise Section B.1, “Apache,” on page 313 Section B.2, “BLT,” on page 314 Section B.3, “GD Graphics Library,” on page 314 Section B.4, “getopt.h,” on page 315 Section B.5, “JRE,” on page 316 Section B.6, “NET-SNMP Open Source Package,”...
BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Portions relating to GIF decompression copyright 1990, 1991, 1993 by David Koblas, with modifications for thread safety by Thomas Boutell. Portions relating to WBMP copyright 2000, 2001, 2002, 2003, 2004 Maurice Szmurlo and Johan Van den Brande. Permission has been granted to copy, distribute and modify gd in any context without fee, including a commercial application, provided that this notice is present in user-accessible supporting documentation.
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. B.5 JRE JRE Note This product includes code licensed from RSA Security, Inc.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
Redistribution and use in source and binary forms, with or without modifications, are permitted provided that the following conditions are met: Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
The OpenLDAP Foundation may revise this license from time to time. Each revision is distinguished by a version number. You may use this Software under terms of this license revision or under the terms of any subsequent revision of the license. THIS SOFTWARE IS PROVIDED BY THE OPENLDAP FOUNDATION AND ITS CONTRIBUTORS ``AS IS’’...
Page 321
6 Redistributions of any form whatsoever must retain the following acknowledgment: “This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org/)” THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS’’ AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
4 If you include any Windows specific code (or a derivative thereof) from the apps directory (application code) you must include an acknowledgement: “This product includes software written by Tim Hudson (tjh@cryptsoft.com)” THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS’’ AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
This section lists updates to the Installation Guide that have been made since the initial release of ® ® Novell GroupWise 7. The information helps you to keep current on documentation updates and, in some cases, software updates (such as a Support Pack release).
Location Change Section 20.2, “Performing Added the -m switch to the command for migrating libraries to dbcopy the Post Office Migration,” Linux and provided a link to a helpful TID if problems with documents are on page 274 encountered after the migration. Section 21.2, “Performing Removed the --noconfig switch from the gwmta...
Domain or Post Office on NetWare or Windows from Linux ConsoleOne,” on page 271 Appendix Appendix A, “GroupWise Added a link to the Novell GroupWise 7 Feature Comparison chart. Version Compatibility,” on page 303 C.5 August 15, 2006 Location Change Install Section 2.1, “GroupWise...
Location Change Section 5.4.2, “Linux: Provided a link to TID 3248145 in the Novell Support Knowledgebase Setting Up GroupWise (http://www.novell.com/support) that provides instructions for installing WebAccess,” on page 123 WebAccess on SUSE Linux Enterprise Server 10. Section 6.4.2, “Linux: Provided a link to TID 3248145 in the...
Location Change “Enabling the High Availability Added that the WebAccess Agent and its accompanying Document Service for the Linux Viewer Agent are now supported by the GroupWise High Availability GroupWise Agents” on Service. page 185 “Preparing the Windows Indicated that if you are running the Windows POA for a post office on a ®...
Page 328
Its POA to Linux,” on page 273 Chapter 21, “Manually Added a second example mount command. Migrating a Domain and Its MTA to Linux,” on page 281 Entire Guide Page design reformatted to comply with revised Novell documentation standards. 328 GroupWise 7 Installation Guide...
Need help?
Do you have a question about the GROUPWISE 7 and is the answer not in the manual?
Questions and answers