Chat now with support
Chat with Support

NetVault Plug-in for Domino 12.4 - User Guide

Configuring default settings

The plug-in lets you set default options for backup and restore jobs. You can override these options on a per-job basis. If you intend to use a partitioned server, the settings entered at the plug-in level are automatically set for the primary partition, partition 1. You can also access this option from the partition level.

1
In the Navigation Pane, click Create Backup Job, and click next to the Selections list.
2
In the selection tree, open the applicable client node.
3
Click Plug‑in for Domino, and select Configure from the context menu.
4
Configure the following parameters:
 
* 
NOTE: If you are running a Windows OS, the appropriate information is displayed in the Configure dialog box by default — except the Lotus Domino User Domain name, which you must enter, if necessary. Quest strongly recommends that you review the default values for these parameters to ensure their accuracy.
•
Lotus Domino Installation Directory: Enter the full path to the Domino installation directory. On AIX, Linux, and Windows, this path is displayed by default.
•
Lotus Domino Data Directory: Enter the full path to the directory where the Domino Databases are stored. On AIX, Linux, and Windows, this path is displayed by default.
•
Lotus Domino Username: The Plug‑in for Domino requires a host login account — OS user account — to access the data on the Domino Server for backups. Depending on the OS in use, the following preconfigured user account is displayed in this field:
•
Windows: On Windows, “Administrator” is displayed by default.
•
Linux and UNIX: On Linux and UNIX, “notes” is displayed by default if the default user name was not changed during Domino installation and Domino Server is running from this account. Otherwise, the Plug‑in for Domino does not preconfigure a default user. If the box is blank, configure a valid user account for the plug-in’s use.
When configuring a user account, ensure that the specified user has sufficient privileges to access the Domino Server program and the database.
•
Lotus Domino User Domain (Windows)/User Group (Linux/UNIX): Depending on the OS, provide the User Domain or User Group:
•
Windows: 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.
•
Linux or UNIX: Enter the user group to which the configured user belongs. If the Domino Server is running from this account, the preconfigured user group is notes.
•
Tmp Directory for Recovery: Enter the path to a temporary directory on the Plug‑in for Domino host. The plug-in uses this directory to store data temporarily when relocating a database as part of the restore operation. When the entire database is restored, the data is moved to the data directory on the target server and the temporary directory is emptied.
•
Location of file notes.ini: Enter the full path to the Domino Server configuration file, “notes.ini.”
•
Name of *.ini file: Enter the filename of the initialization file. The default name of the initialization file on Windows, Linux, and UNIX is “notes.ini.”
•
Location of file server.id: Enter the path to the Domino Server’s ID file, “server.id.
•
Location of file cert.id: Enter the path to the Domino Domain Certifier ID file, “cert.id.
•
Location of file mail.box: Enter the path to the Domino Outbox Mail Router file, “mail.box.
•
Location of User’s Mail: Enter the path to the directory where the user email data is stored.
•
Location of file log.nsf: Enter the path to the Domino Log Database, “log.nsf.
•
Location of file names.nsf: Enter the path to the Domino Domain directory, “names.nsf.
•
Logs Directory: Enter the path to the directory where the log files are stored.
•
Logs ControlFile: Enter the name of the file acting as the logs control file.
•
Lotus DAOS Directory: Available starting with Domino 8.5, the Domino Attachment and Object Service (DAOS) consolidates storage of attachments in a separate DAOS repository. DAOS also reduces disk space usage by allowing single-instance storage for attachments present in multiple mails.
For Domino Servers on which DAOS is enabled, enter the path to the DAOS repository on the server.
 
* 
IMPORTANT: In a standard database, you only have to back up the “.nsf” file because the attachments are stored inside this file. With DAOS enabled, the “.nsf” file only contains a reference to the attachment. In this environment, also back up the files in the DAOS repository.
•
Ignore Circular Log Warnings in Full Backups: As described in Setting up Transactional logging on the Domino Server, Quest strongly recommends that you enable Archive logging. If you must use Circular logging and you do not want NetVault Backup to generate Circular logging warnings during Full Backups, select this option.
•
Ignore No Logged Database Log Warnings in Backups: To skip Completed with warnings messages for backup jobs that do not include logged databases, select this option.
If you select this option and no logged databases are encountered during the backup process, the warning associated with the event of the database not being logged is not taken into account for the exit status of the backup job. If other errors or warnings are encountered, the job exit status is set to errors or warnings accordingly.
•
Incomplete backup of ALL items selected: The plug-in lets you specify what action a backup job should take if it is unable to back up all the selected items. Consider the following example:
A backup job includes multiple Domino Databases and User Mailboxes. When you run a job instance, the backup of user mailboxes is unsuccessful, while the server databases are backed up successfully. In this situation, you can specify what action the backup job should take.
To configure a default action for the Plug‑in for Domino, select one of the following from the list:
•
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.
 
* 
NOTE: To override the default action on a per-job basis, see Setting backup options.
•
Job Manager Channel Exercise Message Interval (in seconds): To change the frequency at which a running instance of the plug-in sends a probe message to the NetVault Job Manager to maintain an active communication channel between the plug-in and the Job Manager, enter the new number here. The default is 180 seconds.
•
Number of Logical Domino Servers (Partitions): If you are using a partition-server setup, use this option to change the value from 1, the default, to the number that reflects the number of partitions you have created. This ensures that the subsequent nodes appear in the selection tree and that you can configure them and back them up is applicable.
On a partitioned server, the partitions share one set of program files located in the Domino home directory, while each partition has a separate Domino Data Directory.
 
* 
IMPORTANT: If you are using a standalone Domino Server, leave the default value set to 1.
5
To save the settings, click OK.

Configuring additional settings for a partitioned server

As explained previously, when you access the Configure option from the plug-in level, the settings are automatically set for the primary partition, partition 1. If you access the option for partition 1, the settings reflect the defaults that you entered at the plug-in level. For the additional partitions, the plug-in only displays the fields that you can update for the selected partition.

 
* 
NOTE: On Windows, when you browse one of the non-primary partition nodes after configuring the primary node, the plug-in prompts you to log in. To do so, enter the name and password, and domain if applicable, that you used to configure the primary node.
To configure additional partitions:
1
In the selection tree, expand the Plug‑in for Domino node to see the list of partitions.
2
Click the first applicable partition, such as partition 2, and select Configure from the context menu.
3
On the Configure Domino Server Partition dialog box, enter the following parameters for the selected partition:
•
Data Directory: Enter the full path to the directory where the Domino Databases are stored.
•
Domino Username: (Required only for Linux/UNIX.) The plug-in requires either a Domino, host, or OS login account to access the data on the partition. Enter a valid user account for the plug-in’s use. When configuring a user account, ensure that the specified user has sufficient privileges to access the Domino Server program and the database.
•
Domino User Group: (Required only for Linux/UNIX.) Enter the user group to which the configured user belongs.
•
Location of file notes.ini: Enter the full path to the Domino Server configuration file, “notes.ini.”
•
Name of *.ini file: Enter the filename of the initialization file.
•
Location of file server.id: Enter the path to the Domino Server’s ID file, “server.id.
•
Location of file cert.id: Enter the path to the Domino Domain Certifier ID file, “cert.id.
•
Location of file mail.box: Enter the path to the Domino Outbox Mail Router file, “mail.box.
•
Location of User’s Mail: Enter the path to the directory where the user email data is stored.
•
Location of file log.nsf: Enter the path to the Domino Log Database, “log.nsf.
•
Location of file names.nsf: Enter the path to the Domino Domain directory, “names.nsf.
•
Logs Directory: Enter the path to the directory where the log files are stored.
•
Logs ControlFile: Enter the name of the file acting as the logs control file.
•
DAOS Directory: For Domino Servers on which DAOS is enabled, enter the path to the DAOS repository on the server.
 
* 
IMPORTANT: In a standard database, you only have to back up the “.nsf” file because the attachments are stored inside this file. With DAOS enabled, the “.nsf” file only contains a reference to the attachment. In this environment, also back up the files in the DAOS repository.
4
To save the settings, click Save.
5
Repeat these steps for each applicable partition.

Backing up data

•
Available backup types
•
Performing Full Backups
•
Performing Incremental Backups

Available backup types

The Plug‑in for Domino offers the following backup types:

•
Full Backup: This type backs up the full contents of the selected items. Full Backups usually take longer to complete and consume more backup media. A Full Backup serves as the base for future Incremental Backups. A Full Backup of the DAOS repository includes all the existing attachments in the repository.
•
Incremental Backup: This type backs up the new and changed data written to the Transaction Logs. To use this method, Transactional Logging must be enabled on the Domino Server. For more information, see Setting up Transactional logging on the Domino Server. For a nonlogged database, the Incremental Backup backs up the full contents of the database. When a backup job includes both logged and nonlogged databases, the saveset contains the Transaction Logs for the logged databases and the full contents of the nonlogged database.
Incremental backups usually consume less storage space and are quicker to perform. The Incremental Backup method can only be selected for the server database, user-mailbox items, and the DAOS repository. An Incremental Backup of the DAOS repository only backs up DAOS files that have been newly added since the last Full or Incremental Backup.
 
* 
IMPORTANT: Any additional items that you select for backup are ignored; if none of the three valid types — server database, user-mailbox items, and the DAOS repository — are selected, the plug-in logs a warning and does not complete the backup process.
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating