Cisco EnergyWise Configuration Guide, EnergyWise Phase 2
Managing Multiple Entities
Downloads: This chapterpdf (PDF - 190.0KB) The complete bookPDF (PDF - 2.52MB) | Feedback

Managing Multiple Entities

Table Of Contents

Managing Multiple Entities

Running Queries

Multiple Switches Connected to Multiple End Points

Using Queries to Manage Power in the Domain

Examples

Querying with the Name Attribute

Querying with Keywords

Querying to Set Power Levels

Setting the Time-Out Value


Managing Multiple Entities


Running Queries

Multiple Switches Connected to Multiple End Points

Using Queries to Manage Power in the Domain

Examples

Running Queries

The management station sending a query receives all the power-usage responses from the EnergyWise domain. The domain members use neighbor relationships to forward the query.

For secure communication, the domain members use a shared secret and send only authenticated queries to the end points.

Figure 2-1 Query Requests and Replies

1

Sends queries and messages to the domain

3

Sends queries and messages from domain members and end points

2

Replies to queries and messages from the domain

4

Replies to queries and messages from domain members and end points


EnergyWise supports these query types:

Collect—Receive power-usage information in W from the domain members and end points.

Save—Save the running configuration of a domain member. Use the energywise allow query save global configuration command.

Set—Change the power level of a domain member or end point in the running configuration.

Sum—Summarize the information from domain members and end points.

You can filter the results with these attributes:

Importance—Rate your devices based on the business or deployment context.

The range is from 1 (least important) to 100 (most important).

The default is 1.

For example, a desk phone has a lower importance than a business-critical emergency phone.

Role—Device function based on the business or deployment context.

Name—Device identity.

Keywords—Device descriptions (other than the name or role).

The query results show entities with importance values less than or equal to the specified value in a query.

Multiple Switches Connected to Multiple End Points

Three switches send queries and messages to the IP phones, access points, IP cameras, and PCs running the end point SDK.

Figure 2-2 Multiple Switches and End Points Scenario

1

Management station

3

End point

2

Domain member

   

Using Queries to Manage Power in the Domain

Beginning in privileged EXEC mode:

 
Command
Purpose

Step 1 

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

or

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

(Optional) Runs a query to display power information for the domain entities.

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.

(Optional) keywords word,word—Filters the results based on one or more keywords.

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

collect {delta | usage}—Displays power-usage information in watts (W) from the domain members and end points.

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.

sum {delta | usage}—Displays the summary of the power-usage information from domain members and end points.

delta—Displays the delta vector.

usage—Displays the actual power usage.

Note In the results with 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.

(Optional) timeout timeout—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 default is 6 seconds. The range is from 1 to 180.

Repeat this step to run another query.

Step 2 

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

(Optional) Runs a query to power on or off the domain members, PoE ports, or end points.


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

importance importance—Filters the results based on the importance value. Only entities with values less than or equal to the specified value appear. The importance range is from 1 to 100.

(Optional) keywords word,word,...Filters the results based on one or more keywords.

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

set level level—Sets the power level of the entities or PoE ports. The range is from 0 to 10.

(Optional) timeout timeout—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 default is 6 seconds. The range is from 1 to 180.

Repeat this step to run another query.

Examples

Querying with the Name Attribute

Querying with Keywords

Querying to Set Power Levels

Setting the Time-Out Value

In these examples, Switch 1 and Switch 2 are in the same domain. The entity called shipping.1 is a PoE port on Switch 1, and the entity called shipping.2 is a PoE port on Switch 2.

Querying with the Name Attribute

To show the power usage of the domain entities with names beginning with shipping and with importance values less than or equal to 80, run this query on Switch 1:

Switch# energywise query importance 80 name shipping.* collect usage
EnergyWise query, timeout is 6 seconds:
 
   
Host              Name                        Usage       Level   Imp
----              ----                        -----       -----   ---
192.168.20.1      shipping.1                  6.3   (W)   10      1
192.168.20.2      shipping.2                  8.5   (W)   10      1
 
   
Queried:  2    Responded:  2      Time:  0.4 seconds
 
   

The first row (shipping.1) is from Switch 1. The second row (shipping.2) is from Switch 2, a neighbor of Switch 1.

Querying with Keywords

To show the power usage of IP phones with different names, different roles, and importance values less than or equal to 80, but all that have the Admin keyword, run this query on Switch 1:

Switch# energywise query importance 80 keyword Admin collect usage
EnergyWise query, timeout is 6 seconds:
 
   
Host              Name                        Usage       Level   Imp
----              ----                        -----       -----   ---
192.168.40.2      shipping.1                  6.3   (W)   10      1
192.168.50.2      orders.1                   10.3   (W)   10      1
192.168.60.3      pc.1                      200.0   (W)    8     75 
 
   
Queried:  3    Responded:  3      Time:  0.5 seconds
 
   

Switch 1 reports two phones connected to Switch 2, a neighbor of Switch 1.

Querying to Set Power Levels

Run these queries on Switch 1 to

Set the power level of the shipping.2 entity to 0:

Switch# energywise query importance 80 name shipping.2 set level 0
 
   

Manually set the power level of the shipping.1 entity and the shipping.2 entity to 0:

Switch# energywise query importance 90 name shipping.* set level 0
 
   

Set the power level of devices that have the keyword Admin to 10:

Switch# energywise query importance 60 keyword Admin set level 10
EnergyWise query, timeout is 6 seconds:
!!!!
Success rate is (2/2) setting entities
 
   
Queried:  2    Responded:  2      Time:  0.15 seconds
 
   

Verify the power levels:

Switch# energywise query importance 85 keyword Admin collect usage
EnergyWise query, timeout is 6 seconds:
 
   
Host              Name                        Usage       Level   Imp
----              ----                        -----       -----   ---
192.168.40.2      shipping.1                  6.3   (W)   10      1
192.168.50.2      orders.1                   10.3   (W)   10      1
192.168.60.3      pc.1                      200.0   (W)    8     85 
 
   
Queried:  3    Responded:  3      Time:  0.9 seconds
 
   

You can also use the show energywise usage privileged EXEC command on Switch 1 and Switch 2 to verify the power levels.

Setting the Time-Out Value

When you use the default timeout value with the energywise query importance importance {keywords word,word, ... | name name} set level level timeout timeout command and you wait more than 6 seconds to receive query results, you should increase the timeout value.

For example, if you set a timeout value of 60 seconds and you wait less than 60 seconds to receive query results, the actual query time appears.

Switch# energywise query importance 90 name * set level 0
EnergyWise query, timeout is 60 seconds:
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!
Success rate is (48/48) setting entities
 
   
Switch# energywise query importance 90 name * collect usage
EnergyWise query, timeout is 60 seconds:
 
   
Host              Name                        Usage       Level   Imp
----              ----                        -----       -----   ---
....
Queried:  48    Responded:  48      Time:  45 seconds