Deployment and Administration Guide -

Full Overview -


What is Runbook Commander -

Runbook Commander is a dynamic console extension for Configuration Manager that allows for console initiated execution of Orchestrator Runbooks. Once installed and configured, the Configuration Manager console user will have the ability to right click on a computer, collection, or program and execute one of many predetermined Orchestrator Runbooks against the selected Configuration Manager object. Once executed, a form is dynamically created to reflect in input parameters specified in the target Runbook. The values entered into each parameter control including that of the selected Configuration Manager object (Computer Name, Collection ID, or Program Name) will then be passed to the target Runbook and the Runbook will be executed.

Included with Runbook Commander 2.0 is an application that will aid in the predetermining of what Runbooks to make available to the console extensions. This application will also auto create the appropriate Configuration Manager Console extension XML files. The RBC XML Generator toll will discover all Runbooks from the Orchestrator environment, which meet the prerequisites for execution from Configuration Manager. RBC XML Generator will then allow you to manually pick which of these to include in your custom console extensions and give them a friendly display name. The tool then creates and places the Configuration Manager XML in the appropriate location. Additionally RBC XML Generator will allow you to save off the custom XML for an automated deployment experience.

What is new to version 2 -

Here is a list of the new features to V2.0. Most of the new goodness focuses around the installation experience and platform supportability; however there are a few functional changes as well. Please stay tuned for a second post which will contain the configuration and administration guide.

Support for Configuration Manager 2007 – RBC 2.0 now supports both Configuration Manager 2007 and 2012 Configuration Manager. Additionally when deploying Runbook Commander bundled with pre-created XML files the installer will determine what version on Configuration Manager Console is being used and appropriately stage the XML extensions files.

New XML Generator Tool – RBC requires custom XML files to be created for each environment. These XML files controll which Orchestrator Runbooks are available for execution from the Configuration Manager environment. The new XML Generator tool handles the XML creation for Configuration Manager 2007 and 2012 Configuration Manager. This tool now also allows saving off XML files for use in a pre-staged deployment (see next bullet point). Finally the XML GEN tool has been redesigned for an easier interactive experience.

New Installer – with RBC version 1, the installer basically staged the computer for use with RBC. It was then up to the individual to run the XML generator tool on each machine in order to create the console extension. Alternatively the XML files could have been manually (or scripted) copied to the appropriate location on the target computer. New to version 2, the console extensions XML files can be pre-created and then deployed with RBC allowing for a single and automated installation experience across many computers.

Replace XML Application – RBC 2.0 includes a new application that can be deployed to computers which will replace the console extensions XML. In the situation where new Runbooks need to be added to RBC or old Runbooks need to be removed from RBC, the custom XML would be created using the XML generator tool and then deployed to all machines with the Replace XML application. The replace XML application will appropriately replace the console extension XML and at next launch the Configuration Manager console will be loaded with the updated set of Runbooks.

Console Extensions to the Program Node – RBC Version 1 had support for consoles extensions for devices and collections. I had received a request to add programs which has been completed. I will add more console items as time permits with priority going to those requested.

Drop Down Lists – Added to version 2.0 is the ability to dynamically create drop down lists as parameter values. This will allow the Runbook administrator to provide a list of values on the actual Runbook. These values will then be available from RBC at execution time from the Configuration Manager console. I will detail the creation of these in the soon to complete full documentation.

Fixed IIS Paging Limitation – The Orchestrator Web Service contains a paging mechanism which allows only 50 Rubooks (or other objects) to be retuned at query time. With RBC V1.0 the XML Gen tool would not return all available Runbooks without making modification to the IIS Web Service application settings. The XML GEN 2.0 includes code that gets around the paging feature and will now present all Runbooks at execution time.

Removed Start Menu Shortcuts – As RBC is for the most part initiated from within the Configuration Manager console all start menu shortcuts have been removed. This does mean that if using the XML generator application you will need to navigate to the installation folder and execute directly. This process will be detail in the forthcoming configuration and deployment guide.