With compelling new features in SUSE Linux Enterprise Server—and the stellar workgroup services found in Novell Open Enterprise Server 2—the benefits of moving your Novell GroupWise environment to Linux are more readily apparent than ever. This session will cover how you can use available Novell tools to move a GroupWise system to the Linux platform. In addition to tools and utilities, we'll share practical tips, tricks and demonstrations.

1. Migrating Novell ®
GroupWise to Linux ®
Robin Redgrave Tim Heywood
Collaboration Technical Specialist CTO, NDS8
rredgrave@novell.com tim.heywood@nds8.co.uk

2. Agenda
• Preparing to migrate
• Manual Migration vs. Wizard Migration
• Domain Migration
• Post Office Migration
• What’s going on behind the scenes
• Troubleshooting
• Question and Answer
2 © Novell, Inc. All rights reserved.

3. Planning the Migration
• Health Check first
• Contents check on all post Offices
– Resolve all problems and errors
3 © Novell, Inc. All rights reserved.

4. Planning the Migration
• Planning
– Is hardware being replaced?
– New hosts virtualised?
4 © Novell, Inc. All rights reserved.

5. Special Considerations
• Case sensitivity
– On Linux, Novell GroupWise , will expect all lowercase
® ®
filenames
• Management
– You need to decide how to access your GW domain
> ConsoleOne on the Linux server
®
> ConsoleOne on Windows workstation
5 © Novell, Inc. All rights reserved.

6. The Migration

7. Manual Migration vs. Wizard
• Manual Migration is “easy” - if you understand
Linux
• Wizard is more “hidden”
– More things to “go wrong”
– Much easier if you aren't that comfortable with Linux
7 © Novell, Inc. All rights reserved.

8. Manual Migration
• Install the Agents on the Linux Server
• Copy Novell GroupWise data to Linux Server
® ®
• Configure the Agents
• Load the Agents
Sounds simple huh?
8 © Novell, Inc. All rights reserved.

9. Wizard Migration
• Run the Wizard
Sounds even more simple
9 © Novell, Inc. All rights reserved.

10. Manual Migration vs. Wizard
• If it's that simple why don't we just use the wizard?
– Path...
– There is no control over the destination
– Log File locations
– Clustering
10 © Novell, Inc. All rights reserved.

11. Manual Migration

12. Prerequisites
• A Linux Server
• NCPFS on Linux Server *
– This allows you to mount a drive to a NetWare Server
®
• SMBFS on Linux Server * (usually there by default)
– This allows you to mount a drive to a Windows Server
• Adequate Disk Space for Migration
• Novell GroupWise Linux software
® ®
• ConsoleOne and snapins on Linux server
®
* Depending on what you are migrating from
12 © Novell, Inc. All rights reserved.

13. Which File System
• Recommended Choices
– NSS
– EXT3
– Reiser
– EXT3 with H-Tree?
> Currently avoid
– XFS
> Currently avoid
13 © Novell, Inc. All rights reserved.

14. Which Linux?
• Open Enterprise Server
– Manageability
> Integrated with Novell eDirectory
®
™
> Novell client / NCP access to all file systems
™
> Linux User Management
> Novell Remote Manager
– Novell Cluster Services ™
• SUSE Linux Enterprise Server
®
– One free server license with Novell GroupWise purchase*
®
* - “Or as many as your Novell GroupWise system Requires”
14 © Novell, Inc. All rights reserved.

15. Data Preparation
Belt, Braces and Binder Twine!
Run a change case utility to make all files
lower case before you start
http://www.febooti.com/
15 © Novell, Inc. All rights reserved.

16. Server Configuration
• Install SUSE Linux Enterprise Server and
®
partition disk
– Partitioning scheme
> boot – ext3 – 5GB+
> swap 2GB
> /var – 10 GB
> /srv GroupWise data partition
®
» dbcopy, 3 times post office size
» tsafsgw, 2 times post office size
> /srv/backup or /srv/restore partition is an option
– Logical vs. primary
> Only four primary partition permitted (primary or extended)
» Multiple extended partitions?
» LVM or EVMS?
16 © Novell, Inc. All rights reserved.

17. Accessing File Systems
• Use NCP to access domains on NetWare servers or
®
OES2 Linux servers
• Use SMB/CIFS to access domains on SUSE Linux ®
Enterprise Server or Windows servers
• Using NFS will result in File Lock (820E) errors
– (or is that OK?)
17 © Novell, Inc. All rights reserved.

18. Moving Your Post Office
• Phase One
– Install agent software on your Linux server for all objects you plan
to migrate
> Agents
> GWIA
> WebAccess Agent
> WebAccess Application
– Make sure ngwguard.db is lower case before running
– Mount a drive to your NetWare server ®
> ncpmount -S server -A 123.123.123.123 -U userid -P password /mnt/netware/server
• NCPFS is slow
18 © Novell, Inc. All rights reserved.

19. Moving Your Post Office
• Use DBCopy
– Run dbcopy to make first pass copy of the post office
> dbcopy –p –m –f –k <source> <destination>
> –p Post Office Migration
> –m This is a migration – storelowercase and case conversion
> -f First pass of a migration
> -k do not calculate database sizes etc.
– The first pass copy can be run days prior to the final copy, or
immediately preceding
19 © Novell, Inc. All rights reserved.

20. Configuring Post Office
• Configuring Agent
– Creates POA startup file
– Configures gwha.conf
• Start POA on Linux server for testing
– /opt/novell/groupwise/agents/bin/gwpoa @startup.poa –show
• Watch via the “-show” window
• Connect to test – specify the IP address
• Shut down this POA
20 © Novell, Inc. All rights reserved.

21. Post Office Migration – Phase Two
• Stop the source Post Office Agent
• Edit Post Office configuration
– Post Office UNC path (do this first)
– POA IP address
– POA Platform
– Ports (if needed)
– Log file path
– SSL cert/key file paths
– Remote Library Storage area path
– LDAP server Trusted Root certificate for LDAP authentication
21 © Novell, Inc. All rights reserved.

22. Post Office Configuration– Phase Two
• Rebuild the PO
– Rebuild to c:temp
– Rename the old wphost.db
– Copy the new wphost.db
22 © Novell, Inc. All rights reserved.

23. Migrating Post Office – Phase Two
• Use DBCopy
– Run dbcopy to make the second pass copy of the post office
> dbcopy –p –m –s –k <source> <destination>
> –p Post Office Migration
> –m This is a migration – storelowercase and case conversion
> –s Second pass of a migration
> –k Still do not calculate database sizes etc.
• DO NOT USE –l or -o switches!
23 © Novell, Inc. All rights reserved.

24. Remote Library Storage Area
• May need to manually copy remote library storage
area to Linux server
• Modify storage path in ConsoleOne ®
• Do this before starting the POA
24 © Novell, Inc. All rights reserved.

25. Post Office Migration
• Start the POA on the Linux server, verify that you
can log in and send mail in and out of the GWIA
– and to another post office on another server
25 © Novell, Inc. All rights reserved.

26. Migrating Domains and Gateways

27. Domain Migration
• Gateways – Kill or Keep?
– If you have other Gateways running GWIA etc
> Kill – Cleaner in the new environment
– No other Gateways
> Kill – Create temporary gateways
– If you really insist – yes it will work
YMMV
27 © Novell, Inc. All rights reserved.

28. Domain Migration
• The Domain does not require a two step migration
process, because it is typically a “fast” process
– Clean out queues from “old” and invalid information
– Clean out “problem” and “log” directories
– Stop the GWIA
– Stop the GWINTER
– Stop any other gateways
– Delete the Gateways (save the gwac.db first)
– Stop the MTA
28 © Novell, Inc. All rights reserved.

29. Migrating the Domain
• Mount your source server
• Run dbcopy –d –m <source> <destination>
–d domain copy
–m migration
29 © Novell, Inc. All rights reserved.

30. Domain Migration
• In ConsoleOne , change the IP ®
addresses and paths for all migrated
objects (including gateways)
• Verify the link configuration for the
migrated domain
30 © Novell, Inc. All rights reserved.

31. Domain Migration
• Edit domain configuration
– Domain UNC path
– MTA IP address
– MTA Platform
– Ports (if needed)
– Log file path
– Message log path (if enabled)
– SSL cert/key file paths
– Run the Agent Configuration module from the Linux
Install application
31 © Novell, Inc. All rights reserved.

32. If you MUST migrate Gateways

33. Gateways – GWIA
• Edit GWIA settings in ConsoleOne ®
– Change Platform to Linux
– Modify NetWork Address settings
> Bind Exclusively to TCP/IP Address
» Allows coexistence with Postfix (Watch out for SLES10 SP3)
– Modify /dhome path (if not in current gwia.cfg)
– Modify Log path
– Modify SSL path
> May need to create new certificates for new server
• Change MX record to point to new DNS name
• Run the GWIA configuration module in the Linux
installation program
33 © Novell, Inc. All rights reserved.

34. Gateways – WebAccess
• If running remote, edit starup file to point to new UNC
for the new domain location
• Configure the WebAccess Agent with the
Installation software
• Install and Configure WebAccess application on
Linux Server
– If application is on another server, copy commgr.cfg to
application directory to use new agent IP address
34 © Novell, Inc. All rights reserved.

35. Domain Migration
Start the MTA
Start the Internet Agent
Start the WebAccess Agent
35 © Novell, Inc. All rights reserved.

36. Verify Your Migration
Verify that all portions of your migration have
been successful
36 © Novell, Inc. All rights reserved.

37. The Novell Migration Wizard
®

38. Prerequisites – NetWare ®
38 © Novell, Inc. All rights reserved.

39. Prerequisites – Windows
39 © Novell, Inc. All rights reserved.

40. Source Server
40 © Novell, Inc. All rights reserved.

41. Destination Server
41 © Novell, Inc. All rights reserved.

42. Software Location
42 © Novell, Inc. All rights reserved.

43. Select Component to Migrate
43 © Novell, Inc. All rights reserved.

44. Auto Detect /Add Post Office
– Looks in SYS:SYSTEM for GRPWISE.NCF and agent
startup files
– Add Post Office to configure manually
– Destination path is cosmetic
44 © Novell, Inc. All rights reserved.

45. Post Office Migration – Phase One
45 © Novell, Inc. All rights reserved.

46. Behind the Scenes – Phase One
• Creates directory structure on Linux server
• Copies and installs RPM’s to Linux server
• Mounts source server
– NCP mount to Netware ®
– Samba mount to Windows
• Runs dbcopy –a 127.0.0.1 –p –m –f –k –u 5001
– -a sends status update to update utility
– -p designates a post office copy
– -m to migrate to lower case
– -f first pass (phase one copy)
– -k don’t compute size before copy
– -u port for –a parameter
46 © Novell, Inc. All rights reserved.

47. Behind the Scenes – Phase One
• Creates POA startup file
• Configures gwha.conf
• Starts POA on Linux server for testing
• Removes RPM files (if selected)
• Shuts down POA
47 © Novell, Inc. All rights reserved.

48. Post Office Migration – Phase One
48 © Novell, Inc. All rights reserved.

49. Post Office Configuration
49 © Novell, Inc. All rights reserved.

50. Post Migration Configuration
• Edit Post Office configuration
– Post Office UNC path (do this first)
– POA IP address
– POA Platform
– Ports (if needed)
– Log file path
– SSL cert/key file paths
– Remote Library Storage area path
– LDAP server Trusted Root certificate for LDAP authentication
50 © Novell, Inc. All rights reserved.

51. Post Office Migration – Phase Two
51 © Novell, Inc. All rights reserved.

52. Behind the Scenes – Phase Two
• Mounts source server
• dbcopy –a 127.0.0.1 –m –s –i <date> –u 5001
– -a sends status update to update utility
– -m to migrate to lower case
– -s second pass (phase two copy)
> -i incremental copy based on date
– -u port for –a parameter
• dbcopy executes gwcheck call for /storelowercase
option
– When –s option is used
52 © Novell, Inc. All rights reserved.

53. Behind the Scenes – Phase Two
• Migration utility ships with own version of dbcopy
– Optimized for performance
• Removes temp files
• Dismounts source server
53 © Novell, Inc. All rights reserved.

