NetVault Plug-in for Domino 4.4

Selecting data for a backup

You must use sets — Backup Selection Set, Backup Options Set, Schedule Set, Target Set, and Advanced Options Set — to create a backup job.

Backup Selection Sets are essential for Incremental Backups. Create the Backup Selection Set during a Full Backup, and use it for Incremental Backups. The backup job reports an error if you do not use a Selection Set for the Incremental Backup. For more information, see the Quest NetVault Backup Administrator’s Guide.

IMPORTANT: Consider the following while selecting data for a backup.

•

Domino Server lets you create the following types of links:

•

Directory Link: A Directory Link is used to access a specific directory that contains Domino Database files.

•

Database Link: A Database Link is used to access a specific database.

The Directory Links can be backed up and restored normally. However, when you restore a backed-up Database Link, the actual database is restored, not just the link. In addition, the database is restored to the location of the Database Link file, not its original location. Consider the following example: A Domino Database resides on partition A, while the Database Link is created on partition B. When you restore the backed-up Database Link, the database is restored to partition B where the link file resides. This process results in two instances of the same database residing on different partitions. Therefore, Quest recommends against including Database Links in a backup.

•

Multiple server databases and template files can share a display name, for example, two template files could be named Template_1. When navigating the selection tree to include items for a backup, ensure that the applicable item is selected. This process can be completed by checking the server database and template-file structure on the Domino Server.

•

Domino Server allows you to access a server-database file based on its file type and ignores its physical directory location. However, to access a server-database file on the NetVault Backup Selections page, navigate the selection tree to locate the file at its actual destination directory.


	TIP: To use an existing set, click Create Backup Job, and select the set from the Selections list.

In the Navigation pane, click Create Backup Job.

You can also start the wizard from the Guided Configuration link. In the Navigation pane, click Guided Configuration. On the NetVault Configuration Wizard page, click Create backup jobs.

In Job Name, specify a name for the job.

Assign a descriptive name that lets you easily identify the job when monitoring its progress or restoring data. The job name can contain alphanumeric and nonalphanumeric characters, but it cannot contain non-Latin characters. On Linux, the name can have a maximum of 200 characters. On Windows, there is no length restriction. However, a maximum of 40 characters is recommended on all platforms.

Next to the Selections list, click Create New.

In the list of plug-ins, open Plug‑in for Domino to display the Domino Server components.

If you are using a Windows system, enter the following login credentials when the dialog box is displayed, and then click OK:

•

Account Name: Enter a Windows user account that the plug-in can use to access the Domino Server. You can configure a default user account for the plug-in’s use as described in Configuring default settings. The user account must have sufficient privileges to access the Domino Server and databases.

•

Password: Enter the password associated with the specified user.

•

Domain: If the NetVault Backup Server and the Domino Server belong to different Windows Domains, enter the Windows Domain for the Domino Server. This parameter is optional.

Upon authentication, the selection tree is displayed.


	IMPORTANT: On Linux and UNIX, the plug-in uses the default user account and user group provided in the Configure dialog box to log in automatically to the Domino Server. No login prompt is displayed on this platform when you open the Domino Server node. Instead, the Domino Server components are listed for selection. However, if you have not specified a user name or user group in the Configure dialog box, or either of the configured parameters is invalid, the plug-in fails with an error message.

Select the applicable data:

•

<server>: To select all files and databases, select this node.

•

Initialization File: To include the “notes.ini” file, select this node.

•

Identification Files: To include the “*.id” files, including the “server.id” and “cert.id” files, select this node.

•

Mail Configuration File: To include the “*.box” files, including the “mail.box” file, select this node.

•

Mail Databases: To include the “log.nsf” and “names.nsf” database files, select this node.

•

Template Files: To back up all the Template Files, select this node. To include individual files, open this node, and select the target files.

•

Server Databases: To back up all the server databases, select this node. To include individual databases, open this node, and select the target databases.

•

Users MailBox: To back up all the mailboxes, select this node. To include individual mailboxes, open this node, and select the target mailboxes. Any database that contains an Inbox is automatically displayed beneath the Users MailBox node on the Selections tab.

•

