Cisco Catalyst 3850 Operating manual

Cisco EnergyWise Cisco IOS Command Reference for Catalyst 3850
Switches, EnergyWise Version 2.8
First Published: June 15, 2014
Americas Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: [phone]
800 553-NETS (6387)
Fax: [phone]
Text Part Number: OL-32343-01

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS,
INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH
THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY,
CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain version
of the UNIX operating system. All rights reserved. Copyright ©1981, Regents of the University of California.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS" WITH ALL FAULTS.
CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT
LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS
HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network
topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional
and coincidental.
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: http://
www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership
relationship between Cisco and any other company. (1110R)
©2014 Cisco Systems, Inc. All rights reserved.

CONTENTS
Preface Preface v
Document Conventions v
Related Documentation vii
Obtaining Documentation and Support on the Cisco Developer Network vii
Obtaining Documentation and Submitting a Service Request viii
CHAPTER 1 EnergyWise Commands 1
clear energywise 2
debug energywise 4
energywise (global configuration) 6
energywise (interface configuration) 10
energywise domain 14
energywise query 17
show energywise 22
snmp-server enable traps energywise 29
Cisco EnergyWise Cisco IOS Command Reference for Catalyst 3850 Switches, EnergyWise Version 2.8
OL-32343-01 iii

Cisco EnergyWise Cisco IOS Command Reference for Catalyst 3850 Switches, EnergyWise Version 2.8
iv OL-32343-01
Contents

Preface
•Document Conventions, page v
•Related Documentation, page vii
•Obtaining Documentation and Support on the Cisco Developer Network, page vii
•Obtaining Documentation and Submitting a Service Request, page viii
Document Conventions
This document uses the following conventions:
DescriptionConvention
Both the ^symbol and Ctrl represent the Control (Ctrl) key on a keyboard. For
example, the key combination ^D or Ctrl-D means that you hold down the Control
key while you press the D key. (Keys are indicated in capital letters but are not
case sensitive.)
^ or Ctrl
Commands and keywords and user-entered text appear in bold font.bold font
Document titles, new or emphasized terms, and arguments for which you supply
values are in italic font.
Italic font
Terminal sessions and information the system displays appear in courier font.Courier font
Bold Courier font indicates text that the user must enter.Bold Courier font
Elements in square brackets are optional.[x]
An ellipsis (three consecutive nonbolded periods without spaces) after a syntax
element indicates that the element can be repeated.
...
A vertical line, called a pipe, indicates a choice within a set of keywords or
arguments.
|
Cisco EnergyWise Cisco IOS Command Reference for Catalyst 3850 Switches, EnergyWise Version 2.8
OL-32343-01 v

DescriptionConvention
Optional alternative keywords are grouped in brackets and separated by vertical
bars.
[x | y]
Required alternative keywords are grouped in braces and separated by vertical
bars.
{x | y}
Nested set of square brackets or braces indicate optional or required choices
within optional or required elements. Braces and a vertical bar within square
brackets indicate a required choice within an optional element.
[x {y | z}]
A nonquoted set of characters. Do not use quotation marks around the string or
the string will include the quotation marks.
string
Nonprinting characters such as passwords are in angle brackets.< >
Default responses to system prompts are in square brackets.[ ]
An exclamation point (!) or a pound sign (#) at the beginning of a line of code
indicates a comment line.
!, #
Reader Alert Conventions
This document may use the following conventions for reader alerts:
Means reader take note. Notes contain helpful suggestions or references to material not covered in the
manual.
Note
Means the following information will help you solve a problem.
Tip
Means reader be careful. In this situation, you might do something that could result in equipment damage
or loss of data.
Caution
Means the described action saves time. You can save time by performing the action described in the
paragraph.
Timesaver
Cisco EnergyWise Cisco IOS Command Reference for Catalyst 3850 Switches, EnergyWise Version 2.8
vi OL-32343-01
Preface
Document Conventions

IMPORTANT SAFETY INSTRUCTIONS
This warning symbol means danger. You are in a situation that could cause bodily injury. Before you
work on any equipment, be aware of the hazards involved with electrical circuitry and be familiar with
standard practices for preventing accidents. Use the statement number provided at the end of each warning
to locate its translation in the translated safety warnings that accompanied this device. Statement 1071
SAVE THESE INSTRUCTIONS
Warning
Related Documentation
See the latest release notes at Cisco IOS Release Notes for Cisco EnergyWise, EnergyWise Version 2.8 for
the following information:
•For the list of devices that EnergyWise supports, see the "Supported Devices" section.
•For Device Manager requirements, see the "System Requirements" section.
•For upgrade information, see the "Downloading Software" section.
For information about the Cisco IOS Release commands, see the Cisco IOS documentation set on Cisco.com.
For initial configuration information, see the "Using Express Setup" section in the getting started guide or the
"Configuring the Switch with the CLI-Based Setup Program" appendix in the hardware installation guide.
For information about how to install your network device, see the hardware installation guide for your device.
For Network Assistant requirements, see Getting Started with Cisco Network Assistant (not orderable but
available on Cisco.com). This guide does not provide detailed information on the GUIs for embedded Device
Manager or for Cisco Network Assistant (hereafter referred to as Network Assistant), which you can use to
manage the domain member. However, the concepts in this guide are applicable for the GUI user. For
information about Device Manager, see the domain member online help.
For cluster requirements, see the release notes for Cisco Network Assistant (not orderable but available on
Cisco.com).
For information about the management application programming interface (MAPI) and endpoint software
development kit (SDK), go to the Cisco Developer Network.
Obtaining Documentation and Support on the Cisco Developer
Network
Cisco EnergyWise development partners can access the Cisco EnergyWise documents, MAPI and SDK
software code, and Cisco IOS software by joining the Cisco Developer Network:http://developer.cisco.com/
web/esdk/home
You need a support contract and license to access Cisco EnergyWise resources on the Cisco Developer Network
and on TAC. The business development manager who registered your licence must set up your Cisco.com
account with the appropriate access privileges.
Cisco EnergyWise Cisco IOS Command Reference for Catalyst 3850 Switches, EnergyWise Version 2.8
OL-32343-01 vii
Preface
Related Documentation

The forum, wiki, and other resources on the Cisco Developer Network provide a self-help knowledge base
and community for Cisco EnergyWise application developers and programmers. You can get additional
support by opening a case in the TAC Service Request Tool:http://tools.cisco.com/ServiceRequestTool/create/
launch.do
Obtaining Documentation and Submitting a Service Request
For information on obtaining documentation, submitting a service request, and gathering additional information,
see the monthly What's New in Cisco Product Documentation, which also lists all new and revised Cisco
technical documentation, at:
http://www.cisco.com/c/en/us/td/docs/general/whatsnew/whatsnew.html
Subscribe to the What's New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed
and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free
service and Cisco currently supports RSS version 2.0.
Cisco EnergyWise Cisco IOS Command Reference for Catalyst 3850 Switches, EnergyWise Version 2.8
viii OL-32343-01
Preface
Obtaining Documentation and Submitting a Service Request

EnergyWise Commands
•clear energywise, page 2
•debug energywise, page 4
•energywise (global configuration), page 6
•energywise (interface configuration), page 10
•energywise domain, page 14
•energywise query, page 17
•show energywise, page 22
•snmp-server enable traps energywise, page 29
Cisco EnergyWise Cisco IOS Command Reference for Catalyst 3850 Switches, EnergyWise Version 2.8
OL-32343-01 1

clear energywise
To delete the discovered domain member neighbors and IP endpoints from the EnergyWise database, use the
clear energywise privileged EXEC command.
clear energywise {endpoints [all |cached ] | neighbors}
Syntax Description 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.
endpoints
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.
neighbors
Command Default None
Command Modes Privileged EXEC
Command History ModificationFirst EW VersionRelease
This command was introduced.2.8Cisco IOS XE 3E
Usage Guidelines To check that you have deleted neighbors and endpoints from the database, use the show energywise neighbors
privileged EXEC command.
If you enter the clear energywise neighbors command, all non static neighbors are cleared and the neighbor
table is updated. If the command is not used and an entry becomes obsolete, the entry is removed only during
the next automatic update, which happens approximately every 30 minutes.
If you statically add a neighbor, the clear energywise neighbors privileged EXEC command does not
affect it.
Note
Cisco EnergyWise Cisco IOS Command Reference for Catalyst 3850 Switches, EnergyWise Version 2.8
2OL-32343-01
EnergyWise Commands
clear energywise

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 DescriptionCommand
Displays EnergyWise settings.show energywise, on page 22
Cisco EnergyWise Cisco IOS Command Reference for Catalyst 3850 Switches, EnergyWise Version 2.8
OL-32343-01 3
EnergyWise Commands
clear energywise

debug energywise
To debug EnergyWise endpoints and management stations, use the debug energywise privileged EXEC
command.
debug energywise{debug| discovery| endpoint| ha| management| packet| query| trace| wol}
Syntax Description Displays errors such as invalid sequence numbers and communication errors on
the domain.
debug
Displays all EnergyWise discovery information.discovery
Displays information about EnergyWise endpoints running a client or agent and
helps detect mismatched domain names, secrets, and sequence numbers of connected
endpoints.
endpoint
Displays EnergyWise high availability (HA) information for devices that have HA
capability.
ha
Displays information about authentication failures and EnergyWise management
stations running power management applications.
management
Displays EnergyWise packet trace information.packet
Displays query information with respect to the device from which the query is
initiated.
query
Displays information about all the EnergyWise processes with respect to the device
from which the query is initiated.
trace
Displays Wake on LAN (WoL) query information with respect to the device from
which the query is initiated.
wol
Command Default EnergyWise debugging is disabled.
Command Modes Privileged EXEC
Command History ModificationFirst EW
Version
Release
This command was introduced.2.8Cisco IOS XE 3E
Cisco EnergyWise Cisco IOS Command Reference for Catalyst 3850 Switches, EnergyWise Version 2.8
4OL-32343-01
EnergyWise Commands
debug energywise

Usage Guidelines Because debugging output is assigned high prioirity in the CPU process, it can render the system unusable.
For this reason, use debug commands only to troubleshoot specific problems or during troubleshooting sessions
with Cisco technical support staff. Use 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.
Examples This example shows how to enable debugging for an EnergyWise query:
DomainMember# debug energywise query
Query debug debugging is on
DomainMember# energywise query importance 100 name sw* set level 1
EnergyWise query, timeout is 6 seconds:
May 19 00:38:28.596: NRGYZ:QUERY:Created query packet, locked CLI (0x77DCB24)!
Success rate is (1/1) setting entities
Queried: 1 Responded: 1 Time: 4.27 seconds
DomainMember#
May 19 00:38:38.624: NRGYZ:QUERY:Set CLI boolean, ready to unlock CLI (0x72238AC)
May 19 00:38:38.624: NRGYZ:QUERY:Unlocked CLI (0x72238AC)
Cisco EnergyWise Cisco IOS Command Reference for Catalyst 3850 Switches, EnergyWise Version 2.8
OL-32343-01 5
EnergyWise Commands
debug energywise

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]
no energywise{allow query| {save| set}| endpoint| importance| keywords| level| management| name|
neighbor| role}
Syntax Description Configures the domain member to respond to queries from
the management station or another domain member.
•save—Responds to a query to save the running
configuration.
•set—Responds to a query to change the power level or
the EnergyWise attributes.
allow query
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 0or 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.
endpoint security
Sets the importance. The range is from 1 to 100.
importance importance
Cisco EnergyWise Cisco IOS Command Reference for Catalyst 3850 Switches, EnergyWise Version 2.8
6OL-32343-01
EnergyWise Commands
energywise (global configuration)

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.
keywords word word ...
Sets the power level. The range is from 0 to 10.
level level
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.
name name
Assigns a static neighbor.
•{hostname |ip address }—You can enter alphanumeric
characters and symbols, such as #, (, $, !, and &.
•udp-port-number—Sends and receives queries. The
range is from 1 to 65000.
neighbor
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.
role role
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 0or 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.
management security shared-secret
Cisco EnergyWise Cisco IOS Command Reference for Catalyst 3850 Switches, EnergyWise Version 2.8
OL-32343-01 7
EnergyWise Commands
energywise (global configuration)

