A runbook is a set of instructions describing how to spin up the production environment in the cloud. You can create runbooks in the Acronis Disaster Recovery Cloud service console. To access the Runbooks tab, select Disaster recovery > Runbooks.
Why use runbooks?
Runbooks let you:
- Automate a failover of one or multiple servers
- Automatically check the failover result by pinging the server IP address and checking the connection to the port you specify
- Set the sequence of operations for servers running distributed applications
- Include manual operations in the workflow
- Verify the integrity of your disaster recovery solution, by executing runbooks in the test mode.
Creating a runbook
To start creating a runbook, click Create runbook > Add step > Add action. You can use drag and drop to move actions and steps. Do not forget to give a distinctive name to the runbook. While creating a long runbook, click Save from time to time. Once you are finished, click Close.
Steps and actions
A runbook consists of steps that are executed consecutively. A step consists of actions that start simultaneously. An action may consist of:
- An operation to be performed with a cloud server (Failover server, Start server, Stop server, Failback server). To define this operation, you need to choose the operation, the cloud server, and the operation parameters.
- A manual operation that you need to describe verbally. Once the operation is completed, a user must click the confirmation button to allow the runbook to proceed.
- Execution of another runbook. To define this operation, you need to choose the runbook.
A runbook can include only one execution of a given runbook. For example, if you added the action “execute Runbook A”, you can add the action “execute Runbook B”, but cannot add another action “execute Runbook A”.
All operations with cloud servers have the following parameters:
- Continue if already done (enabled by default)
This parameter defines the runbook behavior when the required operation is already done (for example, a failover has already been performed or a server is already running). When enabled, the runbook issues a warning and proceeds. When disabled, the operation fails and the runbook fails.
- Continue if failed (disabled by default)
This parameter defines the runbook behavior when the required operation fails. When enabled, the runbook issues a warning and proceeds. When disabled, the operation fails and the runbook fails.
You can add completion checks to the Failover server and Start server actions, to ensure that the server is available and provides the necessary services. If any of the checks fail, the action is considered failed.
- Ping IP address
The software will ping the production IP address of the cloud server until the server replies or the timeout expires, whichever comes first.
- Connect to port (443 by default)
The software will try to connect to the cloud server by using its production IP address and the port you specify, until the connection is established or the timeout expires, whichever comes first. This way, you can check if the application that listens on the specified port is running.
The default timeout is 10 minutes. You can change it if you wish.
Operations with runbooks
To access the list of operations, hover on a runbook and click the ellipsis icon. When a runbook is not running, the following operations are available:
Executing a runbook
Every time you click Execute, you are prompted for the execution parameters. These parameters apply to all failover and failback operations included in the runbook. The runbooks specified in the Execute runbook operations inherit these parameters from the main runbook.
- Failover and failback mode
Choose whether you want to run a test failover (by default) or a real (production) failover. The failback mode will correspond to the chosen failover mode.
- Failover recovery point
Choose the most recent recovery point (by default) or select a point in time in the past. If the latter is the case, the recovery points closest before the specified date and time will be selected for each server.
Stopping a runbook execution
During a runbook execution, you can select Stop in the list of operations. The software will complete all of the already started actions except for those that require user interaction.
Viewing the execution history
When you select a runbook on the Runbooks tab, the software displays the runbook details and execution history. Click the line corresponding to a specific execution to view the execution log.