The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
Each hub site or branch site may have one or more associated devices. The IWAN app provides methods for managing the devices individually, including the Custom Configuration feature, which enables executing batch CLI commands on devices in the network.
Custom Configuration is a mechanism for executing CLI configuration commands on devices within the IWAN network. The feature works similarly to executing a batch file of commands, but operates remotely from the IWAN app. Enter a set of commands (and optionally save them for later use), and select the devices on which to execute the configuration commands. The IWAN app sends the commands to each selected device and then indicates whether execution was successful or not. If the execution is not successful, the feature provides a mechanism for rollback—executing a set of commands to reverse any failed configuration operations.
Note In this release, Custom Configuration is provided as a "beta" feature.
Use the following procedure to enable execution of CLI configuration commands using the Custom Configuration feature.
Step 1 On the site list page, display the Custom Config Status column by clicking the gear icon above the table and selecting Custom Config Status . The column is displayed and the Custom Config button appears above the table.
Use the following procedure to open the Custom Configuration window to create a Custom Configuration CLI batch file, or to execute an existing Custom Configuration, called a template.
Step 1 On the site list page, click the Custom Config button above the table. If the button is not displayed, see Enabling Custom Configuration. The Custom Config page appears.
Step 2 Select an existing custom configuration or click the plus-sign icon ( ) to create a new one.
Step 3 In the Actual pane, enter the CLI commands to execute, similarly to a batch CLI command file. The commands will be executed in configuration mode on the device.
Note The IWAN app does not perform any validation of the entered commands.
Step 4 (Optional) The full set of commands will be executed on all selected devices. To individually enter parameters specific to each device on which the configuration commands are being executed, use a "parameter" value in the CLI command: a dollar sign ($) followed by a parameter name.
When you execute the custom configuration, you will be prompted to enter values for this "parameter" one-by-one for each selected target device. A maximum of 10 parameters may be used.
Step 5 In the Rollback pane, enter the commands to execute in case one or more of the configuration commands in the Actual pane fail to execute correctly. For information about handling failed executions of custom configuration commands, see Handling Failed Custom Configuration Executions.
Step 6 In the Devices pane, select the devices on which to execute the CLI configuration commands.
Step 7 Click Save to save the configuration without executing. Click Deploy to execute the configuration on the specified devices. The site list page opens automatically, enabling you to view the Success or Failure status of execution of the configuration commands.
On the site list page, the Custom Config Status column shows the Success or Failure status of execution of the configuration commands per site.
If execution fails for any device within a site, the Custom Config Status column for the site displays Failure . If a failure occurs, click the Failure link in the Custom Config Status column to display the status of each device within the site. For information about handling failed executions of custom configurations, see Handling Failed Custom Configuration Executions.
Use the following procedure to handle failed Custom Configuration CLI command execution.
Step 1 On the site list page, the Custom Config Status column shows the Success or Failure status of execution of the configuration commands per site. If execution fails for any device within a site, the Custom Config Status column for the site displays Failure . If a failure occurs, click the Failure link in the Custom Config Status column to open a Site Details pop-up.
Step 2 The Site Details pop-up displays the status of each device within the site. For each site with Failure status, the Rollback option is displayed by default. Do one of the following to resolve the failure status for each device:
The Custom Configuration feature has the following limitations: