NetVault Plug-in for SQL Server 10.0.6


	IMPORTANT: To make a copy of a database using the Full File and Filegroup Backup method (available only for VDI), it must be restored to a different SQL Server® Instance. When renaming a database during a VSS-based restore, the database files must also be relocated to an alternate directory. If the database files are not relocated to an alternate directory, the restore fails. This failure is because VSS does not let you rename the database without moving the data and log files to a different directory. When relocating data and log files for VSS-based restores, you can relocate the data files to one directory and the log files to a separate directory if both directories are different than the original.

To rename or relocate a database (or both) during a restore:

In the Navigation pane, click Create Restore Job, select Plug‑in for SQL Server from the Plugin Type list, select the applicable saveset, and click Next.

Select the database to restore from the backup saveset by following the instructions outlined in Restoring data from online VDI backups.

With the database selected on the Create Selection Set page, select Rename from the Actions list.

In the Rename/Relocate dialog box, enter the applicable information:

•

Rename: Enter the new name.


	IMPORTANT: When renaming a database during a VSS-based restore, the database files must also be relocated to an alternate directory. If the database files are not relocated to an alternate directory, the restore fails. This failure is because VSS does not let you rename the database without moving the data and log files to a different directory. When relocating data and log files for VSS-based restores, you can relocate the data files to one directory and the log files to a separate directory if both directories are different from the original.

•

Relocate: Enter the new path.

The plug-in lets you relocate the log files to a directory other than the data files directory. To restore to separate directories, type in the paths to the directories where the data files and log files are to be restored. Enter the data file directory first, and then enter the path to the log file directory. Separate the two directory paths using a comma (no space must exist before or after the comma). The directory specified in this field must exist at job run-time.

To apply your changes, click Ok.

The database name is accompanied by the rename and relocate information in parentheses.

Continue with the restore procedure as explained in Restoring data from online VDI backups.

Restoring a database to an alternate instance

With the plug-in’s VDI-based backup method, you can restore a database to an alternate instance of SQL Server® running on the database server. The procedure for performing this type of a restore is outlined in the following sections.


	IMPORTANT: If you intend to restore a database to an alternate instance that resides on the same server and the original database still exists, you must use the Rename/Relocate option described previously in Renaming or relocating a database. Use this option to rename or move the datafiles to ensure that they do not overwrite or conflict with the same files in the original database.

Figure 4. Restoring to alternate instance

Before initiating this type of restore, check that the following prerequisites are met:

•

Same version of SQL Server: Both the source instance from which the data was backed up and the target instance to which the data is to be restored must be running the same version of SQL Server.

•

Instance configured for access: The instance to which the database is to be restored must be accessible to the plug-in. To set up the instance for access, see Configuring authentication details.

To complete the restore:

In the Navigation pane, click Create Restore Job, select Plug‑in for SQL Server from the Plugin Type list, select the applicable saveset, and click Next.

Select the database to restore from the backup saveset by following the instructions outlined in Restoring data from online VDI backups.

On the Create Selection Set page, click Edit Plugin Options, and configure the restore options by following the instructions outlined in Restoring data from online VDI backups.

In addition, set the Target Instance parameter.

To do so, specify the name of the instance to which the selected database is to be restored. You can either specify the fully qualified name (that is, <HostName>\<InstanceName> — for example, WIN2K3\SQLINSTANCE2 or the instance name (for example, SQLINSTANCE2) in this field.

Complete the procedure by following the instructions outlined in Restoring data from online VDI backups.


	IMPORTANT: You can also rename or relocate a database while performing this type of restore for VDI-based backups. For more information, see Renaming or relocating a database.

Restoring data to an alternate SQL Server®

Figure 5. Restoring to alternate SQL Server

This functionality is useful during disaster recovery operations. You can restore a database to a different SQL Server by using the steps provided in the following sections. You can also use this process to restore a NetVault Backup Virtual Client to a standalone NetVault Backup Client.


	IMPORTANT: Microsoft’s VSS backup method does not support restoring a VSS-based backup to an alternate instance; therefore, restoring VSS-based backups to an alternate instance with Plug‑in for SQL Server is not supported.

The following requirements must be met on the new restore target before attempting this procedure:

•

Same version of SQL Server installed: The SQL Server version must be the same as the version running on the existing database server.

•

NetVault Backup software and the Plug‑in for SQL Server installed: The same version of NetVault Backup software and the plug-in must be installed and configured on the new restore target.

•

Client added to the NetVault Backup Server: The target machine must be added to the NetVault Backup Server by using the Manage Clients page of the NetVault Backup WebUI.

•

Instance of SQL Server must exist on the new restore target: An instance of SQL Server must exist on the new restore target. This instance serves as the target of the relocation restore. Not only must this instance be properly set up and configured in SQL Server, it must also be accessible to the plug-in on the new restore target. To set up the instance for access, see Configuring authentication details.

To complete the restore:


	IMPORTANT: In a disaster recovery scenario, use this procedure to restore the master and the msdb database backups. After restoring the master database, restart the server. Restore and recover each individual database.

Restore the master and the msdb database backups.


	IMPORTANT: When you perform a restore to an alternate server, you cannot modify the name or destination of the restored master database. The master database is restored to the location of the current master database in the target for the restore.

After restoring the master database, restart the server.

Restore and recover each individual database.

In the Navigation pane, click Create Restore Job, select Plug‑in for SQL Server from the Plugin Type list, select the applicable saveset, and click Next.

Select the database to be restored from the backup saveset by following the instructions outlined in Restoring data from online VDI backups.

On the Create Selection Set page, click Edit Plugin Options, and configure the restore options by following the instructions outlined in Restoring data from online VDI backups.

In addition, set the Target Instance parameter.

To do so, specify the name of the instance to which the selected database is to be restored on the new database server. Enter only the instance name in this field; the restore fails if the server name is included.


	NOTE: If you are restoring the default SQL Server® Instance to the alternate server, you can enter the name of the destination server (for example, MSSQLSERVER) for the Target Instance.

Click Ok to save the settings, and then click Next.

In Job Name, specify a name for the job if you do not want to use the default setting.

Assign a descriptive title that lets you easily identify the job when monitoring its progress. The job name can contain alphanumeric and non-alphanumeric characters, but it cannot contain non-Latin characters. On Windows®, there is no length restriction; however, a maximum of 40 characters is recommended.

In the Target Client list, select the new restore target.

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

Click Save or Save & Submit, whichever is applicable.

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

Troubleshooting

This section describes some common errors and their solutions. In those cases where an error occurs and is not described in this table, obtain the SQL Server® error number from the NetVault Backup Logs, and then see the relevant SQL Server documentation for the resolution.

Table 1. Troubleshooting

Symptom

Reason/symptom

Solution

NetVault Backup 10.x service (netvault-pgsql) does not start on Windows®

Check the Windows Event Viewer to see if it displays the following message: PDT FATAL: lock file “postmaster.pid” already exists.

NetVault Backup 10.x uses a PostgreSQL database. If the PostgreSQL database does not start, NetVault Backup cannot start. To correct this issue, delete the “postmaster.pid” file from the location referenced in the log and restart the NetVault Backup Server. For more information, see https://support.quest.com/netvault-backup/kb/122475.

Transaction Log backup failed

Transaction Log backups are not allowed for Simple Recovery Model databases.

For taking Transaction Log backups, the recovery model for the database must be set to Full Recovery Model.

Or clear the Simple Recovery Model databases.

Backup failed

The File and Filegroup backup fails and the following error message appears in the logs:

“The primary filegroup cannot be backed up as a file backup because the database is using the SIMPLE recovery model. Consider taking a partial backup by specifying READ_WRITE_FILEGROUPS.”

Either modify the Selection Set to include only secondary filegroups for the Simple Recovery Model databases or select the Partial Database or Differential Partial Database backup type.

Backup failed

Verify that the password for the plug-in has been entered correctly.

Backup Completed with warnings

After this status is revealed for backup, check the NetVault Backup Log entries for the job to see if they display one or both of the following messages:

•

“Failed to add backup record”

•

“Failed to write index of backup to the database”

These messages indicate that the selected data was backed up, but the job’s index information was not properly added by NetVault Backup to its database. Without this index information, the data cannot be properly restored.

Method 1:

Open the Manage Devices page, select the backup media, and click Scan. NetVault Backup stores index information for backup jobs in two locations: in the NetVault Database and on the media targeted by the backup. Performing this scan adds the index information to the NetVault Database. To verify that the information was added, open the Manage Job Definitions page, and locate the specific job. If you can run the job now, the scan process has corrected the problem.

Method 2:

If the scan has failed, run the backup job again.

VSS Restore fails from a NetVault Backup Server installed on Linux®/UNIX®.

By default, the plug-in assumes that the media format for backup tapes is MTF, which is typically used for Windows. However, Linux and UNIX use CPIO.

Configure the plug-in to set the Media Format to use CPIO during VSS Restores. For more information, see Specifying a default configuration (optional).