EnergyWise CLI Commands

Note In the examples, the interface-id is in this format: typeslot-or-module-number/port-number; for example, gigabitethernet 0/5. To specify an interface, see your device software documentation.

clear energywise neighbors

To delete the discovered neighbors and end points running agents or clients from the EnergyWise neighbor table, use the clear energywise neighborscommand in privileged EXEC mode. The switch immediately rediscovers them.

clear energywise neighbors

Syntax Description

This command does not have arguments or keywords.

Command Default

Default is not defined.

Command Modes

Privileged EXEC

Command History

Release

Modification

12.2(50)SE

This command was introduced on the Catalyst 3750-E, 3750, 3560-E, 3560, and 2960 switches.

12.2(52)SG

This command was introduced on Catalyst 4500 switches.

12.2(33)SXI4

This command was introduced on the Catalyst 6500 switches. See the Cisco IOS Release Notes for Cisco EnergyWise, EnergyWise Phase 2 for the specific devices.

15.0(1)M2

This command was introduced on Cisco Integrated Service Routers Generation 2 (ISR G2), including Cisco 3900, 2900, and 1900 ISRs.

Usage Guidelines

If the end point is a PC running an agent or client and you enter the clear energywise neighborsprivileged EXEC command, the PC is removed from the neighbor table.

You can verify that the tables were deleted by entering the show energywise neighbors privileged EXEC command.

Examples

This example shows how to delete the neighbor tables:

Switch# clear energywise neighbors

Cleared all non static energywise neighbors

Related Commands

Command

Description

show energywise neighbors

Displays the EnergyWise neighbor tables.

debug energywise

To enable debugging of EnergyWise end points and managment stations, use the debug energywise command in privileged EXEC mode.

debug energywise{endpoint | management}

Syntax Description

endpoint

Display information about EnergyWise end points running a client or agent.

Command Default

Command Modes

Command History

This command was introduced on the Catalyst 3750-E, 3750, 3560-E, 3560, and 2960 switches.

12.2(54)SG

This command was introduced on Catalyst 4500 switches.

12.2(33)SXI4

This command was introduced on the Catalyst 6500 switches. See the Cisco IOS Release Notes for Cisco EnergyWise, EnergyWise Phase 2 for the specific devices.

15.0(1)M2

This command was introduced on Cisco Integrated Service Routers Generation 2 (ISR G2), including Cisco 3900, 2900, and 1900 ISRs.

Usage Guidelines

Theundebug energywise command is the same as the nodebug energywise command.

When you enable debugging on a stacking-capable switch, it is enabled only on the stack master. To enable debugging on a stack member, use the sessionswitch-numberprivileged EXEC command to start a session from the stack master. Enter the debug command on the stack-member command-line prompt. You can also use the remotecommandstack-member-number LINEprivileged EXEC command on the stack master to enable debugging on a member switch before you start a session.

Related Commands

Command

Description

show energywise neighbors

Displays the EnergyWise neighbor tables.

energywise (global configuration)

To configure EnergyWise on a domain member or end point, use the energywisecommand in global configuration mode. To disable EnergyWise and to remove the EnergyWise configuration, use the no form of this command.

If you enter the no energywise level command, the switch does not immediately change the power level to the default. The power level changes when the switch restarts or when you enter the energywiselevellevel command.

Examples

This example shows how to enable EnergyWise, assign an IP phone to a domain, and set the domain and management passwords.

energywise (interface configuration)

To configure EnergyWise on the switch port, use the energywisecommand in interface configuration mode. To disable EnergyWise and to remove the EnergyWise configuration, use the no form of this command.

(Optional) If the interface receives a query from the management station or another domain member, configures the interface to respond to a query changing the power level and the EnergyWise attributes.

importanceimportance

(Optional) Sets the importance of the port.

The range is from 1 to 100.

keywordsword,word

(Optional) Assigns at least one keyword for the port.

When assigning multiple keywords, separate the keywords with commas, and do not use spaces between keywords.

•You can enter alphanumeric characters and symbols such as #, (, $, !, and &.

•Do not enter an asterisk (*) or a blank space between the characters or symbols.

levellevel

(Optional) Sets the power level of the port.

The range is from 0 and 10.

•To power off the end point, enter 0.

•To power on the end point

–If it is a PoE end point, enter 10.

–If it is not, enter a power level from 1 to 10. The end point determines the appropriate action.