(Optional) Specifies the TCP port for management access.
The port number range is from 1025 to 65535.
port tcp-port-number
Command Default
EnergyWise is disabled by default. When EnergyWise is enabled, these are the defaults if they are not
otherwise configured:
Important
•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 ModificationFirst EW
Version
Release
This command was introduced.2.8Cisco IOS XE 3E
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 by entering the energyWise domain global configuration command,
the switch and all interfaces (PoE or otherwise) are managed through EnergyWise.
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.
Cisco EnergyWise Cisco IOS Command Reference for Catalyst 3850 Switches, EnergyWise Version 2.8
8OL-32343-01
EnergyWise Commands
energywise (global configuration)

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 DescriptionCommand
Displays the EnergyWise settings and status.show energywise, on page 22
Cisco EnergyWise Cisco IOS Command Reference for Catalyst 3850 Switches, EnergyWise Version 2.8
OL-32343-01 9
EnergyWise Commands
energywise (global configuration)

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 ]
no 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 ]
Syntax Description (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.
The domain member cannot determine if the IP phone is in the hold
state.
Note
activitycheck
(Optional) Configures the interface to respond to a query changing the power level
and the EnergyWise attributes if the interface receives a query from the
management station or another domain member.
allow query set
(Optional) Sets the importance of the port. The range is from 1 to 100.
importance importance
(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.
keywords word, word,...
(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.
level level
Cisco EnergyWise Cisco IOS Command Reference for Catalyst 3850 Switches, EnergyWise Version 2.8
10 OL-32343-01
EnergyWise Commands
energywise (interface configuration)

(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 clock) 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 0 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 domain member time.
recurrence importance
importance at minute
hour day_of_month
month day_of_week |
time-range
time-range-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.
name name
(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.
role role
Command Default The following are the default settings or values for the different parameters:
•EnergyWise is disabled.
•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.
Cisco EnergyWise Cisco IOS Command Reference for Catalyst 3850 Switches, EnergyWise Version 2.8
OL-32343-01 11
EnergyWise Commands
energywise (interface configuration)

•The role is the model number.
Command Modes Privileged EXEC
Command History ModificationFirst EW
Version
Release
This command was introduced.2.8Cisco IOS XE 3E
Usage Guidelines If activity check is enabled, 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. Before using the energywise activitycheck command,
see the "Activity Check" section of the EnergyWise configuration guide.
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 to occur 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
"Configuring Recurrences" section of the EnergyWise configuration guide.
When you enter the time-range time-range-name global configuration command, you can configure the
following commands in the time range configuration mode:
•absolute—Sets a specific time and day for a recurring event. Cisco EnergyWise uses only the start time
for this condition. Any configured end times are ignored.
•periodic—Sets a weekly time and day for a recurring event. You must enter a start and end time for this
condition.
For EnergyWise recurrences, set the periodic time to after the absolute start time or do not set the absolute
start time at all. This way the time-range is active only after the first periodic start time. If only the absolute
time-range is configured, the recurring event does not occur.
Cisco EnergyWise Cisco IOS Command Reference for Catalyst 3850 Switches, EnergyWise Version 2.8
12 OL-32343-01
EnergyWise Commands
energywise (interface configuration)