Storage Center OS Version 7 Command Utility Reference Guide

Description

Creates a view volume on an existing Replay and optionally maps the new view volume to a server.

Format

replay createview –index <int> | ({–name <string> | –last} {–volumeindex <int> | –volume <string> | –deviceid <string> | –serialnumber
                                 <string>})
                              

Options

–boot

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

–deviceid 
                                 string
                              

Specifies the volume device ID.

–folder 
                                 string
                              

Specifies a folder for the volume.

-folderindex 
                                 integer
                              

Specifies a folder by index for the volume.

–h

Shows help for command options.

–index 
                                 string
                              

Specifies the Replay index. If the index is specified, no other volume or Replay identifiers are required.

–last

Creates a view from the last frozen Replay.

–localport 
                                 string
                              

Sets the world wide name (WWN) of the local port to which the volume is mapped. (Deprecated. The –localport option is ignored if the Storage Center version is 4.x and is invalid if the Storage Center version is 5.0 or 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 EMC recommends that you allow LUNs to be automatically assigned to avoid issues with operating systems that require sequential LUN ordering.

–move

For the –view option only. If the view volume created by the –view option already exists, takes a Replay of the existing view volume before making the new view volume the active view for the created Replay. Changes to the existing view volume are retained in the Replay for the existing view volume. If the view volume created by the –view option already exists and you omit the –move option, the command terminates with an error.

–name 
                                 string
                              

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

–nomovereplay

For the –move options only. If the view volume created by the –view option already exists, makes the new view volume the active view for the created Replay without first taking a Replay of the existing view volume. Changes to the existing view volume are not retained.

–purge

Indicates that expired view volumes should be permanently deleted by the replay checkviews command. If omitted, expired views are moved to the recycle bin by the replay checkviews command. See replay checkviews.

–readonly

Makes the Replay read only.

–remoteport 
                                 string
                              

Sets the world wide name (WWN) of the remote port to which the volume is mapped.

–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 server to which to map the volume or view volume.

–singlepath

Indicates that only a single port can be used for mapping. If omitted, all local ports are used for mapping. Use this option with the –localport and –remoteport options to set the single port to use. (The –localport option is deprecated on Storage Center 5.0 and later.)

–view 
                                 string
                              

Specifies the name of the view volume to create. Names that contain spaces must be enclosed in single quotes.

–viewexpire 
                                 integer
                              

Specifies the number of minutes to wait before unmapping and deleting an expired view.

–volume 
                                 string
                              

Specifies the volume on which the Replay is located.

–volumeindex 
                                 integer
                              

Specifies the volume index on which the Replay is located.

Examples

Create a view volume from a Replay

replay createview -volume 'volume 1' -name 'replay cu' -view view1

replay createview -deviceid 6000d3100000c90000000000000000c7 -name 'replay cu' -view 'view1'

Create a view volume from the last Replay:

replay createview -volume 'volume 1' -name 'replay cu' -view view1

Create and map a view volume:

replay createview -volume 'volume 1' -name 'replay cu' -view view1 -server 'server 1'

Create a view volume from a Replay, map the view volume to a server assigning a LUN, and the make the view volume read only:

replay createview -volume 'volume 1' -view view1 -server done'server 1' -lun 200 -readonly

Create a view volume and map it to a server with a view expiration time of five minutes:

replay createview -volume 'volume 1' -view view1- server 'server 1' -viewexpire 5 -last

Create a view volume with an expiration time, map the view volume to a server, and set the purge option:

replay createview -volume 'volume 1' -view view1 | -server 'server 1' -viewexpire -purge -last

Move a view volume (if it exists) to the -name Replay. Creates a Replay on ‘view1’ before moving.

replay createview -volume 'volume 1' -view view1 -name 'next replay from cu' -move

Move a view volume (if it exists) to the -name Replay. Does not create a Replay on ‘view1’ before moving.

replay createview -volume 'volume 1' -view view1 -name 'next replay from cu' -move -nomovereplay