mkusermap

Creates a user mapping to make a user on Windows® and a user on UNIX® equivalent for file access purposes.

Read syntax diagramSkip visual syntax diagram
>>-mkusermap--+--------+-- -src--user@domain-------------------->
              +- -?----+
              +- -h----+
              '- -help-'

>-- -tgt--user@domain--+---------+-----------------------------><
                       '- -quiet-'

Parameters

–? | –h | –help
Displays a detailed description of this command, including syntax, parameter descriptions, and examples. If you specify a help option, all other command options are ignored.
–src user@domain
Defines a user and domain in a user mapping in the form user@domain where user can be a user name or userid. A userid would be the Windows security ID (SID) on Windows and the user ID (UID) on UNIX. If you are specifying a userid, you must prefix it with ID:. For example: -src ID:6038@U.

If you specify the Windows user and domain with this parameter, specify the UNIX user and domain with the –tgt parameter or if you specify the UNIX user and domain with this parameter, specify the Windows user and domain with the –tgt parameter.

–tgt user@domain
Defines the user and domain in the user mapping that is equivalent to the user specified with the –src parameter, in the form user@domain where user can be a user name or userid.
–quiet
Turns off confirmation messages for this command.

Prerequisites

You must have Administrator privileges to use the command.

You must be logged in to the operating system on the engine hosting the master metadata server to run this command.

Description

Before creating a user mapping, user domains must exist on SAN File System. Use the mkdomain command to create user domains.

You can only have one mapping for a specific Windows or UNIX user at one time.

Example

Create a user mapping using user names The following example creates a user mapping for user1 on UNIX and USERONE on Windows:
sfscli> mkusermap -src user1@UNIX -tgt USERONE@Windows  
The user mapping for user1@UNIX with USERONE@Windows was created successfully.
Create a user mapping using userids The following example creates a user mapping for 6038 on UNIX domain U and S-1-5-21-427903388-3687960729-265688067-1115 on Windows domain W:
sfscli> mkusermap -quiet -tgt ID:6038@U -src ID:S-1-5-21-427903388-3687960729-265688067-1115@W  

Parent topic: Administrative commands

Related tasks
Creating a user mapping

Related reference
lsdomain
lsusermap
mkdomain
refreshusermap
rmdomain
rmusermap

Library | Support | Terms of use | Feedback
(C) Copyright IBM Corporation 2003, 2004. All Rights Reserved.
IBM TotalStorage SAN File System v2.2