System Center 2012 Orchestrator - Test & Start RunBooks
In RunBook Designer console, on the top bar you’ll notice three buttons:
http://blogs.technet.com/cfs-file.ashx/__key/communityserver-blogs-components-weblogfiles/00-00-00-79-57-metablogapi/2577.image_5F00_thumb_5F00_23F6BD8C.png
Check Out: To be able to edit an existing RunBook, it must be checked out. The main purpose for that action is to prevent concurrent editing of the same RunBook by different users.
http://blogs.technet.com/cfs-file.ashx/__key/communityserver-blogs-components-weblogfiles/00-00-00-79-57-metablogapi/8446.image_5F00_thumb_5F00_16440184.png
If someone else is already editing RunBook, we will notice a pop-up window informing that someone is already editing RunBook.
Check-In: After we finish editing, we can Check In RunBook and so that all our changes will be committed. And also other users can then edit RunBook.
Undo Check Out: If we click Undo Check Out button when editing the RunBook, all changes we made are reverted.
Testing RunBooks
Before we run Runbooks, we can test it with RunBook Tester and also easily debug each activity or entire RunBook. This is especially helpful for troubleshooting issues. But don’t be confused about terms, RunBook Tester will apply each activity changes to our current environment, that means it will not use a demo or isolated env.
Please also note that tester runs in the currently logged user context. The orchestrator Service account will not be used for testing purposes. So it would be better to open RunBook Tester as Administrator with the high-level security token.
http://blogs.technet.com/cfs-file.ashx/__key/communityserver-blogs-components-weblogfiles/00-00-00-79-57-metablogapi/7853.image_5F00_thumb_5F00_77AA10DA.png
When we click RunBook Tester from the toolbar, Tester starts and loads relevant RunBook
http://blogs.technet.com/cfs-file.ashx/__key/communityserver-blogs-components-weblogfiles/00-00-00-79-57-metablogapi/8400.image_5F00_thumb_5F00_0939FBA6.png
RunBook tester interface consists of five panes;
Run Time Properties: This is one of the mostly used pane. It displays resolved published data items. It’s important because if we use several published items for activities, we may want to see what data is carried between activities. Best way to see them in a clear way is RunBook Tester.
Design Time Properties: Displays design-time information for each activity. This is same with Activity details page.
http://blogs.technet.com/cfs-file.ashx/__key/communityserver-blogs-components-weblogfiles/00-00-00-79-57-metablogapi/6787.image_5F00_thumb_5F00_0C1F3A8C.png
Workspace: Displays active current Runbook. We can set a breakpoint for each activity.
http://blogs.technet.com/cfs-file.ashx/__key/communityserver-blogs-components-weblogfiles/00-00-00-79-57-metablogapi/8400.image_5F00_thumb_5F00_21B97329.png
The breakpoint will be marked with a red round on activity and tester will stop on it.
Log: Displays detailed information for each activity.
http://blogs.technet.com/cfs-file.ashx/__key/communityserver-blogs-components-weblogfiles/00-00-00-79-57-metablogapi/7532.image_5F00_thumb_5F00_459224B6.png
We can expand each entry to show details.
http://blogs.technet.com/cfs-file.ashx/__key/communityserver-blogs-components-weblogfiles/00-00-00-79-57-metablogapi/2234.image_5F00_thumb_5F00_01FA7394.png
Resource Browser: Displays the counters, variables, computer groups, and schedules.
http://blogs.technet.com/cfs-file.ashx/__key/communityserver-blogs-components-weblogfiles/00-00-00-79-57-metablogapi/5270.image_5F00_thumb_5F00_705A62FB.png
We can predefine each of them and make available for all RunBooks.
Computers Groups and global items can be added within Connections Node.
http://blogs.technet.com/cfs-file.ashx/__key/communityserver-blogs-components-weblogfiles/00-00-00-79-57-metablogapi/5850.image_5F00_thumb_5F00_344E2146.png
Let's add a computer set to use it within activities.
http://blogs.technet.com/cfs-file.ashx/__key/communityserver-blogs-components-weblogfiles/00-00-00-79-57-metablogapi/7411.image_5F00_thumb_5F00_509B6366.png
http://blogs.technet.com/cfs-file.ashx/__key/communityserver-blogs-components-weblogfiles/00-00-00-79-57-metablogapi/8883.image_5F00_thumb_5F00_7EC53953.png
Now we can use Computer Group within an activity;
http://blogs.technet.com/cfs-file.ashx/__key/communityserver-blogs-components-weblogfiles/00-00-00-79-57-metablogapi/7433.image_5F00_thumb_5F00_6FCDE46C.png
http://blogs.technet.com/cfs-file.ashx/__key/communityserver-blogs-components-weblogfiles/00-00-00-79-57-metablogapi/5367.image_5F00_thumb_5F00_56A26467.png
http://blogs.technet.com/cfs-file.ashx/__key/communityserver-blogs-components-weblogfiles/00-00-00-79-57-metablogapi/5367.image_5F00_thumb_5F00_603AACD0.png
This activity will be performed for all computers which members of previously created Computer Group.
Starting Test
We can start our test with different options;
http://blogs.technet.com/cfs-file.ashx/__key/communityserver-blogs-components-weblogfiles/00-00-00-79-57-metablogapi/7418.image_5F00_thumb_5F00_15EFF22B.png
Step-Through: Runbook starts with first activity and after completion, it waits for our input. We can click the Step button to move one step forward. So we can view design-time properties for each activity easily.
http://blogs.technet.com/cfs-file.ashx/__key/communityserver-blogs-components-weblogfiles/00-00-00-79-57-metablogapi/6431.image_5F00_thumb_5F00_004593C1.png
Waits for my next click..
Starting RunBooks
To start a RunBook, firstly we must click Check In button to commit changes. Then just navigate related Runbook tab and click Run.
http://blogs.technet.com/cfs-file.ashx/__key/communityserver-blogs-components-weblogfiles/00-00-00-79-57-metablogapi/6431.image_5F00_thumb_5F00_5BF08971.png
To stop, just click the Stop button on the Toolbar. We can track the activity’s success&failure progress on Log Pane;
http://blogs.technet.com/cfs-file.ashx/__key/communityserver-blogs-components-weblogfiles/00-00-00-79-57-metablogapi/1541.image_5F00_thumb_5F00_78A9FE86.png
All related events will be logged under Events Pane;
http://blogs.technet.com/cfs-file.ashx/__key/communityserver-blogs-components-weblogfiles/00-00-00-79-57-metablogapi/6825.image_5F00_thumb_5F00_475B1426.png
Also to track RunBook changes, In the RunBook Designer, select Audit History tab at the bottom and click individual items.
http://blogs.technet.com/cfs-file.ashx/__key/communityserver-blogs-components-weblogfiles/00-00-00-79-57-metablogapi/0160.image_5F00_thumb_5F00_0B4ED271.png
http://blogs.technet.com/cfs-file.ashx/__key/communityserver-blogs-components-weblogfiles/00-00-00-79-57-metablogapi/4774.image_5F00_thumb_5F00_0F0C7741.png
This is important if there are multiple Runbook designer users in your environment. You can track each Runbook change easily within Audit History.