Apply Switch Configuration Profile Changes

You can apply the switch configuration changes to the newly installed or existing RUCKUS ICX switches from the RUCKUS One web interface.
To provide an overview of a feature and its benefits. May require several Concept topics to keep content in short, manageable, and reusable chunks of content.

The intention of this new template is to outline the information that you will need to collect from SMEs and provide to readers.

NOTE: Feature Configuration / Troubleshooting are *not* part of the Feature Concept template. These templates are likely to be part of seperate task/reference templates (to be developed).

General Notes for Concept Topics:
  • Optional sections are to be used with discretion based on the feature characteristics.

Feature Overview

This section is required. Providing detailed and accurate information in the feature overview is crucial as it helps users understand the functionality, benefits, and usage of the feature. Moreover, it ensures consistency in communication across all platforms, enhancing user experience and product perception.
  • What is the name of the feature? (What do users call the feature? If the feature is referred to by an acronym, what is the acronym expansion? What is the formal name to be used in documentation?)
    Note: Typically, the name is used as part of the section titles, such as the overview title and the configuration section titles.
  • Where does the feature fit within our taxonomy? (What are the taxonomy group and sub-group? This information is important for categorizing the feature documentation and incorporating it into the existing document sets.)
  • What standard or standards govern the feature? (Sometimes needed.)
  • Is the feature a new feature or an enhancement to an existing feature?
  • Does the feature replace another feature?
  • What does the feature do? (General description)
  • How does the feature benefit the user?
  • What set of terms do the writer and reader need to know to understand the feature and its use?
  • How does the feature work? (Detailed description, if needed.)

When the Apply profile changes to existing switches option is:

  • Disabled: The switch configuration profile changes are applied to newly installed switches only.
  • Enabled (default): The switch configuration profile changes are applied to both newly installed switches and existing switches.

Requirements

You have two options for setting up configuration profile on your ICX switches:

  • Create a regular switch configuration profile first, define the configuration settings for your switches in a profile, and associate this profile with one or more venues.
  • For the existing ICX switches that are already associated with one or more venues, create a regular switch configuration profile later and apply the profile changes to the switches.
This section is required. Including this section, even when there is no impact, lets SMEs and customers know that the associated information was not forgotten.

If there are no requirements, use the following default wording:

This feature has no special hardware or software requirements for feature enablement or usage.

If there are requirements, include the applicable below points (depending on product line):

  • What releases support the feature?
    Note: Typically, this is not documented in the configuration guides; however, we need to know where to include the information.
  • What hardware models support the feature?
  • Does the feature require specific modules?
  • Does the feature run only on certain ports?
  • Does the feature have special memory requirements?
  • In an integrated system, can the feature be managed or configured from another device? What are the related release and system requirements?
  • Does the feature introduce new user requirements?
  • Does the feature introduce physical or location-based requirements?

Considerations

Consider the following behavior changes:

  • For the newly installed Greenfield ICX switches, when a regular switch configuration profile is created first (before associating the switch with a venue), the profile changes are applied to the switches regardless of whether the Apply profile changes to existing switches option is turned ON or OFF.
    Note: A newly installed Greenfield ICX switch refers to a RUCKUS ICX switch that is new without any configuration (prior to its integration into the production environment).
  • For the newly installed Brownfield ICX switches, when a regular switch configuration profile is created first (before associating the switch with a venue), the profile changes are not applied to the switches regardless of whether the Apply profile changes to existing switches option is turned ON or OFF.
    Note: A newly installed Brownfield ICX switch refers to a RUCKUS ICX switch that has its own pre-existing configuration (prior to its integration into the production environment).
  • When the existing ICX switches are already associated with one or multiple venues and the Apply profile changes to existing switches option is turned ON, the profile changes are applied to the switches; when this option is turned OFF, the profile changes are not applied.
  • While applying the profile changes, if the VLAN setting has port-level override, then the VLAN port settings are not affected.
This section is required. Including this section, even when there is no impact, lets SMEs and customers know that the associated information was not forgotten.

If there are no considerations, use the following default wording:

This feature has no special considerations or limitations pertaining to feature enablement or usage.

If there are considerations, include the applicable below points (depending on product line).

Note: A separate section on Limitations may sometimes be needed.
  • Does the feature replace an existing feature?
  • Does the feature work only with a certain protocol or with a limited set of protocols?
  • Is the feature meant to be used in combination with another feature or a set of features?
  • Is the feature incompatible with any features?
  • What happens when the feature is enabled?
  • What happens when the feature is disabled?
  • Does enabling/disabling the feature enable/disable another feature?
  • What system behavior changes, if any, does the feature introduce?
  • Are performance issues associated with the feature? How can these be mitigated?

Best Practices

This feature has no special recommendations for feature enablement or usage.

This section is required. Including this section, even when there is no impact, lets SMEs and customers know that the associated information was not forgotten.

If there are no best practices (recommendations), use the following default wording:

This feature has no special recommendations for feature enablement or usage.

If there are considerations, include the applicable below points (depending on product line).

  • Brief list of RUCKUS recommendations on product use to optimize performance.

Prerequisites

This feature has no prerequisites to feature enablement or usage.

This section is required. Including this section, even when there is no impact, lets SMEs and customers know that the associated information was not forgotten.

If there are no prerequisites, use the following default wording:

This feature has no prerequisites to feature enablement or usage.

If there are prerequisites, include the applicable below points (depending on product line).

Note: This section is sometimes part of a general overview and sometimes part of a configuration overview.
  • What are the task prerequisites that the user must ensure are met,for configuration? (For example, must you be running certain protocols, or must you configure other features first?)
Parent topic: Adding and Managing a Regular Switch Configuration Profile