Cisco EnergyWise IOS Configuration Guide, EnergyWise Version 2.8
CLI Commands
Downloads: This chapterpdf (PDF - 314.0KB) The complete bookPDF (PDF - 1.66MB) | Feedback

EnergyWise CLI Commands

Table Of Contents

EnergyWise CLI Commands

clear energywise

debug energywise

energywise (global configuration)

energywise (interface configuration)

energywise domain

energywise query

show energywise

snmp-server enable traps energywise


EnergyWise CLI Commands


clear energywise

debug energywise

energywise (global configuration)

energywise (interface configuration)

energywise domain

energywise query

show energywise

snmp-server enable traps 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

To delete the discovered domain member neighbors and IP endpoints from the EnergyWise database, use the clear energywise neighbors privileged EXEC command.

clear energywise {endpoints [all | cached] | neighbors}

Syntax Description

endpoints [all | cached]

Clears the connected EnergyWise-capable IP endpoints. PoE devices that do not run the agent are not deleted.

(Optional) all—Removes all operational and nonoperational (cached) EnergyWise endpoints.

(Optional) cached—Removes only nonoperational (cached) EnergyWise endpoints.

neighbors

Deletes the discovered domain member neighbors from the EnergyWise database. After the discovered domain members are deleted the local domain member immediately begins to rediscover any connected neighbors.


Command Default

None.

Command Modes

Privileged EXEC

Command History

Release
First EW Version
Modification

12.2(33)SXI4

2

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.

12.2(50)SE

1

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

12.2(52)SG

2

This command was introduced on the Catalyst 4500 switches.

12.2(53)SE2

2

This command was introduced on the Catalyst 3750-X and 3560-X switches.

12.2(58)SE

2.5

The endpoint [all | cached] keywords were added to the Catalyst 3750-X, 3750-E, 3750, 3560-X, 3560-E, 3560, and 2960 switches.

15.0(1)M2

2

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


Usage Guidelines

To check that you have deleted neighbors and endpoints from the database, use the show energywise neighbors privileged EXEC command.


Note If you statically add a neighbor, the clear energywise neighbors privileged EXEC command does not affect it.


Examples

This example shows the EnergyWise children before and after using the clear energywise endpoints privileged EXEC command.

Before clearing endpoints:

DomainMember# show energywise children 
Module/
Interface   Role              Name                  Usage      Category  Lvl   Imp  Type
---------   ----              ----                  -----      --------  ---   ---  ----
            Switch            Switch                94.0  (W)  consumer  10    100  module
Gi0/12      Parent            Endpoint              12.0  (W)  consumer  10    50   
endpoint
Gi0/14      IP Phone 7960     SEP000E833CB4E3       1.88  (W)  consumer  10    35   PoE
Gi0/15      IP Phone 7960     SEP0011920E0A05       1.775 (W)  consumer  10    35   PoE
 
   

Clearing endpoints:

DomainMember# clear energywise endpoints all
Cleared all energywise endpoints
 
   

After clearing endpoints:

DomainMember# show energywise children 
Module/
Interface   Role              Name                  Usage      Category  Lvl   Imp  Type
---------   ----              ----                  -----      --------  ---   ---  ----
            Switch            Switch                94.0  (W)  consumer  10    100  module
Gi0/14      IP Phone 7960     SEP000E833CB4E3       1.88  (W)  consumer  10    35   PoE
Gi0/15      IP Phone 7960     SEP0011920E0A05       1.775 (W)  consumer  10    35   PoE
 
   

Related Commands

Command
Description

show energywise neighbors

Displays the EnergyWise neighbors.


debug energywise

To debug EnergyWise endpoints and managment stations, use the debug energywise privileged EXEC command.

debug energywise {debug | discovery | endpoint | ha | management | packet | query | trace | wol}

Syntax Description

debug

Displays errors such as invalid sequence numbers and communication errors on the domain.

discovery

Displays all EnergyWise discovery information.

endpoint

Displays information about EnergyWise endpoints running a client or agent and helps detect mismatched domain names, secrets, and sequence numbers of connected endpoints.

ha

Displays EnergyWise high availability (HA) information for devices that have HA capability.

management

Displays information about authentication failures and EnergyWise management stations running power management applications.

packet

Displays EnergyWise packet trace information.

query

Displays query information with respect to the device from which the query is initiated.

trace

Displays information about all the EnergyWise processes with respect to the device from which the query is initiated.

wol

Displays Wake on LAN (WoL) query information with respect to the device from which the query is initiated.


Command Default

EnergyWise debugging is disabled.

Command Modes

Privileged EXEC

Command History

Release
First EW Version
Modification

12.2(33)SXI4

2

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.

12.2(53)SE1

2.5

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

12.2(53)SE2

2

This command was introduced on the Catalyst 3750-X and 3560-X switches.

12.2(52)SG

2

This command was introduced on the Catalyst 4500 switches.

12.2(58)SE

2.5

The ha, packet, and trace keywords were added on the Catalyst 3750-X, 3750-E, 3750, 3560-X, 3560-E, 3560, and 2960 switches.

15.0(1)M2

2

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

15.0(2)SE

2.8

The discovery, query, and wol keywords were added on the Catalyst 2900, 3500, and 3700 switches. See the Cisco IOS Release Notes for Cisco EnergyWise, EnergyWise Version 2.8 for the specific devices.


Usage Guidelines


Caution Because debugging output is assigned high priority in the CPU process, it can render the system unusable. For this reason, use the debug commands only to troubleshoot specific problems or during troubleshooting sessions with Cisco technical support staff. It is best to use the debug commands during periods of lower network traffic and fewer users. Debugging during these periods decreases the likelihood that increased debug command processing overhead will affect system use.

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.

energywise (global configuration)

To configure EnergyWise on a domain member or endpoint, use the energywise global configuration command. 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]

energywise proxy mapping map_name word

no energywise {allow query {save | set} | endpoint | importance | keywords | level | management | name | neighbor | proxy | role}

Syntax Description

allow query {save | set}

Configures the domain member to respond to queries from the management station or another domain member.

save—Respond to a query to save the running configuration.

set—Respond 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 a plain-text 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 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 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 name.

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

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

neighbor {hostname | ip-address} udp-port-number

Assigns a static neighbor.

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.

proxy mapping map_name word

Assigns an alias to the XML file.

mapping map_name—Specifies an alias for the XML file.

word—Specifies the exact XML filename that is stored on the flash directory of the switch.

role role

Specifies the role 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 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 a plain-text 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 space between the characters or symbols.

(Optional) port tcp-port-numberSpecifies the TCP port for management access. The port number range is from 1025 to 65535.


Command Default

The following are the default settings or values for the different parameters:

EnergyWise is disabled.

The domain member interfaces do not respond to save queries.

The interfaces respond to set queries.

The endpoint 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
First EW Version
Modification

12.2(33)SXI4

2

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.

12.2(50)SE

1

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

12.2(52)SE

2

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(53)SE2

2

This command was introduced on the Catalyst 3750-X and 3560-X switches.

12.2(52)SG

2

This command was introduced on the Catalyst 4500 switches.

12.2(52)SG

2

On the 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.

15.0(1)M2

2

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

15.0(2)SE

2.8

The proxy mapping map_name word keywords were added on the Catalyst 2900, 3500, and 3700 switches. See the Cisco IOS Release Notes for Cisco EnergyWise, EnergyWise Version 2.8 for the specific devices.


Usage Guidelines

When you add a domain member to a domain, EnergyWise is enabled on the domain member.

When you add a PoE 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 domain member does not immediately change the power level to the default. The power level changes when the domain member restarts or when you enter the energywise level level command.

When configurig the energywise proxy mapping map_name word command, ensure that the XML files you use are installed on each one of the stack members.

Examples

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

DomainMember# configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
DomainMember(config)# energywise domain cisco security shared-secret cisco protocol udp 
port 43440 ip 2.2.4.30
DomainMember(config)# energywise importance 50
DomainMember(config)# energywise keywords lab1,devlab 
DomainMember(config)# service password-encryption
DomainMember(config)# energywise management security shared-secret 7 cisco port 60500
DomainMember(config)# energywise name Device01
DomainMember(config)# energywise neighbor member-21 43440
DomainMember(config)# energywise role role.labaccess
DomainMember(config)# energywise allow query save
DomainMember(config)# end

Related Commands

Command
Description

show energywise

Displays the EnergyWise settings and status.

show energywise domain

Displays the domain to which the domain member or endpoint belongs.

