Mig2NDS

Version PK-2.02
(Nov 22, 1998)


 DISCLAIMER:
     THIS  PRODUCT  IS  SUPPLIED  "AS  IS".  DREAMLAN 
     DISCLAIMS ALL WARRANTIES,  EXPRESSED OR IMPLIED,
     INCLUDING, WITHOUT  LIMITATION,  THE  WARRANTIES
     OF  MERCHANTABILITY   AND  OF  FITNESS  FOR  ANY
     PURPOSE.  DREAMLAN   ASSUMES  NO  LIABILITY  FOR
     DAMAGES,  DIRECT  OR  CONSEQUENTIAL,  WHICH  MAY
     RESULT FROM THE USE OF THIS PRODUCT.

Introduction

Although Novell supplied a couple of migration utilities with NetWare to assist you in moving information from a bindery-based environment to NDS, however, there are types of certain information, such as Group Names and Home Directory settings, are not moved. Also, the migration utilities create NDS objects all in uppercase and translates underscores (often used in the bindery-based environment) into space; this sometimes cause confusion.

Mig2NDS is a set of three DOS-based utilities that were developed to assist you in migrating from a bindery-based NetWare environment to NDS:


What's New

NetWare 5 certified. (YES Bulletin #44436)


Notes

  1. PRTINFO is a bindery tool and is therefore meant for NetWare 3.1x servers and not for NDS. However, the data it generates are used to update information in the NDS tree by the other utilities.


Installation

No special installation steps or program need to be used. Simply copy CLEANUP.EXE, GRPNAME.EXE and PRTINFO.EXE to SYS:PUBLIC of your servers. You must have the Unicode files for the country code and code page that your workstation use available in the the respective NLS directories, for example, SYS:PUBLIC\NLS.

If you choose to place the Mig2NDS files in a different directory, you may need a search map to SYS:PUBLIC\NLS in order for the application to find the Unicode files.


Usage

PRTINFO

You can use PrtInfo to get a list of all users, groups, print queues, and print servers defined on a given NetWare server. However, the group information is of most importance -- you can use it to populate the NDS Group objects with the group name information as it is not migrated.

PrtInfo expects three command-line parameters, two mandatory and one optional:

PRTINFO servername -PQ | -PS | -USER | -GROUP [-R]

The first parameter tells PrtInfo from which server to extract the information from; the second parameter specifies the type of information:

The third parameter is optional, and specifies if a report file should be generated. NOTE: You must first establish a connection to the server before running PrtInfo.

For example, to generate a user report for the server named NW410B, the command is PRTINFO nw410b -user -r

The following is a sample output from PrtInfo; the name of the log file correpsonds to the information-type selection:

PrtInfo Version PK-1.50 [s/n: DLAN/971017-DLAN]
(Print Bindery User/Group/PrintQ/PrintServer Info)
Copyright (C) 1997, DreamLAN Network Consulting Ltd.  All Rights Reserved.
Licensed to XYZZY

				Report generated on 17 Oct 97 at 21:17:58.

All known Users found on server NW410B:
	CSADMIN
	GUEST
	KUOP (full name from syscon - modified by NWAdmin)
	SUPERVISOR
	UNIX_SERVICE_HANDLER
	USER1
	USER2
	USER3
	USER5 (User 5 - NDS)


     *** End of Report (USER.LOG) ***


CLEANUP

CleanUp is designed to perform some house cleanup routines after a migration process. However, you can also use it regularly to keep NDS object naming convention consistent. CleanUp accepts the following command-line parameters:

CLEANUP [-b #] [-o #] [-n #] [-?] [-c] [-r] [-h]

where

-b #  NDS object name type
      0 = allow blank
      1 = use underscore (default)

-o #  NDS object name case type        -n #  User object Full Name case type
      1 = all lowercase (default)            1 = all lowercase
      2 = all uppercase                      2 = all uppercase
      3 = mixed case                         3 = mixed case (default)
      4 = leave as is                        4 = leave as is

-?    Show this help screen            -c    Continuous scroll on display
-h    Populate Home Directory attribute
-r    Generate a report file (CLEANUP.LOG)


CleanUp operates on objects in the current context only.

To make all object names in the current container (context) to be in lower case and generate a report file, the syntax for CleanUp is:

CLEANUP -o1 -c -r

To change all spaces in object names to underscores, change all object names and User objects' Full Names to mixed case, and assign Home Directories, the syntax for CleanUp is:

CLEANUP -b1 -n3 -o3 -h

You will be prompted for the volume object name and the parent directory for the user home directories. Shown below is a sample log file from the above CleanUp command:

CleanUp Version MT-1.50 [s/n: DLAN/971017-DLAN]
(Cleanup NDS Information)
Copyright (C) 1997, DreamLAN Network Consulting Ltd.  All Rights Reserved.

Report file (CLEANUP.LOG) generated on October 18, 1997 at 17:04:20
Runtime options: [-R] [-B 1] [-O 3] [-N 3]

Searching context <test> only

NDS Tree Listing:

test
 CN=Test1 [Not changed]
     FullName: Test User Here  [Not changed]
 CN=Test2 [Not changed]
     FullName: !NONE!
 CN=Test3 [Not changed]
     FullName: Test 3  [Not changed]
 OU=Level2 [Not changed]
 OU=Level2b [Not changed]
 CN=Test6_Alias [Not changed]
 CN=New_Group_here -> New_Group_Here
 CN=New_User_name -> New_User_Name
     FullName: New User Name  [Not changed]
 CN=Q1 [Not changed]
 CN=Ps-test [Not changed]
 CN=P1 [Not changed]
 CN=$$lan_Coordinators [Not changed]
 CN=$reset_By_helpdesk -> $reset_By_Helpdesk
 CN=Scout [Not changed]

TotalContainer found = 3.
TotalObject found    = 15.
Total User objects   = 4.
User names processed = 0.

              *** End of Report ***


GRPNAME

GrpName is to be used in conjunction with PrtInfo (or PRINTGRP available from Novell Research). GrpName reads the output log file from PrtInfo (with the -GROUP option) and updates the Group objects in NDS with the group names. If you are using PRINTGRP, you have to create the log file by redirecting the screen output to a file. GrpName accepts the following command-line parameters:

GRPNAME [-f name] [-?] [-c] [-r]

where

GrpName operates on objects in the current context only.

The following is a sample output from GrpName:

GrpName Version PK-1.50 (s/n: DLAN/971017-DLAN)
(Populate Group Name)
Copyright (C) 1997, DreamLAN Network Consulting Ltd.  All Rights Reserved.
Pre-Release Version (Do not distribute)

Log file generated on October 18, 1997 at 16:43:41

Current context: <test>
$$LAN_COORDINATORS -> [R] <Designated Departmental LAN Coordinator>
$RESET_BY_HELPDESK -> [R] <(Helpdesk Staff Group)>

Number of groups processed: 2
Groups have name added    : 2
Groups have name replaced : 0

 *** End of Report (GRPNAME.LOG) ***


Configuration

n/a


Registration

Mig2NDS is Shareware. However, you are granted an unlimited usage, until March-31-1999, to use this Pre-Release Version at no cost.


Other Information

Mig2NDS is written in C using Microsoft C optimizing compiler and Novell Developer Kit. Some string manipulating routines are from the CXL library.

Inclusion of this utility on CD-ROMs (except for backup purposes) without permission from DreamLAN Network Consulting Ltd. is expressly prohibited.


Revision History