#
# SWR RELEASE NOTES
#
# Copyright (c) 2012-2014, 2016 by Cisco Systems, Inc.
# All rights reserved.
#
#
#
#********************************************************************************

Section 1.  New Features
The following are the new features:

1)  Interface Monitoring

    Raw interface monitoring feature that allows IOS to get interface status 
from Linux such as  Link state, Link Speed, MTU and Duplex. IOS will updates its
own interface to match linux. This feature can be enabled with 
monitor-state option. The SWR also pulls an interface's MAC address from Linux.


2)  SWROPTIONS

    The  SWROPTIONS  file provides a list of user-specified options to the 
SoftWare Router (SWR). When the image is loaded without any options, by default, 
it will check for the SWROPTIONS  file  in the  HOME  directory. The alternate
way to use the SWROPTIONS file is_through command line by using "-o <path>" 
option along with the image name, where <path> is path of the option file. 
The user can specify the required options using the command line also, 
rather than using the SWROPTIONS file. Refer SWROPTIONS.example.txt for more
information.


3)  Password Recovery

    In the case where the customer forgets an "enable" or "enable_secret"
_password, the ability to recover control of the SWR has been provided.
A CLI option is provided that disables 
processing of the startup config. This option is "-x". 


4)  Crashdump
 
    Crashdump provides the ability for the SWR to create a log file in the event
that the SWR crashes.

5)  Rate Limiting Licensing

    Licensing mechanism, which supports performance levels:5, 10, 25, 50, 100 and 200 mbps.
The throughput is rate limited based on the aggregate outbound data rate of all
active SWR interfaces (physical interface, as well as TAP interfaces).


6)  SWR Reload

    swr_reload  is  an  optional  application to reload Cisco's IOS-Linux based 
software router in the event of crash or a manually initiated reload.
This application completely terminates and restarts all processes related to SWR when
a reload is initiated (versus simply starting the SWR process over without 
actually terminating it). The purpose of swr_reload is to launch and reload the 
software router which is specified in the SWROPTIONS file, or through 
command-line options, or from current working directory. Control-C should be
used to exit the swr_reload application.


7)  Intrusion Prevention System

    Cisco Intrusion prevention Systems (IPS) monitors network and/or system 
activities for malicious activity, logs/reports information about the activity, 
and attempts to block the activity.
 

8)  Cisco Unified Call Manager Express

    Cisco Unified Call_Manager Express provides call processing for Cisco 
IP phones for small office or branch office environments. Cisco Unified  
Call Manager Express enables the deployment of a cost_effective, highly reliable 
communications system using a single_Cisco Integrated Services Router using
Cisco IOS Software. Call Manager Express running on the SWR supports up to
20 endpoints.


9)  Filesystem Directory Mapping

    Filesystem mapping feature provides options to map a file-system name in the 
IOS file-name space to a corresponding directory in the Linux filename space.
For each such mapping, it creates an IOS filesystem with the given IOS 
File-system name that provides view into the corresponding Linux directory
(and subdirectories). Refer to SWROPTIONS.example.txt for more information.

10) 802.1q Interfaces MTU Functionality

    When any of the c5921 interfaces are configured to send 802.1q traffic, 
vlan tagged packets with maximum MTU(default Ethernet MTU is 1500) would be 
dropped in linux.  To avoid this, a four -byte buffer space has to be 
introduced between the linux MTU and IOS MTU for dot1q vlan tagging or an 
eight -byte buffer space if it is a QinQ vlan tagging.Hence when a 802.1q 
encapsulation is configured user will be notified with a Warning message to
adjust the Dot1q or QinQ configured sub-interfaces IP MTU to the specified
value to avoid packet drop or to increase the Linux MTU value to avoid packet
fragmentation. Also an Error Message will be given to the user about the
Minimum configurable MTU for Dot1q and QinQ. This Warning/Error message
will be shown on first dot1q/QinQ configuration. Also IOS MTU will be 
limited/capped to 1500 when Linux MTU is configured above 1500 in any case 
irrespective of whether dot1q/qinq is enabled or both disabled in IOS.

11) Push Interface Fields 

    Interface fields such as Speed, Duplex and MAC address can be configured 
and pushed from IOS to Linux. For this push to happen, it should be a 
monitored interface. Hence monitor-state option needs to be enabled. For 
speed and duplex along with monitor-state option, push-mon-int option 
should also need to be enabled. For tap interfaces, speed/duplex CLI's are 
disabled and these interface fields will not be pushed from IOS to Linux. 

#********************************************************************************

Section 2.  Open Caveats
 
 For Open Caveats please refer Release Notes 


#********************************************************************************


Section 3.  Limitations

CSCug45324 c5920: Delimiter Presence in SWROptions filesystem mapping
causing issues 

    In the SWROPTIONS file, when a user is specifying the linux directory with
delimiter with an invalid character, such as a quote: (linux="/opt/cisco/c5921")
it causes tracebacks and error messages.


CSCuc32258  CME/SIP audio-only calls seen on call between 2 video endponts

    A video call on any ESR platform between SIP phones comes up without video
channel. If the receiving phone puts the phone on hold and resumes the call,
the video displays.

Workaround:
Configure asymmetric payload support for dynamic codecs on the voice service:
(conf)# voice service voip
(conf-voi-serv)# sip
(conf-voi-serv)# asymmetric payload dynamic-codecs

