Task Topic

A task topic describes a sequence of steps that must be performed to achieve a particular result.

Task Topic Note

Mind the following differences:

  • Task — a piece of work required to be done to reach a goal.

For example, performing backup is a task required to create a copy of production data.

  • Operation — an activity involved in a task.

For example, creating a backup job is an activity required to perform backup.

  • Procedure — a series of actions taken together to perform an operation.

For example, creating a backup job involves a number of steps to be taken. You must select VMs to back up, define the VM backup order, specify backup storage settings and so on.

  • Process — a high-level term used to define a series of events that lead to the conversion of an input into an output.

For example, backup is a job-driven process: to perform backup, you must configure backup jobs; a backup job is a configuration unit of the backup activity.

When to Use Task Topic

Use this topic type in the following cases:

 

Task Topic Tip

If a task topic describes a complex procedure, add a concept topic to support the task topic. A procedure is considered to be complex if one or more of the following conditions are met:

  • More than 3 paragraphs are required to describe one or more steps in the procedure.
  • It is hard to get the meaning of the procedure without some additional information.
  • To describe the procedure, you have to define multiple types of objects or processes.
  • Several other task topics reference the same objects or processes.

How to Use Task Topic

This topic structure consists of the following elements:

  1. Title — the name of an operation.

Use a verb-based title (as opposed to a noun-based title for a concept topic) that briefly outlines the operation. Make sure the verb is the first word in the title.

If an operation can be performed for only one object of a kind, use the singular form for the object noun (for example, Installing License). If an operation can be performed for multiple objects, use the plural form for the object noun (for example, Deleting Files).

  1. Rationale — reasons for the operation.

Explain why it is important to perform this operation. Provide enough context to understand the operation; the context must connect user goals with solution workflows.

Organize content into paragraphs and subsections.

  1. [Optional] Warnings — possible outcomes of the operation.

If the result of an operation affects users in any way, clarify the consequences before proceeding to the operation. To draw attention, use notes.

For example, consider a situation where a user goes through a configuration wizard to edit job settings. If all currently running jobs will be stopped as soon as the user completes the wizard and clicks Finish, you must warn the user about that.

  1. [Optional] Prerequisites — limitations and prerequisites that exist for the operation.

Specify conditions under which this operation can be performed. For example, some operations become available only if there is a specific license edition installed or if some other operations have already been performed beforehand.

Do not dive too deep into details. For example, do not list system requirements — this is what the System Requirements section is for.

  1. Procedure — a sequence of steps required to perform the operation.

Begin the procedure with an introductory phrase that describes the procedure goal, starts with an infinitive and ends with a colon. A period at the end of the lead-in phrase is also acceptable. If the procedure applies to multiple objects (for example, if a user can modify and delete a set of objects using the same procedure), clarify that in the introductory phrase.

Use a numbered list to show the order in which procedure steps must be performed. Each step must describe a particular action and begin with navigation details. If a step is optional, mark it with the [Optional] tag, and place the tag at the beginning of the step. Do not add software responses and supplementary details as separate steps — depending on the context, include this information in the currently or next executed step as List Paragraph.

 

Task Topic Important

In Veeam documentation, we do not instruct users to click Next when proceeding to the next step of a wizard. Instead, we begin each topic that describes a particular step with the name of that step. For example, At the Virtual Machines step of the wizard, select VMs and VM containers that you want to back up.

The maximum number of levels in a nested procedure is 3. If a procedure requires more than 3 levels, consider restructuring the procedure and adding subsections. In this case, each subsection must have a title that briefly summarizes the step and starts with Step #.

  1. [Optional] Post-requisites — follow-up steps that exist for the operation.

Describe expected results, explain if there is a way to check whether the operation completed successfully, include examples and useful tips to support the operation, or provide information on actions that users could do next.

  1. Screenshot — an illustration of the operation.

If there is only one screenshot that illustrates the operation, place it at the end of the topic. Do not leave important details and notes after the screenshot — users tend to skip such information, especially when they read documents online and have to scroll further to notice it. For more information, see Aligning Images with Text.

  1. [Optional] Links — links to related concept and task topics.

 

Task Topic

 

Tip

As task topics are usually related to hypothetical situations and their consequences (such as user actions and the particular results of these actions), you can use the simple future tense and first conditional sentences when describing procedures and usage scenarios. For more information on verb tenses that we use in Veeam technical documentation, see Plain English.

Task TopicExample

Creating Lab Groups [title]

In most cases, a VM does not work in isolation but has dependencies on other services and components, such as Microsoft Active Directory or DNS. To verify such a VM, the DataLab will have to supply all services this VM is dependent on. For this purpose, Orchestrator uses lab groups. [rationale]

Task Topic Important

If an orchestration plan contains a particular VM group or VM, do not attempt to test this plan in a DataLab that includes a lab group with the same VM or VM group. [limitations]

To create a lab group for a DataLab: [procedure]

  1. Navigate to DataLabs.
  2. In the DataLabs column, click the DataLab name.

For a DataLab to be displayed in the DataLabs list, it must be included into the list of plan components available for the scope, as described in section Configuring Veeam Recovery Orchestrator.

  1. On the DataLab Details page, in the DataLab column, select the DataLab and click Edit.
  2. On the Edit DataLab page, in the Lab Groups column, click Add to include VM groups in the DataLab.
  3. Complete the Add Lab Group wizard.
  1. At the Lab Group Type step, choose whether the lab group will contain VMs recovered from backups or replicas.
  2. At the VM Groups step, select the required VM groups and click Add to include them in the lab group.
  3. To configure VM recovery options and choose default steps that will be performed for VMs in the lab group, follow the instructions provided in both section Creating Failover Plans and section Creating Restore Plans.

Task Topic Important

A common use case for lab groups is to provide domain controllers for the test environment. If there are domain controllers in a lab group, it is essential to add the Prepare DC for DataLab step. By design, it will automatically become the first step in the step execution order.

You may also optionally add domain controller-specific checks, such as Verify Domain Controller Port and Verify Global Catalog Port. These steps must be performed after the Check VM Heartbeat step.

  1. At the Summary step, review configuration information and click Finish.
  1. To save changes made to the DataLab settings, click Save.

Task Topic Note

There is no clear use case for replicating a domain controller. Failing over to a domain controller that contains an old version of the Microsoft Active Directory database is not recommended by Microsoft. The only real use case for replicating a domain controller is to use it in an isolated lab group, and you may need to create a replication job specifically for that purpose.

 

Creating a Lab Group

Related Topics [links]