show energywise recurrences

Displays the recurring-event settings and status.


energywise (interface configuration)

To configure EnergyWise on the domain member port, use the energywise interface configuration command. 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 proxy mapping map_name protocol protocol host host discovery-interval interval port port

energywise proxy protocol protocol version version

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 proxy mapping map_name protocol protocol host host discovery-interval interval port port

no energywise proxy protocol protocol version version


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 domain member to wait until a Cisco IP phone connected to a PoE port is not sending or receiving traffic before the domain member powers off the port.

Note The domain member cannot determine if the IP phone is in the hold state.

allow query set

(Optional) If the interface receives a query from the management station or another domain member, this command 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 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 endpoint, enter 0.

To power on the endpoint:

If it is a PoE endpoint, enter 10.

If it is not a PoE endpoint, enter a power level from 1 to 10. The endpoint 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 endpoint 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-nameSpecifies the time range name for the recurring event.

The event uses the domain member 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 space between the characters or symbols.

role role

(Optional) Specifies the role of the port in the domain, such as a lobbyport.

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

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

mapping map_name

Refers to the alias of the XML file that you want to use.

protocol protocol

Specifies the translation protocol for the device. For SNMP devices, the protocol is SNMP.

host host

Specifies the IP address of the SNMP device.

discovery-interval interval

Configures the interval for discovery updates from the SNMP device specified by the host and port, in seconds.

port port

Specifies the TCP or UDP port number for the SNMP device.

version version

Specifies the SNMP version. Use version SNMPv2c


Command Default

The following are the default settings or values for the different parameters:

EnergyWise is disabled.

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

The domain member 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.

The discovery interval is 180 seconds.

Command Modes

Privileged EXEC

Command History

Release
First EW Version
Modification

12.2(33)SXI4

2

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.

12.2(50)SE

1

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

12.2(52)SE

2

The activitycheck, allow query 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

2

This command was introduced on Catalyst 4500 switches.

12.2(53)SE2

2

This command was introduced on the Catalyst 3750-X and 3560-X switches.

12.2(52)SG

2

The activitycheck, allow query set, and recurrence time-range time-range-name keywords were added on Catalyst 4500 switches.

15.0(1)M2

2

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

15.0(2)SE

2.8

The proxy target, host host, port port, mapping map_name, discovery-interval interval, and protocol protocol keywords were added on the Catalyst 2900, 3500, and 3700 switches. See the Cisco IOS Release Notes for Cisco EnergyWise, EnergyWise Version 2.8 for the specific devices.


Usage Guidelines

Before using the energywise activitycheck command, see the "Activity Check" section.

If you enter the no energywise level command, the domain member does not immediately change the power level to the default. The power level changes when the domain member 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 "Recurrences" section.

Before you configure the energywise proxy interface configuration commands, you have to configure the energywise proxy mapping map_name word global configuration command.

The community string you configure for an SNMP proxy should match the community string that is configured on the SNMP device. Check with your system administrator about the SNMP device community string.

Examples

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

DomainMember# configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
DomainMember(config)# service password-encryption
DomainMember(config)# energywise domain cisco security shared-secret cisco protocol udp 
port 43440 ip 2.2.4.30
DomainMember(config)# time-range onfirstfloor
DomainMember(config-time-range)# absolute start 0:00 1 August 2009
DomainMember(config-time-range)# periodic weekdays 6:00 
DomainMember(config-time-range)# periodic weekend 9:00
DomainMember(config)# time-range offfirstfloor
DomainMember(config-time-range)# absolute start 0:00 1 August 2009
DomainMember(config-time-range)# periodic weekdays 20:00 
DomainMember(config-time-range)# periodic weekend 18:00
DomainMember(config)# interface gigabitethernet0/3
DomainMember(config-if)# energywise level 10 recurrence importance 70 time-range 
onfirstfloor
DomainMember(config-if)# energywise level 0 recurrence importance 70 time offfirstfloor
DomainMember(config-if)# energywise name floor.1
DomainMember(config-if)# energywise role pc-mgr
DomainMember(config-if)# end

Related Commands

Command
Description

absolute

Sets a specific time and day for a recurring event.

periodic

Sets a weekly time and day for a recurring event.

show energywise

Displays the EnergyWise settings and status.

show energywise domain

Displays the domain to which the domain member or endpoint belongs.

