Professional Documents
Culture Documents
Release 7.1
EMC Corporation
Corporate Headquarters:
Hopkinton, MA 01748-9103
1-508-435-1000
www.EMC.com
Copyright © 1998 - 2012 EMC Corporation. All rights reserved.
Published July 2012
EMC believes the information in this publication is accurate as of its publication date. The
information is subject to change without notice.
THE INFORMATION IN THIS PUBLICATION IS PROVIDED "AS IS." EMC CORPORATION
MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WITH RESPECT TO
THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED
WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Use, copying, and distribution of any EMC software described in this publication requires an
applicable software license.
For the most up-to-date regulatory document for your product line, go to the Technical
Documentation and Advisories section on EMC Powerlink.
For the most up-to-date listing of EMC product names, see EMC Corporation Trademarks on
EMC.com.
All other trademarks used herein are the property of their respective owners.
Corporate Headquarters: Hopkinton, MA 01748-9103
Preface.....................................................................................................5
Chapter 1: Introduction...........................................................................9
System requirements.............................................................................................10
User interface choices...........................................................................................10
Related information..............................................................................................10
Chapter 2: Concepts.............................................................................13
ntmigrate.exe..........................................................................................................15
ntmiunix.pl.............................................................................................................15
Chapter 3: Configuring.........................................................................17
Verify the configuration requirements...............................................................18
Chapter 4: Managing............................................................................19
Generate text files from the Windows account and group data.....................20
Generate converted user and group account information..............................20
Generate converted account information from local UNIX
UID/GID files..........................................................................................20
Generate converted account information from an NIS server..............21
Syntax for the ntmiunix.pl script..............................................................22
Merge the passwd and group files......................................................................26
Create a remote Windows account.....................................................................27
Install ntmigrat.exe on the Windows host...............................................27
Set up and run the UNIX remote shell daemon (RSHD).......................27
Chapter 5: Troubleshooting..................................................................29
Glossary..................................................................................................33
Index.......................................................................................................35
As part of an effort to improve and enhance the performance and capabilities of its product lines,
EMC periodically releases revisions of its hardware and software. Therefore, some functions described
in this document may not be supported by all versions of the software or hardware currently in use.
For the most up-to-date information on product features, refer to your product release notes.
If a product does not function properly or does not function as described in this document, please
contact your EMC representative.
Note: Emphasizes content that is of exceptional importance or interest but does not relate to personal
injury or business/data loss.
CAUTION Indicates a hazardous situation which, if not avoided, could result in minor or
moderate injury.
Indicates a hazardous situation which, if not avoided, could result in death or serious injury.
DANGER Indicates a hazardous situation which, if not avoided, will result in death or serious
injury.
Note: Do not request a specific support representative unless one has already been assigned to
your particular system problem.
Your comments
Your suggestions will help us continue to improve the accuracy, organization, and overall
quality of the user publications.
Please send your opinion of this document to:
techpubcomments@EMC.com
Introduction
System requirements
Table 1 on page 10 describes the EMC® VNX™ software, hardware, network, and storage
configurations.
Related information
Specific information related to the features and functionality described in this document are
included in:
VNX wizards
Unisphere software provides wizards for performing setup and configuration tasks. The
Unisphere online help provides more details on the wizards.
Related information 11
Introduction
Concepts
ntmigrat.exe ntmiunix.pl
ntmigrate.exe
The ntmigrate.exe program reads the contents of the Windows user database and produces
three text files that contain the Windows account and group data needed for the conversion
to UNIX.
Note: The Windows user database exists in either a Windows NT SAM or Windows Active Directory.
Element Notes
Nonprintable characters
◆ All nonprintable characters are
converted to a hexadecimal num-
ber preceded by an escape charac-
ter (=). For example, an account
name in French that contains a
special character set outside the
ASCII printable range is converted
to =2a.
◆ This range of characters is not
converted: 0x21 through 0x7E.
Generate text files from the Windows account and group data on page 20 provides
instructions for using the program.
ntmiunix.pl
The ntmiunix.pl script does the following:
1. Reads the text files produced by ntmigrat.exe.
2. Reads the UNIX UID/GID files from either the local files or from an NIS database.
3. Compares the user and group accounts from both sources to avoid duplicating existing
mappings.
Note: If ntmiunix.pl script encounters duplicate user or group accounts, it displays the following
warning:
ntmigrate.exe 15
Concepts
Target Instructions
The Data Mover’s group and passwd files Generate converted account information from local UNIX
UID/GID files on page 20
Note: To use this option, the group and passwd files on the
Data Mover and all UNIX hosts must be synchronized.The
UNIX host must be configured to the same NIS domain as
the Data Mover.
Syntax for the ntmiunix.pl script on page 22 provides more information about the options
and arguments for this script.
Configuring
Step Action
1. Determine which machines you are going to use to configure NTMigrate:
◆ Windows host (any Windows NT, Windows 2000, or Windows Server 2003 system in the domain)
◆ UNIX host (any UNIX system)
◆ NIS server (optional)
2. If moving files by FTP, load and configure FTP software on the UNIX and Windows hosts.
3. Ensure that Perl version 5.003 or later is loaded on the UNIX host.
Managing
Generate text files from the Windows account and group data
This task is used to create the set of files that contain the information about Windows users
and groups. ntmigrate.exe on page 15 provides more information.
Step Action
1. Log in to the Windows host as a user with Domain Administrator privileges.
2. On the Windows host, create the directory ntmigrate on the C: drive (C:\ntmigrate).
◆ For 5.0 and later versions: the /nas/cifs directory on the Control Station
◆ For pre-5.0 versions: the \CifsTools directory on the Celerra Network Server Applications and Tools CD
◆ domain.txt
◆ ntfile.txt
◆ ntgroup.txt
The group and passwd files on the Data Mover and all UNIX hosts must be synchronized.
Step Action
1. On the UNIX host, create the directory /ntmigrate by typing:
$ mkdir /ntmigrate
Step Action
2. Copy ntmiunix.pl from one of these sources to /ntmigrate:
◆ For 5.0 and later versions: the /nas/cifs directory on the Control Station
◆ For pre-5.0 versions: the \CifsTools directory on the VNX Applications and Tools CD
3. Transfer these files, which were generated by ntmigrat.exe, to the directory/ntmigrate on the UNIX host:
◆ domain.txt
◆ ntfile.txt
◆ ntgroup.txt
◆ UNmap.db
◆ domainGID.txt
◆ updategroup
◆ updatepasswd
These files are stored in the directory /ntmigrate/<domain_name>. For example, if the domain name is
"CIFS", the files are placed in the directory /ntmigrate/CIFS.
Note: When local files are used for Windows ID user mapping, the passwd and group files on the UNIX host
must have the same mapping information as the passwd and group files on the Data Mover. Table 4 on page
22 summarizes the syntax for ntmiunix.pl.
This task is used to compare the Windows user and group account information with UNIX
UID/GID information in an NIS database.
Step Action
1. On the NIS server or an NIS client, create the directory /ntmigrate, by typing:
$ mkdir /ntmigrate
Step Action
2. Copy ntmiunix.pl from one of these sources to /ntmigrate:
3. Transfer these files, which were generated by ntmigrat.exe, to the directory/ntmigrate on the UNIX host:
◆ domain.txt
◆ ntfile.txt
◆ ntgroup.txt
◆ UNmap.db
◆ domainGID.txt
◆ updategroup
◆ updatepasswd
Note: These files are stored in the directory /ntmigrate/<domain_name>. For example, if the domain name
is CIFS, the files would be in the directory /ntmigrate/CIFS.
-D <GID> Default group ID for Windows domain users Specifies the default GID for
Windows users.
Procedure
Use the following procedure to merge the updated files with the existing passwd and group
files on the Data Mover.
Step Action
1. Transfer the updategroup and updatepasswd files to the Control Station.
2. Copy the group and passwd files from the Data Mover to the Control Station by using this command
syntax:
$ server_file <movername> -get group group_dm
$ server_file <movername> -get passwd passwd_dm
where:
<movername> = name of the specified Data Mover
3. Merge passwd and group files to existing passwd and group files by typing:
cat updatepasswd >> passwd_dm cat updategroup >> group_dm
Step Action
4. Transfer the updated group and passwd files to the Data Mover by using this command syntax:
$ server_file <movername> -put passwd_dm passwd
$ server_file <movername> -put group_dm group
where:
<movername> = name of the specified Data Mover
5. If using NIS, merge the updatepasswd and updategroup files with the passwd and group files on all
NIS servers.
Step Action
1. On the Windows host, create the directory ntmigrate on the C: drive (C:\ntmigrate).
Although you can use the domain controller, you should use another machine.
2. Copy ntmigrat.exe from the \CifsTools directory on the Celerra Network Server Applications and
Tools CD to C:\ntmigrate.
Step Action
1. In a web browser, open http://www.denicomp.com.
Download the Winsock RSHD/NT application to the Windows host.
Step Action
2. Run setup.exe for Winsock RSHD/NT.
3. From the Control Panel on the Windows host, click RSHD, and then select Advanced.
5. In RCP options, under the RCP home directory dialog box, copy C:\ntmigrate.
7. Restart the remote shell daemon service from the Security and Logs menu, and then select Service
Control.
Troubleshooting
Error messages
All event, alert, and status messages provide detailed information and recommended actions
to help you troubleshoot the situation.
To view message details, use any of these methods:
◆ Unisphere software:
• Right-click an event, alert, or status message and select to view Event Details, Alert
Details, or Status Details.
◆ CLI:
• Use this guide to locate information about messages that are in the earlier-release
message format.
• Use the text from the error message's brief description or the message's ID to search
the Knowledgebase on the EMC Online Support website. After logging in to EMC
Online Support, locate the applicable Support by Product page, and search for the
error message.
EMC Professional Services can help you implement your system efficiently. Consultants
evaluate your business, IT processes, and technology, and recommend ways that you can
leverage your information for the most benefit. From business plan to implementation, you
get the experience and expertise that you need without straining your IT staff or hiring and
training new personnel. Contact your EMC Customer Support Representative for more
information.
Data Mover
In VNX for file, a cabinet component that is running its own operating system that retrieves
data from a storage device and makes it available to a network client. This is also referred to as
a blade.
file system
Method of cataloging and managing the files and directories on a system.
C NTMigrate (continued)
ntmigrat.exe, running 15
command syntax summary 22 ntmiunix.pl
configuration tasks 17 command sytax 22
running against local group file 20
running against NIS server 21
E NTMigrate;account, creating remote Windows
EMC E-Lab Navigator 30 remote Windows account 27
error messages 30
P
G password file, merge 26
group file, merge 26
R
I related documents 10
information, related 10 remote Windows account, creating 27
M S
management tasks 19 system requirements 10
merge files 26
messages, error 30 U
UNIX remote shell daemon (RSHD) 27
N
NTMigrate