the five different command sections, pre, post, commands, rollback-commands and post-rollback-commands
Config Set Management
import from cli only at this time; view is possible from gui
can list, export, activate and deactivate
Config Push Scheduling
gui or cmdline
limitations for non-admin user, filters cannot be overridden, just refined
limited rescheduling on failure
aborting via gui, or from cli
As mentioned above, config set documents must be imported into opConfig to become active. Configuration sets cannot be deleted (to ensure a valid audit trail), but they can be superseded and optionally disabled and hidden from the GUI.
opconfig-cli.pl provides full config set management, using the functions
disable_configset; As of version 3.0.0, the opConfig GUI only allows to display the newest revision for a config set.
A new revision of a config set automatically starts in "enabled" state, and scheduled operations normally use the highest enabled config set revision. To switch to an earlier revision instead you may disable the unwanted but higher numbered revision; in which case the GUI will no longer show the disabled revision, nor will scheduling of config changes pick this disabled revision.
Scheduling of Configuration Changes
Scheduling of config set applications can be performed both from the GUI as well as using
opconfig-cli.pl. When you schedule a change, you have to provide at least an execution time and a config set (name); optionally you may also provide refinements for device selections, or additional notification recipients. A schedule is immutable once set and can only be removed entirely.
opConfig accepts all common time formats as described on the Supported Time Formats page. These include both absolute time and date formats like the ISO 8601 type "2016-05-20T14:40", as well as very handy relative formats like "
now + 45 minutes" or "
To enter relative formats when scheduling config changes from the GUI you'll have to use the Target Date/Time input field as the Date and Time picker only produces absolute outputs.
If you schedule a change for a time in the past, then the opConfig daemon will execute the operation immediately.
The device filters and notification recipients given in a config set cannot be overruled when scheduling a config change; they can only be refined and extended.
- If you use the Refine Node Selection options in the scheduling GUI, then all candidate devices will have to match both filters from the config set and your refinement filters in order to be targetted.
If your refinements or the config set filters are too strict and don't meet at least a single existing node, the change will not be scheduled and you will see an error message in the scheduling GUI.
- If you add Email Notification recipients when scheduling, then these recipients will be added to recipients from the config set.
Scheduling using the CLI Tool
To perform a configuration change operation from the command line you would be using
opconfig-cli.pl act=push_configset name=<cset name>. Refinements can be given using an explicit list of desired nodes with
nodes=nodeA,nodeB...; extra email recipients can be given with the optional
If you don't provide a target time (with
at=<timespec>), then opconfig-cli will execute the configuration change immediately. With an
at argument in the future, the change will be scheduled for the given date and time.
You may check the list of scheduled jobs using the command
opconfig-cli.pl act=list_queue, and to delete a scheduled (but not yet active) job use the argument
act=remove_queued with the job's id (shown by
Limitations in opConfig 3.0.0
pbs only primed fullly for cisco ios devices, must have config mode prompt and enter/leave macros
no config set editing from the gui, no import or export of csets from the gui eitherAs of version 3.0.0, only one-off scheduling is supported; recurring schedules are planned for a future release.
The shipped phrasebooks are not fully primed for configuration changing for device types other than Cisco IOS; more specifically most other phrasebooks do not have the necessary macros and prompts for handling configuration mode yet.
Within the opConfig GUI, config sets can only be viewed, not edited or imported/exported; A full config set management GUI is planned for the next release.
Config Set Example
This fully functional example config set ships with opConfig 3.0.0 as