show energywise recurrences

Displays the recurring-event settings and status.

time-range

Assigns a name to the time range for a recurring event.


energywise domain

To enable Cisco EnergyWise on a network device or endpoint, assign it to a domain, set the domain security mode, and set the domain password, use the energywise domain global configuration command. 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-name

Assigns a network device or endpoint 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 space between the characters or symbols.

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

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 domain member or endpoint drops events.

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

(Optional) 0—Uses a plain-text password.

(Optional) 7—Uses a hidden password.

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

For the shared-secret

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

Do not enter an asterisk (*) or a 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 network device or endpoint is not assigned to a domain.

The domain password is not set.

The udp-port-number is 43440.

Command Modes

Global configuration

Command History

Release
First EW Version
Modification

12.2(33)SXI4

2

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.

12.2(50)SE

1

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

12.2(52)SE

2

The secret [0 | 7] password keywords were replaced with the security {ntp-shared-secret | shared-secret} [0 | 7] shared secret keywords on the
Catalyst 3750-E, 3750, 3560-E, 3560, and 2960 switches.

12.2(52)SG

2

This command was introduced on the Catalyst 4500 switches.

12.2(53)SE2

2

This command was introduced on the Catalyst 3750-X and 3560-X switches.

12.2(52)SG

2

The secret [0 | 7] password keywords were replaced with the security {ntp-shared-secret | shared-secret} [0 | 7] shared-secret keywords on Catalyst 4500 switches.

15.0(1)M2

2

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] shared-secret command, the domain member 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.

When configuring a domain, ensure that you set the same security mode (either ntp-shared-secret or shared-secret) for all the domain members.

When using ntp-share-secret in a domain, ensure that the domain members are running NTP to synchronize their clocks. If NTP is not used or the clocks are not synchronized, some domain members may not be discovered.

Examples

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