This command was introduced on the Catalyst 6500 switches. See the Cisco IOS Release Notes for Cisco EnergyWise, EnergyWise Phase 2 for the specific devices.

15.0(1)M2

This command was introduced on Cisco Integrated Service Routers Generation 2 (ISR G2), including Cisco 3900, 2900, and 1900 ISRs.

Usage Guidelines

Before using the energywise activitycheck command, see the "Using the Call In-Progress Feature" section in the "Managing Single Entities" chapter.

If you enter the no energywise levelcommand, the switch does not immediately change the power level to the default. The power level changes when the switch restarts or when you enter the energywiselevellevel command.

For a recurring event, to configure multiple dates and times using the cron format (minute hour day_of_month month day_of_week)

•Use a comma (,) to specify a list of values without spaces between the values, for example, 1,3,4,7,8.

•Use a dash (-) to specify a range of values, for example, 1-6 (same as 1,2,3,4,5,6).

•Use an asterisk (*) for a wildcard.

•Use a slash (/) to skip a specific number of values. For example

–Enter */15 * * * *forthe event occurs every 15 minutes.

–Enter 0-59/3 * * * * or 0,20,40 for the event to occur every 20 minutes.

–Enter */61 * * * * for the event to occur every hour.

–Enter * */3 * * * or 0,3,6,9,12,15,18,21 for the event to occur every three hours.

For information about specifying the day_of_monthand the day_of_weekin the energywise levellevelrecurrence importanceimportanceatminute hour day_of_month month day_of_week command, see the "Configuration Guidelines" section in the "Managing Single Entities" chapter.

Examples

This example shows how to enable and configure EnergyWise on a port and how to configure a recurring event.

energywise domain

To enable EnergyWise on an entity, assign the entity to a domain, set the domain security mode, and set the domain password, use the energywise domaincommand in global configuration mode . To disable EnergyWise and to remove the EnergyWise configuration, use the no form of this command.

Syntax Description

•You can enter alphanumeric characters and symbols such as #, (, $, !, and &.

•Do not enter an asterisk (*) or a blank space between the characters or symbols.

security {ntp-shared-secret | shared-secret} [0 | 7] domain-password

Sets the domain security mode and the domain password to authenticate all communication in the domain.

•ntp-shared-secret—Uses a strong password with Network Time Protocol (NTP). If the time between members varies ±30 seconds, the entity drops events.

•shared-secret—Sets a strong password without NTP.

•(Optional) 0—Uses an unencrypted password.

•(Optional) 7—Uses a hidden password.

If you do not enter 0 or 7, the default is 0.

•For the domain-password

–You can enter alphanumeric characters and symbols such as #, (, $, !, and &.

–Do not enter an asterisk (*) or a blank space between the characters or symbols.

protocol udp portudp-port-number

(Optional) Specifies UDP as the communication protocol, and specifies the UDP port that communicates with the domain.

The range is from 1 to 65000.

interfaceinterface-id

(Optional) Specifies the port that communicates with the domain if the IP address is dynamically assigned.We recommend that you specify the interface-id. You should use this in a bridged network.

ipip-address

(Optional) Specifies the IP address that communicates with the domain if the interface is a switched virtual interface (SVI) and VLAN trunking protocol (VTP) pruning is enabled. You should use this in a routed network.

Command Default

EnergyWise is disabled, and the entity is not assigned to a domain.

The domain password is not set.

The udp-port-number is 43440.

Command Modes

Privileged EXEC

Command History

Release

Modification

12.2(50)SE

This command was introduced on the Catalyst 3750-E, 3750, 3560-E, 3560, and 2960 switches.

This command was introduced on the Catalyst 6500 switches. See the Cisco IOS Release Notes for Cisco EnergyWise, EnergyWise Phase 2 for the specific devices.

15.0(1)M2

This command was introduced on Cisco Integrated Service Routers Generation 2 (ISR G2), including Cisco 3900, 2900, and 1900 ISRs.

Usage Guidelines

If you enter the energywise domaindomain-namesecurity {ntp-shared-secret | shared-secret} [0 | 7] domain-password command, the switch selects the first available port for communicating with the management station.

snmp-server enable traps energywise

To enable the switch to send Simple Network Management Protocol (SNMP) notifications for EnergyWise traps or inform requests to the network management system (NMS), use the snmp-server enable traps energywise command in global configuration mode. To return to the default setting, use the no form of this command.