UNIX Custom Application Migration Guide V2.0 Readme
May 31, 2006
© 2006 Microsoft Corporation. All rights reserved.

Contents

  1. Download and on-line locations for UNIX Custom Application Migration Guide V2.0
  2. Brief description of UNIX Custom Application Migration Guide V2.0
  3. Getting started
  4. Download component locations and descriptions
  5. Prerequisites and installation and uninstallation notes
  6. Copyright and license agreement

1. Download and on-line locations for UNIX Custom Application Migration Guide V2.0

2. Brief description of UNIX Custom Application Migration Guide V2.0

For organizations that have decided to migrate UNIX applications to Microsoft® Windows® environment, this guide covers all phases of the migration project (Planning, Migrating, and Deploying). It provides the technical details needed by developers and explores the issues associated with each of multiple migration techniques, using .NET, Win32/Win64, and Windows Services for UNIX. IT decision makers, network managers, and operating system administrators will benefit from the planning and operating chapters.

The best practices, code samples and tools in this guide were provided by consultants working in the field and organizations that have already confronted and solved the issues involving migrating from UNIX to Windows. Topics covered in the guide include the following: 

Tools and Templates
The guide is accompanied by a set of tools, templates, and code samples intended to facilitate the implementation of a UNIX application migration project.
WARNING: The samples are provided as examples only. Be sure to review, customize, and test them before using them in any non-test environment.

3. Getting started

To begin using this guide, see the "About This Guide" document.

To begin using the sample code in the UNIX Custom Application Migration Guide Tools and Templates folder that the .msi installs, refer to the corresponding volume in the guide documents, which show all of the code samples in context. Locate the code sample you need in the Tools and Templates folder by name. Names include: the concept the code illustrates (associated with the guide section where the concept is discussed), a reference to the guide, the relevant volume and chapter, and a consecutive number indicating the position of the sample relative to other samples in that section. For example, N_FileMgt-UAMV4C4.02 is the second sample on file management calls in Volume 4, Chapter 4.

4. Download component locations and descriptions

The following section shows the file and folder levels for the storage of the download on your hard drive after you run the Tools and Templates .msi, provided that you have located both the guide and tools and templates high-level folders in My Documents. The order of folders and items within a folder may differ from the order shown here, depending on how you sort.

The Volume 1–5 folders each contain both PDF and Word document versions of the guidance.

 UNIX Custom Application Migration Guide V2.0
This folder extracts from the WinZip archive to the computer location that you specified. It contains the following files and folders:
 Readme
You are currently reading this file.
 Images
Contains the icons used in this readme file.
 About This Guide
Describes the contents, intended audience, and structure of this 5-volume guide. This document is provided as a PDF as well as a Word document.
 Volume 1: Plan
Compares the UNIX and Windows environments and describes planning requirements for an application migration project.
 Volume 2: Migrate Using Windows Services for UNIX 3.5
Describes the migration activities required to migrate UNIX applications to the Interix environment.
 Volume 3: Migrate Using Win32/Win64
Describes the steps required to migrate UNIX applications to the Win32/Win64 environments using the Windows Platform Software Development Kit (SDK)
 Volume 4: Migrate Using .NET
Describes the .NET architecture, configuration of the .NET environment, and the steps to migrate UNIX applications to the .NET environment using Microsoft Visual Studio® .NET and .NET Framework.
 Volume 5: Deploy and Operate
Describes the steps involved in deploying the migration as well as post-deployment operations and support activities.
 Acronyms
Lists the acronyms and their definitions that are used in this guide. This document is provided as a PDF as well as a Word document.
 Composite Index
An index of all five volumes. This document is provided as a PDF as well as a Word document.

 UNIX Custom Application Migration Guide Tools and Templates
This is the top-level folder that installs to the computer location you choose when you run the .msi file. It contains the following files and folders:
 Volume 1 Tools and Templates
Contains the three Excel tools, associated scripts, and the Word template described in Volume 1 of the guide.
 Volume 2 Code Samples
Contains the two code samples described in Volume 2 of the guide.
 Volume 3 Code Samples
Contains the 119 code samples described in Volume 3 of the guide.
 Volume 4 Code Samples
Contains the 135 code samples described in Volume 4 of the guide.
 License Terms
The license agreement for the contents of the .msi package.

5. Prerequisites and installation and uninstallation notes

Prerequisites

The installation of the .msi relies on Microsoft Windows Installer 2.0 or higher (2.0 released with Windows XP and as a redistributable; also provided in Windows 2000 SP3).

Installation

You can install the .msi package on any Windows-based operating system. By default, the .msi installs to the C:\Documents and Settings\<user>\My Documents directory.

Uninstallation

  1. Open the Windows Control Panel and open Add or Remove Programs.
  2. Select "UNIX Custom Application Migration Tools and Templates" from the list of Currently installed programs.
  3. Click the Remove button.
  4. Click Yes, to confirm removal of the .msi components.

6. Copyright and license agreement

© 2006 Microsoft Corporation.  This work is licensed under the Creative Commons Attribution-NonCommercial License. To view a copy of this license, visit http://creativecommons.org/licenses/by-nc/2.5/ or send a letter to Creative Commons, 543 Howard Street, 5th Floor, San Francisco, California, 94105, USA.