Table Of Contents
Caching Services Module Commands
cluster add
cluster config
cluster name
dir modflash:
feature enable
flash-copy
host
install module node
interface svc
iogroup
ip
mdisk-grp
migrate vdisk
node
node svc delete
node svc recover
node svc servicemode
node svc upgrade
quorum
remote-copy
show cluster flash-copy
show cluster host
show cluster iogroup
show cluster ip
show cluster mdisk
show cluster mdsik-grp
show cluster nodes
show cluster remote-copy
show cluster remote-copy-cluster
show cluster status
show cluster vdisk
show environment battery
show interface svc
show nodes
show svc
svc-config
svc-ibmcli
svc-purge-wwn module
vdisk
Caching Services Module Commands
The commands in this chapter apply to the SAN Volume Controller (SVC) software and the Caching Services Module (CSM) in Cisco MDS 9000 Family of multilayer directors and fabric switches. All commands are shown here in alphabetical order regardless of command mode.
For more information on virtualization using the CSM, see the "Related Documentation" section.
cluster add
To create a cluster with a specified SVC node, use the cluster add command in SVC configuration mode.
cluster add cluster-name ip ip-address node svc slot-number/node-number
Syntax Description
cluster
|
Provides access to cluster commands
|
add cluster-name
|
Specifies a new cluster addition. The cluster name must start with an alphabet and is restricted to 15 alphanumeric characters, including dash (-) and underscore (_). The cluster name cannot be ClusterX, where X is a number.
|
ip ip-address
|
Specifies the IP address of the specified cluster. The IP address must be in the same subnet as the switch management IP address.
|
node svc
|
Specifies the node's SVC interface
|
slot-number
|
Specifies the slot number of the Caching Service Module (CSM).
|
node-number
|
Specifies the node number of the SVC instance running on the CSM. This number ranges from 1 to 2 nodes per module.
|
Defaults
None.
Command Modes
SVC configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
Enter this command while connected to the switch management IP address of a node at which the cluster is being created.
Examples
The following example enters the SVC configuration mode, verifies the status of previously-configured clusters, and adds a cluster called SampleCluster.
switch(svc)# show nodes local
-------------------------------------------------------------------------------
Node cluster config cluster node sw
node status status version
-------------------------------------------------------------------------------
svc2/1 No unconfigured free 1.3(1)
svc2/2 No unconfigured free 1.3(1)
switch(svc)# cluster add SampleCluster ip 10.10.0.1 node svc 2/1
cluster creation going on. Please wait....
The status of the newly-added cluster can be verified using the show nodes local command.
switch(svc)# show nodes local
-------------------------------------------------------------------------------
Node cluster config cluster node sw
node status status version
-------------------------------------------------------------------------------
svc2/1 SampleCluster Yes active active 1.3(1)
svc2/2 No unconfigured free 1.3(1)
Related Commands
Command
|
Description
|
show nodes local
|
Displays the cluster name and status for all nodes in the switch.
|
cluster config
To manage cluster configurations on a specified cluster, use the cluster config configuration submode.
cluster config cluster-name
Syntax Description
cluster
|
Provides access to cluster commands
|
config cluster-name
|
Places a previously created cluster in the cluster configuration submode (switch(svc-cluster)#).
|
Defaults
None.
Command Modes
SVC configuration mode—cluster configuration submode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
None.
Examples
The following example enters the SVC configuration mode and adds a cluster called SampleCluster.
switch(svc)# cluster config SampleCluster
Related Commands
Command
|
Description
|
show cluster
|
Displays configured cluster information.
|
cluster name
To perform operations on a previously-configured cluster, use the cluster name command in SVC configuration mode.
cluster name cluster-name flash-copy fc-grp-name [prepare | start | stop]
cluster name cluster-name remote-copy rc-grp-name {failover | start [aux | clean | force] | stop
aux-enable}
cluster name cluster-name shutdown [node node-name]
cluster name cluster-name start discovery
cluster name cluster-name upgrade svc-system [force]}
Syntax Description
cluster
|
Provides access to cluster commands
|
name cluster-name
|
Identifies a previously created cluster to perform an operation.
|
flash-copy fc-grp-name
|
Specifies a previously-configured FlashCopy relationship.
|
prepare
|
Prepares the FlashCopy consistency group.
|
start
|
Starts the FlashCopy for the specified cluster.
Starts the background copy for the specified remote copy group
|
stop
|
Stops the FlashCopy for the specified cluster.
Stops the remote copy relationships for the specified remote copy group.
|
remote-copy rc-grp-name
|
Specifies the remote copy consistency group name.
|
failover
|
Reverses to using the auxiliary VDisks for the specified relationship.
|
shutdown
|
Shuts down the entire cluster (gracefully).
|
node node-name
|
Specifies a particular node for a graceful shutdown.
|
start discovery
|
Starts the background copy for the specified remote copy group.
|
aux
|
Makes the auxiliary VDisks as primary.
|
clean
|
Marks the intended secondary VDisks as clean.
|
upgrade svc-system
|
Upgrades the specified cluster. The new version of the software image is specified to the FTP:, SCP:, SFTP:, TFTP:, bootflash:, or slot0: directories
|
force
|
Permits the remote copy operation to start—even if it leads to the loss of data consistency between the primary and secondary.
|
aux-enable
|
Enables write access o the secondary (or auxiliary) VDisks.
|
Defaults
None.
Command Modes
SVC configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
None.
Examples
The following example enters the SVC configuration mode and displays all options under the cluster name command.
switch(svc)# cluster name SampleCluster ?
switch(svc)# cluster name SampleCluster flash-copy f1 prepare
switch(svc)# cluster name SampleCluster flash-copy f1 start
switch(svc)# cluster name SampleCluster flash-copy f1 stop
switch(svc)# cluster name SampleCluster remote-copy f1 failover
switch(svc)# cluster name SampleCluster remote-copy f1 start
switch(svc)# cluster name SampleCluster remote-copy f1 stop
switch(svc)# cluster name SampleCluster shutdownn
switch(svc)# cluster name SampleCluster shutdown node svc2/1
switch(svc)# cluster name SampleCluster start discovery
switch(svc)# cluster name SampleCluster upgrade svc-system
bootflash:m9000-ek9-csm-svc_mz.1.3.1.bin
dir modflash:
To display the contents of the modflash: file system, use the dir modflash: command in EXEC mode.
dir modflash://module-number-node-number-path
Syntax Description
modflash:
|
Flash image that resides on the Caching Services Module (CSM).
|
module-number
|
Specifies the slot number in which the CSM resides.
|
node-number
|
Specifies one of the two nodes in the CSM (SVC node). The options are 1 or 2.
|
path
|
Specifies the volatile or the cores paths.
|
volatile
|
Displays the /var and /tmp of the SVC node on the supervisor module and can be used to move files from/to the SVC node.
|
cores
|
Displays process, kernel crash dumps, and other trace information used to debug software issues.
|
Defaults
None.
Command Modes
EXEC mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
None.
Examples
The following example shows how to list the files on the bootflash directory.
switch# dir modflash://2-2-cores
switch# dir modflash://2-2-volatile
Related Commands
Command
|
Description
|
delete
|
Deletes a file on a Flash memory device.
|
feature enable
To enable a specified feature in a cluster, use the feature enable command in the cluster configuration submode.
cluster config cluster-name
feature enable {capacity number | flash-copy | remote-copy}
Syntax Description
cluster
|
Provides access to cluster commands
|
config cluster-name
|
Places a previously created cluster in the cluster configuration submode.
|
feature enable
|
Enables a specified feature on this cluster. Three features can be enabled: capacity, flash-copy, or remote-copy
|
capacity
|
Configures the virtualization capacity of this cluster.
|
number
|
Provides a range from 1- 1677215 Gigabytes.
|
flash-copy
|
Enables the flash-copy feature for this cluster.
|
remote-copy
|
Enables the remote-copy feature for this cluster.
|
Defaults
None.
Command Modes
SVC configuration mode—cluster configuration submode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
The cluster configuration submode prompt is (switch(svc-cluster)#).
By default, flash-copy and remote-copy are disabled and 0 (zero) GB of virtualization capacity is enabled.
Examples
The following example enters the cluster configuration submode for the SampleCluster cluster and assigns a size of 4000 Gigabytes. The next two commands enables the flash-copy and remote-copy features for this cluster.
switch(svc)# cluster config SampleCluster
switch(svc-cluster)# feature enable ?
capacity Cluster enable feature capacity
flash-copy Cluster enable feature flash-copy
remote-copy Cluster enable feature remote-copy
switch(svc-cluster)# feature enable capacity ?
<0-2147483647> Enter the capacity
switch(svc-cluster)# feature enable capacity 4000
switch(svc-cluster)# feature enable flash-copy
switch(svc-cluster)# feature enable remote-copy
Related Commands
Command
|
Description
|
show cluster name flash-copy
|
Displays configured flash-copy information for a specified cluster.
|
show cluster name remote-copy
|
Displays configured remote copy information for a specified cluster.
|
flash-copy
To create a snapshot (or point-in-time copy) of a specified VDisk or group of VDisks, use the flash-copy command in the cluster configuration submode.
cluster config cluster-name
flash-copy add fcopy-name
flash-copy name fcopy-name
map src-vdisk vdisk-name dst-vdisk vdisk-name |
[mode copy-on-write | full rate rate]
flash-copy rename old-name newname new-name
Syntax Description
cluster
|
Provides access to cluster commands
|
config cluster-name
|
Places a previously created cluster in the cluster configuration submode.
|
flash-copy add fcopy-name
|
Creates a FlashCopy instance.
|
flash-copy fcopy-name
|
Enters the FlashCopy submode for an existing copy name.
|
map
|
Creating a mapping between the source and destination VDisks.
|
src-vdisk vdisk-name
|
Specifies the source VDisk for the flash copy.
|
dst-vdisk vdisk-name
|
Specifies the destination VDisk for the flash copy.
|
mode
|
Controls the FlashCopy mode.
|
copy-on-write
|
Copies to the source VDisk only if new information in written to it after FlashCopy is initiated (default).
|
full rate rate
|
Specifies the background copy rate (ranges from 1 to 100) at which the source VDisk is copied to the destination VDisk even if no new information is written to the source.
|
Defaults
None.
Command Modes
SVC configuration mode—cluster configuration submode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
The cluster configuration submode prompt is (switch(svc-cluster)#.
The flash-copy submode prompt is switch(svc-cluster-flash-copy)#.
Examples
The following example enters the enters the cluster configuration mode for the SampleCluster 1 cluster.
switch(svc)# cluster config SampleCluster
switch(svc-cluster)# flash-copy f2
switch(svc-cluster-flash-copy)# ?
no Negate a command or set its defaults
switch(svc-cluster-flash-copy)# map src-vdisk VDISK1 dst-vdisk DDISK1
switch(svc-cluster-flash-copy)# mode copy-on-write
switch(svc-cluster-flash-copy)# exit
switch(svc-cluster)# flash-copy add FlashC2
switch(svc-cluster)# exit
switch(svc)# show SampleCluster flash-copy
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
switch(svc)# show SampleCluster flash-copy f2
Related Commands
Command
|
Description
|
show SampleCluster name flash-copy
|
Displays configured flash-copy information for a specified SampleCluster.
|
host
To create or configure hosts, use the host command in the cluster configuration submode.
cluster config cluster-name
host add host-name hostport port-wwn
host name host-name
hostport port-wwn |
map vdisk vdisk-name [SCSI-lun lun-number]
Syntax Description
cluster
|
Provides access to cluster commands
|
config cluster-name
|
Places a previously created cluster in the cluster configuration submode.
|
host add host-name
|
Creates a host with one port and assigns the host name.
|
hostport port-wwn
|
Specifies a port using the port WWN
|
host name host-name
|
Enters the host submode for an existing host name.
|
map
|
Maps a previously configured disk to this host.
|
vdisk vdisk-name
|
Specifies the VDisk to be mapped to the host.
|
SCSI-lun lun-number
|
Specifies a LUN to map the host port. If the LUN number is not specified, the next available number is assigned automatically.
|
Defaults
None.
Command Modes
SVC configuration mode—cluster configuration submode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
The cluster configuration submode prompt is (switch(svc-cluster)#).
The host submode prompt is switch (svc-cluster-host)#
Examples
The following example enters the cluster configuration mode for SampleCluster and creates a host called Host 1with one port, adds a second port, and maps the VDisk for Host1, and verifies the configured information for Host1.
switch(svc)# cluster config SampleCluster
switch(svc-cluster)# host add Host1 hostport 11:22:33:44:aa:bb:cc:dd
switch(svc-cluster)# host Host1
switch(svc-cluster-host)# ?
hostport Add pWWN to host
no Negate a command or set its defaults
switch(svc-cluster-host)# hostport 22:11:33:55:11:aa:bb:cc
switch(svc-cluster)# host add Host1 hostport 35:66:11:22:aa:bb:22:cc
switch(svc-cluster)# host Host1
switch(svc-cluster-host)# hostport 35:66:11:22:aa:bb:22:11
switch(svc-cluster-host)# map vdisk Vdisk1
switch(svc-cluster-host)# map vdisk Vdisk1 ssci-lun 10
Related Commands
Command
|
Description
|
show cluster name host
|
Displays configured host information for a specified cluster.
|
install module node
To install the SVC node image, use the install module node command.
install module module-number node node-number image svc-system [bootflash: | slot0: | ftp: |
sftp: | scp: | svc-image]
Syntax Description
install module
|
Installs the specified image for the CSM.
|
module-number
|
Switching modules: From slot 1 to 4 and 7 to 9 in a Cisco MDS 9500 Series switch. For slot 2 in a Cisco MDS 9200 Series switch.
Supervisor modules: Slot 5 or 6—only on the active supervisor module in a Cisco MDS 9500 Series switch. Slot 1—upgrades both the supervisor and switching parts of the module in a Cisco MDS 9200 Series switch.
|
node
|
Selects the SVC node to install the image.
|
node-number
|
Specifies the node number.
|
image svc-system
|
Specifies the file name of an SVC image.
|
bootflash:
|
Source location for internal bootflash memory
|
ftp
|
URI containing SVC Image.
|
scp
|
URI containing SVC Image.
|
sftp
|
URI containing SVC Image.
|
tftp
|
URI containing SVC Image.
|
slot0:
|
Source location for the CompactFlash memory or PCMCIA card.
|
svc-image
|
The name of the SAN Volume Controller (SVC) image.
|
Defaults
None.
Command Modes
EXEC mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(3).
Usage Guidelines
The install module module-number node command installs the new image in the specified node on the CSM module. All previous data in that node is lost.
Examples
The following example shows how to install a new image on an SVC node.
switch# install module 2 node 1 image svc-system
scp://root@172.22.93.174/auto/isan-src/MAIN_1_3_0_17t/VegasSW/build/gdb.sb-svc/isan/target
fs/sb-svc.bin
SVC reimage going on. Please wait
root@172.22.93.174's password:
sb-svc.bin 100% |*****************************| 45408 KB 00:53
svc 2/1 software reimage succeeded
Related Commands
Command
|
Description
|
show version compatibility
|
Shows the system software that is currently running on the switch
|
interface svc
To configure a SAN Volume Controller (SVC) interface on the Cisco MDS 9000 Family of switches, use the interface svc command.
interface svc slot_number/node-number
interface svc slot_number/node-number initiator | mgmt | nwwn nwwn-id target vsan vsan-id
interface svc slot_number/node-number switchport description | shutdown]
Syntax Description
interface
|
Configures a new interface.
|
svc
|
Specifies the new interface to be a SVC interface.
|
slot-number
|
Specifies the slot number of the Caching Service Module (CSM).
|
node-number
|
Specifies the node number of the SVC instance running on the CSM. This number ranges from 1 to 2 nodes per module.
|
initiator
|
Configures the initiator or port in the specified VSAN.
|
mgmt
|
Configures the management or port in the specified VSAN.
|
target
|
Configures the target or port in the specified VSAN.
|
vsan vsan-id
|
Specifies the VSAN ID ranging from 1 to 4093.
|
shutdown
|
Enables or disables an interface.
|
nwwn nwwn-id
|
Configured a non-system allocated nWWN for SVC Node.
|
switchport description
|
Assigns a description to the switchport. Restricted to 80 alphanumeric characters.
|
Defaults
None.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
By default, all three N-port types (initiator, mgmt, and target) are in VSAN 1. Explicitly remove it from VSAN 1 if this is not required by your network.
The VSAN number can be any number from 1 to 4096. Only 64 VSANs for all initiator/mgmt/target are allowed (meaning, you can have initiator in VSANs 1-30, target in VSANs 31-60, and mgmt in VSANs 61-64). If the target, initiator, and mgmt overlap in VSANs, each overlap is also included in the total VSAN count.
A mgmt N-port can only exist in 4 of these 64 VSANs.
You can specify a range of interfaces by issuing a command with the following example format:
interface svc 1/1 space , space svc 2/1-2
This command configures Slot 1 Node 1 as an SVC interface and simultaneously configures Slot 2, Nodes 1and 2 as SVC interfaces.
Place the disk, host, and other SVC nodes in the appropriate VSAN for any configuration to be completely established
Examples
The following example configures the initiator N-port on VSAN 1, the target N-port on VSAN 2, and the management N-port on VSAN 3.
Enter configuration commands, one per line. End with CNTL/Z.
switch(config)# interface svc 2/1
Interface configuration commands:
exit Exit from this submode
initiator Configure Initiator traffic for SVC Node
mgmt Configure traffic for communication with other SVC Nodes
no Negate a command or set its defaults
nwwn Configured a non-system allocated nWWN for SVC Node
shutdown Enable/disable an interface
switchport Configure switchport parameters
target Configure Target traffic for SVC Node
switch(config-if)# initiator vsan 1
switch(config-if)# target vsan 2
switch(config-if)# mgmt vsan 3
Related Commands
Command
|
Description
|
show interface
|
Displays an interface configuration for a specified interface.
|
iogroup
To assign a name to I/O groups, use the iogroup command in the cluster configuration submode. Use the no form of this command to delete the configured I/O group alias.
cluster config cluster-name
iogroup group-id alias alias-name
Syntax Description
cluster
|
Provides access to cluster commands
|
config cluster-name
|
Places a previously created cluster in the cluster configuration submode.
|
iogroup group-id
|
Identifies one of four I/O groups in the specified cluster. The ID ranges from 1 to 4.
|
alias alias-name
|
Assigns a name to the selected I/O group. The name is restricted to 15 alphanumeric characters.
|
Defaults
None.
Command Modes
SVC configuration mode—cluster configuration submode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
The no iogroup command deletes the alias name, not the I/O group itself.
The cluster configuration submode prompt is (switch(svc-cluster)#).
Examples
The following example enters the cluster configuration mode for SampleCluster and configures a new I/O group. The created group is verified using the show cluster name iogroup command
switch(svc)# cluster config SampleCluster
switch(svc-cluster)# iogroup 1 alias SampleIOgroup
switch(svc-cluster)# exit
Related Commands
Command
|
Description
|
show cluster name iogroup
|
Displays configured I/O group information for a specified cluster.
|
ip
To modify the IP address for a cluster, use the ip command in the cluster configuration submode.
cluster config cluster-name
ip ip-address
Syntax Description
cluster
|
Provides access to cluster commands
|
config cluster-name
|
Places a previously created cluster in the cluster configuration submodes.
|
ip ip-address
|
Specifies the IP address of the cluster.
|
Defaults
None.
Command Modes
SVC configuration mode—cluster configuration submode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
The IP address of the cluster can be changed, but not deleted. If you connect using the current cluster IP address, that session is lost when the command completes. You must then reconnect using the new IP address.
The no form of this command is not allowed.
The cluster configuration submode prompt is (switch(svc-cluster)#).
Examples
The following example enters the cluster configuration mode for SampleCluster, configures the IP address, and verifies by displaying this information
switch(svc)# cluster config SampleCluster
switch(svc-cluster)# ip 172.22.92.32
switch(svc)# show cluster SampleCluster ip
cluster ip address is 172.22.92.32
Related Commands
Command
|
Description
|
show cluster name ip
|
Displays configured -- information for a specified cluster.
|
mdisk-grp
To create and configure a mdsik group, use the mdisk-grp command in the cluster configuration submode.
cluster config cluster-name
mdisk-grp add grp-name extent size
mdisk-grp name grp-name -> mdisk id mdisk-id
Syntax Description
cluster
|
Provides access to cluster commands
|
config cluster-name
|
Places a previously created cluster in the cluster configuration submode.
|
mdisk-grp add grp-name
|
Adds a mdisk group.
|
extent size
|
Assigns the extent size of the storage allocation for MDisks in this cluster. The extent size can be 16, 32, 64, 128, 256, or 512 MB.
|
mdisk-grp name grp-name
|
Enters the mdisk submode of an existing MDisk group.
|
mdisk id mdisk-id
|
Assigns the disk ID ranging from 1 to 4096 to the mdisk in the MDisk group submode.
|
Defaults
None.
Command Modes
SVC configuration mode—cluster configuration submode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
The cluster configuration submode prompt is (switch(svc-cluster)#).
The submode prompt for the MDisk group is switch (svc-cluster-mdisk-grp)#
Examples
The following example enters the cluster configuration mode for SampleCluster, creates an MDisk group, and adds an MDisk to the group.
switch(svc)# cluster config SampleCluster
switch(svc-cluster)# mdisk-grp add Mdisk1 extent 512
switch(svc-cluster)# mdisk-grp name Mdisk1
switch(svc-cluster-mdisk-grp)# mdisk id 3
switch(svc)# show cluster SampleCluster mdisk-grp
-------------------------------------------------------------------------------
name Capacity free extent number number status
size(MB) of mdisks of vdisks
-------------------------------------------------------------------------------
finance 7.56 GB 7.56 GB 16 5 0 online
marketing 6.48 GB 6.48 GB 16 5 0 online
Related Commands
Command
|
Description
|
show cluster name mdisk
|
Displays configured MDisk group information for a specified cluster.
|
migrate vdisk
To configure data migration from a VDisk, use the migrate vdisk command in the cluster configuration submode.
cluster config cluster-name
migrate vdisk vdisk-name new-mdisk-grp grp-name
migrate vdisk vdisk-name src-mdisk id mdisk-id num-extents number tgt-mdisk id mdisk-id
Syntax Description
cluster
|
Provides access to cluster commands
|
config cluster-name
|
Places a previously created cluster in the cluster configuration submode.
|
migrate vdisk vdisk-name
|
Migrates data from the specified VDisk to a MDisk or MDisk group.
|
new-mdisk-grp grp-name
|
Migrates data to a newly specified MDisk group.
|
src-mdisk id mdisk-id
|
Specifies the source MDisk for data migration.
|
num-extents number
|
Specifies the extents of a VDisk for data migration.
|
tgt-mdisk id mdisk-id
|
Specifies the target MDisk for data migration.
|
Defaults
None.
Command Modes
SVC configuration mode—cluster configuration submode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
The cluster configuration submode prompt is (switch(svc-cluster)#).
Examples
The following example enters the cluster configuration mode for SampleCluster, migrates a VDisk to a new MDisk group.
switch(svc)# cluster config SampleCluster
switch(svc-cluster)# migrate vdisk Vdisk2 new-mdisk-grp Group5
switch(svc-cluster)# migrate vdisk Vdisk2 src-mdisk id 3 num-extents 2 tgt-mdisk id 4
Related Commands
Command
|
Description
|
show cluster name status migrate
|
Displays configured MDisk migration status information for a specified cluster.
|
node
To add a node to a cluster or to assign a name to a preconfigured node, use the node command in the cluster configuration submode.
cluster config cluster-name
node name node-name
node nwwn node-wwn
node iogroup group-id [alias alias-name]
Syntax Description
cluster config
|
Provides access to cluster commands
|
node
|
Adds a specified node to the cluster being configured.
|
name node-name
|
Specifies the node using a 15 alphanumeric characters.
|
nwwn node-wwn
|
Specifies the node using the nWWN with the format hh:hh:hh:hh:hh:hh:hh:hh.
|
iogroup group-id
|
Identifies one of four I/O groups in the specified cluster. The ID ranges from 1 to 4.
|
alias alias-name
|
Assigns a name to the selected node. The name is restricted to 156 alphanumeric characters.
|
Defaults
None.
Command Modes
SVC configuration mode—cluster configuration submode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
The cluster configuration submode prompt is (switch(svc-cluster)#).
The node must first be added before assigning an alias name.
The no form of the command deletes the node from the cluster.
Examples
The following example enters the cluster configuration mode for SampleCluster, adds a node by assigning the nWWN, and associates the node with an alias.
switch(svc)# cluster config SampleCluster
switch(svc-cluster)# node nwwn 20:00:00:04:cf:e6:e4:df iogroup 1
switch(svc-cluster)# node nwwn 20:00:00:04:cf:e6:e4:df alias NodeAlias
Related Commands
Command
|
Description
|
show cluster name nodes
|
Displays configured node information for a specified cluster.
|
node svc delete
To delete all cluster configurations from a specific node, use the node svc delete command in SVC configuration mode.
node svc slot-number/node-number delete
Syntax Description
node svc
|
Specifies the node's SVC interface
|
slot-number
|
Specifies the slot number of the Caching Service Module (CSM).
|
node-number
|
Specifies the node number of the SVC instance running on the CSM. This number ranges from 1 to 2 nodes per module.
|
delete
|
Deletes a cluster information from the specified node.
|
Defaults
None.
Command Modes
SVC configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
Use this command if the node has lost communication with a configured cluster.
Examples
The following example enters the SVC configuration mode and adds a cluster called SampleCluster.
switch(svc)# node svc 2/1 delete
Related Commands
Command
|
Description
|
show nodes local
|
Displays configured node information.
|
node svc recover
To initiate cluster recovery on a specified SVC node, use the recover cluster command in SVC configuration mode.
node svc slot-number/node-number recover
Syntax Description
node svc
|
Specifies the node's SVC interface
|
slot-number
|
Specifies the slot number of the Caching Service Module (CSM).
|
node-number
|
Specifies the node number of the SVC instance running on the CSM. This number ranges from 1 to 2 nodes per module.
|
recover
|
Initiates recovery for a specified node.
|
Defaults
None.
Command Modes
SVC configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
Use this command to initiate cluster recovery after a failure. If the output of the show nodes local command displays recovery pause in the node status column.
Examples
The following example initiates recovery for the SVC node 1 in slot 2.
switch(svc)# node svc 2/1 recover
Related Commands
Command
|
Description
|
show nodes local
|
Displays configured node information.
|
node svc servicemode
To place a node in service mode, use the servicemode node svc command in SVC configuration mode. Use the no form of the command to remove a node from service mode.
node svc slot-number/node-number servicemode
Syntax Description
node svc
|
Specifies the node's SVC interface
|
slot-number
|
Specifies the slot number of the Caching Service Module (CSM).
|
node-number
|
Specifies the node number of the SVC instance running on the CSM. This number ranges from 1 to 2 nodes per module.
|
servicemode
|
Places a node in service mode.
|
Defaults
None.
Command Modes
SVC configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
None.
Examples
The following example enters the SVC configuration mode and places the specified node in service mode.
switch(svc)# node svc 2/2 servicemode
Related Commands
Command
|
Description
|
show nodes local
|
Displays configured node information.
|
node svc upgrade
To upgrade the software on a specified SVC node, use the upgrade node svc command in SVC configuration mode.
node svc slot-number/node-number url upgrade svc-system url
Syntax Description
node svc
|
Specifies the node's SVC interface
|
slot-number
|
Specifies the slot number of the Caching Service Module (CSM).
|
node-number
|
Specifies the node number of the SVC instance running on the CSM. This number ranges from 1 to 2 nodes per module.
|
upgrade
|
Upgrades the image on the specified node.
|
svc-system url
|
Specifies the SVC image to be used. The new version of the software image is specified to the FTP:, SCP:, SFTP:, TFTP:, bootflash:, or slot0: directories
|
Defaults
None.
Command Modes
SVC configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
This command is valid only if the node is in service mode or the node has been shutdown.
Examples
The following example enters the SVC configuration mode and displays all options in this mode.
switch(svc)# node svc 2/1 upgrade svc-system ?
bootflash: URI containing the system image for SVC
ftp: URI containing the system image for SVC
scp: URI containing the system image for SVC
sftp: URI containing the system image for SVC
slot0: URI containing the system image for SVC
tftp: URI containing the system image for SVC
quorum
To set the quorum disk for a cluster, use the quorum command in the cluster configuration submode.
cluster config cluster-name
quorum disk [1 | 2 | 3] mdisk disk-id
Syntax Description
cluster
|
Provides access to cluster commands
|
config cluster-name
|
Places a previously created cluster in the cluster configuration submode.
|
quorum disk id
|
Configures one of three quorum disks for the specified cluster. The quorum ID ranges from 1 to 3.
|
mdisk mdisk-id
|
Specifies the MDisk ID (ranges form 1 to 4096).
|
Defaults
None.
Command Modes
SVC configuration mode—cluster configuration submode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
The cluster configuration submode prompt is (switch(svc-cluster)#).
You can assign one of 3 possible quorum IDs in any desired order.
Examples
The following example enters the cluster configuration mode for SampleCluster and sets the quorum disk ID.
switch(svc)# cluster config SampleCluster
switch(svc-cluster)# quorum disk 2 mdisk 1
remote-copy
To create a synchronous copy of a specified VDisk or group of VDisks, use the remote-copy command in the cluster configuration submode.
cluster config cluster-name
remote-copy add rcopy-name [cluster rcluster-name]
remote-copy rcopy-name
map src-vdisk vdisk-name aux-vdisk vdisk-name
Syntax Description
cluster
|
Provides access to cluster commands
|
config cluster-name
|
Places a previously created cluster in the cluster configuration submode.
|
remote-copy add rcopy-name
|
Creates a remote copy instance and assigns a name.
|
remote-copy cluster rcluster-name
|
Specifies the remote cluster name for the consistency group.
|
remote-copy rcopy-name
|
Enters the remote-copy submode for an existing copy object.
|
map
|
Establishes a relationship between the source and destination VDisks.
|
src-vdisk vdisk-name
|
Specifies the source VDisk for the copy creation.
|
aux-vdisk vdisk-name
|
Specifies a VDisk in the remote copy cluster.
|
Defaults
None.
Command Modes
SVC configuration mode—cluster configuration submode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
The cluster configuration submode prompt is (switch(svc-cluster)#).
The remote-copy submode prompt is switch(svc-cluster-remote-copy)#
Examples
The following example enters the cluster configuration mode for SampleCluster and creates a synchronous copy of a specified disk.
switch(svc)# cluster config SampleCluster
switch(svc-cluster)# remote-copy add Rcopy1
switch(svc-cluster)# remote-copy r1
switch(svc-cluster-remote-copy)# ?
no Negate a command or set its defaults
switch(svc-cluster-remote-copy)# map src-vdisk SrcVdisk1 aux-vdisk AuxVdisk1
switch(svc-cluster)# remote-copy add Rcopy1 cluster remote-cluster
switch(svc-cluster)# remote-copy name Rcopy1
Related Commands
Command
|
Description
|
show cluster name remote-copy
|
Displays configured remote-copy information for a specified cluster.
|
show cluster flash-copy
To display configured FlashCopy information for a specified cluster, use the show cluster cluster-name flash-copy command.
show cluster cluster-name flash-copy [fcopy-name]
Syntax Description
show cluster cluster-name
|
Specifies a previously created cluster name.
|
flash-copy fcopy-name
|
Displays FlashCopy relationships configured for the specified FlashCopy object.
|
Defaults
None.
Command Modes
SVC configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
None.
Examples
The following examples display configured cluster information.
switch(svc)# show cluster SampleCluster flash-copy
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
switch(svc)# show cluster SampleCluster flash-copy f2
show cluster host
To display configured host information for a specific cluster, use the show cluster cluster-name host command.
show cluster cluster-name host [host-name | candidate]
Syntax Description
show cluster cluster-name
|
Specifies a previously created cluster name.
|
host
|
Displays information about hosts and host ports.
|
candidate
|
Lists all candidates that are not part of this entity but are visible to the cluster.
|
host-name
|
Displays information about the specified host.
|
Defaults
None.
Command Modes
SVC configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
None.
Examples
The following examples display configured cluster host information.
switch(svc)# show SampleCluster host
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
switch(svc)# show SampleCluster host Host1
Port WWN is 11:22:33:44:aa:bb:cc:dd
Port WWN is 22:11:33:55:11:aa:bb:cc
switch(svc)# show cluster SampleCluster host candidate
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
1 21:00:00:e0:8b:09:e7:04
show cluster iogroup
To display configured I/O group information for a specified cluster, use the show cluster cluster-name iogroup command.
show cluster cluster-name iogroup [group-id]
Syntax Description
show cluster cluster-name
|
Specifies a previously created cluster name.
|
iogroup
|
Identifies one of four I/O groups in the specified cluster.
|
group-id
|
Specifies the iogroup ID (ranges from 1 to 4).
|
Defaults
None.
Command Modes
SVC configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
None.
Examples
The following examples display configured cluster iogroup information.
switch(svc)# show SampleCluster iogroup
-----------------------------------------------------------------------------
ID NAME NODE-COUNT VLUN_COUNT
-----------------------------------------------------------------------------
Note Only four IDs can be used, the fifth I/O group is internally created and is only used for cluster recovery.
switch(svc)# show SampleCluster iogroup id 2
show cluster ip
To displays configured ip information for a specified cluster, use the show cluster-name ip command.
show cluster cluster-name ip
Syntax Description
show cluster cluster-name
|
Specifies a previously created cluster name.
|
ip
|
Displays the IP address of the specified cluster.
|
Defaults
None.
Command Modes
SVC configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
None.
Examples
The following example displays configured cluster ip information.
switch(svc)# show SampleCluster ip
cluster ip address is 172.22.92.32
show cluster mdisk
To display configured MDisk information for a specified cluster, use the show cluster cluster-name mdisk command.
show cluster cluster-name mdisk {candidate | id mdisk-id [extent]}
Syntax Description
show cluster cluster-name
|
Specifies a previously created cluster name.
|
mdisk
|
Displays MDisk specific information.
|
candidate
|
Displays all MDisks that are not assigned to a group.
|
id mdisk-id
|
Displays details of the specified MDisk ID.
|
extent
|
Displays information about the specified MDisk's extent.
|
Defaults
None.
Command Modes
SVC configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
None.
Examples
The following examples display configured cluster MDisk information.
switch(svc)# show SampleCluster mdisk
-------------------------------------------------------------------------------
id nwwn mdisk-grp capacity status
-------------------------------------------------------------------------------
1 20:00:00:04:cf:e6:1b:5b mg1 68.37 GB online
2 20:00:00:04:cf:e6:e5:32 mg1 68.37 GB online
3 20:00:00:04:cf:e6:21:a2 mg1 68.37 GB online
4 20:00:00:04:cf:e6:e1:81 mg1 68.37 GB online
5 20:00:00:04:cf:e6:e4:df 68.37 GB online
6 20:00:00:04:cf:e6:1c:fb 68.37 GB online
7 20:00:00:04:cf:e6:1a:4c 68.37 GB online
8 20:00:00:04:cf:e6:e4:6b 68.37 GB online
switch(svc)# show SampleCluster mdisk candidate
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
5 20:00:00:04:cf:e6:e4:df 68.37 GB
6 20:00:00:04:cf:e6:1c:fb 68.37 GB
7 20:00:00:04:cf:e6:1a:4c 68.37 GB
8 20:00:00:04:cf:e6:e4:6b 68.37 GB
switch(svc)# show cluster SampleCluster mdisk id 1
Is member of mdisk-grp mg1
Controller node WWN is 20:00:00:04:cf:e6:e4:6b
Controller port WWN is 22:00:00:04:cf:e6:e4:6b, LUN 00:00:00:00:00:00:00:00
Controller serial number is 3HZ0KZ8W
Number of free extents is 2231
switch(svc)# show cluster SampleCluster mdisk id 1 extent
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
show cluster mdsik-grp
To display configured MDisk group information for a specified cluster, use the show cluster cluster-name mdisk-grp command.
show cluster cluster-name mdisk-grp [grp-name]
Syntax Description
show cluster cluster-name
|
Specifies a previously created cluster name.
|
mdisk-grp grp-name
|
Displays information about a specified MDisk group.
|
Defaults
None.
Command Modes
SVC configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
None.
Examples
The following examples display configured cluster information for a MDisk group.
switch(svc)# show cluster SampleCluster mdisk-grp
--------------------------------------------------------------------------------------
name Capacity free extent number number status
size(MB) of mdisks of vdisks
--------------------------------------------------------------------------------------
mg1 410.16 GB 309.16 GB 16 6 1 online
switch(svc)# show cluster SampleCluster mdisk-grp mg1
Total capacity is 410.16 GB
Free capacity is 309.16 GB
Number of vdisks using this group is 1
show cluster nodes
To display configured node information for a specified cluster, use the show cluster cluster-name nodes command.
show cluster cluster-name nodes [candidate]
Syntax Description
show cluster cluster-name
|
Specifies a previously created cluster name.
|
nodes
|
Displays information about nodes in this cluster.
|
candidate
|
Lists all candidates that are not part of this entity but are visible to the cluster.
|
Defaults
None.
Command Modes
SVC configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
None.
Examples
The following example displays configured cluster information for a specified node.
switch(svc)# show cluster SampleCluster nodes
Node WWN is 20:06:00:0b:be:57:73:42
Serial number is JAB072705JH
Unique id is 01:00:07:27:30:35:4a:48
Node is part of iogroup id 1 name io_grp0
Node WWN is 20:08:00:0b:be:57:73:42
Serial number is JAB076605JH
Unique id is 01:00:07:66:30:35:4a:48
Node is in non config mode
Node is part of iogroup id 1 name io_grp0
switch1(svc)# show cluster SampleCluster nodes candidate
-----------------------------------------------------------------------------
-----------------------------------------------------------------------------
switch1.2.1 20:06:00:05:30:00:8d:e0
show cluster remote-copy
To display configured remote-copy information for a specified cluster, use the show cluster cluster-name remote-copy command.
show cluster cluster-name remote-copy [rcopy-name]
Syntax Description
show cluster cluster-name
|
Specifies a previously created cluster name.
|
remote-copy
|
Displays remote copy relationships configured for a specified cluster.
|
rcopy-name
|
Displays the specified remote copy object.
|
Defaults
None.
Command Modes
SVC configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
None.
Examples
The following example displays configured cluster information for the specified copy instance.
switch(svc)# show cluster SampleCluster remote-copy r1
master cluster is SampleCluster
status is inconsistent_stopped
master cluster is SampleCluster
status is inconsistent_stopped
show cluster remote-copy-cluster
To display configured remote-copy partnership information for a specified cluster, use the show cluster cluster-name remote-copy-cluster command.
show cluster cluster-name remote-copy-cluster [rcopy-name]
Syntax Description
show cluster cluster-name
|
Specifies a previously created cluster name.
|
remote-copy-cluster
|
Displays remote copy relationships configured for a specified cluster.
|
rcopy-name
|
Displays the specified remote copy object.
|
Defaults
None.
Command Modes
SVC configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
None.
Examples
The following example displays configured cluster information for the specified copy instance.
switch(svc)# show cluster SampleCluster remote-copy-cluster
-----------------------------------------------
Cluster Local/remote Bandwidth
-----------------------------------------------
show cluster status
To displays progress information for a specified cluster, use the show cluster cluster-name status command.
show cluster cluster-name status [flash-copy fcopy-name | remote-copy rcopy-name]
Syntax Description
show cluster cluster-name
|
Specifies a previously created cluster name.
|
status
|
Displays the status of a upgrade or copy process.
|
flash-copy
|
Displays FlashCopy relationships configured for the specified cluster.
|
fcopy-name
|
Displays the specified FlashCopy object.
|
remote-copy
|
Displays remote copy relationships configured for a specified cluster.
|
rcopy-name
|
Displays the specified remote copy object.
|
Defaults
None.
Command Modes
SVC configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
None.
Examples
The following examples display configured cluster information.
switch(svc)# show cluster SampleCluster status flash-copy fc1
-------------------------------------------------------------------------------
src vdisk dest vdisk progress
-------------------------------------------------------------------------------
switch(svc)# show cluster SampleCluster status remote-copy rc1
-------------------------------------------------------------------------------
src vdisk aux vdisk progress
-------------------------------------------------------------------------------
show cluster vdisk
To display configured VDisk information for a specified cluster, use the show cluster cluster-name vdisk command.
show cluster cluster-name vdisk {vdisk-id [extent | mapped_hosts]}
Syntax Description
show cluster cluster-name
|
Specifies a previously created cluster name.
|
vdisk
|
Displays configured VDisks in the cluster
|
vdisk-id
|
Displays details of the specified VDisk ID.
|
extent
|
Displays information about the specified MDisk's extent.
|
mapped_hosts
|
Displays information about which hosts are mapped to the specified VDisk.
|
Defaults
None.
Command Modes
SVC configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
None.
Examples
The following examples display configured cluster information for VDisks.
switch(svc)# show cluster SampleCluster vdisk v1 extent
-------------------------------------------------------------------------------
mdisk id number of extents
-------------------------------------------------------------------------------
switch(svc)# show cluster SampleCluster vdisk v1 mapped_hosts
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
show environment battery
To display status of a battery module for the Caching Services Module (CSM), use the show environment battery command.
show environment battery module slot-number [detail]
Syntax Description
show environment
|
Displays the hardware environment in any Cisco MDS 9000 Family switch.
|
battery
|
Displays the status of the battery in a CSM.
|
module slot-number
|
Specifies the slot number of the CSM.
|
detail
|
Provides detailed information about the CSM battery status.
|
Defaults
None.
Command Modes
EXEC mode.
Command History
This command was modified in Release 1.3(1).
Usage Guidelines
None.
Examples
The following example displays the current contents of the boot variable.
switch# show environment battery module 2
Current Capacity : 1571 mAHr
Full Capacity : 2057 mAHr
CySampleClustere Count : 3
Last conditioned in : Week 22 2003
Current Capacity : 1701 mAHr
Full Capacity : 2032 mAHr
CySampleClustere Count : 6
Last conditioned in : Week 22 2003
switch## show environment battery module 2 detail
Current Capacity : 1571 mAHr
Full Capacity : 2057 mAHr
Caching Capacity : 6463 MB
CySampleClustere Count : 3
Last conditioned in : Week 22 2003
Manufacturer Access : 0x0
Remaining Capacity Alarm : 0xc8
Remaining Time Alarm : 0xa
AtRate Time To Full : 0xffff
AtRate Time To Empty : 0xffff
Relative State of Charge : 0x4c
Absolute State of Charge : 0x4f
Remaining Capacity : 0x623
Full Charge Capacity : 0x809
Run Time To Empty : 0xffff
Average Time To Empty : 0xffff
Average Time To Full : 0x13f2
Charging Voltage : 0x3840
CySampleClustere Count : 0x3
Specification Info : 0x21
Manufacture Date : 0x3037
Manufacturer Name : 0x430a
Device Chemistry : 0x4e04
Manufacturer Data : 0x7507
Pack Status & Configuration : 0x2020
show interface svc
You can check the status of a SVC interface at any time by using the show interface svc command.
show interface svc slot-number/node-number [brief | counters | description]
Syntax Description
interface range
|
Displays the interfaces in the specified range.
|
brief
|
Displays brief info of interface.
|
counters
|
Displays the interface counter information.
|
description
|
Displays a description of interface.
|
svc
|
Displays the SAN Volume Controller (SVC) interface.
|
slot-number
|
Specifies the slot number of the Caching Service Module (CSM).
|
node-number
|
Specifies the node number of the SVC instance running on the CSM. This number ranges from 1 to 2 nodes per module.
|
Defaults
None
Command Modes
EXEC
Command History
This command was modified in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
None.
Examples
The following examples display configured SVC interface information.
switch# show interface svc 2/1
Node WWN is 10:00:00:00:00:00:00:00
Fabric WWN is 20:41:00:05:30:00:33:1e
Target N-port WWN is 27:39:00:05:30:00:33:2a, vsan is 1, FCID is 0x010006
Initiator N-port WWN is 27:3a:00:05:30:00:33:2a, vsan is 1, FCID is 0x010007
Mgmt N-port WWN is 27:3b:00:05:30:00:33:2a, vsan is 1, FCID is 0x010008
5 minutes input rate 16 bits/sec, 2 bytes/sec, 0 frames/sec
5 minutes output rate 0 bits/sec, 0 bytes/sec, 0 frames/sec
7 frames input, 736 bytes
3 frames output, 276 bytes
switch# show interface svc 8/1-2
svc8/1 is down (Administratively down)
Node WWN is 23:34:00:05:30:00:00:02
Fabric WWN is 21:c1:00:05:30:00:00:00
Target N-port WWN is 23:2e:00:05:30:00:00:02, vsan is 1, FCID is 0x000000
Initiator N-port WWN is 23:2f:00:05:30:00:00:02, vsan is 1, FCID is 0x000000
Mgmt N-port WWN is 23:30:00:05:30:00:00:02, vsan is 1, FCID is 0x000000
5 minutes input rate 0 bits/sec, 0 bytes/sec, 0 frames/sec
5 minutes output rate 0 bits/sec, 0 bytes/sec, 0 frames/sec
Node WWN is 23:35:00:05:30:00:00:02
Fabric WWN is 21:c2:00:05:30:00:00:00
Target N-port WWN is 23:31:00:05:30:00:00:02, vsan is 1, FCID is 0x650003
Initiator N-port WWN is 23:32:00:05:30:00:00:02, vsan is 1, FCID is 0x650004
Mgmt N-port WWN is 23:33:00:05:30:00:00:02, vsan is 1, FCID is 0x650005
5 minutes input rate 0 bits/sec, 0 bytes/sec, 0 frames/sec
5 minutes output rate 0 bits/sec, 0 bytes/sec, 0 frames/sec
3268061 frames input, 6602103068 bytes
3208131 frames output, 6598470800 bytes
switch# show interface brief
-------------------------------------------------------------------------------
Interface Vsan Admin Admin Status FCOT Oper Oper Port
Mode Trunk Mode Speed Channel
-------------------------------------------------------------------------------
fc8/1 1 FX -- fcotAbsent -- -- --
fc8/32 1 FX -- fcotAbsent -- -- --
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
Interface Status IP Address Speed MTU
-------------------------------------------------------------------------------
mgmt0 up 172.22.90.21/24 100 Mbps 1500
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
switch# show interface svc 2/1 counters
5 minutes input rate 0 bits/sec, 0 bytes/sec, 0 frames/sec 0 ios/sec
5 minutes output rate 0 bits/sec, 0 bytes/sec, 0 frames/sec 0 ios/sec
272 frames input, 89764 bytes
39 input session management frames
19 plogi, 1 plogi_acc, 13 prli, 1 prli_acc
2 logo, 0 logo_acc, 0 prlo, 0 prlo_acc
3 abts, 0 ba_acc, 0 ls_rjt
28 input I/Os, 28 cmd complete, 0 cmd fail
0 sess not up, 0 no resources, 0 bad frames
0 up layer rjt, 0 out of order, 0 proc unexp exch st
0 drop unexp exch st, 0 no exch match
0 sess not up, 0 no resources, 0 bad frames
0 up layer rjt, 0 out of order, 0 proc unexp exch st
0 drop unexp exch st, 0 no exch match
0 sess not up, 0 no resources, 0 bad frames
0 up layer rjt, 0 out of order, 0 proc unexp exch st
0 drop unexp exch st, 0 no exch match
0 sess not up, 0 no resources, 0 bad frames
0 up layer rjt, 0 out of order, 0 proc unexp exch st
0 drop unexp exch st, 0 no exch match
232 frames output, 84176 bytes
35 output session management frames
6 plogi, 13 plogi_acc, 1 prli, 12 prli_acc
0 logo, 0 logo_acc, 0 prlo, 0 prlo_acc
1 abts, 2 ba_acc, 0 ls_rjt
103 out I/Os, 103 cmd complete, 0 cmd fail
LS requests while sess not up
0 cmds 0 data xfers 0 status xfers 0 ds xfers
switch# show interface svc 4/2 description
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
show nodes
To displays configured information for the CSM, use the show svc command.
show nodes {local [detail] | svc slot_number/node-number | version}
Syntax Description
show nodes
|
Displays information about the specified nodes.
|
local
|
Displays SVC nodes in the switch.
|
detail
|
Displays detailed node information.
|
svc
|
Displays node information specific to the SVC interface.
|
slot-number
|
Specifies the slot number of the Caching Service Module (CSM).
|
node-number
|
Specifies the node number of the SVC instance running on the CSM. This number ranges from 1 to 2 nodes per module.
|
version
|
Displays software version information for each node.
|
Defaults
None.
Command Modes
SVC configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
None.
Examples
The following example display configured SVC information and statistics.
switch(svc)# show nodes local detail
Is a config node for cluster SampleCluster
Is member of cluster SampleCluster
switch(svc)# show nodes ?
local Show nodes in the switch
version Show node sw versions in the switch
switch(svc)# show nodes svc 2/2
Is not a member of any cluster
Cluster Status is unconfigured
switch(svc)# show nodes version
------------------------------------------------------
------------------------------------------------------
svc2/1 1.3(1) Runtime code (5)
svc2/2 1.3(1) Runtime code (5)
Related Commands
Command
|
Description
|
svc config
|
Configures SVC nodes.
|
show svc
To displays configured information for the CSM, use the show svc command.
show svc
port svc slot_number/node-number [detail | initiator | mgmt | target [detail | vsan vsan-id]] |
session [detail | initiator | mgmt | peer-wwn pwwn-id | target [detail | vsan vsan-id]] |
stats xipc [interface svc slot_number/node-number] | [module slot-number]
Syntax Description
show svc
|
Displays configured SVC information.
|
port
|
Displays N-port specific SVC information.
|
svc
|
Specifies the new interface to be a SVC interface.
|
slot-number
|
Specifies the slot number of the Caching Service Module (CSM).
|
node-number
|
Specifies the node number of the SVC instance running on the CSM. This number ranges from 1 to 2 nodes per module.
|
detail
|
Displays detailed information for all N ports
|
initiator
|
Displays a SVC node as an initiator in the specified VSAN.
|
mgmt
|
Displays a SVC node as a management node in the specified VSAN.
|
target
|
Displays a SVC node as a target in the specified VSAN.
|
vsan vsan-id
|
Specifies the VSAN ID ranging from 1 to 4093.
|
session
|
Displays information specific to the SVC session.
|
peer-pwwn pwwn-id
|
Specifies the port WWN of the target or host, with the format hh:hh:hh:hh:hh:hh:hh:hh.
|
stats
|
Displays SVC statistical information generally used for debugging.
|
module slot-number
|
Specifies the slot number containing the CSM.
|
Defaults
None.
Command Modes
EXEC mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
None.
Examples
The following examples display configured SVC information and statistics.
switch# show svc session svc 2/1
Target N-port WWN is 21:00:00:05:30:00:8d:e0, vsan is 2, FCID is 0x610100
pWWN 21:00:00:e0:8b:09:f0:04, nWWN 20:00:00:e0:8b:09:f0:04, FCID 0x610000
Initiator N-port WWN is 20:01:00:05:30:00:8d:e0, vsan is 1, FCID is 0xec0100
pWWN 22:00:00:04:cf:e6:e4:6b, nWWN 20:00:00:04:cf:e6:e4:6b, FCID 0xec00d4
pWWN 22:00:00:04:cf:e6:1a:4c, nWWN 20:00:00:04:cf:e6:1a:4c, FCID 0xec00d5
pWWN 22:00:00:04:cf:e6:1c:fb, nWWN 20:00:00:04:cf:e6:1c:fb, FCID 0xec00d6
pWWN 22:00:00:04:cf:e6:e1:81, nWWN 20:00:00:04:cf:e6:e1:81, FCID 0xec00d9
pWWN 22:00:00:04:cf:e6:e4:df, nWWN 20:00:00:04:cf:e6:e4:df, FCID 0xec00da
pWWN 22:00:00:04:cf:e6:21:a2, nWWN 20:00:00:04:cf:e6:21:a2, FCID 0xec00dc
pWWN 22:00:00:04:cf:e6:e5:32, nWWN 20:00:00:04:cf:e6:e5:32, FCID 0xec00e0
pWWN 22:00:00:04:cf:e6:1b:5b, nWWN 20:00:00:04:cf:e6:1b:5b, FCID 0xec00e1
Mgmt N-port WWN is 21:02:00:05:30:00:8d:e0, vsan is 3, FCID is 0x7a0000
pWWN 21:03:00:05:30:00:8d:e0, nWWN 20:07:00:05:30:00:8d:e0, FCID 0x7a0001
switch# show svc session svc 2/1 peer-pwwn 22:00:00:04:cf:e6:e4:6b detail
Initiator N-port WWN is 20:01:00:05:30:00:8d:e0, vsan is 1, FCID is 0xec0102
pWWN 22:00:00:04:cf:e6:e4:6b, nWWN 20:00:00:04:cf:e6:e4:6b, FCID 0xec00d4
47 frames input, 920 data bytes
0 FCP commands, 0 FCP xfer ready
20 FCP data frames, 25 FCP status
0 FCP overrun, 15 FCP underrun
0 aborts, 0 bad FC2 drops
27 frames output, 0 data bytes
25 FCP commands, 0 FCP xfer ready
0 FCP data frames, 0 FCP status
switch# show svc port svc 2/1
Target N-port in vsan 2 is up
Port WWN is 21:00:00:05:30:00:8d:e0, FCID is 0x610101
Initiator N-port in vsan 1 is up
Port WWN is 20:01:00:05:30:00:8d:e0, FCID is 0xec0102
Mgmt N-port in vsan 1 is up
Port WWN is 20:02:00:05:30:00:8d:e0, FCID is 0xec0103
switch# show svc port svc 2/1 target detail
Target N-port in vsan 1 is up
Port WWN is 27:39:00:05:30:00:33:2a, FCID is 0x010006
0 sessions, 0 closed, 0 in transition
5 minutes input rate 0 bits/sec, 0 bytes/sec, 0 frames/sec 0 ios/sec
5 minutes output rate 0 bits/sec, 0 bytes/sec, 0 frames/sec 0 ios/sec
9 frames input, 1064 bytes
0 input session management frames
0 input I/Os, 0 cmd complete, 0 cmd fail
5 frames output, 388 bytes
0 output session management frames
0 output I/Os, 0 cmd complete, 0 cmd fail
switch# show svc session svc 2/1 peer-pwwn 27:46:00:05:30:00:33:2a detail
Mgmt N-port WWN is 27:3b:00:05:30:00:33:2a, vsan is 1, FCID is 0x010008
pWWN 27:46:00:05:30:00:33:2a, nWWN 27:48:00:05:30:00:33:2a, FCID 0x010011
19 frames input, 16517 data bytes
3 FCP commands, 1 FCP xfer ready
10 FCP data frames, 3 FCP status
0 FCP overrun, 2 FCP underrun
0 aborts, 0 bad FC2 drops
19 frames output, 16520 data bytes
3 FCP commands, 1 FCP xfer ready
10 FCP data frames, 3 FCP status
0 sess not up, 0 no resources, 0 bad frames
0 up layer rjt, 0 out of order, 0 proc unexp exch st
0 drop unexp exch st, 0 no exch match
0 sess not up, 0 no resources, 0 bad frames
0 up layer rjt, 0 out of order, 0 proc unexp exch st
0 drop unexp exch st, 0 no exch match
0 sess not up, 0 no resources, 0 bad frames
0 up layer rjt, 0 out of order, 0 proc unexp exch st
0 drop unexp exch st, 0 no exch match
0 sess not up, 0 no resources, 0 bad frames
0 up layer rjt, 0 out of order, 0 proc unexp exch st
0 drop unexp exch st, 0 no exch match
svc-config
To perform SAN Volume Controller (SVC) configurations, use the svc-config command.
svc-config
Syntax Description
svc-config
|
Enters the SVC configuration mode.
|
cluster
|
Provides access to cluster commands.
|
node
|
Provides access to node commands.
|
show
|
Displays configured SVC information for the specified node.
|
Defaults
None.
Command Modes
EXEC mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
None.
Examples
The following example enters the SVC configuration mode and displays all options in this mode.
no Negate a command or set its defaults
svc-ibmcli
To perform SAN Volume Controller (SVC) configurations by using IBM's CLI, use the svc-ibmcli command.
svc-ibmcli {cluster-name cluster-name [IBM-CLI-command] | node svc slot-number/node-number
[IBM-CLI-command]}
Syntax Description
svc-ibmcli
|
Enters the IBM CLI configuration mode.
|
cluster-name
|
Specifies a new cluster.
|
cluster-name
|
Specifies a cluster name.
|
node svc
|
Specifies a node in the SVC interface.
|
slot-number
|
Specifies the slot number of the Caching Service Module (CSM).
|
node-number
|
Specifies the node number of the SVC instance running on the CSM. This number ranges from 1 to 2 nodes per module.
|
IBM-CLI-command
|
Specifies the IBM TotalStorage command to be executed
|
Defaults
None.
Command Modes
EXEC mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
When you enter the IBM TotalStorage shell, all future commands are interpreted directly by this shell. Type exit to return to the Cisco MDS switch prompt.
Examples
The following example enters the SVC configuration mode and displays all options in this mode.
switch# svc-ibmcli cluster-name SampleCluster
Attaching to config node for cluster SampleCluster
To exit type 'exit', to abort type '$.'
switch# svc-ibmcli node svc 2/1
To exit type 'exit', to abort type '$.'
svc-purge-wwn module
To remove all configured WWNs for the CSM from the running configuration, use the svc-purge-wwn module command.
svc-purge-wwn module module-number
Syntax Description
svc-purge-wwn
|
Purges the WWN for the CSM.
|
module module-number
|
Specifies the slot number for the CSM.
|
Defaults
None.
Command Modes
EXEC mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
This command also purges all system allocated pWWNs and nWWNs from the system and will never be used again (by the system or by SVC interfaces). New system values will be allocated for all pWWN/nWWNs for the module.
Examples
The following example enters the SVC configuration mode and displays all options in this mode.
switch# svc purge-wwn module 2
!!!WARNING! This command will purge all SVC system allocated
WWNs for the specified module. These WWNs will be lost.
All user configured WWNs will be removed from the
running-config, but not from the startup-config.
This operation can take a long time. Other CLI commands
on the system may be stopped while this operation is
Are you sure you want to do this? [Y/N] [N] y
vdisk
To create a new VDisk or access a new VDisk, use the vdisk command in the cluster configuration submode.
cluster config cluster-name
vdisk add vdisk-name iogroup group-id mdisk-grp grp-name capacity number | import [clean |
mdisk-list | preferred-node | sequential]
vdisk name vdisk-name -> expand [capacity | extent mdisk disk-id offset number] | io-throttle
number [MB] | iogroup | shrink
Syntax Description
cluster
|
Provides access to cluster commands
|
config cluster-name
|
Places a previously created cluster in the cluster configuration submode.
|
vdisk add vdisk-name
|
Creates a VDisk of the specified name.
|
iogroup group-id
|
Identifies one of four I/O groups in the specified cluster. The ID ranges from 1 to 4. The I/O for the VDisk is serviced by node belonging to that I/O group.
|
mdisk-grp grp-name
|
Specifies an existing MDisk group from which the VDisk storage originates.
|
capacity
|
Configures the size of this VDisk.
|
number
|
Provides a range from 0- 1677215 Gigabytes.
|
import
|
Imports a previously unmanaged disk that contains SVC virtualization data.
|
clean
|
Clears all data in the VDisk.
|
mdisk-list
|
Specifies a list of MDisks. All disks in this list must be part of the MDisk group
|
preferred-node
|
specifies the preferred node within the two nodes in this group to send I/Os for this VDisk
|
sequential
|
Specifies a sequential virtualization policy. If this option is not specified, the striped (default) virtualization policy is used.
|
vdisk vdisk-name
|
Enters the VDisk submode of an existing VDisk.
|
expand capacity
|
Expands the MDisk capacity.
|
extent
|
Expands the MDisk by a single extent.
|
offset number
|
Offsets the extent.
|
io-throttle
|
Limits the amount of I/Os allowed for this VDisk. If MB is not specified, the unit is calculated in I/Os per second.
|
MB
|
Specifies the I/O throttling in Megabytes.
|
shrink
|
Shrinks the capacity of the VDisk as specified.
|
Defaults
None.
Command Modes
SVC configuration mode—cluster configuration submode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
The cluster configuration submode prompt is (switch(svc-cluster)#).
The VDisk submode prompt is switch (svc-cluster-vdisk)#
Extents are allowed from all MDisks in the list
Examples
The following example enters the cluster configuration mode for SampleCluster and ---
switch(svc)# cluster config SampleCluster
switch(svc-cluster)# vdisk add Vdisk1 iogroup 1 mdisk-grp Mdisk1 ?
capacity Vdisk add name iogroup mdisk-grp
switch(svc-cluster)# vdisk add Vdisk1 iogroup 1 mdisk-grp Mdisk1 capacity ?
<0-2147483647> Enter the capacity
switch(svc-cluster)# vdisk add Vdisk1 iogroup 1 mdisk-grp Mdisk1 capacity 5000 ?
gb Vdisk add name iogroup mdisk-grp capacity
mb Vdisk add name iogroup mdisk-grp capacity
pb Vdisk add name iogroup mdisk-grp capacity
tb Vdisk add name iogroup mdisk-grp capacity
switch(svc-cluster)# vdisk add Vdisk1 iogroup 1 mdisk-grp Mdisk1 capacity 5000 gb ?
mdisk-list Vdisk add mdisk-list
preferred-node Vdisk add sequential mdisk
sequential Vdisk add sequential
switch(svc-cluster)# vdisk add VDISK1 iogroup 1 mdisk-grp Mdisk1 capacity 0 gb
switch(svc-cluster)# vdisk VDISK1
switch(svc-cluster-vdisk)# ?
iogroup Move vdisk to iogroup
no Negate a command or set its defaults
switch(svc-cluster-vdisk)# expand ?
switch(svc-cluster-vdisk)# io-throttle 0
switch(svc-cluster-vdisk)# shrink capacity 1 ?
switch(svc-cluster-vdisk)# exit
switch(svc)# show cluster SampleCluster vdisk
-------------------------------------------------------------------------------
name capacity iogroup mdisk-grp name policy status
-------------------------------------------------------------------------------
Vdisk1 100.00 GB 1 Group1 striped online
Vdisk2 50.00 GB 1 Group2 striped online
switch(svc)# show cluster SampleCluster vdisk Vdisk1
Using storage from mdisk-grp Group1
Virtualization policy is striped
switch(svc)# show cluster SampleCluster vdisk Vdisk1 extent
-------------------------------------------------------------------------------
mdisk id number of extents
-------------------------------------------------------------------------------
switch(svc)# show cluster SampleCluster vdisk Vdisk1 mapped_hosts
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
Related Commands
Command
|
Description
|
show cluster name vdisk
|
Displays configured vdisk information for a specified cluster.
|