Storage Center OS Version 7 Command Utility Reference Guide
Notes, Cautions, and Warnings NOTE: A NOTE indicates important information that helps you make better use of your computer. CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. © 2016 - 2019 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries.
Contents About this Guide.............................................................................................................................................. 11 Revision History................................................................................................................................................................. 11 Audience........................................................................................................................................................
cache show.......................................................................................................................................................................23 Description.................................................................................................................................................................. 23 Format.....................................................................................................................................................
diskfolder show................................................................................................................................................................ 34 Description.................................................................................................................................................................. 34 Format......................................................................................................................................................
replayprofile show............................................................................................................................................................ 47 Description.................................................................................................................................................................. 47 Format.......................................................................................................................................................
server show...................................................................................................................................................................... 56 Description..................................................................................................................................................................56 Format.....................................................................................................................................................
Example.......................................................................................................................................................................68 system show.....................................................................................................................................................................68 Description.................................................................................................................................................
Example....................................................................................................................................................................... 77 usergroup show................................................................................................................................................................ 78 Description.................................................................................................................................................
volume unmap.................................................................................................................................................................. 90 Description..................................................................................................................................................................90 Format........................................................................................................................................................
Preface About this Guide This guide describes how to use Storage Center Command Utility to manage your Dell EMC storage infrastructure. Revision History Document Number: 680-018-014 Revision Date Description A May 2016 Initial release for Storage Center OS Version 7 B January 2019 Added Java 8 requirement Audience Storage administrators make up the target audience for this document. The intended reader has a working knowledge of storage and networking concepts.
• For customized support, enter your system service tag on the support page and click Submit. • For general support, browse the product list on the support page and select your product.
1 Getting Started The Storage Center Command Utility is a Java application that provides a command-line interface (CLI) for users who want to use commands and write scripts to manage or automate the management of a Storage Center. Command Utility commands are available to perform most common management operations. The Storage Center Command Utility commands support Storage Center functionality on Microsoft Windows, Linux, Solaris, and AIX platforms.
Command Format Conventions The following are the formatting conventions for commands run in the Storage Center Command Utility. Item Description braces {} Surround a set of required options from which you must choose one item. brackets [] Indicate optional items. ellipsis... Indicates that an item can be repeated. italics Indicate a variable. vertical line | Indicates mutually exclusive options within braces or brackets.
To save a default file with a specified name for storagecenter1: java –jar compcu.jar –default -defaultname saved_default_01 -host storagecenter1 -user admin password mmm To use the newly created default file: java –jar compcu.jar -defaultname saved_default_01 -c "anycommand" The ability to specify a default file name allows you to specify different default files for each Storage Center you manage. –file filename Specifies a file in which to save output. -h Shows help for command options.
Once the default logon is set, you need not specify the logon information. Logon information is automatically supplied from an encrypted file. Getting Command Help All Storage Center CU commands provide the –h option. Use the –h option to display help information for the command and command options. To get a list of all commands, execute CompCU.jar with the –h option: java -jar compcu.jar -h The format for CompCU.jar, as well as a list of all Storage Center CU commands is displayed.
Increasing Available Memory By default, the Java Application Launcher assigns 64 MB to the memory allocation pool. If an out-of-memory exception occurs while executing a CompCU.jar command, use the –Xms n and –Xmx n arguments on the Java Application Launcher to increase the amount of available memory. For example: java -Xms128m -Xmx1024m -jar compcu.jar -c "replay" NOTE: The value must be a multiple of 1024 that is greater than 2 MB. Use k for kilobytes or m for megabytes.
The Command Utility first verifies the command syntax for all commands in the script file. If there are no syntax errors, Storage Center CU executes the commands one-by-one. If an error is encountered (either in the initial syntax parsing or during a command execution), script execution is terminated. java –jar compcu.
2 Command Reference The commands featured in this section perform common management operations from the Storage Center Command Utility. Each command consists of the command name and options. This section lists all of the commands available for use in the Command Utility and their options. alert acknowledge Description Marks a Storage Center alert as having been acknowledged. Acknowledgment indicates to the Storage Center that you have read the alert message and are aware of the problem.
Example Acknowledge a maintenance alert with an index of 20 on a controller with an index of 2: alert acknowledge -controller 2 -index 20 alert show Description Returns information for alerts that were generated on a Storage Center. Output depends on the filter options specified in the command. Format alert show {options} Options –acknowledged string Specifies an acknowledgment status by which to filter the display. –alert_type string Specifies the alert type by which to filter the display.
Specifies the count by which to filter the display. The “count” shows the number of times the alert has been generated. –csv filename Specifies a csv file in which to save output. –date_cleared string Specifies a cleared date and time by which to filter the display. –date_created string Specifies a creation date and time by which to filter the display. –h Shows help for command options. –index string Specifies the alert index by which to filter the display.
Output Description Controller Shows the index number of the controller of the alert. Index Shows the index of the alert. Alert_Type Shows the alert type for the alert. Message Shows the message contained in the alert. Status Shows the status level of the alert. Date_Created Shows the date and time an alert was created. Object_Name Shows the name of the object to which the alert pertains. Category Shows the category for the alert.
Enables or disables global read cache. Specify true (or 1) to enable global read cache or false (or 0) to disable global read cache. –writecache {true|false} Enables or disables global write cache. Specify true (or 1) to enable global write cache or false (or 0) to disable global write cache. Example Enable global write cache: cache modify -writecache true cache show Description Shows Storage Center cache settings. Output depends on the filter options specified in the command.
Output Description Read_Cache Shows global read cache setting: true for on or false for off. Write_Cache Shows global write cache setting: true for on or false for off. Examples Show all Storage Center cache information and save results in a text file and an xml file: cache show -txt cache_info.txt -xml cach_info.xml Show global cache read and write settings: cache show cmm copy Description Creates a new CMM copy operation on the Storage Center.
Example Copy current active data from a source volume with an index of 42 to a destination volume with an index of 56: cmm copy -sourcevolumeindex 42 -destvolumeindex 56 cmm delete Description Deletes a CMM operation from the Storage Center by aborting the operation. Copy/Mirror/Migrate (CMM) is a Storage Center feature that enables volumes to be migrated between different disk types and RAID levels. Format cmm delete –index integer {options} Options –h Shows help for command options.
Options –copyhistory {true|false} Specifies whether the Replay history of the source volume is copied to the destination volume. If set to false, only current active data is copied. –deletesource {true|false} Specifies whether to delete the source volume after migration. –destvolumeindex integer Specifies the index of the destination volume for the migrate operation. –h Shows help for command options. –priority string Specifies the priority of a CMM operation.
Format cmm mirror –sourcevolumeindex integer –destvolumeindex integer {options} –copyhistory {true|false} Specifies whether the Replay history of the source volume is copied to the destination volume. –destvolumeindex integer Specifies the index of the destination volume for the CMM operation. –h Shows help for command options. –priority string Specifies the priority of a CMM operation.
Shows help for command options. –index integer Specifies the index of a CMM operation. –priority string Specifies the priority of a CMM operation. Available options are: • High • Medium • Low Example Modify the priority level of a CMM operation with an index of 77: cmm modify -index 77 -priority high cmm show Description Shows the attributes of CMM operations. Copy/Mirror/Migrate (CMM) is a Storage Center feature that enables volumes to be migrated between different disk types and RAID levels.
For CMM migrate operations, specifies the delete source value of the CMM operation by which to filter the display. –destination_volume_index string Specifies the index of a CMM destination volume by which to filter the display. –destination_volume_name string Specifies the name of a destination volume by which to filter the display. Names that contain spaces must be enclosed in single quotes. –h Shows help for command options.
Output The following information is output to the console in table format. Output Description Index Shows the index of the CMM operation. Type Shows the type of the CMM operation. Source_Vol Shows the index of the source volume. Source_Volume_Name Shows the name of the source volume. Destination_Vol Shows the index of the destination volume. Destination_Volume_Name Shows the name of the destination volume. State Shows the state of the CMM operation.
Specifies a date/time expiration stamp for Replays in a Consistency Group by which to filter the display. –freeze string Specifies a date/time freeze stamp for Replays in a Consistency Group by which to filter the display. –groupsize integer Specifies the number of Replays in a Consistency Group by which to filter the display. –h Shows help for command options. –index string Specifies the index of groups of Replays created for a Consistency Group by which to filter the display.
Format controller show {options} Options –controllerindex string Specifies a controller index by which to filter the display. –controlleripaddress string Specifies the IP address for the controller IP port by which to filter the display. –controlleripgateway string Specifies the gateway address for the controller IP port by which to filter the display. –controlleripmask string Specifies the subnet mask for the controller IP port by which to filter the display.
• Unbalanced –name string Specifies a controller name by which to filter the display. –primarydns string Specifies the IP address of the primary Domain Name Server (DNS) by which to filter the display. –status string Specifies a a controller status by which to filter the display. Available options are: • Down • Up –txt filename Specifies a txt file in which to save output. –version string Specifies four-part controller/system software version by which to filter the display.
diskfolder show Description Shows Storage Center disk folder information. Output depends on the filter options specified in the command. Format diskfolder show {options} Options –allocatedspace string Specifies the allocated space for the disk folder by storage types by which to filter the display. –allocatedspaceblocks string Specifies the allocated space for each storage type in blocks by which to filter the display.
Specifies a txt file in which to save output. –xml filename Specifies an xml file in which to save output. Output The followingStorage Center disk folder information is output to the console in table format. Output Description Index Shows the index of the disk folder. Name Shows the name of the disk folder. Num Managed Shows number of managed disks in the disk folder. Num Spare Shows number of spare disks in the disk folder.
Specifies a world wide name (WWN) of the local port by which to filter the display. (The –localport option is deprecated on Storage Center 5.0 and later.) –lun integer Specifies a logical unit number (LUN) by which to filter the display. –remoteport string Specifies the world wide name (WWN) of the remote port by which to filter the display. –serialnumber string Specifies the volume serial number by which to filter the display.
os show Description Shows server operating system information. Output depends on the filter options specified in the command. Format os show {options} Options –csv filename Specifies a csv file in which to save output. –h Shows help for command options. –index string Specifies the operating system index by which to filter the display. –multipath string Specifies the operating system(s) that support multiple paths by which to filter the display.
Output Description Index Shows operating system index. Name Shows operating system name. Product Shows operating system product name. Version Shows operating system version. Multipath Shows if the operating system supports multipath. replay checkviews Description Checks for and deletes expired views: • If the –purge option for an expired view is not set, moves the view to the recycle bin. • If the –purge option for an expired view is set, permanently deletes the view.
Format replay create {-volumeindex | -deviceid | -serialnumber | -volume } Options –deviceid string Specifies the volume device ID. –expire integer Specifies the number of minutes after which the Replay expires. Specify 0 to indicate no expiration. The default is 0. –folder string Specifies a folder for the volume. –folderindex integer Specifies a folder index for the volume. –h Shows help for command options.
For the –view option only. Specifies the server to which to map the 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 a view volume to create from the Replay. Use the –server option to map the view volume.
replay createview Description Creates a view volume on an existing Replay and optionally maps the new view volume to a server. NOTE: A Replay is a Storage Center point-in-time copy that allows a site to restore data from a specific point in time. When planning Replay schedules and expiration settings, take care to balance restore requirements with the amount of resources consumed by unexpired Replays. Unexpired Replays can consume a disproportionate amount of Storage Center resources.
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.
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 createv
Specifies the volume name on which the Replay is located. Names that contain spaces must be enclosed in single quotes. –volumeindex integer Specifies the index of the volume on which the Replay is located. Examples Delete a Replay: replay delete -volume 'volume 1' -name 'replay cu' replay delete -deviceid 6000d3100000c90000000000000000c7-name 'replay cu' replay show Description Shows Replay information. Output depends on the filter options specified in the command.
Specifies the Replay index by which to filter the display. –name string Specifies the Replay name by which to filter the display. Names that contain spaces must be enclosed in single quotes. –txt filename Specifies a txt file in which to save output. –volume string Specifies a volume name by which to filter the display. Names that contain spaces must be enclosed in single quotes. –volumeindex integer Specifies a volume index by which to filter the display.
replayprofile createreplay Description Creates a Replay on all volumes in a Replay profile, including Replay profiles that form a Consistency Group. NOTE: A Replay is a Storage Center point-in-time copy that allows a site to restore data from a specific point in time. When planning Replay schedules and expiration settings, take care to balance restore requirements with the amount of resources consumed by unexpired Replays. Unexpired Replays can consume a disproportionate amount of Storage Center resources.
replayprofile show Description Shows Replay profile information. Output depends on the filter options specified in the command. NOTE: A Replay is a Storage Center point-in-time copy that allows a site to restore data from a specific point in time. When planning Replay schedules and expiration settings, take care to balance restore requirements with the amount of resources consumed by unexpired Replays. Unexpired Replays can consume a disproportionate amount of Storage Center resources.
Output For each Replay, the following information is output to the console in table format. Output Description Index Shows index of the Replay profile. Name Shows name of the Replay profile. Type Shows type for the Replay profile. numRules Shows number of rules associated with the Replay profile. NumVolumes Shows number of volumes using the Replay profile. Schedule Shows schedule(s) for the Replay profile. server addhba Description On Storage Center 5.
Shows help for command options. –index integer Specifies the server index. –manual Optional flag to configure the requested HBAs before they are discovered. If the WWN matches a known server port, then this flag is ignored. If this flag is present, then –porttype must also be specified. –name string Specifies the server name. Names that contain spaces must be enclosed in single quotes. –porttype string Specifies the transport type for all HBAs being added. This option is required if the –manual flag is set.
Format server addtocluster {–name string | –index integer} {–parent string | –parentindex integer} {options} Options –h Shows help for command options. –index integer Specifies the server index. –name string Specifies the server name. Names that contain spaces must be enclosed in single quotes. –parent string Specifies an existing physical server or cluster on which to host the new virtual server. Names that contain spaces must be enclosed in single quotes.
Format server create –name string –wwn string,…,string {options} Options –folder string Specifies a folder for the server. Names that contain spaces must be enclosed in single quotes. –folderindex integer Specifies the server folder index. –h Shows help for command options. –name string Specifies the server name. Server names that contain spaces must be enclosed in single quotes. –notes string Specifies optional user notes associated with the server.
server createcluster Description On Storage Center 5.0 and higher, creates a server cluster with no underlying physical or virtual servers. To add a physical or virtual server to a cluster, see server addtocluster. The command is rejected if: • Cluster name or operating system is omitted. • Requested operating system is not supported (unknown or invalid).
server delete Description Deletes a server from the Storage Center, along with the associated HBAs and volume mappings. The scope of deletion and protection depend on server type, as follows: • If the requested server is a virtual server, then only that virtual server is deleted. • If the requested server is a physical server, then that physical server and all virtual servers whose parent is that physical server are deleted.
server modify Description Modifies a server. Format server modify {–index integer | –name string} {options} Options –folder string Specifies a folder for the server. Names that contain spaces must be enclosed in single quotes. –folderindex integer Specifies the folder index of the server –h Shows help for command options. –index integer Specifies the server index. –name string Specifies the server name. Names that contain spaces must be enclosed in single quotes.
server removefromcluster Description On Storage Center 5.0 and later, removes a physical or virtual server from a server cluster. The server reverts to a standalone physical server. The command is rejected if: • Server name and index are omitted. • Requested server is not found on the Storage Center. • Requested server is not assigned to a cluster. Format server removefromcluster {–name string | –index integer} {options} Options –h Shows help for command options.
• Requested server or WWN is not found on the Storage Center. • Requested WWN is not assigned to the requested server. Format server removehba {–name string | –index integer} –WWN string,…,string {options} Options –h Shows help for command options. –index integer Specifies the server index. –name string Specifies the server name. Names that contain spaces must be enclosed in single quotes. –WWN string Specifies which HBA to remove from the server.
• Partially Connected: requires single quotes and indicates that at least one primary path is up and at least one primary path is down between the HBA and the Storage Center. –csv filename Specifies a csv file in which to save output. –folder string Specifies a server folder name by which to filter the display. Names that contain spaces must be enclosed in single quotes. –folderindex string Specifies a server folder index by which to filter the display. (Storage Center 5.0 and later).
• When multiple WWNs are entered, each name must be entered exactly as the server show command displays it, including spaces. Any WWNs that include the space character, must be enclosed by single quote marks. –xml filename Specifies an xml file in which to save output. The xml file also returns mapping objects that include Volume, DeviceID, SerialNumber, RemotePort, and LUN. (See also volume show.) Output For each Storage Center server, the following information is output to the console in table format.
server showhba Description On Storage Center 5.0 and later, shows server port/HBA information for each attached server known to the Storage Center. Output depends on the filter options specified.
Specifies additional, protocol- and device-specific information by which to filter the display. –server string Specifies the index of the server host for the port/HBA by which to filter the display. –servername string Specifies the name of the server host for the port/HBA by which to filter the display. –status string Specifies the operational status of the server port/HBA by which to filter the display. Valid values are: • Up • Down –txt filename Specifies a text file in which to save output.
Format serverfolder create –name string {options} –h Shows help for command options. –name string Specifies the server folder name. Names that contain spaces must be enclosed in single quotes. –parent string Specifies the parent folder of the server folder. Names that contain spaces must be enclosed in single quotes. –parentindex integer Specifies the parent server folder index.
Specifies the name of the server folder. Names that contain spaces must be enclosed in single quotes. –parent string Specifies the parent folder of the server folder. Names that contain spaces must be enclosed in single quotes. Examples Delete a server folder by name: serverfolder delete -name newfolder -parent servercluster Delete a server folder by index: serverfolder delete -index 42 -parent servercluster serverfolder modify Description Modifies server folder settings.
Modify a server folder by index and parentindex: serverfolder modify -index 88 -parentindex 208 serverfolder show Description Shows information about a server folder. Output depends on the filter options specified in the command. Format serverfolder show {options} Options –csv filename Specifies a csv file in which to save output. –h Shows help for command options. –index string Specifies a server folder index by which to filter the display.
Output Description Index Shows server folder index. Name Shows server folder name. Path Shows path for the server folder. NumServers Shows number of servers in the path. storageprofile show Description Shows Storage Profile information. Output depends on the filter options specified in the command. Format storageprofile show {options} Options –csv filename Specifies a csv file in which to save output. –dualhistorical string Shows the Storage Tier and RAID level for dual-redundant Replay data.
Specifies the number of volumes using the Storage Profile by which to filter the display. –redundanthistorical string Specifies the Storage Tier and RAID level for redundant Replay data by which to filter the display. –redundantwritable string Specifies the Storage Tier and RAID level for redundant writable data by which to filter the display. –txt filename Specifies a txt file in which to save output. –xml filename Specifies an xml file in which to save output.
storagetype show Description Shows information about a storage type. Output depends on the filter options specified in the command. Format storagetype show {options} Options –csv filename Specifies a csv file in which to save output. –diskfolder string Specifies the disk folder associated with a storage type by which to filter the display. –h Shows help for command options. –index string Specifies the index of a storage type by which to filter the display.
Specifies the space allocated in blocks by the storage type by which to filter the display. –spaceused string Specifies the space used by the storage type by which to filter the display. –spaceusedblocks string Specifies the space used in blocks by the storage type by which to filter the display. –txt filename Specifies a txt file in which to save output. –xml filename Specifies an xml file in which to save output.
Options –h Shows help for command options. –simultaneous Specifies whether both controllers on a dual-controller Storage Center should be restarted simultaneously. If the simultaneous option is not specified on the command, a dual-controller Storage Center will be restarted in sequence starting with the leader controller. • • Restarting in sequence does not cause a Storage Center outage. Storage Center shuts down the leader controller, and then restarts the leader controller.
Specifies the Storage Center management IP address by which to filter the display. –name string Specifies a Storage Center name by which to filter the display. –operationmode string Specifies a Storage Center operation mode by which to filter the display. Available options are: • Install • Maintenance • Normal • PreProduction –portsbalanced string Specifies a Local Ports Balanced status by which to filter the display.
system shutdown Description Enables an Administrator to shut down a Storage Center. You cannot shutdown until all controllers are in the Up state. This ensures that the Storage Center shuts down elegantly. NOTE: Restarting a controller that has been shutdown requires manual intervention. The power button on the Storage Center controller must be pressed to restore power. Format system shutdown Option –h Shows help for command options.
Specifies optional notes for the user. –password string Specifies a password for the user. –privilege string Specifies the privilege level of the user. Allowed values are: • Admin • VolumeManager • Reporter –realname string Specifies the real name of the user. –usergroup string,…,string Specifies user groups by name for the user. If user groups exist on the Storage Center, lists the user groups. If no user group has been created, use the usergroup create command to create a user group.
Specifies the index of the user to be removed. –username string Specifies the user name of the user to be removed. Examples Delete a user with a user name of Fred: user delete -username Fred Delete a user with an index of 4: user delete -index 4 user modify Description Enables a user with Administrator privileges to modify existing Storage Center user account information and privileges for any user on the Storage Center.
• • • Admin VolumeManager Reporter NOTE: To downgrade a user’s privileges, delete the user and re-create the user with a new user name. You cannot recreate a user with downgraded privileges with the same user name. You can upgrade a user’s privileges without deleting and re-creating the user with a new user name. –realname string Specifies the real name of the user. –usergroup string,…,string Specifies user group(s) by name for the user. If user groups exist on the Storage Center, lists the user group.
Shows help for command options. –index integer Specifies a user index by which to filter the display. –privilege string Specifies user privilege by which to filter the display. Available options are: • Admin • VolumeManager • Reporter –realname string Specifies user real name by which to filter the display. –showgroupindex Flag indicating that user groups will be displayed by index rather than by name. –txt filename Specifies a txt file in which to save output.
usergroup create Description Enables a user with Administrator privileges to create a user group on the Storage Center and to specify disk, server, and volume folders for the group. User groups have access only to specified disk, server, and volume folders.
Examples Create a user group with a server folder and a volume folder specified for the group’s use on a Storage Center with only one managed disk folder: usergroup create -name HRusers -serverfolder HR1 -volumefolder staffing Create a user group with a server folder, a volume folder, and a disk folder specified for the group’s use on a Storage Center with two managed disk folders: usergroup create -name HRusers -serverfolder HR1 -volumefolder staffing -diskfolder ManagedFolder1 usergroup delete Descriptio
usergroup modify Description Enables a user with Administrator privileges to modify information and privileges for a Storage Center user group. Format usergroup modify {–index integer | –name string} {options} Options –diskfolder string,…,string Specifies a list of disk folders by name. This option is required only if the Storage Center has more than one managed disk folder. If the Storage Center has only a single managed disk folder, that folder is automatically included in the user group.
usergroup show Description Enables a user with Administrator privileges to display information about Storage Center user groups. Output depends on the filter options specified in the command. Format usergroup show {options} Options –csv filename Specifies a csv file in which to save output. –disk_folders string,…,string Specifies disk folders assigned to the user group by which to filter the display. NOTE: Multiple folders must be specified exactly as shown in the output from the usergroup show command.
NOTE: Folders must be specified exactly as shown in the output from the usergroup show command. For example, if the command returns: folder1, folder2, folder3, you must specify all three folder names as shown or the command will not return any user groups. –xml filename Specifies an xml file in which to save output. Output The following information is output to the console in table format. Output Description Index Shows the index of the user group. Name Shows the name of the user group.
Specifies the index of an existing volume folder in which to create the volume. –h Shows help for command options. –localport string Specifies the WWN of the single local port to use for mapping when the –singlepath option is specified. 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.) –lun integer Specifies the logical unit number (LUN) for the mapped volume.
Specifies the volume size. Enter the number of 512-byte blocks or the total byte size. To specify a total byte size, use k for kilobytes, m for megabytes, g for gigabytes, or t for terabytes. For example: enter 32m to specify a block size of 32 MB. This option is required. –storageprofile string Specifies a Storage Profile for the volume. Use storageprofile show to show a list of available Storage Profiles. –storageprofileindex integer Specifies a Storage Profile index for the volume.
Volume Mapping Examples Create and map a volume and allow Storage Center Command Utility to assign a controller and LUN: volume create -name 'volume 1' -server 'server 1' Create and map a volume with a specified controller: volume create -name 'volume 1' -server 'server 1' -controller 'leader' Create and map a volume with a specified controller and LUN: volume create -name 'volume 1' -server 'server 1' -controller 'leader' -lun 25 Create a volume with a single path for mapping: volume create -name 'volume 1
Examples Deleting a volume by moving it to the recycle bin: volume delete -name 'volume 1' Completely purging the volume: volume delete -name 'volume 1' -purge volume delete -deviceid 6000d3100000c90000000000000000cb -purge volume erase Description Erases all data from a volume. This command is deprecated for Storage Center 5.0 and later. Format volume erase {–deviceid string | –index integer | –name string | –serialnumber string} Options –deviceid string Specifies the volume device ID.
volume expand Description Expands the size of a volume. Format volume expand {–deviceid string | –index integer | –name string –serialnumber string} –size integer [k|m|g|t] Options –deviceid string Specifies the volume device ID. See About Device IDs for information. –h Shows help for command options. –index integer Specifies the volume index. –name string Specifies the volume name. Names that contain spaces must be enclosed in single quotes. –serialnumber string Specifies the volume serial number.
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. NOTE: To create a new volume and map it to a server, use volume create.
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.
Specifies a folder for the volume. Names that contain spaces must be enclosed in single quotes. –folderindex integer Specifies the volume folder index. –h Shows help for command options. –index integer Specifies the volume index. –maxwrite integer [k|m|g|t] Specifies the maximum size for volume writes. Enter the number of 512-byte blocks or the total byte size. To specify a total byte size, use k for kilobytes, m for megabytes, g for gigabytes, or t for terabytes.
Set volume cache: volume modify -name testvol -readcache true -writecache false volume modify -name testvol -readcache false -writecache true volume modify -name testvol -readcache true -writecache true volume modify -name testvol -readcache false -writecache false volume show Description Shows volume information. Output depends on the filter options specified in the command. Format volume show {options} Options –activesize integer [k|m|g|t] Specifies an active size by which to filter the display.
Specifies a Replay size in blocks by which to filter the display. –serialnumber string Specifies a volume serial number by which to filter the display. (Available only when running on operating systems that expose serial numbers to the user.) –status string Specifies the volume status by which to filter the display. Valid arguments are: • Up: Returns a list of volumes that are running correctly. • Down: Returns a list of volumes that are not running correctly and cannot be used.
Output Description MappingInfo XML output only. For each map shows: index, server, local port, remote port, and LUN. volume unmap Description Deletes all mappings for a volume. Format volume unmap {–deviceid string | –index integer | –name string | –serialnumber string} Options –deviceid string Specifies the volume device ID. See About Device IDs for information. –h Shows help for command options. –index integer Specifies the volume index. –name string Specifies the volume name.
Format volumefolder create –name string {options} Options –h Shows help for command options. –name string Specifies the volume folder name. Names that contain spaces must be enclosed in single quotes. –parent string Specifies a parent folder for the volume folder. Names that contain spaces must be enclosed in single quotes. –parentindex integer Specifies the parent volume folder index for the volume folder.
Specifies the name of the volume folder to delete. Names that contain spaces must be enclosed in single quotes. –parent string Specifies the parent folder for the volume folder. Names that contain spaces must be enclosed in single quotes. Example Delete a volume folder: volumefolder delete -name 'my folders' volumefolder delete -index 301 volumefolder modify Description Modifies a volume folder.
volumefolder show Description Shows volume folder information. Output depends on the filter options specified in the command. Format volumefolder show {options} Options –csv filename Specifies a csv file in which to save output. –h Shows help for command options. –index string Specifies the index of a volume folder by which to filter the display. –name string Specifies the name of a volume folder by which to filter the display. Names that contain spaces must be enclosed in single quotes.
Output Description Path Shows the path for the volume folder.
3 Device IDs Device IDs identify volumes with a series of numbers and letters. The device ID acts as a substitute to identifying a volume by its name, index, or serial number. This section describes device IDs and provides commands used to modify a device ID. About Device IDs When you create a volume, you must specify a volume name.
replay createview command: replay createview -view 'Test View Bat 0001' -deviceid 6000d3100000c90000000000000000c7 -server 'Ontario' -viewexpire 5 96 Device IDs