Table Of Contents

EnergyWise CLI Commands

clear energywise neighbors

debug energywise

energywise (global configuration)

energywise (interface configuration)

energywise domain

energywise query

snmp-server enable traps energywise

show energywise

EnergyWise CLI Commands

---

•clear energywise neighbors

•energywise (global configuration)

•energywise (interface configuration)

•energywise domain

•energywise query

•snmp-server enable traps energywise

•show energywise

---

Note In the examples, the interface-id is in this format: type slot-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 neighbors command 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 neighbors privileged 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.
management	Display information about EnergyWise management stations running power management applications.

Command Default

EnergyWise debugging is disabled.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(53)SE1	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

The undebug energywise command is the same as the no debug 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 session switch-number privileged 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 remote command stack-member-number LINE privileged 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 energywise command in global configuration mode. To disable EnergyWise and to remove the EnergyWise configuration, use the no form of this command.

energywise allow query {save | set}

energywise endpoint security {none | shared-secret [0 | 7] password}

energywise {importance importance | keywords word,word,... | level level | name name | neighbor [hostname| ip-address] udp-port-number | role role}

energywise management security shared-secret [0 | 7] mgmt-password [port tcp-port-number]

no energywise {allow query {save | set} | endpoint | importance | keywords [word,word] | management | name | neighbor [hostname| ip-address] udp-port-number | role}

Syntax Description

