Storage Center OS Version 7 Command Utility Reference Guide

Description

Maps an existing volume to a server.

The Command Utility supports the ability to map to a server that is offline. If a server is offline, the volume create command creates a mapping profile to the down server. The actual mapping is not created until the server is back online. Therefore, validation of server creation and/or mapping success cannot be determined until the server is back online.

Format

volume map {–deviceid 
                                 string | –index 
                                 integer | –name 
                                 string | –serialnumber 
                                 string} {–server 
                                 string  | –serverindex 
                                 integer} {–boot | –lun} {options}
                              

Options

–boot

If present, designates the mapped volume to be a boot volume. The –boot and –lun options are mutually exclusive. Specifying the –boot option maps the new volume to lun0. If neither –boot nor –lun option is specified, the next available LUN is automatically assigned ( Storage Center 5.0 and later).

–controller 
                                 string
                              

Specifies the name of the controller on which to activate the volume. If omitted Storage Center CU assigns a controller. If specified and the Storage Center cannot map the volume to the specified controller, Storage Center assigns another controller. If the volume to map has already been activated on a controller, the –controller option is ignored.

–deviceid 
                                 string
                              

Specifies the volume device ID. See About Device IDs for information.

–force

Forces mapping even when another mapping already exists.

–h

Shows help for command options.

–index 
                                 integer
                              

Specifies the volume index.

–localport 
                                 string
                              

Specifies the world wide name (WWN) of the single local port to use for mapping when the –singlepath option is used. (The –localport option is deprecated on Storage Center 5.0 and later.)

–lun 
                                 integer
                              

Specifies the logical unit number (LUN) for the mapped volume. The –boot and –lun options are mutually exclusive. If neither –boot nor –lun option is specified, the next available LUN is automatically assigned ( Storage Center 5.0 and later). Dell recommends that you allow LUNs to be automatically assigned to avoid issues with operating systems that require sequential LUN ordering.

–name 
                                 string
                              

Specifies the volume name. Names that contain spaces must be enclosed in single quotes.

–readonly

Flag that makes the map read only.

–remoteport 
                                 string
                              

Specifies the world wide name (WWN) of the remote port for mapping the volume.

–serialnumber 
                                 string
                              

Specifies the volume serial number. (Available only when running on operating systems that expose serial numbers to the user.)

–server 
                                 string
                              

Specifies the name of the server to which to map the volume or volume view. Names that contain spaces must be enclosed in single quotes.

–serverindex 
                                 integer
                              

Specifies the index of the server to which to map the volume or volume view.

–singlepath

Indicates that only a single local port can be used for mapping. If omitted, all local ports are used for mapping. (For Storage Center versions 5.0 and earlier, use with the –localport option to specify a single port.)

Examples

Mapping a volume and allowing Storage Center CU to assign a controller and LUN:

volume map -name 'volume 1' -server 'server 1'

volume map -deviceid 6000d3100000c90000000000000000cb -server 'server 1'

Mapping a volume to a specific controller:

volume map -name 'volume 1' -server 'server 1' -controller 'leader'

Mapping a volume to a specific controller and LUN:

volume map -name 'volume 1' -server 'server 1' -controller 'leader' -lun 25

Forcing volume mapping:

volume map -name testvol -server 'server 1' -force

Mapping a volume using a single path for the mapping:

volume map -name 'volume 1' -server 'server 1' -singlepath