Domino Attachment and Object Service (DAOS): To back up all the items in the DAOS repository, select this node. To include individual directories, open this node, and select the target directories.


	NOTE: For a DAOS Backup, Quest recommends that you create a separate job for the DAOS repository. To do so, create a separate Target Set, also referred to as a Selection Set, for the Full and Incremental Backups. For details on creating Selection Sets, see the Quest NetVault Backup Administrator’s Guide.

Click Save, enter a name in the Create New Set dialog box, and click Save.

The name can contain alphanumeric and nonalphanumeric characters, but it cannot contain non-Latin characters. On Linux, the name can have a maximum of 200 characters. On Windows, there is no length restriction. However, a maximum of 40 characters is recommended on all platforms.

Setting backup options

The next step involves creating the Backup Options Set or selecting an existing one.


	TIP: To use an existing set, in the Plugin Options list, select the set that you want to use.

Next to the Plugin Options list, click Create New.

Configure the following options:

•

Backup Type: Select the Full Backup option. For details, see Available backup types.

•

Number of Retries: Enter or select the number of times that the plug-in should try to back up a database or file that is in use by a different process.

Plug‑in for Domino cannot back up a database if it is locked by a different process. This issue also applies to the database-compact process. The Number of Retries parameter determines the number of times the Plug‑in for Domino tries to back up a database or Domino file when the initial attempt fails. By default, the Plug‑in for Domino only makes one attempt. This feature applies to a specific file or database; it does not apply to the overall backup job.

•

Server Data: If you want to include and exclude specific directories, enter the applicable information — use full path names — in these fields. When completing these fields, use the following guidelines:

•

Use a comma to separate multiple entries.

•

In the Backup Inclusion List — Directories field, verify that the specified directories are subdirectories of entries listed in the Backup Exclusion List — Directories field; otherwise, the directory is ignored. For example, you can exclude c:\domino_data\site1 and include c:\domino_data\site1\marketing.

•

A file or database selected for backup is ignored if it is contained in a directory that is specified in the Backup Exclusion List — Directories field. The file or database must reside in a subdirectory, and that subdirectory must be listed in the Backup Inclusion List — Directories field.

•

Incomplete backup of ALL items selected: To override what action the plug-in should take if an individual job fails to back up all applicable items, select one of the following:

•

Complete with Warnings — Saveset Retained: The job returns a status of “Backup Completed with warnings” and a backup saveset is created that includes the items that were successfully backed up.

•

Complete without Warnings — Saveset Retained: The job completes and returns a status of “Backup Completed.” The errors are logged in the NetVault Backup binary logs and ignored on the Job Status page. A backup saveset is created that includes the items that were backed up.

•

Fail — Saveset Retained: The job returns a status of “Backup Failed.” However, a backup saveset is generated that includes the items that were successfully backed up.

•

Fail — No Saveset Retained: The job returns a status of “Backup Failed” and no saveset of backed-up objects is kept. That is, even if some of the objects were successfully backed up, the saveset is discarded.

A default action for all backup jobs can be set in the Configure dialog box. For details, see Configuring default settings.

Click Save to save the set.

In the Create New Set dialog box, specify a name for the set, and click Save.

Finalizing and submitting the job

Use the Schedule, Target Storage, and Advanced Options lists to configure any additional required options.

Click Save or Save & Submit, whichever is applicable.


	TIP: To run a job that you have already created and saved, select Manage Job Definitions in the Navigation pane, select the applicable job, and click Run Now.

You can monitor progress on the Job Status page and view the logs on the View Logs page. For more information, see the Quest NetVault Backup Administrator’s Guide.


	IMPORTANT: A database that is in the process of being compacted when a job begins might not be included in the backup. Quest recommends that you perform a Full Backup of a compacted database after the compact process ends.

Performing Incremental Backups


	IMPORTANT: If the Database Instance Identification (DB-IID) of any selected database changes after the initial Full Backup, perform a Full Backup before running any Incremental Backups. Otherwise, the data might not be recoverable. If you create a mailbox after performing a Full Backup, it is not backed up as part of an Incremental Backup until a different Full Backup is performed that includes the new mailbox.