Configuration Template

A Configuration Template is a pre-defined set of settings and parameters that facilitates the efficient setup and deployment of various network and service components.

Overview

Configuration templates are essential for creating instances with the necessary configuration settings for venues, networks, and various profiles, particularly when an MSP-managed EC tenant onboards to RUCKUS One. Configuration Templates streamline the deployment process, ensure consistency, and reduce the potential for configuration errors.

From the MSP web interface, the MSP administrator can create and manage template instances for venues, networks, services, and policies. These configuration templates are utilized during the onboarding process of new tenants, enabling rapid and consistent setup. For example, during the onboarding of an MSP-EC tenant, the MSP administrator can link a pre-existing Network template to the tenant. This template includes all necessary settings such as SSID configurations, security settings, and VLAN assignments.

After this Network template instance is created, the MSP administrator can then proceed to create and link a template for additional services or policies. These might include security policies, quality of service settings, or specific service configurations like Wi-Fi Calling or Guest Portal Services. Finally, a Venue template is created to encompass the overall setup, including Wi-Fi, switch configurations, and DHCP settings.

To ensure consistency and accuracy of configurations, RUCKUS One supports drift detection and synchronization features. RUCKUS One can calculate the configuration differences between an updated MSP config template and the EC instance. If a difference is detected, administrators can review and synchronize the configurations as needed.

An MSP administrator can perform the following actions from the MSP web interface:

  • Adding a Configuration Template: Create and define new templates that can be reused across multiple tenants. These templates can include settings for network configurations, access controls, and service parameters.
  • Applying the Configuration Template: Deploy these templates to MSP-managed EC tenants to generate specific template instances tailored to each tenant's needs.
  • Editing and Deleting a Configuration Template: Modify existing templates to update configurations or remove templates that are no longer needed.
  • Viewing the drift difference details: Review the specific differences between the MSP template and the EC instance configurations.
  • Synchronizing the drift difference: Synchronizes the EC instance configuration with an MSP template to ensure consistency.

From the RUCKUS One web interface for a specific EC tenant account, MSP administrators can perform the following action:

  • Viewing Template Instances: Access and review the associated Venue, Network, Services, or Profile template instances for each customer. This visibility helps in managing and troubleshooting the configurations.

The following Configuration Template types are supported:

  • Venue: Includes Wi-Fi, Switch, and DHCP configurations necessary for setting up the network infrastructure for a physical location.
  • Network: Encompasses settings for different types of network security and access configurations, such as Open, PSK, 802.1x (AAA), DPSK, and Captive Portal.
  • Access Point (AP) Group: Activates the Network configurations for specific AP Group templates used in specific venues and Wi-Fi settings.
  • Switch: Covers configurations for network switches, including settings for Venue-specific requirements and Syslog Server integrations.
  • Policies: Includes configurations for RADIUS Servers, Access Control policies, VLAN Pools, Syslog Server settings, and Rogue AP Detection.
  • Services: Encompasses configurations for specific network services such as DPSK, DHCP for Wi-Fi, Wi-Fi Calling, and Guest Portal Service.

Requirements

Only administrators with Prime Admin and Administrator roles have permission to create, apply, modify, and delete the configuration templates.

Considerations

  • Supported for MSP-EC tenants only.
  • The mDNS and Client Isolation profiles are not supported.
  • Only one instance of a specific template type can be created within a specific MSP-managed tenant.
  • All templates assigned to a specific MSP tenant get deleted when the MSP tenant is deleted.
  • Drift detection and synchronization are supported only for RBAC APIs.
  • The Sync operation synchronizes only the template-related configurations to the MSP-EC tenant.
  • The Sync operation attempts to apply the dependent templates if the MSP-EC tenant does not already have them.
  • If a template has any unknown difference result, the Sync operation will try to synchronize all related configurations.

Best Practices

Set up all the necessary or preferred templates, including their dependencies, such as activating Network template(s) on a Venue template, before applying any of them to an EC tenant.

Prerequisites

This feature has no prerequisites to feature enablement or usage.