Professional Documents
Culture Documents
Mapper File
Mapper File
Release 7.0
EMC Corporation
Corporate Headquarters:
Hopkinton, MA 01748-9103
1-508-435-1000
www.EMC.com
/ % 2011
$," . 3
.
3'$ (-%.1, 3(.- (- 3'(2 /4!+(" 3(.- (2 /1.5(#$# " 2 (2." $," ".1/.1 3(., *$2 -. 1$/1$2$-3 3(.-2 .1 6 11 -3($2 .% -8 *(-# 6(3' 1$2/$"3 3.
3'$ (-%.1, 3(.- (- 3'(2 /4!+(" 3(.-, -# 2/$"(%(" ++8 #(2"+ (,2 (,/+($#
6 11 -3($2 .% ,$1"' -3 !(+(38 .1 %(3-$22 %.1 / 13("4+ 1 /41/.2$.
4, , $,"
.
% -- , 3
# $," /.
% -- $," , $," " 3
$,"..
.
" ': ', ,
01748-9103
Contents
Preface.....................................................................................................7
Chapter 1: Introduction.........................................................................11
2 .............................................................................................12
4 ...........................................................................................12
1 ..............................................................................................14
Chapter 2: Concepts.............................................................................15
.................................................................................................................16
4 6- ...............................................18
4 .................................................18
2 .....................................................................................................19
" ............................................................19
" ..................................20
4 ..................................................................................20
4 ........................................................................................20
4 ..........................................................................................21
4............................................................................................................22
1...................................................................................................22
/ .............................................................................23
4 -5-7 4 ...................24
4 -5-7 4 .......................................24
+# /- ...........................................................................25
+ ................................................................................................................25
-(2...........................................................................................................................26
#.....................................................................................................26
4-(7 -...............................................................27
Contents
Contents
1 .......................................................................55
$ ..........................................................................55
( ......................................................56
1 ............................................................................................56
Chapter 7: Troubleshooting..................................................................59
$," $-+ ( -..............................................................60
* .......................................................................60
* ................................60
4 .................................................................61
$ .......................................................................................................62
$," 3 / 2...........................................................63
Glossary..................................................................................................65
Index.......................................................................................................69
Contents
Preface
,
$," . 3,
.
% -- , .
( ,
$," .
Preface
Important:
Note:
, -.
Hint: , -
.
3 % , $," "
2 $," . 2 . ,
2 / , Live Chat Create a service request. 3
$," . 2,
. " $,"
.
Note: #
.
Your comments
8 , ,
.
/ :
Preface
techpubcomments@EMC.com
Preface
10
1
Introduction
$ $," 5-7, , 6
4-(7/+ ,
(4(#) (&(#). 6, ,
(# . (,
(2(#). 3, 6 - ,
" ( % 2 ("(%2), 5-7,
6 2(# 4(# &(#. 3
6- 4-(7/+
6 () . 3 :
+# /- ( #
, 6 2 4-(7 [2%4] ( ,
4-(7 [(,4])
- ( 2 (-(2)
" 2 .
3 5-7
6 (# .
3 :
2 12
4 12
1 14
11
Introduction
System requirements
3 1 12 $," 5-7 , , ,
.
Table 1. System requirements
Software
Hardware
Network
Windows Server or Windows NT domain. You must configure the domains with the following:
Storage
Active Directory
DNS
NTP
Windows NT domains:
WINS
Verify that sufficient space is available in the root file system. Contact your EMC Customer
Support Representative for assistance with determining size requirements.
$," 4
, , " (,,") -
# 4 " ( #4")
3 4 5-7.
( , 5-7 %
4, ,," - #4" .
12
Introduction
3 5-7 , - 5-7
.
Using Unisphere
4 # , 4 -(2,
3 2 13. 8 4 (
, 4-(7 , # .
Table 2. User mapping configured by using Unisphere
Naming service
Unisphere procedure
NIS
Usermapper
4 4
.
Note: 8 -(2 4.
13
Introduction
Related information
% :
5-7 " + ( 1 %
" - 2 $ , &
/ & 5-7
" $ - 5-7 %
" 5-7 - 2
( , 5-7
, , $ 5-7
. 5-7 %
4 -3, 5-7
4 6 3 5-7
VNX wizards
4 . 3
4 .
14
2
Concepts
3 :
. 16
4 6- 18
4 18
2 19
4 20
4 20
4 21
4 22
+# /- 25
+ 25
-(2 26
# 26
4 28
15
Concepts
Overview
$ 5-7 4(# &(#
. 3 5-7
.
Note: % 6 , 2(# . 3
4(# 4
.
16
Concepts
% 1 17
.
Start
Do users have
both UNIX and
Windows
accounts?
No, only
Windows
Usermapper
Yes
Does your
environment
consist primarily
of UNIX or
Windows
users?
Windows
UNIX
Are the
Windows users
in a single domain or
are usernames unique
across multiple
domains?
Are the
Windows users
in a single domain or
are usernames unique
across multiple
domains?
No
Yes
VNX-000023
Overview
17
Concepts
4-(7/+
6 ( "+)
3, 4-(7/+ 6 ,
.
3 ,
6 2(# 4(# &(#
, :
+# /- , # ( , 6
2 4-(7 [2%4] ( , 4-(7 [(,4])
# ,
- ( 2 (-(2)
# ( 5-7 "(%2 , , " [,,"] -)
Note: ( ( 6
4-(7/+), 4. ( ,
.
18
Concepts
Secure mapping
2 () 2(#, 4(#
&(# # , 5 # , (5#,). 2
5-7;
. -, .
3 :
3 # , (4,
+# /- , , -(2, #) ,
. 1 .
Note: 2 . $,"
, .
" 6 .
Secure mapping
19
Concepts
"
"
Note: ,
.
"+
" 53 4
54 .
20
Concepts
21
Concepts
. ( (# ,
"(%2 (
).
Usermapper
4 5-7
2(# 4(# &(# 6
. 4 :
. 4 4,
4(# &(# 6 . ! ,
# , 2 (_2).
3 # , 5-7
4 ,
. !
, # , 5-7
4 . 4
-5-7 4 24
4 5-7 .
( -5-7 , 4
5-7 , # ,
4 . $ 5-7
4 , # ,
4. + 4 , 4
4(# &(#. (
, 4 . 3
4 , , 4(# &(#,
4 .
3 4
, # ,. ( 4
, . $
# , # ,
.
" -5-7 4 32
4 5-7
.
Restrictions
! 4, :
22
# 4 5-7 ,
5-7 , -5-7 . .,
Concepts
. 5-7
4 4
. 4 4
5-7 .
( 5-7, 4 ,
. # , 5-7
.
( -5-7 , 4
4 .
! , 4 # , 2 (_2). 3
4 .
8 4 5 #
, (5#,).
Planning considerations
! 4, :
4 4(# &(# #
, 4 . ( ,
. 3
6 . "
$," " 2 1 .
( 6 4
$," 2 1 # % (21#%), 4
. " $," " 2 1 .
( 4, 4(# &(# 4 ,
4 4(# &(# .
3, 4 4(#
&(# . ', .
4(# &(# . 3 .
. , 4
.
Note: ( 4(# &(#
, $," 4
4(# &(# . (
. , $," " 2 1
.
Usermapper
23
Concepts
3 4 5-7 # ,
2 (_2) 4 . $
# , 5-7 2(# 4(# &(# .
', # ,
, 4 . 3 # ,
4 . ! , # , 5-7
5-7
4 .
" 4(# &(# 2(#. % , 0
4-(7 . . 4(#
&(# 32 *!. 3 4(# &(#
.
4(# &(# .
Note: 5-7 , # ,
# ,, 4 .
# 4 42 4
. ( 4
, " 7 . " 5
4 .
24
Concepts
4 ,
4
4 .
3 4 4
. 3, 4
.
Note: ( , 5-7
4 .
# 2%4 (,4
" 5-7 - 2 # ,
+# /- .
+# /- , # ,
+# /- . ! ,
.
.. ( +# /-
,
# , . 1
36
.
Note: 4 28
.
Local files
( 4-(7
6 , 6 ,
# , . " #
25
Concepts
, 37 6
# ,.
! , # , .
.. (
, 6 6
4(# &(# 4-(7 .
( ,
# ,
. 1
36 .
Note: 4 28
.
NIS
( 4-(7 6
, 6 , -(2
.
" 5-7 - 2 # ,
-(2 . -(2
-(2 .
Note: (6 , , , )
2"(( .
-(2, # , -(2
. ! , .
.. (
-(2 ( -(2
), # ,
. 1
36 .
Note: 4 28
.
Active Directory
! , 4-(7 6
( # 2%4 (,4), # 6
2 6 .
26
Concepts
', # $,"
4-(7 6 , #
, #
4-(7 . ( ,
.
3 # , # 4-(7 ,
4-(7 " "(%2 ,,"
-. 8 #, . " # ,
# 40 .
( , 5-7 % " 4-(7 4 ,
" 4-(7 , . 4
28
.
8 .
3 .
8 4-(7 .
8 :
8 .
!
.
8 4-(7 .
Active Directory
27
Concepts
5-7 4-(7
-3,
, 3
( , 5-7 .
3 5-7 4-(7 , 3
.
NTMigrate
-3, 6 4-(7 4(# &(#
( -(2). -3, 6
4-(7 .
28
Concepts
29
Concepts
30
3
Configuring in Windows
Environments
$," 4 6-
. 4 6- 18
.
5-7 5-7
4 . 4 -5-7 4
24 -5-7
4 .
( 5-7 5-7
6 ,
4 5-7
4 . " -5-7 4
32 .
3 6- :
" -5-7 4 32
31
<movername>
where:
<movername> = name of the Data Mover
Example:
To verify that the primary Usermapper service is enabled on server_2 of VNX 1, type:
$ server_usermapper server_2
Output
server_2 : Usrmapper service: Enabled
Service Class: Primary
32
Example:
To disable the primary Usermapper service on server_2 of VNX 2, type:
$ server_usermapper server_2 -disable
Output
server_2 : done
33
Action
<ip addr> = network IP address of the Data Mover on which the primary Usermapper service is running
Example:
To enable a secondary Usermapper service on server_2 of VNX 2, type:
$ server_usermapper server_2 -enable primary=192.168.21.1
Output
server_2 : done
Example:
To verify that the secondary Usermapper service is enabled on server_2 of VNX 2, type:
$ server_usermapper server_2
Output
server_2 : Usrmapper service: Enabled
Service Class: Secondary
Primary = 192.168.21.1(c)
34
4
Configuring in Multiprotocol
Environments
( , 4-(7/+
6 . ( 4-(7/+ 6
,
. 4
18 :
3 :
1
36
" # , 36
" # , # 40
35
Example:
To change the default format of username and group name so they can be retrieved without a domain extension, type:
$ server_param server_2 -facility cifs -modify resolver -value 1
Output
server_2 : done
(6 , , , )
2"(( .
6 =20
4-(7- .
( 4-(7 , _
,
.
36
Procedure
3 6 #
,:
1. " # , 37
2.
6 38
3.
6 39
4. " # , 40
+ 25 .
Example:
To copy the passwd file to /home/nasadmin/passwd, type:
$ server_file server_2 -get passwd /home/nasadmin/passwd
Output
server_2 : done
37
where:
<groupname.domain> = group name and Windows domain name
* = UNIX password for the group; this field should contain an asterisk (*) because the password is not used on the VNX.
<GID> = unique numeric group ID that you assign to the group name
Example 1:
To add the Windows domain galaxy to the group file, add the following line:
galaxy:*:100
The Windows domain galaxy is the group name. The GID is 100.
Example 2:
Here is an example of a group file, including the galaxy example and the default Windows global groups:
.(numerous UNIX groups skipped)
galaxy:*:100:
domain=20admins.galaxy:*:101: domain=20users.galaxy:*:102:
domain=20guests.galaxy:*:103:
38
where:
<user.domain> = Windows username and domain name, which is appended to preclude accidental mapping to existing
Example:
The following is an example of a password file entry of user, glenn, in the domain galaxy. This requires an entry in passwd
as:
glenn.galaxy:*:530:100:J.GLENN:/usr/home/jdir:/bin/csh
39
Examples:
$ server_file server_2 -put passwd passwd
$ server_file server_2 -put group group
Output
server_2 : done
40
Step
Action
1.
Install the UNIX user management component of the CIFS Microsoft Management Console (MMC)
snap-ins for managing VNX users from a Windows computer. These snap-ins provide a manual
mapping method that enables you to assign specific UIDs and GIDs to Windows users. The CIFS
MMC snap-ins are not required if you are using SFU/IdMU with the Active Directory.
2.
Set the cifs useADMap parameter to 1 to enable the snap-ins to interact with the Data Mover. Installing
Management Applications on VNX for File describes how to enable the CIFS management snap-ins
and tools.
5
Managing Usermapper
3 4 :
# 4 42
( 44
, 4 45
! 4 46
" 4 47
41
Managing Usermapper
3 _ 4
# ,.
3 _ # , "(%2 ,
4 .
6 4
3 (/ 4
Action
To display the status of the Usermapper service, use this command syntax:
$ server_usermapper <movername>
where:
<movername> = name of the Data Mover
Example:
To display the status of the Usermapper service on server_2, type:
$ server_usermapper server_2
Output
Note
You should have only one instance of the Usermapper service, either primary or secondary, in a single VNX server.
All the other Data Movers in that environment are clients of
the primary or secondary service.
42
Managing Usermapper
Example:
To display the Usermapper service used by server_3, type:
$ server_cifs server_3
Output
server_3 :
96 Cifs threads started
Security mode = NT
Max protocol = NT1
I18N mode = UNICODE
Home Directory Shares DISABLED
Usermapper auto broadcast enabled
Usermapper[0]=[128.221.252.2] state:active (auto discovered)
Usermapper[1]=[128.221.253.2] state:active (auto discovered)
Default WINS servers = 192.168.4.230
Enabled interfaces: (All interfaces are enabled)
Disabled interfaces: (No interface disabled)
Note
This example shows that server_3 is using the Usermapper service located on server_2 at internal IP addresses
128.221.252.2 and 128.221.253.2; the service is available, and the service was located using the autodiscovery broadcast.
43
Managing Usermapper
Examples:
To import user information into the Usermapper database on server_2, type:
$ server_usermapper server_2 -Import -user /nas/cifs/usrmapperV3/linux/usrmap.passwd
44
Managing Usermapper
Output
server_2 : done
Examples:
To export user information from the Usermapper database on server_2, type:
$ server_usermapper server_2 -Export -user /home/nasadmin/backup.passwd
Output
server_2 : done
45
Managing Usermapper
( 4 , $,"
" 2 1 .
Note: " 4 # ,,
# , 4 . (
4(# &(#, 4(# &(#
.
Back up Usermapper
Step
Action
1.
As root, dump the password and group files to a specified directory by typing:
$ server_usermapper server_2 -Export -user /home/nasadmin/backup.passwd
$ server_usermapper server_2 -Export -group /home/nasadmin/backup.group
2.
Make a backup copy of the current usrmap.cfg file (if one is in use) by typing:
$ cp /nas/rootfs/slot_2/.etc/usrmapper/usrmap.cfg /home/nasadmin/usrmap.cfg
3.
46
Managing Usermapper
( , 4(# &(#
4 .
Note: / -.
Action
To change the default Usermapper UID or GID values, use this command syntax:
$ server_param <movername> -facility usrmap -modify <param_name> -value
<new_value>
where:
<movername> = name of the Data Mover
<param_name> = name of the parameter
<new_value> = value you want to set for the specified parameter
Example:
To change the minimum UID value, type:
$ server_param server_2 -facility usrmap -modify minuid -value 32
To change the maximum UID value, type:
$ server_param server_2 -facility usrmap -modify maxuid -value 2147483647
Output
server_2 : done
47
Managing Usermapper
48
6
Managing secmap
2 19 . 3
:
# 50
# 50
# 51
" 52
" 53
4 54
1 55
$ 55
( 56
1 56
49
Managing secmap
Disable secmap
2 "(%2 . (
"(%2 . ( ..
3 "(%2 .
Action
To disable secmap caching, use this command syntax:
$ server_param <movername> -facility cifs -modify secmap.enable -value 0
where:
<movername> = name of the Data Mover
Example:
To disable secmap caching, type:
$ server_param server_2 -facility cifs -modify secmap.enable -value 0
Output
server_2 : done
Example:
To display all the secmap mapping entries on server_2, type:
$ server_cifssupport server_2 -secmap -list
To display the secmap mapping entry on server_2 for the user user1 in domain NASDOCS, type:
$ server_cifssupport server_2 -secmap -list -name user1 -domain NASDOCS
50
Managing secmap
Output
Note
server_2 : done
Example:
To display the secmap reverse mapping entry on server_2 for UID 32771, type:
$ server_cifssupport server_2 -secmap -list -uid 32771
Output
Note
server_2 : done
The output might include multiple SIDs if more than one SID
has been mapped to the specified ID. The output displays
all information associated with the SID.
51
Managing secmap
Example:
To create a secmap mapping entry on server_2 for the user user3 in domain NASDOCS, type:
$ server_cifssupport server_2 -secmap -create -name user3 -domain NASDOCS
52
Output
Note
server_2 : done
Managing secmap
Example:
To check all the secmap mapping entries on server_2, type:
$ server_cifssupport server_2 -secmap -verify -user user3 -domain NASDOCS
Output
Note
server_2 : done
53
Managing secmap
Example:
To update all the secmap mapping entries on server_2, type:
$ server_cifssupport server_2 -secmap -update -user user3 -domain NASDOCS
54
Output
Note
server_2 : done
Managing secmap
Example:
To remove a secmap mapping entry on server_2 for the user user3 in domain NASDOCS, type:
$ server_cifssupport server_2 -secmap -delete -name user3 -domain NASDOCS
Output
server_2 : done
Example:
To export secmap mapping entries on server_2, type:
$ server_secmap server_2 -secmap -export -file exportfile.txt
Output
Note
server_2 : done
55
Managing secmap
Example:
To import secmap mapping entries on server_2, type:
$ server_cifssupport server_2 -secmap -import -file importfile.txt
Output
Note
server_2 :
Example:
To display current secmap status on server_2, type:
$ server_cifssupport server_2 -secmap -report
56
Managing secmap
Output
server_2 : done
SECMAP GENERAL INFORMATIONS
Name
State
Fs
Used nodes
Used blocks
:server_2
:Enabled
: /
: 27
: 0
SID
S-1-5-15-56db7d78-9b661160-9e19279b-ffffffff
57
Managing secmap
58
7
Troubleshooting
, $,"
. 3,
. % --
, .
(
, $," " 2 1.
3 :
$," $-+ ( - 60
* 60
4 61
$ 62
$," 3 / 2 63
59
Troubleshooting
Symptom
Workaround
The primary Usermapper service must When you run the server_usermapper Check the operational state of the primabe enabled before secondary services <movername> -enable primary= com- ry service and enable it by using the
can be configured.
mand, you receive the following error: server_usermapper <movername> enable command.
Error 4020: <movername>:failed to
complete command
Usermapper stops mapping new UIDs
and GIDs after the root file system of
the Data Mover (where the Usermapper
database is stored) becomes full. New
users will be denied access to system
objects.
The following errors are entered repeatedly in the server log for any additional
mapping requests after the root file
system reaches capacity:
error: -20 for user uid request
60
Troubleshooting
Symptom
Workaround
If the secmap file system is nearly full, Secmap will work in a degraded mode
the secmap database might reach a
until the file system where it resides is
point where it cannot store new map- cleaned or extended.
pings although it can continue to return
existing mappings.
61
Troubleshooting
Facility ID
Facility description
Event ID
USRMAP
93
Event description
Usermapper OK
Usermapper database
created
Usermapper service
enabled
Usermapper service
stopped
Usermapper database
destroyed
Usermapper available
Usermapper unreachable
Error messages
, ,
.
3 , :
4 :
3 _ - <,(#>, <,(#>
.
" $ , &:
62
"+(:
1- , , $ #,
#, 2 #.
4 -
.
Troubleshooting
$," . 2:
4 ' ' (#
* $," . 2 . $,"
. 2, Support by Product ,
.
63
Troubleshooting
64
Glossary
A
access control list (ACL)
+ ( "$)
.
Active Directory (AD)
6 . (
+ # / (+# /).
authentication
/ , , ,
.
C
CIFS server
+ "(%2 . # ,
"(%2 . $ "(%2 .
CIFS service
"(%2 # ,
, 6- .
Control Station
' 5-7
5-7 .
D
Data Mover
( 5-7 ,
. 3
.
65
Glossary
66
Glossary
/ 2 ( $ 3 % (($3%)
1%" 2251.
M
Microsoft Windows Services for UNIX (SFU)
, 4-(7 6.
N
network file system (NFS)
- (-%2)
.
Network Information Service (NIS)
# ,
, , , , , (/ ,
.
Network Time Protocol (NTP)
/ .
ntxmap
" .
P
primary Usermapper service
( 4 (# (4(#) &(# 6
5-7 .
Q
quota
+ ()
/ % 2. 0
.
S
secondary Usermapper service
( -5-7 , 4
4
# , .
security identifier (SID)
4 , 6 . $
2(#.
67
Glossary
SFU
2 , 6 2 4-(7.
U
user file
1 # ,.
User ID (UID)
- .
Usermapper
2 6 4-(7-
4(# &(#.
W
Windows domain
, 6 , 6 2
# #-2 .
Windows Internet Naming Service (WINS)
2 (/ (-!(.2 ).
3 (/
. 6(-2
6 -3 4.0 , .
Windows NT domain
, 6 , 6 -3
2 , -!(.2 . (
6 -3 , (/#") /
2 ,, (!#") -
2 ,.
2 .
68
Index
A
#
6 26
( 4 22
L
26
24
25
25
, 47
(#, 21
, 62
, 6 2 4-(7 (2%4) 2%4
(, 6 2 4-(7) 18, 36
18
, 46
-(2 25, 26
$," $-+ - 60
62
, 421, / 61
45
25
2(# 24
-, 4-(7 4 , 27
47
25, 26
4-(7 , 28
4-(7 4 , 27
69
Index
()
4-(7 4 &
28
U
4-(7 , 28
4-(7 4 & 28
4-(7 4 , - 27
(#
26
-(2 25, 26
4-(7 , 28
4-(7 4 &
28
70
(# ()
4-(7 4 , - 27
(#, - 21
4
24
45
18
44
18
46
47
25
22
25
25