allow query {save | set}	If the switch receives a query from the management station or another domain member, configures the switch to •save—Responds to a query to save the running configuration. •set—Responds to a query to change the power level or the EnergyWise attributes.
endpoint security {none | shared-secret [0 | 7] password}	Sets the security mode for an endpoint. •none—Disables security. •shared-secret—Uses a password for secure communication with the connected domain member. •(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 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.
importance importance	Sets the importance. The range is from 1 to 100.
keywords word,word,...	Assigns at least one keyword. 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.
level level	Sets the power level. The range is from 0 to 10.
name name	Specifies the EnergyWise-specific entity name. •You can enter alphanumeric characters and symbols such as #, (, $, !, and &. •Do not enter an asterisk (*) or a blank space between the characters or symbols.
neighbor [hostname| ip-address] udp-port-number	Assigns a static neighbor: •(Optional) DNS (Domain Name System) hostname (hostname) or IP address (ip-address). •UDP port (udp-port-number) that sends and receives queries. The range is from 1 to 65000.
role role	Specifies the role of the entity in the EnergyWise domain. For example, lobby.b20. •You can enter alphanumeric characters and symbols such as #, (, $, !, and &. •Do not enter an asterisk (*) or a blank space between the characters or symbols.
management security shared-secret [0 | 7] mgmt-password [port tcp-port-number]	Sets the management password for the management station communicating with the domain. •(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 mgmt-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. •(Optional) port tcp-port-number—Specifies the TCP port for management access. The port number range is from 1025 to 65535.

Command Default

EnergyWise is disabled.

The switch interfaces do not respond to save queries.

The interfaces respond to set queries.

The end-point and management passwords are not set.

The importance is 1.

Keywords are not defined.

The power level is 10.

The tcp-port-number is 43440.

The name is the hostname.

Neighbors are not assigned.

The role is the model number.

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)SE	On the Catalyst 3750-E, 3750, 3560-E, 3560, and 2960 switches •The management udp-port-number keywords were replaced with the management security shared-secret [0 | 7] shared-secret port tcp-port-number keywords. •The allow query {save | set} keywords were added.
12.2(52)SG	This command was introduced on Catalyst 4500 switches.
12.2(54)SG	On Catalyst 4500 switches •The management udp-port-number keywords were replaced with the management security shared-secret [0 | 7] shared-secret port tcp-port-number keywords. •The allow query {save | set} keywords were added.
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

When you add a switch to a domain, EnergyWise is enabled on the switch and its PoE ports.

When setting a hidden (encrypted) password, enter the service password-encryption global configuration command before entering the energywise management security shared-secret 7 mgmt-password [port tcp-port-number] global configuration 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 energywise level level command.

Examples

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

Switch# configure terminal

Enter configuration commands, one per line.  End with CNTL/Z.

Switch(config)# eenergywise domain cisco security shared-secret cisco protocol udp port 
43440 ip 2.2.4.30

Switch(config)# energywise importance 50

Switch(config)# energywise keywords lab1,devlab 

Switch(config)# service password-encryption

Switch(config)# energywise management security shared-secret 7 cisco port 60500

Switch(config)# energywise name Entity01

Switch(config)# energywise neighbor member-21 43440

Switch(config)# energywise role role.labaccess

Switch(config)# energywise allow query save

Switch(config)# end

Related Commands

Command	Description
show energywise	Displays the EnergyWise settings and status.
show energywise domain	Displays the domain to which the entity belongs.
show energywise recurrences	Displays the recurring-event settings and status.

energywise (interface configuration)

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

energywise [activitycheck | allow query set | importance importance | keywords word,word,... | level level [recurrence importance importance {at minute hour day_of_month month day_of_week | time-range time-range-name} | name name | role role]

energywise domain domain-name security {ntp-shared-secret | shared-secret} [0 | 7] shared-secret [protocol udp port udp-port-number [interface interface-id | ip ip-address]]

no energywise [activitycheck | allow query set | importance | keywords [word,word,... ] | level [level recurrence importance importance {at minute hour day_of_month month day_of_week | time-range time-range-name}] | name [name] | role [role]]

no energywise domain

---

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

---

Syntax Description

activitycheck	(Optional) Configures the switch to wait until a Cisco IP phone connected to a PoE port is not sending or receiving traffic before the switch powers off the port. Note The switch cannot determine if the IP phone is in the hold state. The command is supported on •Catalyst 6500 switches (see the Cisco IOS Release Notes for Cisco EnergyWise, EnergyWise Phase 2 for the specific devices.) •Catalyst 4500 switches •Catalyst 3750-X, 3750-E, 3750, 3560-X, 3650-E, 3560, and 2960 switches •Cisco EtherSwitch service modules (NME-16ES-1G, NME-16ES-1G-P, NME-X-23ES-1G, NME-X-23ES-1G-P, NME-XD-24ES-1S-P, NME-XD-48ES-2S-P) •Cisco enhanced EtherSwitch service modules (SM-D-ES2-48, SM-D-ES3-48-P, SM-D-ES3G-48-P, SM-ES2-16-P, SM-ES2-24, SM-ES2-24-P, SM-ES3-16-P, SM-ES3-24-P, SM-ES3G-16-P, SM-ES3G-24-P)
allow query set	(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.
importance importance	(Optional) Sets the importance of the port. The range is from 1 to 100.
keywords word,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.
level level	(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.
recurrence importance importance {at minute hour day_of_month month day_of_week | time-range time-range-name}	(Optional) Schedules the power-on or power-off event. •importance importance—The event occurs if the importance value of the end point is less than or equal to the specified importance value. The range is from 1 to 100. •at minute hour day_of_month month day_of_week—Specifies the time (24-hour format) in cron format for the recurring event. –minute—The range is from 0 to 59. Use * for the wildcard. –hour—The range is from 0 to 23. Use * for the wildcard. –day_of_month—The range is from 1 to 31. Use * for the wildcard. –month—The range is from 1 (January) to 12 (December). Use * for the wildcard. –day_of_week—The range is from 0 (Sunday) to 7 (Sunday). Use * for the wildcard. •time-range time-range-name—Specifies the time range name for the recurring event. The event uses the switch time.
name name	(Optional) Specifies the EnergyWise-specific port name. •You can enter alphanumeric characters and symbols such as #, (, %, !, and &. •Do not enter an asterisk (*) or a blank space between the characters or symbols.
role role	(Optional) Specifies the role of the port in the domain. For example, lobbyport. •You can enter alphanumeric characters and symbols such as #, (, %, !, and &. •Do not enter an asterisk (*) or a blank space between the characters or symbols.
domain domain-name security {ntp-shared-secret | shared-secret} [0 | 7] shared-secret [protocol udp port udp-port-number [interface interface-id | ip ip-address]]	Configures the EnergyWise domain. See the energywise domain interface configuration command.

Command Default

EnergyWise is disabled.

The switch to waits until a Cisco IP phone connected to a PoE port is not sending or receiving traffic before powering off the port.

The switch responds to a query to change the power level and the EnergyWise attributes.

The importance is 1.

Keywords are not defined.

The power level is 10.

The recurring event is not configured.

The name is the short version of the port name; for example, Gi1.0.2 for Gigabit Ethernet 1/0/2.

The role is the model number.

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)SE	The activitycheck, allow query {save | set}, and recurrence time-range time-range-name keywords were added 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(54)SG	The activitycheck, allow query {save | set}, and recurrence time-range time-range-name keywords were added 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

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 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 energywise level level 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 * * * * for the 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_month and the day_of_week in the energywise level level recurrence importance importance at minute 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.

Switch# configure terminal

Enter configuration commands, one per line.  End with CNTL/Z.

Switch(config)# service password-encryption

Switch(config)# energywise domain cisco security shared-secret cisco protocol udp port 
43440 ip 2.2.4.30

Switch(config)# time-range onfirstfloor

Switch(config-time-range)# absolute start 0:00 1 August 2009

Switch(config-time-range)# periodic weekdays 6:00 

Switch(config-time-range)# periodic weekend 9:00

Switch(config)# time-range offfirstfloor

Switch(config-time-range)# absolute start 0:00 1 August 2009

Switch(config-time-range)# periodic weekdays 20:00 

Switch(config-time-range)# periodic weekend 18:00

Switch(config)# interface gigabitethernet0/3

Switch(config-if)# energywise level 10 recurrence importance 70 time-range onfirstfloor

Switch(config-if)# energywise level 0 recurrence importance 70 time offfirstfloor

Switch(config-if)# energywise name floor.1

Switch(config-if)# energywise role pc-mgr

Switch(config-if)# end

Related Commands

Command	Description
absolute	Sets a specific time and day for a recurring event.
show energywise	Displays the EnergyWise settings and status.
show energywise domain	Displays the domain to which the entity belongs.
show energywise recurrences	Displays the recurring-event settings and status.
periodic	Sets a weekly time and day for a recurring event.
time-range	Assigns a name to the time range for 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 domain command in global configuration mode . To disable EnergyWise and to remove the EnergyWise configuration, use the no form of this command.

energywise domain domain-name security {ntp-shared-secret | shared-secret} [0 | 7] shared-secret [protocol udp port udp-port-number [interface interface-id | ip ip-address]]

no energywise domain

Syntax Description

domain domain-name	Assign the entity to a domain with the specified domain-name. •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 port udp-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.
interface interface-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.
ip ip-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.
12.2(52)SE	The secret [0 | 7] password keywords were replaced with the security {ntp-shared-secret | shared-secret} [0 | 7] domain-password keywords 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(54)SG	The secret [0 | 7] password keywords were replaced with the security {ntp-shared-secret | shared-secret} [0 | 7] domain-password keywords 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 you enter the energywise domain domain-name security {ntp-shared-secret | shared-secret} [0 | 7] domain-password command, the switch selects the first available port for communicating with the management station.

When setting a hidden (encrypted) password, enter the service password-encryption global configuration command before entering the energywise management security shared-secret 7 mgmt-password [port tcp-port-number] global configuration command.

Examples

This example shows how to enable EnergyWise, set the domain-name and domain-password, and specify the IP address:

Switch# configure terminal

Enter configuration commands, one per line.  End with CNTL/Z.

Switch(config)# service password-encryption

Switch(config)# energywise domain cisco security shared-secret cisco protocol udp port 
43440 ip 2.2.4.30

Related Commands

Command	Description
show energywise	Displays the EnergyWise settings and status.
show energywise domain	Displays the domain to which the entity belongs.

energywise query

To display power information and to set the power level of domain members, use the energywise query command in privileged EXEC mode.

energywise query importance importance {keywords word,word,... | name name} collect {delta | usage} [timeout timeout]

energywise query importance importance {keywords word,word,... | name name} set level level [timeout timeout]

energywise query importance importance {keywords word,word,... | name name} sum {delta | usage} [timeout timeout]

Syntax Description

importance importance	Only entities with importance values less than or equal to the specified value respond to the query. The importance range is from 1 to 100.
keywords word,word,...	Filters the results based on one or more keywords. When specifying 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.
name name	Filters the results based on the name. For the wildcard, use * or name* with the asterisk at the end of the name phrase. •You can enter alphanumeric characters and symbols such as #, (, $, !, and &. •Do not enter an asterisk (*) or a blank space between the characters or symbols.
collect {delta | usage}	Displays power-usage information in watts (W) from the domain members and end points. •delta—Display the delta vector with the difference between the actual power usage and the maximum power usage for each power level for what-if calculations. •usage—Display the actual power usage.
timeout timeout	(Optional) Sets the time in seconds that the management station waits for query results. When configuring the timeout, configure a minimum of 6 seconds to display correct output. The range is from 1 to 180.
set level level	Sets the power level of the domain entities, including the PoE ports. The range is from 0 to 10.
sum {delta | usage}	Displays the summary of the power-usage information from domain members and end points. •delta—Display the delta vector. •usage—Display the actual power usage.

Command Default

The timeout value is 6 seconds.

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)SE	The timeout timeout keywords were added 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(54)SG	The timeout timeout keywords were added on Catalyst 4500 switches.
12.2(55)SE	The default timeout value was changed from 3 seconds to 6 seconds.
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

In the results from the sum keyword, the Responded total is not accurate. The Queried total is accurate and is the number of entities that respond to the query.

---

Caution Use this query with care. It affects the entity on which you enter the command and other domain devices that match the query criteria.

---

Examples

These examples show how to filter with the entity name.

Switch# energywise query importance 50 name phone* collect usage

EnergyWise query, timeout is 6 seconds:

Host              Name                        Usage       Level   Imp

----              ----                        -----       -----   ---

2.2.2.21          phone                         0.0 (W)   10      1

2.2.2.21          phone                        15.4 (W)   10      1

2.2.2.21          phoneA                        0.0 (W)   10      1

2.2.2.22          phone                         0.0 (W)   10      1

2.2.2.21          phoneB                        0.0 (W)   10      1

2.2.2.22          phoneC                       15.4 (W)   10      1

2.2.2.21          phone                         0.0 (W)   10      1

2.2.2.23          phoneD                       15.4 (W)   10      1

2.2.2.21          phone                         0.0 (W)   10      1

Queried:  9    Responded:  9      Time:  0.26 seconds

Switch# energywise query importance 80 name * sum usage

EnergyWise query, timeout is 6 seconds:

Total Usage

-----------

346.3 (W)

Queried:  147    Responded:  147      Time:  0.121 seconds

Switch# energywise query importance 90 name lobby* collect usage

EnergyWise query, timeout is 6 seconds:

Host              Name                        Usage       Level   Imp

----              ----                        -----       -----   ---

2.2.4.30          lobbyInterface.17            10.0 (W)   10      1

2.2.6.20          lobbypc.17                  200.0 (W)    8     90

Queried:  2    Responded:  2      Time:  0.7 seconds

Switch# energywise query importance 900 name Fa1.0.4* sum usage

EnergyWise query, timeout is 6 seconds:

Total Usage

-----------

129.0 (W)

Queried:  10    Responded:  10      Time:  0.6 seconds

This example shows the summary of the delta values and the potential power change in the domain.

Switch# energywise query importance 90 name * collect delta

EnergyWise query, timeout is 6 seconds:

Level   Label       Delta Power (W)

-----   -----       -----------

0       Shut        -12.9  

1       Hibernate   +723.8  

2       Sleep       +723.8  

3       Standby     +723.8  

4       Ready       +723.8  

5       Low         +723.8  

6       Frugal      +723.8  

7       Medium      +723.8  

8       Reduced     +723.8  

9       High        +723.8  

10      Full        +723.8  

Queried:  48    Responded:  48      Time:  0.15 seconds

These examples show how to change the power level of all the domain members and end points.

Switch# energywise query importance 90 name * set level 0

EnergyWise query, timeout is 6 seconds:

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!

Success rate is (48/48) setting entities

Queried:  48   Responded:  48     Time:  0.996 seconds

Switch# energywise query importance 90 name * set level 10

EnergyWise query, timeout is 6 seconds:

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!

Success rate is (48/48) setting entities

Queried:  48   Responded:  48     Time:  0.996 seconds

These examples show how to filter results with keywords.

Switch(config)# interface gigabitethernet0/2

Switch(config-if)# energywise keywords lobby,sattelite

Switch(config-if)# energywise keywords public

Switch(config-if)# end

Switch# show running-config interface gigabitethernet0/2

!

interface GigabitEthernet0/2

 energywise level 0 recurrence importance 90 at 0 8 * * *

 energywise level 10 recurrence importance 90 at 0 20 * * *

 energywise importance 50

 energywise role role.lobbyaccess

 energywise keywords lobby,sattelite,public

 energywise name lobbyInterface.2

end

Switch# energywise query importance 90 keyword lobby collect usage

EnergyWise query, timeout is 6 seconds:

Host              Name                        Usage       Level   Imp

----              ----                        -----       -----   ---

2.2.4.30          lobbyInterface.17            15.4 (W)   10      1

2.2.5.30          pc.1                        200.0 (W)    8     85 

2.2.6.30          pc.2                        200.0 (W)    8     85 

Queried:  3    Responded:  3      Time:  1.1 seconds

Switch# energywise query importance 90 keyword lobby sum usage    

EnergyWise query, timeout is 6 seconds:

Total Usage

-----------

415.4 (W)

Queried:  3    Responded:  3      Time:  0.11 seconds

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.

snmp-server enable traps energywise [event-occured] [level-change] [neighbor-added] [neighbor-deleted]

no snmp-server enable traps energywise

Syntax Description

event-occured	(Optional) Enable EnergyWise event traps.
level-change	(Optional) Enable EnergyWise entity power-level change traps.
neighbor-added	(Optional) Enable EnergyWise entity traps when neighbors are added.
neighbor-deleted	(Optional) Enable EnergyWise entity traps when neighbors are removed.

Command Default

The sending of EnergyWise traps is disabled.

Command Modes

Global configuration

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

Use the snmp-server host global configuration command to specify the host (network management system [NMS]) that receives the traps.

If you do not specify any keywords, all of the EnergyWise traps are enabled.

You can verify your setting by entering the show energywise or the show running-config privileged EXEC command.

Examples

To send EnergyWise traps to the NMS:

Switch(config)# snmp-server enable traps energywise

To send only EnergyWise event traps to the NMS:

Switch(config)# snmp-server enable traps energywise event-occured

Related Commands

Command	Description
show energywise	Displays the EnergyWise settings and status.
show running-config	Displays the operating configuration.

show energywise

To display the EnergyWise settings, the status of the domain member, and the status of the switch port with a connected end point, use the show energywise privileged EXEC command.

show energywise neighbors [categories | children [provisioned] | domain | events | level [children | current [children] | delta [children] ] | neighbors | recurrences | statistics | usage [children] | version] [ | {begin | exclude | include} expression]

---

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

---

Syntax Description

categories	(Optional) Displays the power levels.
children [provisioned]	(Optional) Displays the status of the connected end point. •provisioned—Displays a summary of the EnergyWise information for the switch and the connected end points.
domain	(Optional) Displays the entity name, domain name, protocol, IP address, and UDP port for the domain.
events	(Optional) Displays the last ten events (messages) sent to other members in the domain.
level [children | current [children] | delta [children]	(Optional) Displays the actual power levels. •children—Actual power levels for the domain member and connected end points. •current—Actual power levels for the domain member. (Optional) children—Actual power levels for the domain member and connected end points. •delta—Delta vector for the domain member. (Optional) children—Delta vector for the domain member and connected end points.
neighbors	(Optional) Displays the neighbor table for the switch.
recurrences	(Optional) Displays the EnergyWise settings and status for the recurring event.
statistics	(Optional) Displays the counters for events and errors.
usage [children]	(Optional) Displays the actual power for the domain member. •children—Displays the actual power for the domain member and connected end points.
version	(Optional) Displays the EnergyWise version.
| begin	(Optional) Displays begins with the line that matches the expression.
| exclude	(Optional) Displays excludes lines that match the expression.
| include	(Optional) Displays includes lines that match the specified expression.
expression	Expression in the output to use as a reference point.

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)SE	The children provisioned keywords were added 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(54)SG	The children provisioned keywords were added 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

Expressions are case sensitive. For example, if you enter | exclude output, the lines that contain output do not appear, but the lines that contain Output appear.

Examples

Switch# show energywise

Module/

Interface   Role              Name                  Usage      Lvl   Imp  Type

---------   ----              ----                  -----      ---   ---  ----

            Manager           NRGYZ-TB-09           130.0 (W)  10    1    parent

Switch# show energywise children 

Module/

Interface   Role              Name                  Usage      Lvl   Imp  Type

---------   ----              ----                  -----      ---   ---  ----

Manager                       NRGYZ-TB-09           130.0 (W)  10    1    parent

Gi0/3       AIR-LAP521G-A-K9  LWAPP-AP-1            9.91  (W)  10    1    PoE

Switch# show energywise children provisioned

Module/

Interface   Role              Name                  Usage      Lvl   Imp  Type

---------   ----              ----                  -----      ---   ---  ----

Manager                       NRGYZ-TB-09           130.0 (W)  10    1    parent

Gi0/1       interface         Gi0.1                 0.0   (W)  10    1    PoE

G0/2        interface         Gi0.2                 0.0   (W)  10    1    PoE

Gi0/3       AIR-LAP521G-A-K9  LWAPP-AP-1            9.91  (W)  10    1    PoE

Gi0/4       interface         Gi0.4                 0.0   (W)  10    1    PoE

Gi0/5       interface         Gi0.5                 0.0   (W)  10    1    PoE

Gi0/6       interface         Gi0.6                 0.0   (W)  10    1    PoE

Gi0/7       interface         Gi0.7                 0.0   (W)  10    1    PoE

<output truncated>

Total Displayed: 49     Usage: 139.9

Switch# show energywise domain 

Name      : Manager-1

Domain    : cisco

Protocol  : udp

IP        : 2.2.2.21

Port      : 43440

Switch# show energywise events 

--------------------------------------------

Sequence:  565316   Priority:  100   References:  0:1   Errors:

Class:     PN_CLASS_DISCOVERY

Action:    PN_ACTION_CPQR_POWERNET_DISCOVERY_DISCOVERY_UPDATE

Reply To:  2.2.2.24:43440

--------------------------------------------

Sequence:  566349   Priority:  100   References:  0:1   Errors:

Class:     PN_CLASS_DISCOVERY

Action:    PN_ACTION_CPQR_POWERNET_DISCOVERY_DELETE

Reply To:  2.2.2.24:43440

--------------------------------------------

Sequence:  799789   Priority:  100   References:  0:1   Errors:

Class:     PN_CLASS_DISCOVERY

Action:    PN_ACTION_CPQR_POWERNET_DISCOVERY_DELETE

Reply To:  2.2.2.23:43440

--------------------------------------------

<output truncated>

Switch# show energywise level  

                                                            Levels (Watts)                         

Interface   Name               0     1     2     3     4     5     6     7     8     9     10

---------   ----               --------------------------------------------------------------

            lobby.1            0.0   130.0 130.0 130.0 130.0 130.0 130.0 130.0 130.0 130.0 130.0 

Switch# show energywise level children

Levels (Watts)                         

Interface   Name             0     1     2     3     4     5     6     7     8     9     10

---------   ----             --------------------------------------------------------------

            lobby.1          0.0   130.0 130.0 130.0 130.0 130.0 130.0 130.0 130.0 130.0 130.0

Gi0/1       Gi1.0.1          0.0   15.4  15.4  15.4  15.4  15.4  15.4  15.4  15.4  15.4  15.4  

Gi0/2       LWAPP-AP-1       0.0   9.91  9.91  9.91  9.91  9.91  9.91  9.91  9.91  9.91  9.91  

Gi0/3       Gi1.0.3          0.0   15.4  15.4  15.4  15.4  15.4  15.4  15.4  15.4  15.4  15.4  

Gi0/4       Gi1.0.4          0.0   15.4  15.4  15.4  15.4  15.4  15.4  15.4  15.4  15.4  15.4  

Gi0/5       Gi1.0.5          0.0   15.4  15.4  15.4  15.4  15.4  15.4  15.4  15.4  15.4  15.4  

<output truncated>

Switch# show energywise level current 

Interface   Name                     Level  Value

---------   ----                     -----  -----

            lobby.1                  10     130.0 (W)  

Switch# show energywise level current children

Interface   Name                     Level  Value

---------   ----                     -----  -----

            lobby.1                  10     558.0 (W)  

Gi0/1       Gi1.0.1                  1      15.4  (W)  

Gi0/2       LWAPP-AP-1               10     9.91  (W)  

Gi0/3       LWAPP-AP-2               10     9.91  (W  

Gi0/4       Gi0.4                    1      15.4  (W)  

Gi0/5       Gi0.5                    1      15.4  (W)  

Gi0/6       Gi0.6                    1      15.4  (W)

<output truncated>

Switch# show energywise level delta 

                                                                  Levels (Watts)                             

Interface   Name                     0      1      2      3      4      5      6      7      8      9      10

---------   ----                     ------------------------------------------------------------------------

            lobby.1                 0.0    0.0    0.0    0.0    0.0    0.0    0.0    0.0    0.0    0.0    0.0 

Switch# show energywise level delta child

                                                                  Levels (Watts)                             

Interface   Name                    0      1      2      3      4      5      6      7      8      9      10

---------   ----                    ------------------------------------------------------------------------

            lobby.1                0.0    0.0    0.0    0.0    0.0    0.0    0.0    0.0    0.0    0.0   0.0 

Gi0/1       Gi0.1                  0.0    15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4  15.4 

Gi0/2       LWAPP-AP-1             0.0    0.0    0.0    0.0    0.0    0.0    0.0    0.0    0.0    0.0    0.0 

Gi0/3       Gi0.3                  0.0    15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4  15.4 

<output truncated>

Switch# show energywise neighbors 

Capability Codes: R - Router, T - Trans Bridge, B - Source Route Bridge

                  S - Switch, H - Host, I - IGMP, r - Repeater, P - Phone, U - Unknown

Id   Neighbor Name                 Ip:Port                 Prot   Capability

--   -------------                 -------                 ----   ----------

1    Router A                      10.0.0.11:43440         udp    R 

2    Switch A                      10.0.0.12:43440         cdp    S I 

3    Router B                      10.0.0.36:43440         cdp    U 

4    IP_phone A                    10.0.0.14:43440         udp    U 

5    Switch B                      10.0.0.4:43440          udp    R 

6    Switch C                      10.0.0.5:43440          udp    R 

7    Router C                      10.0.0.7:43440          udp    R 

When you use the energywise level level recurrence importance importance {at minute hour day_of_month month day_of_week global configuration command

Switch# show energywise recurrences 

Id     Addr       Class Action Lvl Cron//Time-range

--     ----       ----- ------ --- ---------------

2      Gi0/17     QUERY SET     3  minutes: 0 hour: 8 day: * month: * weekday: *

3      Gi0/18     QUERY SET     3  minutes: 0 hour: 8 day: * month: * weekday: *

4      Gi0/19     QUERY SET     3  minutes: 0 hour: 8 day: * month: * weekday: *

When you use the energywise level level recurrence importance importance time-range time-range-name global configuration command

Switch# show energywise recurrences 

Id     Addr       Class Action Lvl Cron/Time-range

--     ----       ----- ------ --- ---------------

1      Gi0/1      QUERY SET    10  tt-range

Switch# show energywise statistics

Children:  48  Errors:  0  Drops:  31  Events:  643

Switch# show energywise usage 

Interface   Name                     Usage      Caliber

---------   ----                     _____      _______

            lobby.1                  130.0 (W)  max

Switch# show energywise usage child

Interface   Name                     Usage      Caliber

---------   ----                     _____      _______

            NRGYZ-TB-09              130.0 (W)  max

Gi0/1       Gi0.1                    0.0  (W)   presumed

Gi0/2       LWAPP-AP-1               9.91 (W)   trusted

Gi0/3       Gi0.3                    0.0  (W)   presumed

Gi0/4       Gi0.4                    0.0  (W)   presumed

Gi0/5       Gi0.5                    0.0  (W)   presumed

<output truncated>

Total Displayed: 49     Usage: 139.9

Switch# show energywise version   

EnergyWise is Enabled

IOS Version:  12.2(52)SE

EnergyWise Specification: 0.6.33

Related Commands

Command	Description
energywise (global configuration)	Enables and configures EnergyWise on the entity.
energywise (interface configuration)	Configures EnergyWise on the PoE port.