Other Important Information

Feature Support

Cisco IOS XE software is packaged in feature sets that consist of software images that support specific platforms. The feature sets available for a specific platform depend on which Cisco IOS XE software images are included in a release. Each feature set contains a specific set of Cisco IOS XE features.


Caution

Cisco IOS XE images with strong encryption (including, but not limited to 168-bit [3DES] data encryption feature sets) are subject to U.S. government export controls and have limited distribution. Strong encryption images to be installed outside the United States are likely to require an export license. Customer orders may be denied or subject to delay because of U.S. government regulations. When applicable, the purchaser or user must obtain local import and use authorizations for all encryption strengths. Please contact your sales representative or distributor for more information, or send an e-mail to export@cisco.com.

Cisco cBR-8 Routers and Cisco Remote PHY Devices Version Compatibility

The versions of Cisco cBR-8 router and RPD must be compatible. If the versions are not compatible, the RPD remains in the init(gcp) state. The following table provides details of the compatible Cisco cBR-8 and Cisco RPD versions:

Cisco cBR-8 Software Version

Compatible Cisco RPD Software Version

Cisco IOS XE Amsterdam 17.3.1z

Cisco 1x2 / Compact Shelf RPD Software 9.5

Cisco IOS XE Amsterdam 17.3.1x

Cisco 1x2 / Compact Shelf RPD Software 9.1, 9.2, 9.3

Cisco IOS XE Amsterdam 17.3.1w

Cisco 1x2 / Compact Shelf RPD Software 9.1

MIBs

To locate and download MIBs for selected platforms, Cisco IOS XE releases, and feature sets, use Cisco MIB Locator found at the following URL:

https://mibs.cloudapps.cisco.com/ITDIT/MIBS/servlet/index

New and Changed MIB Information in Cisco IOS-XE Amsterdam 17.3.1z

There are no new or updated MIBs in the Cisco IOS XE Amsterdam 17.3.1z release for Cisco cBR-8 series routers.

New and Changed MIB Information in Cisco IOS-XE Amsterdam 17.3.1x

There are no new or updated MIBs in the Cisco IOS XE Amsterdam 17.3.1x release for Cisco cBR-8 series routers.

New and Changed MIB Information in Cisco IOS-XE Amsterdam 17.3.1w

The following new MIBs are supoported in the Cisco IOS XE Amsterdam 17.3.1w release.

Support for docsRphyPtpRpdPortMasterClockStatusGmTable

  • docsRphyPtpRpdPortMasterClockStatusGmClockIdentity

  • docsRphyPtpRpdPortMasterClockStatusGmPriority1

  • docsRphyPtpRpdPortMasterClockStatusGmPriority2

  • docsRphyPtpRpdPortMasterClockStatusGmQualityClass

  • docsRphyPtpRpdPortMasterClockStatusGmQualityAccuracy

  • docsRphyPtpRpdPortMasterClockStatusGmQualityOffset

  • docsRphyPtpRpdPortMasterClockStatusGmStepsRemoved

Platform-Independent Features for Cisco cBR 17.3.1w

The following platform-independent features are available in the Cisco IOS XE Amsterdam 17.3.1 release.

These features are tested by the core team. In addition, where it is specified, the features are tested for Cisco cBR-8 routers.

show platform software status control-processor brief Command

Adds additional CPU utilization information to the show tech output for the active Supervisor cards and all line cards.

Example: 
#show platform software status control-processor brief
Load Average
 Slot  Status  1-Min  5-Min 15-Min
  RP0 Healthy   1.74   1.53   1.41
 SIP1 Healthy  11.00  10.44  10.13
 SIP6 Unknown  21.24  21.15  20.89
 SIP7 Unknown  20.80  20.54  20.60
 SIP8 Healthy  10.51  10.94  11.11
 SIP9 Healthy  11.49  11.21  11.26

Memory (kB)
 Slot  Status    Total     Used (Pct)     Free (Pct) Committed (Pct)
  RP0 Healthy 49196136 16354396 (33%) 32841740 (67%)  16138380 (33%)
 SIP1 Healthy 24648372  8060408 (33%) 16587964 (67%)  21536808 (87%)
 SIP6 Healthy 54592044  8696428 (16%) 45895616 (84%)  23665008 (43%)
 SIP7 Healthy 54592044  8718528 (16%) 45873516 (84%)  23662412 (43%)
 SIP8 Healthy 24648372  7200316 (29%) 17448056 (71%)  23058788 (94%)
 SIP9 Healthy 24648372  8653088 (35%) 15995284 (65%)  23069496 (94%)

