NetBackup™ Plug-in for VMware vSphere Client (HTML5) Guide

Last Published:
Product(s): NetBackup (10.0)
  1. Introduction and notes
    1.  
      About the NetBackup plug-in for VMware vSphere Client (HTML5)
    2.  
      Notes on the NetBackup plug-in for vSphere Client (HTML5)
    3.  
      How to access the features of the NetBackup plug-in for vSphere Client (HTML5)
  2. Installing the NetBackup plug-in for vSphere Client (HTML5)
    1.  
      Requirements for the NetBackup plug-in for vSphere Client (HTML5)
    2.  
      Using consistent vCenter naming with the NetBackup plug-in for vSphere Client (HTML5)
    3.  
      vCenter privileges for managing NetBackup plug-in installation
    4.  
      Notes on using the vSphere Client (HTML5) plug-in in a VMware Platform Services Controller (PSC) environment
    5. Installing the NetBackup plug-in for vSphere Client (HTML5)
      1.  
        Register Plug-in when no other Plug-in (either Local or current) is installed
      2.  
        Register Plug-in when no Local Plug-in registered, and one or more Plug-ins's are already registered
      3.  
        Register plug-in when local plug-in already registered but no other Plug-in registered
      4.  
        Register Plug-in when local Plug-in already registered, and one or more Plug-in's already registered
    6.  
      VIRTUALIZATION_HOSTS_SECURE_CONNECT_ENABLED for servers and clients
    7.  
      Uninstalling the NetBackup plug-in for vSphere Client (HTML5)
    8.  
      Uninstalling the NetBackup Local plug-in for vSphere Client (HTML5)
  3. Plug-in Configurations
    1.  
      Configuration overview for the NetBackup Recovery and Instant Recovery Wizards
    2.  
      Port usage for the NetBackup vSphere Client (HTML5) plug-in
    3.  
      Setting vCenter privileges for recovering virtual machines
    4.  
      NetBackup permissions for the plug-in
    5.  
      Configuring vCenter CA Certificates in NetBackup Primary Server
  4. Log in to the Plug-in
    1.  
      Sign-in for the Plug-in
    2.  
      Prerequisites
    3.  
      Log-in to the plug-in
    4.  
      Sign out of the plug-in
  5. Excluding virtual disks from the backup
    1.  
      About excluding virtual disks from the backup
    2.  
      Setting the exclude disks Custom Attribute
  6. Monitoring backup status
    1.  
      vCenter privileges for backup monitoring
    2.  
      Backup monitoring displays in the NetBackup plug-in for vSphere Client (HTML5)
    3.  
      Summary display
    4.  
      Virtual Machines display
    5.  
      Events display
    6.  
      Using the Veritas NetBackup plug-in for backup reporting
    7.  
      How to respond to backup status
  7. Restoring virtual machines
    1.  
      Notes on the NetBackup recovery wizards
    2.  
      How to access the NetBackup Recovery Wizard
    3. Restore virtual machine
      1.  
        Virtual Machine Selection screen
      2.  
        Recovery points screen
      3.  
        Select the Recovery Target screen
      4.  
        Recovery options screen
      5.  
        Review Virtual Machine Recovery screen
    4. Perform Instant Recovery of virtual machines
      1.  
        Instant Recovery: Virtual Machine Selection screen
      2.  
        Instant Recovery: Recovery Options
    5.  
      Instant Recovery: Cleaning the recovery environment and releasing the NetBackup resources
  8. Troubleshooting
    1.  
      A NetBackup primary server is not available in the primary server list of the login screen
    2.  
      The NetBackup plug-in for vSphere Client (HTML5) does not find any backup images in the listed events
    3.  
      Mismatch in vCenter server name (uppercase vs. lowercase letters) causes the VMware connectivity test to fail
    4.  
      Instant recovery operation is not complete due to NFS mount limit exceed
    5.  
      Instant recovery option is disabled for the selected recovery point
    6.  
      The vCenter server names are not available for search
    7.  
      Virtual machine display name conflicts are not shown before the pre-recovery check
    8.  
      Reasons for failure of pre-recovery checks
    9.  
      Too much time taken to populate the list of NetBackup primary servers
    10.  
      The NetBackup plug-in is not shown in the vSphere Client (HTML5) interface even after registration
    11.  
      The NetBackup plug-in is not shown in the vSphere Client (HTML5) interface after vCenter upgrade from older versions to vCenter 7.0 or later
    12.  
      Unregistering the plug-in may result in total uninstallation of the plug-in
    13.  
      Recovery wizard errors
    14.  
      No recovery point found error
  9. Limitations
    1.  
      Limitations
  10. Appendix A. Instant recovery events and best practices
    1.  
      Instant recovery events for non-available virtual machines
    2.  
      Best practices for instant recovery operations

The NetBackup plug-in is not shown in the vSphere Client (HTML5) interface even after registration

This issue may occur for any of the following reasons:

Table: Reasons for the NetBackup plug-in not appearing in the vSphere Client

Reason

Description and recommended action

The NetBackup plug-in does not support the vCenter version.

Messages similar to the following may appear in the vsphere_client_virgo .log file:

javax.net.ssl.SSLHandshakeException: Received fatal alert: 
handshake_failure

For a list of supported vCenter versions for the plug-in, see the following document:

Support for NetBackup 7.x and 8.x in virtual environments:

http://www.veritas.com/docs/000006177

You have not used the default URL for the plug-in ZIP-file download (securely hosted by the NetBackup primary server).

Instead, your plug-in download URL uses the HTTP protocol (http://) rather than the secure HTTPS protocol (https://).

In this case, the default vCenter configuration does not allow the plug-in to be downloaded and deployed. Messages similar to the following may appear in the VMware vsphere_client_virgo.log file:

The plugin package download was blocked because the URL 
is not secure. To allow http URLs add allowHttp=true to 
webclient.properties

See the procedure To allow installation of the plug-in over an HTTP URL.

A previous instance of the NetBackup plug-in did not properly clean up after uninstallation.

Do the following:

  1. On the vCenter server, stop the vSphere Client services.

    The services are vsphere-ui and vsphere-client.

    For assistance with the command line or vSphere Client, see the VMware article "How to stop, start, or restart vCenter Server 6.x services (2109881)":

    https://kb.vmware.com/kb/2109881

  2. Remove references to the plug-in, as follows:

    a.

    On a vCenter appliance, remove the directories or files that the following find command returns:

    # find / -iname "*netbackup*"

    b.

    On a Windows vCenter, remove the directories or files that the following dir commands return:

    dir "%programdata%\*netbackup*" /s /a /b

    dir "%programfiles%\*netbackup*" /s /a /b

    Note:

    For a VMware Platform Services Controller (PSC) environment with multiple vCenters, you need only uninstall the plug-in on the vCenter where the plug-in was installed. However, you should remove references to the plug-in from all of the vCenters that are managed by the PSC.

  3. On the vCenter server, start the vSphere Client services.

    The services are vsphere-ui and vsphere-client.

To allow installation of the plug-in over an HTTP URL

  1. Add the following directive to the vCenter's webclient.properties file:

    allowHttp=true

    The webclient.properties file may be located in the following directory:

    Windows: C:\ProgramData\VMware\vCenterServer\cfg\vsphere-ui\

    Linux: /etc/vmware/vsphere-ui/

  2. Restart the vSphere Client service.

    The following VMware article contains further information on starting the vSphere Client service:

    https://kb.vmware.com/kb/2109887

  3. Log on again to the vSphere Client.

    When you log on, the plug-in is then installed.

    See Installing the NetBackup plug-in for vSphere Client (HTML5).