68
Migrating Novell® GroupWise® to Linux Robin Redgrave Collaboration Technical Specialist [email protected] Tim Heywood CTO, NDS8 [email protected]

Migrating Novell GroupWise to Linux

  • Upload
    novell

  • View
    6.374

  • Download
    1

Embed Size (px)

DESCRIPTION

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.

Citation preview

Page 1: Migrating Novell GroupWise to Linux

Migrating Novell® GroupWise® to Linux

Robin RedgraveCollaboration Technical [email protected]

Tim HeywoodCTO, [email protected]

Page 2: Migrating Novell GroupWise to Linux

© Novell, Inc. All rights reserved.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

Page 3: Migrating Novell GroupWise to Linux

© Novell, Inc. All rights reserved.3

Planning the Migration

• Health Check first

• Contents check on all post Offices

– Resolve all problems and errors

Page 4: Migrating Novell GroupWise to Linux

© Novell, Inc. All rights reserved.4

Planning the Migration

• Planning

– Is hardware being replaced?

– New hosts virtualised?

Page 5: Migrating Novell GroupWise to Linux

© 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

Page 6: Migrating Novell GroupWise to Linux

The Migration

Page 7: Migrating Novell GroupWise to Linux

© Novell, Inc. All rights reserved.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

Page 8: Migrating Novell GroupWise to Linux

© 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?

Page 9: Migrating Novell GroupWise to Linux

© Novell, Inc. All rights reserved.9

Wizard Migration

• Run the Wizard

Sounds even more simple

Page 10: Migrating Novell GroupWise to Linux

© 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

Page 11: Migrating Novell GroupWise to Linux

Manual Migration

Page 12: Migrating Novell GroupWise to Linux

© Novell, Inc. All rights reserved.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

Page 13: Migrating Novell GroupWise to Linux

© Novell, Inc. All rights reserved.13

Which File System

• Recommended Choices– NSS– EXT3– Reiser– EXT3 with H-Tree?

> Currently avoid– XFS

> Currently avoid

Page 14: Migrating Novell GroupWise to Linux

© 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”

Page 15: Migrating Novell GroupWise to Linux

© 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/

Page 16: Migrating Novell GroupWise to Linux

© 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?

Page 17: Migrating Novell GroupWise to Linux

© 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?)

Page 18: Migrating Novell GroupWise to Linux

© 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

Page 19: Migrating Novell GroupWise to Linux

© 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

Page 20: Migrating Novell GroupWise to Linux

© 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

Page 21: Migrating Novell GroupWise to Linux

© 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

Page 22: Migrating Novell GroupWise to Linux

© 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

Page 23: Migrating Novell GroupWise to Linux

© 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!

Page 24: Migrating Novell GroupWise to Linux

© 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

Page 25: Migrating Novell GroupWise to Linux

© 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

Page 26: Migrating Novell GroupWise to Linux

Migrating Domains and Gateways

Page 27: Migrating Novell GroupWise to Linux

© Novell, Inc. All rights reserved.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

Page 28: Migrating Novell GroupWise to Linux

© 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

Page 29: Migrating Novell GroupWise to Linux

© Novell, Inc. All rights reserved.29

Migrating the Domain

• Mount your source server

• Run dbcopy –d –m <source> <destination>

–d domain copy

–m migration

Page 30: Migrating Novell GroupWise to Linux

© 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

Page 31: Migrating Novell GroupWise to Linux

© 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

Page 32: Migrating Novell GroupWise to Linux

If you MUST migrate Gateways

Page 33: Migrating Novell GroupWise to Linux

© Novell, Inc. All rights reserved.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

Page 34: Migrating Novell GroupWise to Linux

© 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

Page 35: Migrating Novell GroupWise to Linux

© Novell, Inc. All rights reserved.35

Domain Migration

Start the MTA

Start the Internet Agent

Start the WebAccess Agent

Page 36: Migrating Novell GroupWise to Linux

© Novell, Inc. All rights reserved.36

Verify Your Migration

Verify that all portions of your migration have been successful

Page 37: Migrating Novell GroupWise to Linux

The Novell® Migration Wizard

Page 38: Migrating Novell GroupWise to Linux

© Novell, Inc. All rights reserved.38

Prerequisites – NetWare®

Page 39: Migrating Novell GroupWise to Linux

© Novell, Inc. All rights reserved.39

Prerequisites – Windows

Page 40: Migrating Novell GroupWise to Linux

© Novell, Inc. All rights reserved.40

Source Server

Page 41: Migrating Novell GroupWise to Linux

© Novell, Inc. All rights reserved.41

Destination Server

Page 42: Migrating Novell GroupWise to Linux

© Novell, Inc. All rights reserved.42

Software Location

Page 43: Migrating Novell GroupWise to Linux

© Novell, Inc. All rights reserved.43

Select Component to Migrate

Page 44: Migrating Novell GroupWise to Linux

© 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

Page 45: Migrating Novell GroupWise to Linux

© Novell, Inc. All rights reserved.45

Post Office Migration – Phase One

Page 46: Migrating Novell GroupWise to Linux

© 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

Page 47: Migrating Novell GroupWise to Linux

© 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

Page 48: Migrating Novell GroupWise to Linux

© Novell, Inc. All rights reserved.48

Post Office Migration – Phase One

Page 49: Migrating Novell GroupWise to Linux

© Novell, Inc. All rights reserved.49

Post Office Configuration

Page 50: Migrating Novell GroupWise to Linux

© 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

Page 51: Migrating Novell GroupWise to Linux

© Novell, Inc. All rights reserved.51

Post Office Migration – Phase Two

Page 52: Migrating Novell GroupWise to Linux

© 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

Page 53: Migrating Novell GroupWise to Linux

© 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

Page 54: Migrating Novell GroupWise to Linux

© 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®

Page 55: Migrating Novell GroupWise to Linux

© Novell, Inc. All rights reserved.55

Post Office Migration

Page 56: Migrating Novell GroupWise to Linux

© Novell, Inc. All rights reserved.56

Domain Migration

Page 57: Migrating Novell GroupWise to Linux

© Novell, Inc. All rights reserved.57

Add Domain

Page 58: Migrating Novell GroupWise to Linux

© Novell, Inc. All rights reserved.58

Add Agent – GWIA

Page 59: Migrating Novell GroupWise to Linux

© Novell, Inc. All rights reserved.59

Add Agent – GWIA

Page 60: Migrating Novell GroupWise to Linux

© 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

Page 61: Migrating Novell GroupWise to Linux

© Novell, Inc. All rights reserved.61

Domain Migration

Page 62: Migrating Novell GroupWise to Linux

© 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

Page 63: Migrating Novell GroupWise to Linux

© 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

Page 64: Migrating Novell GroupWise to Linux

© Novell, Inc. All rights reserved.64

Domain Migration

Page 65: Migrating Novell GroupWise to Linux

© 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

Page 66: Migrating Novell GroupWise to Linux

© 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

Page 67: Migrating Novell GroupWise to Linux
Page 68: Migrating Novell GroupWise to Linux

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 DisclaimerThis 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.