Cisco MDS 9000 Family Command Reference, Release 1.0(3a)
P Commands

Table Of Contents

P Commands

ping

power redundancy-mode

poweroff module

purge fcdomain fcid

pwd


P Commands


The commands in this chapter apply to the Cisco MDS 9000 Family of multilayer directors and fabric switches. All commands are shown here in alphabetical order regardless of command mode. See the "Command Modes" section to determine the appropriate mode for each command. For more information, refer to the Cisco MDS 9000 Family Configuration Guide.

ping

power redundancy-mode

poweroff module

purge fcdomain fcid

pwd

ping

To diagnose basic network connectivity, use the ping (packet internet groper) command in EXEC mode.

ping {host-name | system-address}

Syntax Description

host-name

Host name of system to ping. Maximum length is 64 characters.

system-address

Address of system to ping.


Defaults

None.

Command Modes

EXEC mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

The ping program sends an echo request packet to an address, and then awaits a reply. The ping output can help you evaluate path-to-host reliability, delays over the path, and whether the host can be reached or is functioning.

Verify connectivity to the TFTP server using the ping command.

To abnormally terminate a ping session, type the Ctrl-C escape sequence

Examples

The following example pings system 192.168.7.27.

switch# ping 192.168.7.27
PING 192.168.7.27 (192.168.7.27): 56 data bytes
64 bytes from 192.168.7.27: icmp_seq=0 ttl=255 time=0.4 ms
64 bytes from 192.168.7.27: icmp_seq=1 ttl=255 time=0.2 ms
64 bytes from 192.168.7.27: icmp_seq=2 ttl=255 time=0.2 ms
64 bytes from 192.168.7.27: icmp_seq=3 ttl=255 time=0.2 ms

--- 192.168.7.27 ping statistics ---
13 packets transmitted, 13 packets received, 0% packet loss
round-trip min/avg/max = 0.2/0.2/0.4 ms

power redundancy-mode

To configure the capacity of the power supplies on the Cisco MDS 9500 Family of switches, use the power redundancy-mode command in configuration mode.

power redundancy-mode {combined | redundant [force]}

Syntax Descriptionpower redundancy-mode combined|redundant [force]fcdomainfcdomainfcdomainfcdomain

combined

Configures power supply redundancy mode as combined.

force

Forces combined mode without prompting.

redundant

Configures power supply redundancy mode as redundant.


ower

Defaults

Redundant mode.

Command Modes

Configuration mode

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

If power supplies with different capacities are installed in the switch, the total power available differs based on the configured mode:

In redundant mode, the total power is the lesser of the two power supply capacities. This reserves enough power to keep the system powered on in case of a power supply failure. This is the recommended or default mode.

In combined mode, the total power is twice the lesser of the two power supply capacities. In case of a power supply failure, the entire system could be shut down, depending on the power usage at that time.

When a new power supply is installed, the switch automatically detects the power supply capacity. If the new power supply has a capacity that is lower than the current power usage in the switch and the power supplies are configured in redundant mode, the new power supply will be shut down.

When you change the configuration from combined to redundant mode and the system detects a power supply that has a capacity lower than the current usage, the power supply is shut down. If both power supplies have a lower capacity than the current system usage, the configuration is not allowed.

Examples

The following examples demonstrate how the power supply redundancy mode could be set.

switch(config)# power redundancy-mode combined
WARNING: This mode can cause service disruptions in case of a power supply failure. 
Proceed ? [y/n] y
switch(config)# power redundancy-mode redundant 

Related Commands

Command
Description

show environment power

Displays status of power supply modules, power supply redundancy mode, and power usage summary.

copy running-config startup-config

Copies all running configuration to the startup configuration.


poweroff module

To power off individual modules in the system, use the poweroff module command in configuration mode in configuration mode.

[no] poweroff module module-number

Syntax Descriptionfcdomainfcdomainfcdomainfcdomain

no

Powers up the specified module in the switch

module-number

Specifies the module number from 1 to 9.


Defaults

None.

Command Modes

Configuration mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

Use the poweroff module command to power off individual modules. The poweroff module command cannot be used to power off supervisor modules.

Examples

The following example powers off and powers up module 1.

switch# config t
switch(config)# poweroff module 1
switch(config)#
switch(config)# no poweroff 1
switch(config)# 

Related Commands

Command
Description

show module

Displays information for a specified module.

copy running-config startup-config

Copies all running configuration to the startup configuration.


purge fcdomain fcid

To purge persistent FCIDs, use the purge fcdomain fcid command in EXEC mode.

purge fcdomain fcid vsan vsan-id

Syntax Description

vsan

Indicates that FCIDs are to be purged for a VSAN.

vsan-id

The ID of the VSAN is from 1 to 4093.


Defaults

None.

Command Modes

EXEC mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

None.

Examples

The following example shows how to purge all dynamic, unused FC IDs in VSAN 4

switch# purge fcdomain fcid vsan 4
switch#

The following example shows how to purge all dynamic, unused FC IDs in VSANs 4, 5, and 6.

switch# purge fcdomain fcid vsan 3-5
switch#

pwd

To display the current directory location, use the pwd command in EXEC mode.

pwd

Syntax Description

This command has no keywords or arguments.

Defaults

None.

Command Modes

EXEC mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

None.

Examples

The following example changes the directory and displays the current directory.

switch# cd bootflash:logs
switch# pwd
bootflash:/logs

Related Commands

Command
Description

cd

Changes the current directory to the specified directory.