rConfig - Command Groups

2 mins V8 Pro V6 Core

Note

Please note that the term ‘Categories’ has been updated to ‘Command Groups’ to better reflect their functionality from Version 7.2.0 onwards. It will take some time to fully transition to the new terminology. Until then, ‘Command Group’ will be the primary term, but you may continue to see references to ‘Categories’ in URLs, permission tables, etc.

Note

Command Groups (previously known as Categories) are a crucial construct in rConfig.

All devices added to rConfig must be part of a single Command Group. They can only belong to one. You will use the concept of Command Groups for three primary reasons.

1. Grouping devices for Scheduled Tasks
2. Grouping devices for Compliance jobs
3. Attach your desired show commands to a given category

The last item is the most important. You must add the commands that you will download for a given category. Think about the following scenarios to help you decide the best way to plan your Command Groups, and subsequently commands.

1. You cannot add a Command Group to a device or task unless it has commands attached to it.
2. Command Groups without attached commands will show an error on the Command Groups page as per the screenshot below
3. If you run a manual device config download, either from the UI or the CLI, the commands to be run on that device are based off the commands attached to the command group. See Command Group Design Below
4. Design your Command Groups around your commands, or vice versa, that’s up to you. But design it!

Example Command Group Design

Command Groups	Devices	Commands
Routers	Router1 Router2 Router3	show run show ip route show ip bgp nei
Switches	Switch1 Switch2 Switch3	show run show version show lldp neigh
HP_Edge	HP_Clos_1 HP_Clos_2 HP_Clos_3	show run
CiscoCore	BR_Core_1 US_Core_1 IRE_Core_1	show run show ip route show ip bgp nei show cdp nei show ip bgp

Adding/ Editing Command Groups

Notice the error below when a Command Group does not have any attached commands. You may add commands to a Command Group after the Command Group is created.

Command Groups Error