54. Remote Library Storage Area
• May need to manually copy remote library storage
area to Linux server
• Modify storage path in ConsoleOne ®
54 © Novell, Inc. All rights reserved.

55. Post Office Migration
55 © Novell, Inc. All rights reserved.

56. Domain Migration
56 © Novell, Inc. All rights reserved.

57. Add Domain
57 © Novell, Inc. All rights reserved.

58. Add Agent – GWIA
58 © Novell, Inc. All rights reserved.

59. Add Agent – GWIA
59 © Novell, Inc. All rights reserved.

60. Behind the Scenes – Domain
• One pass only
• Creates directory structure on Linux server
• Copies and installs RPM’s to Linux server
– Includes GWIA and GWINTER, but not
WebAccess application
• Mounts source server
• Runs dbcopy –a 127.0.0.1 –d –m –k –u 5001
– -a sends status update to utility
– -d designates a domain copy
– -m to migrate to lower case
– -k don’t compute size before copy
– -u port for –a parameter
60 © Novell, Inc. All rights reserved.

61. Domain Migration
61 © Novell, Inc. All rights reserved.

62. Domain Migration
• Edit domain configuration
– Domain UNC path
– MTA IP address
– MTA Platform
– Ports (if needed)
– Log file path
– Message log path (if enabled)
– SSL cert/key file paths
62 © Novell, Inc. All rights reserved.

63. Gateways – GWIA
• Edit GWIA settings in ConsoleOne ®
– Change Platform to Linux
– Modify NetWork Address settings
> Bind Exclusively to TCP/IP Address
» Allows coexistence with Postfix
– Modify /dhome path (if not in current gwia.cfg)
– Modify Log path
– Modify SSL path
> May need to create new certificates for new server
• Change MX record to point to new DNS name
63 © Novell, Inc. All rights reserved.

64. Domain Migration
64 © Novell, Inc. All rights reserved.

65. Post Migration Tips
• Verify outbound MTP IP address for Post Offices after
domain migration (use HTTP Console)
• Start/Stop agents without UI
– /etc/init.d/grpwise start <agentname>
> Or rcgrpwise start <agentname>
– /etc/init.d/grpwise stop <agent>
– /etc/init.d/grpwise status
• Start agents with UI
– /opt/novell/groupwise/agents/bin/gwpoa –show @startup.poa
65 © Novell, Inc. All rights reserved.

66. Troubleshooting
• Utility log file
– gwsvrmig_MM-DD-YYYY.log
> In gwsvrmig directory or temp directory
– Check log for errors
• dbcopy log file
> <po>/<date>gwbk.001
• ssh
– Firewall issues – enable ssh port 22
• nfsmount/Samba mounts
– Verify reads/writes to mounted file systems
66 © Novell, Inc. All rights reserved.

68. Unpublished Work of Novell, Inc. All Rights Reserved.
This work is an unpublished work and contains confidential, proprietary, and trade secret information of Novell, Inc.
Access to this work is restricted to Novell employees who have a need to know to perform tasks within the scope
of their assignments. No part of this work may be practiced, performed, copied, distributed, revised, modified,
translated, abridged, condensed, expanded, collected, or adapted without the prior written consent of Novell, Inc.
Any use or exploitation of this work without authorization could subject the perpetrator to criminal and civil liability.
General Disclaimer
This document is not to be construed as a promise by any participating company to develop, deliver, or market a
product. It is not a commitment to deliver any material, code, or functionality, and should not be relied upon in
making purchasing decisions. Novell, Inc. makes no representations or warranties with respect to the contents
of this document, and specifically disclaims any express or implied warranties of merchantability or fitness for any
particular purpose. The development, release, and timing of features or functionality described for Novell products
remains at the sole discretion of Novell. Further, Novell, Inc. reserves the right to revise this document and to
make changes to its content, at any time, without obligation to notify any person or entity of such revisions or
changes. All Novell marks referenced in this presentation are trademarks or registered trademarks of Novell, Inc.
in the United States and other countries. All third-party trademarks are the property of their respective owners.