Adding and Managing a CLI Configuration Template

Using the On-demand CLI configuration feature, you can add a CLI template. The configuration applied using CLI templates gets appended to the existing configuration of the selected switches.

Complete the following steps to add a CLI template.
Note: FastIron CLI commands may be added, modified, or deprecated in any FastIron release version. To ensure that the CLI commands you intend to include in your configuration file are supported, refer to the release-specific RUCKUS FastIron Command Reference Guide and RUCKUS ICX Switches Release Notes documentation supporting the FastIron software release(s) running on your switches.
  1. On the navigation bar, click Wired > Wired Network Profiles > On-Demand CLI Configuration.
    The On-Demand CLI Configuration page is displayed with the following information:
    • CLI Template Name: Displays the name of the CLI template.
    • Switches: Displays the count of switches where the CLI template is applied.
    On-demand CLI Configuration Page
  2. Click Add CLI Template to add a CLI template.
  3. On the Important Notice page, review the information carefully and enter AGREE in the text field to continue. You can optionally utilize the hyperlink to access the published FastIron Command Reference Guide from the RUCKUS Support portal.
    Note: These templates help you define snippets of CLI commands. They can be applied to one or more selected switches which would result in the template configuration getting appended (added) to the existing configuration on the switch.
    Add CLI Template - Important Notice
  4. Click Next.
    The CLI Configuration page is displayed.
    Add CLI Template - CLI Configuration
  5. Enter a name in the Template Name field. The name may consist of up to 64 characters.
  6. (Optional) Enable switches to automatically reboot after applying the configuration by toggling the Reboot the Switches after applying config option to ON. This option is disabled by default.
  7. In the CLI Commands screen, enter the CLI commands you wish to include. You can type the commands, copy and paste the commands, or add the CLI commands by clicking the + icon next to the command name in the CLI Examples sub-tab. Note that when using a command from the CLI Examples list, you must replace any command input field that is enclosed in < > and highlighted in orange with the desired value.
    Alternatively, click Import from file to import a .txt or .csv file that contains CLI commands to the CLI Configuration profile. The file size cannot exceed 2 MB.
  8. Click Next.
    The Switches page is displayed.
    Switches Screen
  9. Click the + icon to expand the desired venues, then select the desired switches.
    Note: All tenant-defined venues are listed, but only venues having assigned, operational switches are expandable and their switches selectable.

    (Optional) To apply this template to all selected switches immediately after finishing its creation, click the Apply the CLI template after adding it toggle switch ON. This option is disabled by default.

  10. Click Next.
    The Summary page is displayed.
    Note: The Selected Switches field can display up to 25 switches.
    Summary Screen
  11. Click Add.
    A confirmation message is displayed indicating that proceeding with this change would result in the configuration getting updated on selected switches.
  12. Review the message and click Proceed.
    The newly created CLI template is added under the On-Demand CLI Configuration sub-tab.
  13. Select the checkbox next to the CLI Template Name to display the Edit and Delete options.
  14. (Optional) Click Edit if you want to modify the CLI template.
    Note: The Summary page shows the Added, Changed, and Removed information only when configuration differences exist. If there are no changes, this information is not displayed. A numeric count appears next to each category, and clicking the count opens the Change Log sidebar, which includes three tabs - Added, Changed, and Removed. Each tab displays the relevant sections and lists the corresponding changes. Since the edit is made to a CLI Template, the CLI configuration preview does not highlight additions, modifications, or deletions using any visual indicators such as strike-through or color highlights.
    Edit CLI Template - Summary Page
  15. (Optional) Click Delete to remove CLI template.

To search for a specific CLI template, enter the partial or full CLI template name in the Search field. All matching CLI templates are displayed.

You can sort the list of CLI templates by CLI template name and switches by clicking the associated column header.