Published On: August 6ᵗʰ, 2019 02:03

Web Services Management Agent Configuration Guide, Cisco IOS XE Release 3S

Web Services Management Agent (WSMA) Enhancements for Wireless Management feature allows you to reduce the reconnecting rates in an outage when device connections to the management server on wireless networks are disconnected unexpectedly. This feature also allows you to implement payload compression to optimize the bandwidth usage.

Finding Feature Information

Your software release may not support all the features documented in this module. For the latest caveats and feature information, see Bug Search Tool and the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the feature information table at the end of this module.

Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/​go/​cfn. An account on Cisco.com is not required.

Restrictions for WSMA Enhancements for Wireless Management

  • Only Web Services Management Agent (WSMA) EXEC response provides compression on demand.
  • WSMA must provide support to all transport protocols including Secure Shell (SSH), Transport Layer Security (TLS), HTTP, HTTPS, and other TCP protocols.
  • WSMA does not use the option to support gzip compression for HTTP.

Information About WSMA Enhancements for Wireless Management

Smart Back-off Reconnect Support

In a network outage, thousands of devices on the same wireless network (for example, Smartgrids) try to reconnect to the Network Management Server (NMS) at the same time. However, only limited number of devices can reconnect successfully on the first reconnect and subsequent retries. This results in high billings of some devices that fail to reconnect.

Web Services Management Agent (WSMA) enhancements for wireless management allows you to reduce the reconnecting rates with smart back-off reconnect policy by enhancing the existing reconnect command.

EXEC Agent–Response Payload Compression Support

The WSMA EXEC Agent enhancement allows you to optimize the payloads on wireless networks whenever possible to optimize bandwidth usage.

A new optional compression XML attribute in the WSMA EXEC request and WSMA EXEC response supports the new response payload compression feature. By default, there is no payload compression if the new compression XML attribute is not specified in the WSMA EXEC request.

How to Configure Smart Back-off Reconnect

Configuring Smart Back-off Reconnect

SUMMARY STEPS

1. enable

2. configure terminal

3. wsma profile initiator profile-name

4. reconnect [pause-time [exponential-backoff-factor [random]]]

5. end


DETAILED STEPS
  Command or Action Purpose
Step 1 enable


Example:
Device> enable
 

Enables privileged EXEC mode.

  • Enter your password if prompted.
 
Step 2 configure terminal


Example:
Device# configure terminal
 

Enters global configuration mode.

 
Step 3 wsma profile initiator profile-name


Example:
Device(config)# wsma profile initiator prof1
 

Creates a service initiator and enters WSMA initiator configuration mode.

 
Step 4 reconnect [pause-time [exponential-backoff-factor [random]]]


Example:
Device(config-wsma-init)# reconnect 130 3 random
 

(Optional) Specifies the time for the WSMA initiator profile to wait before attempting to reconnect a session.

 
Step 5 end


Example:
Device(config-wsma-init)# end
 

Ends the current configuration session and returns you to privileged EXEC mode.

 

Configuration Examples for WSMA Enhancements for Wireless Management

Example: Configuring the Smart Back-off Reconnect

The following example shows how to configure a smart back-off reconnect policy:

Device> enable
Device# configure terminal
Device(config)# wsma profile initiator smartgrid
Device(config-wsma-init)# reconnect 130 4 random
Device(config-wsma-init)# end

Additional References for WSMA Enhancements

Related Documents

Technical Assistance

Description

Link

The Cisco Support and Documentation website provides online resources to download documentation, software, and tools. Use these resources to install and configure the software and to troubleshoot and resolve technical issues with Cisco products and technologies. Access to most tools on the Cisco Support and Documentation website requires a Cisco.com user ID and password.

http:/​/​www.cisco.com/​cisco/​web/​support/​index.html

Feature Information for WSMA Enhancements for Wireless Management

The following table provides release information about the feature or features described in this module. This table lists only the software release that introduced support for a given feature in a given software release train. Unless noted otherwise, subsequent releases of that software release train also support that feature.

Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/​go/​cfn. An account on Cisco.com is not required.

Table 1 Feature Information for Web Services Management Agent

Feature Name

Releases

Feature Information

WSMA Enhancements for Wireless Management

Cisco IOS XE Release 3.11S

Web Services Management Agent (WSMA) Enhancements for Wireless Management feature allows you to reduce the reconnecting rates in an outage when device connections to the management server on wireless networks are disconnected unexpectedly. This feature also allows you to implement payload compression to optimize the bandwidth usage.

The following command was modified: reconnect.