Table Of Contents

P Commands

port-monitor activate

port-monitor enable

port-monitor name

port-type

poweroff module

power redundancy-mode

ptp announce

ptp delay-request minimum interval

ptp domain

ptp pdelay-req-interval

ptp priority1

ptp priority2

ptp source

ptp sync interval

ptp vlan

P Commands

---

This chapter describes the Cisco NX-OS system management commands that begin with the letter P.

port-monitor activate

To activate a Simple Network Management Protocol (SNMP) port-monitor policy, use the port-monitor activate command. To deactivate a port-monitor policy, use the no form of this command.

port-monitor activate [policy-name]

no port-monitor activate [policy-name]

Syntax Description

policy-name

(Optional) Port-monitor policy. The maximum number of alphanumeric characters is 32.

Defaults

None

Command Modes

Global configuration (config)

Supported User Roles

network-admin
vdc-admin

Command History

Release	Modification
4.1(2)	This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to activate an SNMP port-monitor policy:

switch(config)# port-monitor name policy_1

switch(config-port-monitor)# port-monitor activate policy_1

switch(config)#

This example shows how to deactivate a port-monitor policy:

switch(config-port-monitor)# no port-monitor activate policy_1

switch(config)#

Related Commands

Command	Description
counter	Configures an individual counter.

port-monitor enable

To enable the Simple Network Management Protocol (SNMP) port-monitor feature, use the port-monitor enable command. To disable the port-monitor feature, use the no form of this command.

port-monitor enable

no port-monitor enable

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Global configuration (config)

Supported User Roles

network-admin
vdc-admin

Command History

Release	Modification
4.1(2)	This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to enable the SNMP port-monitor feature:

switch(config)# port-monitor enable

switch(config)#

This example shows how to disable the SNMP port-monitor feature:

switch(config)# no port-monitor enable

switch(config)#

Related Commands

Command	Description
port-monitor activate	Activates the specified port-monitor policy.

port-monitor name

To create a Simple Network Management Protocol (SNMP) port-monitor policy, use the port-monitor name command. To delete a port-monitor policy, use the no form of this command.

port-monitor name policy-name

no port-monitor name policy-name

Syntax Description

policy-name

Policy name. The maximum number of alphanumeric characters is 32.

Defaults

None

Command Modes

Global configuration (config)

Supported User Roles

network-admin
vdc-admin

Command History

Release	Modification
4.1(2)	This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to create an SNMP port-monitor policy:

switch(config)# port-monitor name PM1

switch(config-port-monitor)#

This example shows how to remove a SNMP port-monitor policy:

switch(config)# no port-monitor name PM1

switch(config)

Related Commands

Command	Description
port-monitor activate	Activates the specified port-monitor policy.

port-type

To configure a port type for the Simple Network Management Protocol (SNMP) port monitoring, use the port-type command. To delete the port-type configuration for port monitoring, use the no form of this command.

port-type {access-port | all | trunks}

no port-type {access-port | all | trunks}

Syntax Description

access-port	Configures port monitoring for access ports.
all	Configures port monitoring for all ports.
trunks	Configures port monitoring for trunk ports.

Defaults

None

Command Modes

Port-monitor configuration (config-port-monitor)

Supported User Roles

network-admin
vdc-admin

Command History

Release	Modification
4.1(2)	This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a port type for the SNMP port-monitor configuration:

switch(config)# port-monitor name PM1

switch(config-port-monitor)# port-type all

switch(config-port-monitor)#

This example shows how to remove a port-type configuration:

switch(config-port-monitor)# no port-type all

switch(config-port-monitor)#

Related Commands

Command	Description
port-monitor activate	Activates the specified port-monitor policy.

poweroff module

To power off a module, use the poweroff module command. To return power to the module, use the no form of this command.

poweroff module module

no poweroff module module

Syntax Description

module

Module number. The range is from 1 to 18.

Defaults

None

Command Modes

Global configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release	Modification
4.0(1)	This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to power off module 2:

switch# poweroff module 2

Related Commands

Command	Description
show module	Displays information about a module.

power redundancy-mode

To configure the power supply redundancy mode, use the power redundancy-mode command. To disable this mode, use the no form of this command.

power redundancy-mode {combined [force] | insrc-redundant | ps-redundant [single-input] | redundant}

