Service Migration

From MicroFocusInternationalWiki
Jump to: navigation, search

Introduction

This wiki is a repository for "how-to" information about migrating services from various sources to OES 2 Linux, with an emphasis on migrating NetWare and Windows services.

Quick Summary of the Migration Model

The migration model being introduced for Open Enterprise Server (OES) 2 is made up of Linux command line utilities with a GUI "skin" wrapped over them. The utilities adhere to the UNIX philosophy of software development for simplicity, flexibility, and adaptibility. If you are unfamiliar with the UNIX philosophy, refer to the explanation on wikipedia.

To summarize the migration model:
  • Each migration command line utility does one thing and does it well.
  • Individual migration commands work together through the universal interface of stdin/stdout text streams (where needed). The text format used is YAML.
  • Migration follows a source/destination model. All migration utilities reside on the destination OES 2 Linux server and the utilities are "pointed" to the source server.
  • All migration GUI wizards are found in the Migration group of the YaST Control Center. The GUI wizards drive the Linux command line utilities.
  • All migration command line utilities are located in the /opt/novell/migration/sbin directory.
  • Documentation for each migration command can be read by invoking man <command_name>.

Service Migration: Getting Started

Installing the Migration Utilities on the Destination Server

  • Install SUSE Linux Enterprise Server (SLES) 10 SP1 with OES 2 selected as an add-on product.
There isn't a pattern you can select to install all of the OES Migration Tools, and only a few are installed by default. After your OES 2 Linux server is up and running, use one of the following methods to install the tools you need.
Software Selection in YaST
  • Click the Computer button and select YaST Administrator Settings > Software > Software Management.
  • Enter "migration" in the Search field and click Search.
  • Select novell-migration and any other migration tools you want to install. The required Ruby packages and other dependencies are installed automatically.
Shortcut for Installing the Data Migration Tools
  • In YaST, there is a Migration group containing initially two GUI wizards: Migrate NetWare Volumes and Migrate Windows Shares. Click on Migrate NetWare Volumes.
  • Follow the prompts to install the required migration packages.
  • Exit the Migrate NetWare Volumes wizard.

After you install the migration GUI and command line utilities on your destination server, the GUI migration wizards are displayed in the Migration group of the YaST Control Center. For a description of the migration command line utilities, refer to the command line reference. If you want to see the actual commands, go to a terminal prompt and enter cd /opt/novell/migration/sbin. Then you can enter man <command_name> to see the documentation on each utility.

Service Migration How-Tos

Migrating File Services from NetWare to OES 2 Linux

Migrating File Services from Windows to OES 2 Linux

Migrating Print Services from NetWare to OES 2 Linux

Migrating GroupWise to OES 2 Linux

Migrating Other Services from NetWare to OES 2 Linux

FAQ

Why does the command line get so much emphasis in the new migration utilities?

Because of the flexibility and power of linux pipes, text processing, and scripting.

Why is the command line output format in YAML?

YAML is simple and easy to text process. Linux is all about text processing.
In addition, Ruby, Perl, and Python have builtin parsers for YAML, which makes it a versatile file format to use.

Why would I want to text-process the migration utility output?

The information in How to modify login scripts is a good example of the power of text processing. In that example the administrator is migrating trustees from
a source tree to a target tree. In the process, the administrator wants to change mappings on the new system. With a sed substitution command, all login
scripts can be changed on the system.


Forums

Open Enterprise Server Migration Support Forum

Open Enterprise Server Support Forums

Command Line References

File Service Migration Commands

GUI References

File Service GUI

General References

File Service Supported Platforms

Credits

Thanks to Mark and Tim from the the group we affectionately call "the kiltmen". They deserve much credit for the things we got right with file services migration. We are also very appreciative to all of our customers who spoke with us during Brainshare; the input and education was extremely valuable. We eagerly anticipate your input on this wiki, which represents a sort of Virtual Brainshare for Migration.