Applying a Configuration Template Bundle

You can use configuration bundles to organize and manage related templates in a hierarchical view, where each top-level template is linked to one or more downstream templates. The feature supports multiple viewing modes and provides top-level actions to apply, monitor, or manage configuration templates efficiently across the network.

Complete the following steps to apply a configuration template bundle:
  1. From the navigation bar, select Templates.
    The Configuration Templates page is displayed.
  2. Select the Bundles tab to view all configuration bundles.
  3. Choose a view mode from the View by drop-down list:
    • View by Venue Type: Displays bundles organized by venue templates.
    • View by Network Type: Displays bundles organized by network templates.
      You can use the Search option to display only the table entries matching the specified template Name for the specified Type; enter a minimum of two characters. You can sort the list by clicking the associated column header.
      Note: Search and sort apply only to top-level templates.
  4. Expand the bundle by clicking the icon next to the template name to view the downstream templates.
  5. Select the radio button next to the Name column.
    Note: Only the top-level template can be selected to apply the configuration bundle.
    If the selected template has a Drift Detected status, the Show Drifts option is displayed next to the Apply Bundle option.
  6. Click Apply Bundle.
    The Apply Templates - Customers sidebar is displayed.
  7. Select one or more customers to apply the selected bundle by clicking the checkboxes.
    The Override Template option is displayed, and the Next button is enabled.
    Apply Templates - Customers

    The Apply Templates - Customers sidebar displays the following details:

    • Customers: Displays the customer names.
    • Status: Displays the status of the customer account (Active or Trial).
    • Address: Displays the customer’s registered address.
    • Template Override Value: Displays whether overrides exist for the template. This table column appears only for Venue Type bundles, not Network Type bundles.

    You can use the Search option to display only the table entries matching the specified Customer; enter a minimum of two characters. You can customize which fields appear in the table by clicking the icon and selecting or deselecting the desired column names. Optionally, you can click Reset to default to have the default subset of columns.

    Click Clear Filters to reset the filters.

    You can sort the list by clicking the associated column header.

  8. (Optional) Click Override Template to create a customer-specific version of the selected venue template.
    The Override Venue Template dialog box is displayed.
    • Enter or update the required details in the Override Venue Template dialog box:
      • Venue Name: Displays the current template name.
      • Description: (Optional) Enter a brief description of the purpose or customization of the override.
      • Tags: (Optional) Enter identifiers for easy search or grouping.
      • Address: Enter or edit the address. Include city and country details. The embedded map automatically updates based on the entered location.
      • Wi-Fi Country Code: This is a read-only field. The country code can only be added when creating a Venue Template. Refer to the RUCKUS One User Guide for configuration details related to adding a venue.

        The Wi-Fi country code defines the Wi-Fi channels and power levels available for access points at the venue. In most cases, it matches the venue’s location and does not need to be changed.

    • Click Add to save the override configuration for the selected customer(s).

      The override details are displayed in the Template Override Value column.

  9. Click Next to open Apply Templates - Confirmation.
    The confirmation dialog displays the selected customers.
    Note: When applying configuration templates, all configurations in the selected templates overwrite the corresponding configurations in the associated venues. For venue templates, ensure that the customer AP firmware matches the template version to avoid compatibility issues. If required, schedule a firmware update for the customer’s APs before applying the template.
  10. Click Apply Template to confirm and deploy the configuration bundle to the selected customers.
    The dialog box disappears and the Bundles tab refreshes.
  11. (Optional) Click Show Drifts to open the Customer Drifts Report sidebar. Alternatively, click the Drift Detected status in the table to view drift details.
    The sidebar displays customers for which configuration drifts are detected and allows you to reapply templates for correction. Refer to Viewing and Syncing Config Template Drifts for more information.
  12. (Optional) Click the number in the Applied To column to open the Applied to EC Tenants sidebar.
    The sidebar displays the customers (tenants) and their associated addresses where the bundle is currently applied.
  13. (Optional) Click Add Template to create a new configuration template. Refer to Adding and Managing Configuration Templates for more information.
  14. (Optional) Click the template Name to view the Template Details.
    The Template Details sidebar is displayed with the following information: Template Name, Type, Drift Status, Enforcement, Created By, Created On, Last Modified, Last Applied, Configuration Details, Active on Networks (if template category is Venues), Active on Venues (if template category is Wi-Fi Network), and Applied To.
    • Drift Status: Displays the current drift status. If a drift is detected, a Drift Detected hyperlink appears. Clicking the hyperlink opens the Drifts Report sidebar. Refer to Viewing and Syncing Config Template Drifts for more information.
    • Configuration Details: The View Configuration hyperlink opens the configuration details page for the selected template and displays all defined parameters and values. When a template is enforced, all fields appear in read-only mode. For non-enforced templates, click Configure to modify editable fields. The View Configuration hyperlink appears only for templates that contain saved configuration data; the hyperlink is inactive when no configuration is available.
      Note: The View Configuration hyperlink is not available for Switch CLI Profile and Switch Regular Profile templates. Its visibility is independent of the enforcement setting.