mandatory

Enables mandatory Application Visibility Control (AVC) statistics reporting for a specified application group. When configured, the RF Domain manager reports usage stats for applications, in the specified group, to the on-premise, Extreme NSight server. By default, only the top-ten applications by usage are reported. This option allows you to configure mandatory stats reporting for applications that are not in the top-ten list.

To enable mandatory stats reporting for an application or set of applications, create an application group, add the desired application(s) and enable mandatory stats reporting for the group.

The RF Domain manager reports only the top-ten applications, by usage, to the Extreme NSight server. However, if you enable mandatory application stats reporting, applications that are not in the top-ten, most-used applications list are included in the report. This is done by dropping some of the top-ten applications. For example, if mandatory application reporting is enabled for five (5) applications, the report will contain these 5 applications, plus first 5 of the top-ten, most-used applications identified by the system. Thereby totaling the number to ten.

AVC and statistics reporting is available on both the WiNG 5.9.X and WiNG 7.1.X operating systems. However, the DPI engine used to check the data points varies. The WiNG 7.1.2 OS uses EAA (Extreme Application Analytics), formerly known as Purview™, and WiNG 5.9.X uses a third-party DPI engine. Consequently, the configuration differs depending on AP type. Refer to the following for configuration details required for WiNG 5.9.X and WiNG 7.1.X APs:

Supported in the following platforms:

  • Service Platforms — NX7500, NX9500, NX9600, VX9000

Syntax

mandatory app stats [app-group|purview-app-group]
mandatory app stats app-group <APP-GROUP-NAME>
mandatory app stats purview-app-group <PURVIEW-APP-GROUP-NAME>

Parameters

mandatory app stats app-group <APP-GROUP-NAME>
mandatory app stats Enables mandatory, app-usage stats reporting for a specified application group
app-group <APP-GROUP-NAME> Specifies the application group for which usage statistics reporting is to be made mandatory. Use this option for the WiNG 5.9.X access points that use a third-party DPI engine for data inspection.
  • <APP-GROUP-NAME> – Specify the application group name.
mandatory app stats purview-app-group <PURVIEW-APP-GROUP-NAME>
mandatory app stats Enables mandatory, app-usage stats reporting for a specified purview application group
app-group <PURVIEW-APP-GROUP-NAME> Specifies the Purview application group for which usage statistics reporting is to be made mandatory. Use this option for the new, 802.11ax, WiNG 7.1.X access points that use the Purview™ DPI engine for data inspection.
  • <PURVIEW-APP-GROUP-NAME> – Specify the Purview application group name.

Example 1: Configuring mandatory, app-usage stats reporting for WiNG 5.9.X APs.

The WiNG 5.9.X APs use a third-party DPI engine. If you have WiNG 5.9.X APs adopted to a WiNG 7.1.X controller, follow the steps below to enable mandatory, app-usage stats reporting:
  1. Create an application-group.
    <CONTROLER>(config)#application-group <APP-GROUP-NAME>
    Example,
    nx9500-6C8809(config)#application-group APPGRP
    1. Specify the target applications for which mandatory stats reporting is to be enabled.
      <CONTROLLER>(config-app-group-APPGRP)#application <APPLICATION-NAME>
      Example,
      nx9500-6C8809(config-app-group-APPGRP)#show context
      application-group APPGRP
       application ChatCube
       application ChatCube_apache
      nx9500-6C8809(config-app-group-APPGRP)#
  2. Create an NSight policy.
    <CONTROLER>(config)#nsight-policy <POLICY-NAME>
    Example,
    nx9500-6C8809(config)#nsight-policy APPGRP
    1. Enable mandatory stats reporting for the application-group created in Step 1.
      nx9500-6C8809(config-nsight-policy-APPGRP)#mandatory app stats app-group APPGRP
    2. Specify the NSight server's IP address or hostname.
      nx9500-6C8809(config-nsight-policy-APPGRP)#server host 1.2.3.4
    3. Enable the NSight policy.
      nx9500-6C8809(config-nsight-policy-APPGRP)#enable
  3. Use the NSight policy created in Step 2 in the AP's RF Domain.
    For example,
    nx9500-6C8809(config-rf-domain-APPGRP)#use nsight-policy APPGRP

Example 2: Configuring mandatory, app-usage stats reporting for the new, WiNG 7.1.X, AP5XX APs.