no power redundancy-mode {combined [force] | insrc-redundant | ps-redundant [single-input] | redundant}

Syntax Description

combined	Specifies the combined power supply mode.
force	(Optional) Forces the device to choose the combined mode without prompting the user.
insrc-redundant	Specifies the input source redundancy mode.
ps-redundant	Specifies the power supply redundancy mode.
single-input	(Optional) Specifies a single power input.
redundant	Specifies the full redundancy mode.

Defaults

ps-redundant

Command Modes

Global configuration mode

Supported User Roles

network-admin

Release	Modification
4.2(1)	This command was introduced.

Usage Guidelines

You can use the power redundancy-mode command only in the default virtual device context (VDC).

You can configure the power supplies with the following modes:

•Combined mode—This mode does not provide power redundancy. The available power for this mode is the total power capacity of all power supplies.

•Input source redundancy mode—This mode utilizes two electrical grids, each one powering a half module within each power supply. If one power grid goes down, each power supply continues to draw power through its other half module. The available power is the amount of power by the lesser of the two grids through the power supplies.

•Power supply redundancy mode—This mode provides an extra power supply in case an active power supply goes down. The power supply that can supply the most power operates in standby mode. The other one or two power supplies are active. The available power is the amount of power provided by the active power supply units.

•Full redundancy mode—This mode combines power supply redundancy and input source redundancy, which means that the chassis has an extra power supply and one half of each power supply is connected to one electrical grid while the other half of each power supply is connected to the other electrical grid. The available power is the lesser of the available power for power supply redundancy mode and input source redundancy mode.

This command does not require a license.

Examples

This example shows how to configure the power supply redundancy mode:

switch# config t

switch(config)# power redundancy-mode ps-redundant

This example shows how to disable the power supply redundancy mode:

switch# config t

switch(config)# no power redundancy-mode ps-redundant

Related Commands

Command	Description
show environment power	Displays information about the power capacity and power distribution of the system.

ptp announce

To configure the interval between Precision Time Protocol (PTP) announce messages on an interface or the number of PTP intervals before a timeout occurs on an interface, use the ptp announce command. To remove the interval configuration for PTP messages, use the no form of this command.

ptp announce {interval seconds | timeout count}

no ptp announce {interval seconds | timeout count}

Syntax Description

interval	Specifies the interval between Precision Time Protocol (PTP) announce messages on an interface.
seconds	Log seconds. The range is from 0 to 4.
timeout	Specifies the number of PTP intervals before a timeout occurs on an interface.
count	Timeout count. The range is from 2 to 10.

Defaults

interval 1
timeout 3

Command Modes

Interface configuration mode (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release	Modification
5.2(1)	This command was introduced.

Usage Guidelines

Make sure that you are in the correct virtual device context (VDC). To change the VDC, use the switchto vdc command.

Make sure that you have globally enabled PTP on the device and configured the source IP address for PTP communication.

This command does not require a license.

Examples

This example shows how to configure the interval between PTP announce messages on an interface:

switch# configure terminal

switch(config)# interface ethernet 5/1

switch(config-if)# ptp announce interval 1

switch(config-if)#

This example shows how to remove the interval configuration for PTP messages:

switch(config)# interface ethernet 5/1

switch(config-if)# no ptp announce interval 1

switch(config-if)#

Related Commands

Command	Description
ptp	Enables or disables PTP on an interface.
ptp delay-request minimum interval	Configures the minimum interval allowed between PTP delay-request messages when the port is in the master state.
ptp sync interval	Configures the interval between PTP synchronization messages on an interface.
ptp vlan vlan	Configures the PTP VLAN value on an interface.

ptp delay-request minimum interval

To configure the minimum interval allowed between Precision Time Protocol (PTP) delay-request messages when the port is in the master state, use the ptp delay-request minimum interval command. To remove the minimum interval configuration for PTP delay-request messages, use the no form of this command.

ptp delay-request minimum interval seconds

no ptp delay-request minimum interval seconds

Syntax Description

seconds

Log seconds. The range is from 1 to 6.

Defaults

None

Command Modes

Interface configuration mode (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release	Modification
5.2(1)	This command was introduced.

Usage Guidelines

Make sure that you are in the correct virtual device context (VDC). To change the VDC, use the switchto vdc command.

Make sure that you have globally enabled PTP on the device and configured the source IP address for PTP communication.

This command does not require a license.

Examples

This example shows how to configure the minimum interval allowed between PTP delay-request messages:

switch# configure terminal

switch(config)# interface ethernet 5/1

switch(config-if)# ptp delay-request minimum interval 3

switch(config-if)#

This example shows how to remove the minimum interval configuration for PTP delay-request messages:

switch(config)# interface ethernet 5/1

switch(config-if)# no ptp delay-request minimum interval 3

switch(config-if)#

Related Commands

Command	Description
ptp	Enables or disables PTP on an interface.
ptp announce	Configures the interval between PTP announce messages on an interface or the number of PTP intervals before a timeout occurs on an interface.
ptp sync interval	Configures the interval between PTP synchronization messages on an interface.
ptp vlan vlan	Configures the PTP VLAN value on an interface.

ptp domain

To configure a domain number for the Precision Time Protocol (PTP) clock, use the ptp domain command. To remove the domain configuration for the PTP clock, use the no form of this command.

ptp domain domain_number

no ptp domain domain_number

Syntax Description

domain_number

Domain number. The range is from 0 to 28.

Defaults

0

Command Modes

Global configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release	Modification
5.2(1)	This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a domain number for the PTP clock:

switch# configure terminal

switch(config)# ptp domain 6

switch(config)#

This example shows how to remove the PTP domain configuration:

switch(config)# no ptp domain 6 
switch(config)#

Related Commands

Command	Description
feature ptp	Enables or disables PTP on the device.
ptp source	Configures the source IP address for all PTP packets.
ptp priority1	Configures the priority1 value to use when advertising this clock.
ptp priority2	Configures the priority2 value to use when advertising this clock.
show ptp brief	Displays the PTP status.
show ptp clock	Displays the properties of the local clock.

ptp pdelay-req-interval

To configure the mean peer-delay request interval logging for the Precision Time Protocol (PTP), use the ptp pdelay-req-interval command. To remove the mean of the peer-delay request interval logging for PTP, use the no form of this command.

ptp pdelay-req-interval value

no ptp pdelay-req-interval value

Syntax Description

value

Interval value. The range is from 0 to 5.

Defaults

Disabled

Command Modes

Global configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release	Modification
5.2(1)	This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the mean of the peer-delay request interval logging for PTP:

switch# configure terminal

switch(config)# ptp pdelay-req-interval 3

switch(config)#

This example shows how to remove the mean of the peer-delay request interval logging for PTP:

switch(config)# no ptp pdelay-req-interval 3

switch(config)#

Related Commands

Command	Description
feature ptp	Enables or disables PTP on the device.
ptp source	Configures the source IP address for all PTP packets.
ptp domain	Configures the domain number to use for this clock.
ptp priority1	Configures the priority1 value to use when advertising this clock.
ptp priority2	Configures the priority2 value to use when advertising this clock.
show ptp brief	Displays the PTP status.
show ptp clock	Displays the properties of the local clock.

ptp priority1

To configure the priority1 value when advertising the Precision Time Protocol (PTP) clock, use the ptp priority1 command. To remove the priority1 value, use the no form of this command.

ptp priority1 priority-number

no ptp priority1 priority-number

Syntax Description

priority-number

Priority number. The range is from 0 to 255.

Defaults

255

Command Modes

Global configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release	Modification
5.2(1)	This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the priority1 value when advertising the PTP clock:

switch# configure terminal

switch(config)# ptp priority1 10

This example shows how to remove the priority1 value when advertising the PTP clock:

switch# configure terminal

switch(config)# no ptp priority1 10

Related Commands

Command	Description
feature ptp	Enables or disables PTP on the device.
ptp source	Configures the source IP address for all PTP packets.
ptp domain	Configures the domain number to use for this clock.
ptp priority2	Configures the priority2 value to use when advertising this clock.
show ptp brief	Displays the PTP status.
show ptp clock	Displays the properties of the local clock.

ptp priority2

To configure the priority2 value when advertising the Precision Time Protocol (PTP) clock, use the ptp priority2 command. To remove the priority2 value when advertising the PTP, use the no form of this command.

ptp priority2 priority-number

no ptp priority2 priority-number

Syntax Description

priority-number

Priority number. The range is from 0 to 255.

Defaults

255

Command Modes

Global configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release	Modification
5.2(1)	This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the priority2 value when advertising the PTP clock:

switch# configure terminal

switch(config)# ptp priority2 1

This example shows how to remove the priority2 value configuration for use when advertising the PTP clock:

switch# configure terminal

switch(config)# no ptp priority2 1

Related Commands

Command	Description
feature ptp	Enables or disables PTP on the device.
ptp source	Configures the source IP address for all PTP packets.
ptp domain	Configures the domain number to use for this clock.
ptp priority1	Configures the priority1 value to use when advertising this clock.
show ptp brief	Displays the PTP status.
show ptp clock	Displays the properties of the local clock.

ptp source

To configure the global source for all the Precision Time Protocol (PTP) packets, use the ptp source command. To remove the global source for PTP packets, use the no form of this command.

ptp source ip_address

no ptp source ip_address

Syntax Description

ip_address

IPv4 address of the source.

Defaults

None

Command Modes

Global configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release	Modification
5.2(1)	This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the global source for all the PTP packets:

switch# configure terminal

switch(config)# ptp source 10.1.1.1

switch(config)#

This example shows how to remove the global source configuration for all the PTP packets:

switch(config)# no ptp source 10.1.1.1 
switch(config)#

Related Commands

Command	Description
feature ptp	Enables or disables PTP on the device.
ptp domain	Configures the domain number to use for this clock.
ptp priority1	Configures the priority1 value to use when advertising this clock.
ptp priority2	Configures the priority2 value to use when advertising this clock.
show ptp brief	Displays the PTP status.
show ptp clock	Displays the properties of the local clock.

ptp sync interval

To configure the interval between Precision Time Protocol (PTP) synchronization messages on an interface, use the ptp sync interval command. To remove the interval configuration for PTP messages synchronization, use the no form of this command.

ptp sync interval seconds

no ptp sync interval seconds

Syntax Description

seconds

Log seconds. The range is from -1 to 1.

Defaults

0

Command Modes

Interface configuration mode (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release	Modification
5.2(1)	This command was introduced.

Usage Guidelines

Make sure that you are in the correct virtual device context (VDC). To change the VDC, use the switchto vdc command.

Make sure that you have globally enabled PTP on the device and configured the source IP address for PTP communication.

This command does not require a license.

Examples

This example shows how to configure the interval between PTP synchronization messages on an interface:

switch# configure terminal

switch(config)# interface ethernet 5/1

switch(config-if)# ptp sync interval 1

switch(config-if)#

This example shows how to remove the interval configuration for PTP messages synchronization:

switch(config)# interface ethernet 5/1

switch(config-if)# no ptp sync interval 1

switch(config-if)#

Related Commands

Command	Description
ptp	Enables or disables PTP on an interface.
ptp announce	Configures the interval between PTP announce messages on an interface or the number of PTP intervals before a timeout occurs on an interface.
ptp delay-request minimum interval	Configures the minimum interval allowed between PTP delay-request messages when the port is in the master state.
ptp vlan vlan	Configures the PTP VLAN value on an interface.

ptp vlan

To configure the Precision Time Protocol (PTP) VLAN value on an interface, use the ptp vlan command. To remove the PTP VLAN value from an interface, use the no form of this command.

ptp vlan vlan-number

no ptp vlan vlan-number

Syntax Description

vlan-number

VLAN number. The range is from 1 to 4094.

Defaults

1

Command Modes

Interface configuration mode (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release	Modification
5.2(1)	This command was introduced.

Usage Guidelines

Make sure that you are in the correct virtual device context (VDC). To change the VDC, use the switchto vdc command.

Make sure that you have globally enabled PTP on the device and configured the source IP address for PTP communication.

This command does not require a license.

Examples

This example shows how to configure the PTP VLAN value on an interface:

switch# configure terminal

switch(config)# interface ethernet 5/5

switch(config-if)# ptp vlan 9

switch(config-if)#

This example shows how to remove the PTP VLAN value from an interface:

switch(config)# interface ethernet 5/5

switch(config-if)# no vlan 9

Related Commands

Command	Description
ptp	Enables or disables PTP on an interface.
ptp announce	Configures the interval between PTP announce messages on an interface or the number of PTP intervals before a timeout occurs on an interface.
ptp delay-request minimum interval	Configures the minimum interval allowed between PTP delay-request messages when the port is in the master state.
ptp sync interval	Configures the interval between PTP synchronization messages on an interface.