Run Book / Operations Manual template for modern software systems
A Run Book / Operations Manual template for modern software systems.
There are two main files:
run-book-template.md- the template itself (see below)
run-book-template.mdand designed to be printed at A1 paper size for use in a team situation. The Run Book Dialogue Sheet is based on the work on Dialogue Sheets by Allan Kelly and used with his permission.
run-book-template.mdcontains suggested checks and procedures for most non-trivial software systems that can be used as a template to create a Run Book or System Operation Manual (SOM). Treat the resulting information as a starting point for discussions about operational readiness.
In our experience, most interesting software systems will need engineers to address the majority of the points, if only to confirm that "this section definitely does not apply here" - a valuable realisation. Each section has a description to set the context and explain why it's needed.
You'll likely get the best outcomes from having the software development team own and drive the activities around the Run Book, seeking input from Testers and Ops people to fill in gaps in knowledge. In practice, you'll want to automate many of the checks and procedures (rather than leaving them in a wiki), but remember: discussion, not documentation is where the value lives in Run Book collaboration! See runbookcollab.info for more details.
Have fun! Matthew Skelton & Rob Thatcher
The book Team Guide to Software Operability has a chapter dedicated to the use of Run Book collaboration and the Run Book dialogue sheet, including details of how different teams use these techniques.
Copyright © 2014-2016 Skelton Thatcher Consulting
Licenced under CC BY-SA 4.0
Expect to redesign parts of the software in order to better meet the operational needs outlined in this template!