CPU Utilization
 Slot  CPU   User System   Nice   Idle    IRQ   SIRQ IOwait
  RP0    0   3.00   2.50   0.00  94.50   0.00   0.00   0.00
         1   2.90   2.20   0.00  94.90   0.00   0.00   0.00
         2  10.80   6.80   0.00  82.40   0.00   0.00   0.00
         3   1.00   1.80   0.00  97.10   0.00   0.10   0.00
         4   1.90   3.10   0.00  91.90   0.00   3.10   0.00
         5   2.40   2.80   0.00  94.80   0.00   0.00   0.00
         6   2.00   1.20   0.00  96.69   0.00   0.10   0.00
         7  12.48   4.59   0.00  82.81   0.00   0.09   0.00
         8   3.10   1.80   0.00  95.00   0.00   0.10   0.00
         9   0.90   1.50   0.00  97.40   0.00   0.20   0.00
        10   0.70   1.00   0.00  98.20   0.00   0.10   0.00
        11   9.79   2.69   0.00  87.51   0.00   0.00   0.00
        12   2.90   2.70   0.00  94.40   0.00   0.00   0.00
        13   4.49   1.09   0.00  94.40   0.00   0.00   0.00
        14   2.09   1.19   0.00  96.20   0.00   0.49   0.00
        15   4.30   0.80   0.00  94.80   0.00   0.10   0.00
…

Memory Garbage Detection for Non-IOSd Processes

The show process memory platform accounting command is enhanced to show additional backtrace information for non-IOSd processes in the system. This backtrace information helps in diagnosing a potential memory leak issue.

Example: 
#show process memory platform accounting
  Hourly Stats

  process        callsite_ID(bytes)  max_diff_bytes  callsite_ID(calls)  max_diff_calls  tracekey                            timestamp(UTC)    
  -------------------------------------------------------------------------------------------------------------------------------------------
  rphyman_rp_0   3093525504          12736552        3093525506          408             1#ea1f8e152bfdd7b892f4772458bef529  2020-09-07 01:37  
…

Backtrace
…

GuestShell Migration to CentOS8

GuestShell is upgraded to CentOS8 in Cisco IOS XE Amsterdam 17.3.1.


Note

If you use GuestShell to run a Python script on the Cisco cBR-8 router, CentOS8 supports only the Python 3.x compatible scripts. For Python 3.x compatibility, update only those scripts that are compatible with legacy Python versions. In addition, command line execution must specify python3. For example guestshell run python3 [file].

gNMI, gNOI, and YANG

The following programmability features are introduced in the core IOS XE Amsterdam 17.3.1 release:

  • gNMI (gRPC Network Management Interface) configuration persistence: Ensures that all successful changes made through the gNMI SET RPC persist after a device restart.

  • gNOI (gRPC Network Operations Interface) certificate management: Enables RPCs to install, rotate, get certificate, revoke certificate, and generate a certificate signing request (CSR).

  • gNOI bootstrapping with certificate service: After installing gNOI certificates, bootstrapping is used to configure or operate a target. gNMI bootstrapping is enabled by using the gnxi-secure-int command and disabled by using the secure-allow-self-signed-trustpoint command.

  • YANG data models: For a list of Cisco IOS XE YANG models available with the core Cisco IOS XE Amsterdam 17.3.1 release, see https://github.com/YangModels/yang/tree/master/vendor/cisco/xe/1731.

Revision statements embedded in the YANG files provide details of the model revisions. The README.md file in the same GitHub location highlights changes that are made in the release.

As specified in the feature configuration guide, these features are officially supported only on the Cisco Catalyst 9x00 Series Switches.

OpenConfig LLDP 0.2.1

OpenConfig LLDP supports the use of vendor-neutral data models to configure and manage the LLDP protocol. This data model defines the configuration and operational state of LLDP protocol. For more details on OpenConfig, see this Cisco blog: https://blogs.cisco.com/sp/openconfig-on-cisco-platforms.

Best Practice Manual of Procedure for Cisco IOS XE Amsterdam 17.3.x Upgrade

See the Upgrading the Cisco cBR Converged Broadband Routers for Cisco IOS XE Amsterdam 17.3.x document at the Install and Upgrade Guides page.

Cisco cBR-8 Documentation References

We recommend that you view the field notices for this release to see if your software or hardware platforms are affected. If you have an account at Cisco.com, you can find the field notices at http://www.cisco.com/en/US/customer/support/tsd_products_field_notice_summary.html.

If you do not have an account at Cisco.com, you can find the field notices at http://www.cisco.com/en/US/support/tsd_products_field_notice_summary.html.


Note

Cisco IOS XE Amsterdam 17.3.x is generally available for field deployment. However, we recommend that you validate and qualify Cisco IOS XE Amsterdam 17.3.x in a limited field trial with your specific network configuration requirements. This process ensures a smoother, faster, and successful field deployment.

For information on Cisco cBR-8, go through the following links: