Editing Configuration Using MultiEdit on AOS-CX

Edit configuration for one or more switches in the MultiEdit mode. Edit the entire configuration in a familiar looking CLI with syntax checking, colorization, and command completion.

To edit and review switch configuration in the MultiEdit mode, complete the following steps:

  1. In the Network Operations app, select one of the following options:
    • To select a group in the filter:
      1. Set the filter to a group.

        The dashboard context for the group is displayed.

      2. Under Manage, click Devices > Switches.
      3. Click the AOS-CX or Config icon to view the AOS-CX switch configuration dashboard.
    • To select a switch:
      1. Set the filter to Global or a group containing at least one switch.
      2. Under Manage, click Devices > Switches.

        A list of switches is displayed in the List view.

      3. Click an AOS-CX switch under Device Name.

        The dashboard context for the switch is displayed.

      4. Under Manage, click Device.

        The AOS-CX UI configuration page is displayed.

  2. To enable MultiEdit mode, move the MultiEdit toggle switch to the on position.

    The Device-Level Configuration page is displayed with the list of devices displayed in the Devices table.

    At the device level, the Devices table lists only the switch that you have selected. Also, a pop-up is displayed on the bottom-right corner of the page with the options View Config, Edit Config, and Express Config. Go to step 6.

  3. Search for a switch by entering a search query in the Contextual Search Engine field.

    For more information about search queries, see Using Device Search on AOS-CX.

  4. In the Devices table, select one or multiple switches by clicking the corresponding rows.

    A pop-up is displayed on the bottom-right corner of the page with the options View Config, Edit Config, and Express Config.

  5. To edit the configuration of switches, click Edit Config.
    • If you select a single switch, the Edit Configuration page is displayed.
    • If you select multiple switches, the Edit Multi-Device Configuration page is displayed with the following panes:

      • Devices—Lists the selected switch names.

        Select the switches for which you want to edit the configuration by clicking the row corresponding to the switches.

      • Configuration—Displays the aggregate running configuration of all switches.

    In both the pages, the following views are available:

    • Editor View—Displays the aggregate running configuration on the switches in the Configuration pane. Edit the configuration in this view.

      When editing multiple switches, the Devices pane is also displayed. Select the check box for the switches you want to edit. The following features are supported in the Editor View:

      • Configuration that is same across all switches is displayed as normal text.
      • Differences in configuration is displayed as one of the following:
        • Highlighted parameters (in green)—When parameter value differs across switches. Hover over the parameter to view the list of switches that have this parameter.
        • Entire line differences—Entire line differences are displayed by highlighting the lines along with a description mentioning the switch name that has this line in the configuration. When more than one switch contains this line, a summary of the number of switches is displayed. For example, 2/7 is displayed if two out of seven switches that are selected contain this line in the configuration. To view the list of switches, hover over this summary.

        To modify the values of these parameters, right-click the parameter. The Modify Parameters pane is displayed.

        1. If the parameter is already configured on a switch, you can modify the value. Otherwise, N/A is displayed for the value and it cannot be modified.
        2. If you want to apply the same value to all selected switches, select the Set same value for all devices check box.
        3. To save the changes, click Save Changes in the Modify Parameters pane.

          Clicking Save at the bottom of the Editor View discards the changes made in the Modify Parameters pane.

      • Command completion and help text are available by pressing the CTRL+SPACE key combination.

        An inline drop-down is displayed with the available commands or parameters within commands. To insert a command or parameter, select an option and press TAB.

      • Syntax errors are marked (in red) directly under the incorrect text.
      • If a command line is not inserted in the correct position, the line is automatically moved to the correct position in the configuration.

        For example, if the configuration contains information for VLANVirtual Local Area Network. In computer networking, a single Layer 2 network may be partitioned to create multiple distinct broadcast domains, which are mutually isolated so that packets can only pass between them through one or more routers; such a domain is referred to as a Virtual Local Area Network, Virtual LAN, or VLAN. IDs 1 to 3, and you are adding VLAN 4 after VLAN 1 in the configuration, the editor moves the VLAN 4 command line after VLAN 3.

    • Diff View—Displays the difference between changes made in the Editor View and the running configuration on a switch. In this view, two panes, Running and Candidate, are displayed. When viewing details of multiple switches, select a switch from the drop-down.
      • The Running pane displays the running configuration on the switch.
      • The Candidate pane highlights the changes made in the Editor View in addition to displaying the running configuration on the switch. You cannot edit the switch configuration in this view.
  6. Edit the configuration in the Editor View, and click Save.

Configuration Drift Warning in Edit Config

When you edit the configuration of the same AOS-CX switch, in the MultiEdit mode, in two different browser tab sessions, and try to save the configuration one after the other, the following events occur:

  1. The configuration that you save first in the editor in any of the two browser tabs is saved on the switch.
  2. When you try to save the configuration in the editor in the other browser tab, Aruba Central (on-premises) displays a warning that the configuration has been changed outside the current editor.
  3. If you ignore the warning and continue to save the configuration, Aruba Central (on-premises) overwrites the changes saved earlier with the current changes.

If you save any changes in the MultiEdit mode and the changes do not reflect on the switch, check the Audit Trail details for any errors in the configuration sync.