DomainMember# configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
DomainMember(config)# service password-encryption
DomainMember(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 Cisco EnergyWise settings and status.

show energywise domain

Displays the domain to which the network device or endpoint belongs.


energywise query

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

energywise query analyze domain domain-name

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

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

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

energywise query importance importance {keywords word,word,... | name name} wol mac mac-address [password password | port tcp-port-number [password password]

Syntax Description

analyze domain domain-name

Runs a query to analyze and display information about the domain, including the domain size and the number of members and endpoints.

importance importance

Only domain members or endpoints 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 space between the characters or symbols.

name name

Filters the results based on the name. For wildcards, 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 space between the characters or symbols.

collect {delta | usage}

Displays power-usage information from the domain members and endpoints in watts (W).

delta—Displays 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—Displays the actual power usage.

all

(Optional) Displays EnergyWise devices of all usage types.

timeout timeout

(Optional) Sets the time in seconds that the management station waits for query results.

The range is from 1 to 180. When configuring the timeout, configure a minimum of 6 seconds to display correct output.

consumer

(Optional) Filters the results to display devices that consume power, such as a switch. This is the default usage type.

meter

(Optional) Filters the results to display devices that measure the pass-through power, such as a PDU that sends power from a source to a connected device.

producer

(Optional) Filters the results to display devices that generate power, such as a solar panel.

set level level

Sets the power level of the domain members or endpoints, 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 endpoint.

delta—Displays the delta vector.

usage—Displays the actual power usage.

wol mac mac-address

Filters the results based on the MAC address and powers on only the device with the matching MAC address.

password password

(Optional) Specifies the WoL password configured on the WoL-enabled endpoint. The password must be 6 characters long.

port port-number

(Optional) Specifies the port number on which the WoL-enabled endpoint listens for WoL packets.


Command Default

The timeout value is 6 seconds.

The port-number is 7.

The usage type is consumer.

Command Modes

Privileged EXEC

Command History

Release
First EW Version
Modification

12.2(33)SXI4

2

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.

12.2(50)SE

1

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

12.2(52)SE

2

The timeout timeout keywords were added on the Catalyst 3750-E, 3750, 3560-E, 3560, and 2960 switches.

12.2(52)SG

2

This command was introduced on the Catalyst 4500 switches.

12.2(53)SE2

2

This command was introduced on the Catalyst 3750-X and 3560-X switches.

12.2(52)SG

2

The timeout timeout keywords were added on the Catalyst 4500 switches.

12.2(55)SE

2.6

The default timeout value was changed from 3 seconds to 6 seconds.

12.2(58)SE

2.7

The wol mac mac-address, port port-number, password password, analyze domain domain-name keywords were added on the Catalyst 3750-X, 3750-E, 3750, 3560-X, 3560-E, 3560, and 2960 switches.

15.0(1)M2

2

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


Usage Guidelines


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

If the timeout value in the energywise query importance privileged EXEC command is too short, the management station does not receive query results when the domain members and endpoints respond to the query. For example, if you want to power off a specific phone but the timeout value in the energywise query importance command is too short, the phone is not powered off. When configuring the timeout, configure a minimum of 6 seconds to display correct output.

Do not run a query with keywords *. No results are generated.

When sending a WoL magic packet, if you do not know where the device is located, use the energywise query importance 100 name * wol mac mac-address command to send the packet to all domain members.

Examples

These examples show how to filter with the name.

DomainMember# 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
 
   
DomainMember# 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
 
   
DomainMember# 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
DomainMember# 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.

DomainMember# 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 endpoints.

DomainMember# 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
 
   
DomainMember# 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.

DomainMember(config)# interface gigabitethernet0/2
DomainMember(config-if)# energywise keywords lobby,sattelite
DomainMember(config-if)# energywise keywords public
DomainMember(config-if)# end
DomainMember# 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
 
   
DomainMember# 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
 
   
DomainMember# 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
 
   

This example shows how to send a directed WoL magic packet:

Queried:  148    Responded:  148      Time:  5.119 seconds
DomainMember# energywise query importance 100 keyword PC wol mac 0123.4567.89ab
EnergyWise query, timeout is 6 seconds:
Success rate is (1/1) setting entities
Queried:  1    Responded:  1      Time:  4.31 seconds
 
   

show energywise

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

show energywise [categories | children [provisioned] | domain | events | level [children | current [children] | delta [children] ] | neighbors | proxies | recurrences | statistics | usage [children] | version]

Syntax Description

categories

(Optional) Displays the power levels.

children [provisioned]

(Optional) Displays the status of the connected endpoint.

provisioned—Displays a summary of the EnergyWise information for the domain member and the connected endpoints.

domain

(Optional) Displays the 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 endpoints.

current—Actual power levels for the domain member.

(Optional) children—Actual power levels for the domain member and connected endpoints.

delta—Delta vector for the domain member.

(Optional) children—Delta vector for the domain member and connected endpoints.

neighbors

(Optional) Displays the neighbor table for the domain member.

proxies

(Optional) Displays all the interfaces on which you have configured an SNMP proxy.

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.

childrenDisplays the actual power for the domain member and connected endpoints.

version

(Optional) Displays the EnergyWise version.


Command Modes

Privileged EXEC

Command History

Release
First EW Version
Modification

12.2(33)SXI4

2

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.

12.2(50)SE

1

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

12.2(52)SE

2

The children provisioned keywords were added on the Catalyst 3750-E, 3750, 3560-E, 3560, and 2960 switches.

12.2(52)SG

2

This command was introduced on the Catalyst 4500 switches.

12.2(53)SE2

2

This command was introduced on the Catalyst 3750-X and 3560-X switches.

12.2(52)SG

2

The children provisioned keywords were added on the Catalyst 4500 switches.

15.0(1)M2

2

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

15.0(2)SE

2.8

The proxies keyword was added on the Catalyst 2900, 3500, and 3700 switches. See the Cisco IOS Release Notes for Cisco EnergyWise, EnergyWise Version 2.8 for the specific devices.


Examples

DomainMember# show energywise
Module/Interface   Role              Name           Usage      Category  Lvl   Imp  Type
       ---------   ----              ----           -----      --------  ---   ---  ----
                   WS-C3560G-48PS    NRGYZ-TB-09    130.0 (W)  consumer  10    1    module
 
   

Table 3-1 show energywise Field Descriptions

Character
Description

Module/ Interface

Module or interface ID

Role

Domain member role

Name

Domain member name

Usage

Power usage in watts (W)

Category

Domain member usage type

Lvl

Domain member power level

Imp

Domain member importance value

Type

Domain member device type


DomainMember# show energywise children 
Module/Interface   Role              Name                  Usage      Category  Lvl   Imp  Type
---------          ----              ----                  -----      --------  ---   ---  ----
                  WS-C3560G-48PS    NRGYZ-TB-11           130.0 (W)  consumer  10    1    parent
Gi0/1             Endpoint          saturn-lnx1           100.0 (W)  consumer  10    1    endpoint
Gi0/5             IP Phone 7960     SEP0003E3864795       6.3   (W)  consumer  10    1    PoE
Gi0/11            IP Phone 7970     SEP00192FB9CAA5       6.3   (W)  consumer  10    1    PoE
Gi0/12            Xerox WorkCentre  Printer_Floor1_Lobby  300.0 (W)  consumer  10    1    proxy
Subtotals: (Consumer: 542.6 (W), Meter: 0.0 (W), Producer: 0.0 (W))
Total: 542.6 (W), Count: 5
 
   
DomainMember# show energywise children provisioned
Module/Interface   Role              Name                  Usage      Category  Lvl   Imp  Type
       ---------   ----              ----                  -----      --------  ---   ---  ----
                   WS-C3560G-48PS    NRGYZ-TB-09           130.0 (W)  consumer  10    1    module
       Gi0/1       interface         Gi0.1                 0.0   (W)  consumer  10    1    PoE
       Gi0/2       interface         Gi0.2                 0.0   (W)  consumer  10    1    PoE
       Gi0/3       interface         Gi0.3                 0.0   (W)  consumer  10    1    PoE
       Gi0/4       interface         Gi0.4                 0.0   (W)  consumer  10    1    PoE
       Gi0/5       interface         Gi0.5                 0.0   (W)  consumer  10    1    PoE
       Gi0/6       interface         Gi0.6                 0.0   (W)  consumer  10    1    PoE
       Gi0/7       interface         Gi0.7                 0.0   (W)  consumer  10    1    PoE
       Gi0/8       interface         Gi0.8                 0.0   (W)  consumer  10    1    PoE
       Gi0/9       interface         Gi0.9                 0.0   (W)  consumer  10    1    PoE
<output truncated>
Total Displayed: 48     Usage: 145.3
 
   
DomainMember# show energywise domain 
Name      : Manager-1
Domain    : cisco
Protocol  : udp
IP        : 2.2.2.21
Port      : 43440
 
   

Table 3-2 show energywise domain Field Descriptions

Character
Description

Name

Domain member name

Domain

Domain name

Protocol

Communication protocol

IP

IP address

Port

Port that communicates with the domain


DomainMember# show energywise events 
--------------------------------------------
Sequence:  343550446   Priority:  100   References:  0:1   Errors:
Class:     PN_CLASS_DISCOVERY
Action:    PN_ACTION_CPQR_POWERNET_DISCOVERY_DISCOVERY_UPDATE
Reply To:  2.2.2.10:43440
--------------------------------------------
Sequence:  345394888   Priority:  100   References:  0:1   Errors:
Class:     PN_CLASS_DISCOVERY
Action:    PN_ACTION_CPQR_POWERNET_DISCOVERY_DISCOVERY_UPDATE
Reply To:  2.2.2.10:43440
--------------------------------------------
Sequence:  343550449   Priority:  100   References:  0:1   Errors:
Class:     PN_CLASS_DISCOVERY
Action:    PN_ACTION_CPQR_POWERNET_DISCOVERY_DISCOVERY_UPDATE
Reply To:  2.2.2.10:43440
--------------------------------------------
Sequence:  345394889   Priority:  100   References:  0:1   Errors:
Class:     PN_CLASS_DISCOVERY
Action:    PN_ACTION_CPQR_POWERNET_DISCOVERY_DISCOVERY_UPDATE
Reply To:  2.2.2.10:43440
--------------------------------------------
Sequence:  343550450   Priority:  100   References:  0:1   Errors:
Class:     PN_CLASS_DISCOVERY
Action:    PN_ACTION_CPQR_POWERNET_DISCOVERY_DISCOVERY_UPDATE
<output truncated>
 
   

Table 3-3 show energywise events Field Descriptions

Character
Description

Sequence

EnergyWise event sequence number

Class

EnergyWise event class

Action

EnergyWise event action

Reply to

IP address where the event originated


DomainMember# show energywise level  
                                                                 Levels (Watts)
Interface   Name               0      1      2      3      4      5      6      7      8      9      10
---------   ----               --------------------------------------------------------------------------
            NRGYZ-TB-09        0.0    390.0  390.0  390.0  390.0  390.0  390.0  390.0  390.0  390.0 390.0
Gi0/27      SEP001201D75BB9    0.0    15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4
Gi0/41      ap                 0.0    15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4
 
   
DomainMember# show energywise level children
                                                                 Levels (Watts)
Interface   Name               0      1      2      3      4      5      6      7      8      9      10
---------   ----               ------------------------------------------------------------------------
            NRGYZ-TB-09        0.0    390.0  390.0  390.0  390.0  390.0  390.0  390.0  390.0  390.0 90.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       Gi0.2              0.0    15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4
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
Gi0/4       Gi0.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       Gi0.5              0.0    15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4
Gi0/6       Gi0.6              0.0    15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4
Gi0/7       Gi0.7              0.0    15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4
Gi0/8       Gi0.8              0.0    15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4
<output truncated>
 
   
DomainMember# show energywise level current 
Interface   Name                     Level  Value
---------   ----                     -----  -----
            NRGYZ-TB-09              10     390.0 (W)
Gi0/27      SEP001201D75BB9          10     15.4  (W)
Gi0/41      ap                       10     15.4  (W) 
 
   
DomainMember# show energywise level current children
Interface   Name                     Level  Value
---------   ----                     -----  -----
            NRGYZ-TB-09              10     390.0 (W)
Gi0/1       Gi0.1                    10     15.4  (W)
Gi0/2       Gi0.2                    10     15.4  (W)
Gi0/3       Gi0.3                    10     15.4  (W)
Gi0/4       Gi0.4                    10     15.4  (W)
Gi0/5       Gi0.5                    10     15.4  (W)
Gi0/6       Gi0.6                    10     15.4  (W)
Gi0/7       Gi0.7                    10     15.4  (W)
Gi0/8       Gi0.8                    10     15.4  (W)
Gi0/9       Gi0.9                    10     15.4  (W)
Gi0/10      Gi0.10                   10     15.4  (W)
<output truncated>
 
   
DomainMember# show energywise level delta 
                                                                   Levels (Watts)
 
   
Interface   Name                     0      1      2      3      4      5      6      7      8      9      10
---------   ----                     ------------------------------------------------------------------------            
NRGYZ-TB-09                       -130.0 260.0  260.0  260.0  260.0  260.0  260.0  260.0  260.0  260.0  260.0 
Gi0/27      SEP001201D75BB9          -6.3   9.1    9.1    9.1    9.1    9.1    9.1    9.1    9.1    9.1   9.1
Gi0/41      ap                       -9.0   6.4    6.4    6.4    6.4    6.4    6.4    6.4    6.4    6.4   6.4
 
   
DomainMember# show energywise level delta children
                                                                   Levels (Watts) 
Interface   Name                     0      1      2      3      4      5      6      7      8      9      10
---------   ----                   --------------------------------------------------------------------------
            NRGYZ-TB-09            -130.0 260.0  260.0  260.0  260.0  260.0  260.0  260.0  260.0  260.0 260.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       Gi0.2                   0.0    15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4  15.4
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
Gi0/4       Gi0.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       Gi0.5                   0.0    15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4  15.4
Gi0/6       Gi0.6                   0.0    15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4  15.4
Gi0/7       Gi0.7                   0.0    15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4  15.4
Gi0/8       Gi0.8                   0.0    15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4   15.4  15.4
<output truncated>
 
   
DomainMember# 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 
 
   

Table 3-4 show energywise neighbors Field Descriptions

Character
Description

Id

Neighbor ID

Neighbor Name

Neighboring domain member name

Ip: Port

Neighbor IP address and port

Prot

Protocol that the neighbor was discovered on

Capability

See device capability codes


DomainMember# show energywise proxies
Interface  Host                Role             Name                  Protocol     Mapping
---------  -----               ----             ----                  --------     ------
Gi0/12     2.2.2.11:161        Xerox Workcentre Printer_Floor1_Lobby  snmp v2c     Xerox 
Gi0/13     2.2.2.12:161        Xerox Workcentre Printer_Floor2_Lobby  snmp v2c     Xerox
Gi0/14     2.2.2.20:161        Ricoh            Printer_Floor3_Lobby  snmp v2c     Ricoh
 
   

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

DomainMember# show energywise recurrences 
Id     Interface  Class Action Lvl Cron/Time-range
--     ---------  ----- ------ --- ---------------
1      Gi0/1      QUERY SET    10  minutes: 34 hour: 6 day: * month: * weekday:*
 
   

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

DomainMember# show energywise recurrences 
Id     Addr       Class Action Lvl Cron/Time-range
--     ----       ----- ------ --- ---------------
1      Gi0/1      QUERY SET    10  tt-range
2      Gi0/2      QUERY SET    10  periodicdaily
4      Gi0/3      QUERY SET    10  absolutestart06:34**2009
 
   

Table 3-5 show energywise recurrences Field Descriptions

Character
Description

Id

Recurrence ID

Addr

Recurrence configuration interface

Class

Recurring event class

Action

Recurring event action

Lvl

EnergyWise level set by recurring event

Cron/ Time-range

Recurring event in cron format/ Recurring event time-range name


DomainMember# show energywise statistics
Children:  2  Errors:  0  Drops:  3  Events:  3256
 
   
DomainMember# show energywise usage 
Interface   Name                     Usage      Category  Caliber
---------   ----                     -----      --------  -------
            NRGYZ-TB-09              130.0(W)   consumer  max
Gi0/27      SEP001201D75BB9          6.3  (W)   consumer  trusted
Gi0/41      ap                       9.0  (W)   consumer  trusted
 
   
Total Displayed: 3      Usage: 145.3
 
   

Table 3-6 show energywise usage Field Descriptions

Character
Description

Interface

Interface ID

Name

Domain member name

Usage

Power usage in watts (W)

Category

Domain member usage type

Caliber

Power usage caliber


DomainMember# show energywise usage child
Interface   Name                     Usage      Category  Caliber
---------   ----                     -----      --------  -------
            NRGYZ-TB-09              130.0(W)   consumer  max
Gi0/1       Gi0.1                    0.0  (W)   consumer  presumed
Gi0/2       Gi0.2                    0.0  (W)   consumer  presumed
Gi0/3       Gi0.3                    0.0  (W)   consumer  presumed
Gi0/4       Gi0.4                    0.0  (W)   consumer  presumed
Gi0/5       Gi0.5                    0.0  (W)   consumer  presumed
Gi0/6       Gi0.6                    0.0  (W)   consumer  presumed
Gi0/7       Gi0.7                    0.0  (W)   consumer  presumed
Gi0/8       Gi0.8                    0.0  (W)   consumer  presumed
Gi0/9       Gi0.9                    0.0  (W)   consumer  presumed
<output truncated>
Total Displayed: 48     Usage: 145.3
 
   
DomainMember# show energywise version   
EnergyWise is Enabled
IOS Version:  12.2(n)xx
EnergyWise Specification: (rel2_7)n.0.n

Related Commands

Command
Description

energywise (global configuration)

Enables and configures EnergyWise on the domain member.

energywise (interface configuration)

Configures EnergyWise on the PoE port.


snmp-server enable traps energywise

To enable the domain member to send Simple Network Management Protocol (SNMP) notifications for EnergyWise traps or inform the network management system (NMS) of requests, use the snmp-server enable traps energywise global configuration command. 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 [event-occured] [level-change] [neighbor-added] [neighbor-deleted]

Syntax Description

event-occured

(Optional) Enables EnergyWise event traps.

level-change

(Optional) Enables EnergyWise power-level change traps.

neighbor-added

(Optional) Enables EnergyWise traps when neighbors are added.

neighbor-deleted

(Optional) Enables EnergyWise traps when neighbors are removed.


Command Default

The sending of EnergyWise traps is disabled.

Command Modes

Global configuration

Command History

Release
First EW Version
Modification

12.2(33)SXI4

2

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.

12.2(50)SE

1

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

12.2(52)SG

2

This command was introduced on the Catalyst 4500 switches.

12.2(53)SE2

2

This command was introduced on the Catalyst 3750-X and 3560-X switches.

15.0(1)M2

2

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 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 enable the EnergyWise domain member to send traps to the NMS:

DomainMember(config)# snmp-server enable traps energywise
 
   

To enable the EnergyWise domain member to send only event traps to the NMS:

DomainMember(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.