The WiNG 7.1.X APs use Extreme Networks' Purview™ DPI engine. Follow the steps below to enable mandatory, app-usage stats reporting on these APs:
  1. Create a purview-application-group.
    <CONTROLER>(config)#purview-application-group <APP-GROUP-NAME>
    Example,
    nx9500-6C8809(config)#purview-application-group PURVIEW
    1. Specify the target applications for mandatory stats reporting.
      <CONTROLLER>(config-purview-app-group-PURVIEW)#application <APPLICATION-NAME>
      Example,
      nx9500-6C8809(config-purview-app-group-PURVIEW)#show context
      purview-application-group PURVIEW
       application ChatCube
       application ChatCube_apache
      nx9500-6C8809(config-purview-app-group-PURVIEW)#
      
  2. Create an NSight policy.
    <CONTROLER>(config)#nsight-policy <POLICY-NAME>
    Example,
    nx9500-6C8809(config)#nsight-policy PURVIEW
    1. Enable mandatory stats reporting for the application-group created in Step 1.
      nx9500-6C8809(config-nsight-policy-PURVIEW)#mandatory app stats purview-app-group PURVIEW
    2. Specify the Extreme NSight server's IP address or hostname.
      nx9500-6C8809(config-nsight-policy-PURVIEW)#server host 1.2.3.4 https
    3. Enable the NSight policy.
      nx9500-6C8809(config-nsight-policy-PURVIEW)#enable
  3. Use the NSight policy created in Step 2 in the AP's RF Domain context.
    Example,
    nx9500-6C8809(config-rf-domain-PURVIEW)#use nsight-policy PURVIEW

Example 3: Configuring mandatory, app-usage stats reporting in a mixed deployment of WiNG 5.9.X and WiNG 7.1.X APs.

In a mixed deployment, consisting of WiNG 5.9.X and WiNG 7.1.X APs, adopted to a WiNG 7.1.X controller, follow the steps below:
  1. Place the WiNG 5.9.X and WiNG 7.1.X APs in separate RF Domains, as shown in the following example.
    Example,
    nx9500-6C8809(config)#show adoption timeline
    -----------------------------------------------------------------------------
          AP-NAME    RF-DOMAIN    EVENT      TIME-STAMP        TIME-SINCE-EVENT
    -----------------------------------------------------------------------------
       ap7562-84A224   WiNG5    adopted   2019-05-08 15:56:30   0 days 01:25:56
       ap7532-DF9A4C   WiNG5    adopted   2019-05-08 15:56:30   0 days 01:25:56
        ap505-134038   WiNG7    adopted   2019-05-08 15:56:30   0 days 01:25:56
       ap8432-070235   WiNG5    adopted   2019-05-08 15:56:28   0 days 01:25:58
    ------------------------------------------------------------------------------
    Total number of devices displayed: 4
    nx9500-6C8809(config)#
    Note

    Note

    The WiNG 5.9.X and WiNG 7.1.X APs are placed in the WiNG5 and WiNG7 RF Domains respectively.
  2. Create application groups for the WiNG 5.9.X and WiNG 7.1.X APs.
    • For the WiNG 5.9.X APs, use the application-group command.
      <CONTROLER>(config)#application-group <APP-GROUP-NAME>
      

      Specify the applications for which mandatory, app-usage stats is to be enabled.

      <CONTROLLER>(config-purview-app-group-PURVIEW)#application <APPLICATION-NAME>
      
      Example,
      nx9500-6C8809(config-purview-app-group-WiNG5)#show context
      application-group WiNG5
       application ChatCube
       application ChatCube_apache
      nx9500-6C8809(config-purview-app-group-WiNG5)#
      
    • For WiNG 7.1.X APs, use the purview-application-group command.
      <CONTROLER>(config)#purview-application-group <APP-GROUP-NAME>
      

      Specify the applications for which mandatory, app-usage stats is to be enabled.

      <CONTROLLER>(config-purview-app-group-WiNG7)#application <APPLICATION-NAME>
      
      Example,
      nx9500-6C8809(config-purview-app-group-WiNG7)#show context
      purview-application-group WiNG7
       application ChatCube
       application ChatCube_apache
      nx9500-6C8809(config-purview-app-group-WiNG7)#

  3. Create two NSight policies and enable mandatory, app-usage stats reporting for the application groups created in Step 1.
    • For the WiNG 5.9.X APs:
      Example,
      nx9500-6C8809(config)#nsight-policy WiNG5
      
      1. Enable mandatory stats reporting.
        nx9500-6C8809(config-nsight-policy-WiNG5)#mandatory app stats app-group WiNG5
        
      2. Specify the Extreme NSight server's IP address or hostname.
        nx9500-6C8809(config-nsight-policy-WiNG5)#server host 1.2.3.4 https
        
      3. Enable the NSight policy.
        nx9500-6C8809(config-nsight-policy-WiNG5)#enable
        
    • For the WiNG 7.1.X APs:
      Example,
      nx9500-6C8809(config)#nsight-policy WiNG7
      1. Enable mandatory stats reporting.
        nx9500-6C8809(config-nsight-policy-WiNG7)#mandatory app stats purview-app-group WiNG7
      2. Specify the NSight server's IP address or hostname.
        nx9500-6C8809(config-nsight-policy-WiNG7)#server host 1.2.3.4 https
      3. Enable the NSight policy.
        nx9500-6C8809(config-nsight-policy-WiNG7)#enable
  4. Use the appropriate NSight policy in the WiNG 5.9.X and WiNG 7.1.X AP's RF Domains.
    • For the WiNG 5.9.X APs:
      nx9500-6C8809(config-rf-domain-WiNG5)#use nsight-policy WiNG5
      
    • For the WiNG 7.1.X APs:
      nx9500-6C8809(config-rf-domain-WiNG7)#use nsight-policy WiNG7
      

Related Commands

no (nsight-policy-config-commands) Disables mandatory app-usage statistics reporting