Applying command set groups

You can apply a command set group in different ways. A command set group can be selected and applied to one or more network devices. One or more network devices can be selected, and then a command set group can be applied. Also multiple command set groups can be applied to multiple network devices. In addition, one or more command set groups can be applied to a realm.

1. Navigate to the Resource Browser, and highlight the command set group from the listing of network resources.
2. From the menu bar, select Tools > Apply Command Set Group.
3. When the Apply Command Set Groups window is displayed, choose the command set groups required using the Add/Remove buttons in between the panels. The Move Up and Move Down buttons are used for prioritizing the order in which the command set groups are applied.
4. When you have selected all required command set groups, select Next to proceed.
5. The Scope of Application dialog displays. Using the following table as a guide, enter the appropriate information requested.

   Table 1. Scope of Application dialog

   Selection	Description
   Apply the Command Set Group(s) to Network Resources in a Realm	Will apply the command set group(s) to all network resources in the realm selected.
   Apply the Command Set Group(s) to specific Network Resources	Will apply the command set group(s) only to the specific network resources chosen.
   Apply the Command Set Group(s) to the Network Resources retrieved from a Realm	Will apply the command set group(s) to all network resources in the retrieved realm.

6. When done, select Next to display the second part of the Scope of Application window. Select the realm name/network resources as applicable to the choice made in the previous window. This filters devices based on their support level, for example to display SmartModel only. Units of Work can also be filtered by Name or VTMOS as required. However, this is an optional step. Wildcards are in place by default to retrieve all possibilities. Click Next to proceed.
7. The Configure Execution Options dialog displays. Using the following table as a guide, please enter the appropriate information requested.

   Table 2. Configure Execution Options dialog

   Element		Description
   Execution Mode
   Execute Mode		Applies command set group to selected network resources.
   Report Only Mode		Does not change resources, but produces a report detailing the changes that would be made to those resources if in execute mode. Note: The Report Only mode does not apply to native command sets.
   Apply Device at a time		Applies all command set groups to one individual device at a time.
   Apply Command Set Group at a time		Applies one command set group at a time to a resource.
   Pre-Emptive Compliance Options Note: These options are only available if the user is a member of a group with Pre-Emptive compliance activities. Pre-emptive options are only available for Modeled command sets.
   Enable Pre-Emptive Compliance Checks		When in Execute mode all Pre-emptive modes are available. However if the user has selected Report Only execution mode, then report only pre-emptive mode is automatically selected. If the user has ‘Manage Work' rights they will be able to disable Pre-emptive Compliance checks by deselecting the check box. Users who do not have 'Manage Work' rights will not be able to modify pre-emptive settings.
   Block Configuration Change if projected configuration contains compliance failures		Policy is run against the current and projected configuration to determine if a violation is present. If a violation is found, the configuration change is blocked.
   Block Configuration Change if projected configuration contains new compliance failures only		If a compliance violation is found within the projected configuration and the current configuration has no violations then the configuration change will be blocked. If both projected and current configurations have failures then the configuration change will not be blocked and changes will be made to the device.
   Report Compliance Failure(s) only (Configuration change will not be blocked)		Produces a report providing information on violations in both the current and projected configuration. Pre-Emptive failures are ignored and the command set group continues to execute.
   Command set groups		This lists the command set groups that will be rolled back.

8. Select Next to proceed. If Execute Mode has been chosen, the Rollback Options window will be displayed. Otherwise, the wizard skips ahead to the Enter Parameters window.
9. If the Rollback Options window displays, use the following table as a guide to enter the appropriate information. A Rollback can be requested in the event that a command set group fails. The Rollback can be carried out for a single command set group, or multiple command set groups.

   Table 3. Rollback Options fields

   Field	Definition
   How should Rollbacks on command set group failures be handled?
   No Rollback	Select this to turn off the rollback option.
   Use Modeled Rollback	This option will enable a rollback to a modeled configuration.
   Reload the configuration and reboot the device	This option will load the original configuration and reboot the device.
   Check here to have Rollbacks verified	Select this checkbox to enable rollback verification.
   How should Rollbacks be done for each Network Resource?
   Rollback only the failed command set group on the failed Network Resource	This option rolls back only that command set group that failed.
   Rollback all command set groups on the failed Network Resources	This option rolls back all command set groups on the failed resource.

10. When done, select Next to proceed.
    If parameters are detected in the command sets in the group, the Enter Parameters window is displayed.
11. If parameters are present, enter a value for each parameter.
12. When done, select Next to proceed.
13. The Password Override window displays. Using the following table as a guide, please enter the appropriate information requested.

    Table 4. Password Override fields

    Field	Definition
    Override ITNCM Authentication	Select this check box to override the default authentication information.
    Login Name	Provide the login name for the device you are accessing.
    Password	Provide the password for the device you are accessing.
    Enable Password	Provide the device enable password for the device you are accessing.
    Only Use This Authentication	Select this check box if you will always use this authentication for your resource.

14. The Execution Priority window displays. By default all UOWs are submitted with a priority of Medium. Select the priority required and click Next .
15. The Schedule Work window displays. If you select Immediate, the Describe Work window will be displayed. If you select Scheduled or Recurring Schedule, use the information in the following table to make the rest of your selections in the Schedule Work window.

    Table 5. Schedule Work options

    Option	Definition
    Scheduled	The job will run at a specific time, based on the values entered for Scheduled Start and Scheduled End.
    Hourly	Use this option to specify that the process should run each hour, or every n hours after the scheduled start time, for example, Every 3 hours after Scheduled Start.
    Daily	Use this option to specify that the process should run every n days, for example, Every 5 days, or else every weekday (Monday - Friday).
    Weekly	Use this option to specify that the process should run every n weeks on a specific day of the week, for example, Every 3 weeks on a Monday.
    Monthly	Use this option to specify that the process should run on a specific day of every n months, for example, Day 30 of every 6 months. Or, you can specify that the process runs on a relative day of every month, for example, The First Monday of every 3 months.
    Yearly	Use this option to specify that the process runs on a specific day and month of every year, for example, Every January 1st. Or, you can specify that the process should run on a relative day of the week of a specific month, for example, The First Monday of January
    Scheduled Start	Enter the scheduled start time and date.
    Scheduled End	Enter the scheduled end time and date.
    Next Execution	Enter the time and date for the next execution.
    Window Size	Use the drop-down lists to indicate the window size.
    Every n hours after Scheduled Start	Choose the number of hours from the drop-down list.
    Every n days	Choose the number of days from the drop-down list.
    Every Weekday	The job will run every weekday.
    Recur every n weeks	Choose the number of weeks from the drop-down list and select the appropriate day.
    Day n of every n months	Choose the number of days and months from the drop-down lists.
    The specific day of every n month	Choose the specific day and month from the drop-down lists.
    Every specific date	Choose the month and day from the drop-down lists.
    The specific day of every n month	Choose the specific day and month from the drop-down lists.

16. The Describe Work window displays. Enter a description for the UOW, and then click Finish.