Veritas NetBackup™ Add-in for Microsoft SCVMM Console Guide

Last Published:
Product(s): NetBackup (8.3.0.1, 8.3, 8.2)
  1. Introduction and notes
    1.  
      About the NetBackup Add-in for System Center Virtual Machine Manager (SCVMM)
    2.  
      Notes on the NetBackup Add-in for SCVMM
    3.  
      Updates to this guide for NetBackup 8.2
  2. Installing the NetBackup Add-in for SCVMM
    1.  
      Requirements for the NetBackup Add-in for SCVMM
    2.  
      Installing the NetBackup Add-in for SCVMM
    3.  
      Installation message: Add-in cannot be installed
    4.  
      Installation message regarding localized environments
    5.  
      Configuring the add-in for an external certificate
    6.  
      Reconfiguring the add-in for a NetBackup CA-signed certificate
    7.  
      Uninstalling the NetBackup Add-in for SCVMM
    8. Configuring the NetBackup Recovery Wizard
      1.  
        Creating an authentication token for the NetBackup add-in for SCVMM
      2.  
        Authorizing the NetBackup add-in to restore virtual machines
      3.  
        Adding or deleting an additional host name or IP address for an authentication token
      4.  
        Revoking an authorization token
      5.  
        Renewing an authorization token
      6.  
        Listing all current authorization tokens
  3. Recovering virtual machines
    1.  
      Notes on restoring Hyper-V virtual machines with the Recovery Wizard
    2.  
      Accessing the Recovery Wizard
    3. Restore Virtual Machine Wizard screens
      1.  
        Virtual Machine Selection screen
      2.  
        Backup Image Selection screen
      3.  
        Select Another Image screen
      4.  
        Restore Options screen
      5.  
        Review Settings screen
    4.  
      Checking the status of a recovery job
  4. Troubleshooting
    1.  
      About logging for the NetBackup Add-in for SCVMM
    2.  
      Viewing log messages for the NetBackup Add-in for SCVMM
    3.  
      Changing the logging level for the NetBackup Add-in for SCVMM
    4.  
      The pre-recovery checks in the Recovery Wizard of the NetBackup Add-in for SCVMM return out-of-date information about the VM
    5.  
      Next button in the NetBackup Add-in Recovery Wizard is enabled even though required input has not been entered
    6.  
      The NetBackup Add-in Recovery Wizard does not prompt to overwrite the VM, and the recovery fails
    7.  
      Troubleshooting master server communication failures in the NetBackup Add-in for SCVMM

Troubleshooting master server communication failures in the NetBackup Add-in for SCVMM

To recover VMs, the add-in must have a registered NetBackup master server with a valid and correct authentication token. The NetBackup administrator generates the authentication token on a specific NetBackup master server for a specific SCVMM console host. The token gives the SCVMM console host access to the NetBackup master server where the token was generated. (Note: you can validate authentication tokens for currently registered master servers by means of the Manage Master Servers option in the add-in.)

If the TCP/IP address or host name of the SCVMM console host does not exactly match the information in the authentication token, the following operations fail: the Manage Master Servers operation, and VM recovery. Error messages such as the following may appear:

Unable to connect the Netbackup Master Server. Do you want to add this master server?

Authentication failed. Please verify that the master server token is valid and correct using the 'Manage Master Servers' dialog box

To correctly determine the problem and the corrective action, you must review the VxUL log file. On the master server, enter the following command:

vxlogview -i nbwebservice -p nb - L -E

Error example 1

The log file includes messages similar to the following:

02/17/2017 10:03:37.831 [Error] Remote host name does not match the 
name in the certificate, remote name:scvmm02.domain.com, name from 
certificate:scvmm02

In the log snip shown, the name in the token is scvmm02 and the required name is scvmm02.domain.com.

Veritas recommends that you revoke the existing token, generate a new token with the required name, and use the new token on the SCVMM console host. If you cannot do that, add the SCVMM console host's fully qualified domain name as an alias for the existing token, as follows:

manageClientCerts -addAlias scvmm02 -HOST scvmm02.domain.com

As an alternative, you can use the -ANY option:

manageClientCerts -addAlias scvmm02 -ANY

-ANY allows any host or any IP address to communicate with the NetBackup server by means of this token.

Caution:

The -ANY option is not a secure method for restores. Please see the NetBackup Commands Reference Guide for more information on the manageClientCerts command.

Error example 2

The log file includes messages similar to the following:

02/17/2017 16:18:13.951 [Error] Remote host name does not match the 
name in the certificate, remote name:10.10.10.11, name from 
certificate:scvmm02

In the log snip shown, the name in the token is scvmm02 and the required name is 10.10.10.11.

Veritas recommends that you revoke the existing token, generate a new token with the required name, and use the new token on the SCVMM console host. If you cannot do that, add the SCVMM console host's TCP/IP address as an alias for the existing token, as follows:

manageClientCerts -addAlias scvmm02 -IP 10.10.10.11

As an alternative, you can use the -ANY option:

manageClientCerts -addAlias scvmm02 -ANY

-ANY allows any host or any IP address to communicate with the NetBackup server by means of this token.

Caution:

The -ANY option is not a secure method for restores.

Additional information is available:

See Adding or deleting an additional host name or IP address for an authentication token.

See the manageClientCerts command in the NetBackup Commands Reference Guide.