Veritas NetBackup™ Upgrade Guide

Last Published:
Product(s): NetBackup (8.3.0.2, 8.3.0.1, 8.3)
  1. Introduction
    1.  
      About the NetBackup 8.3 Upgrade Guide
    2.  
      Available NetBackup upgrade methods
    3. About changes in NetBackup 8.3
      1.  
        Java GUI and JRE installation optional for some computers
      2.  
        Logging directory permissions require reset on rollback
      3.  
        Upgrades from NetBackup 7.6.0.4 and earlier are not supported
      4.  
        External certificate authority certificates supported in NetBackup 8.2 and later
    4.  
      About Veritas Smart Meter
    5.  
      Best practices for Veritas Smart Meter
  2. Planning for an upgrade
    1. General upgrade planning information
      1.  
        About planning a NetBackup 8.3 upgrade
      2.  
        How to plan for an upgrade to NetBackup 8.3
      3.  
        Known catalog backup limitation
      4.  
        About security certificates for NetBackup hosts
      5.  
        About automatic file changes from an upgrade
    2. About upgrade tools
      1.  
        About Veritas Services and Operations Readiness Tools
      2.  
        Recommended SORT procedures for upgrades
      3.  
        Recommended SORT procedures for new installations
      4.  
        About the NetBackup preinstall checker
    3. Upgrade operational notes and limitations
      1.  
        Creating the user account to support the NetBackup web server
      2.  
        About NetBackup 8.3 support for Fibre Transport Media Server with RHEL 7.5
      3.  
        MSDP changes in NetBackup 8.1
      4.  
        Potential required changes for NetApp clusters
      5.  
        Errors when Bare Metal Restore information is replicated using Auto Image Replication
      6.  
        Upgrade issue with pre-8.1 clients and 8.1 or later media servers
  3. Master server upgrade
    1.  
      About master server upgrades
    2.  
      Preinstall procedure for upgrading to NetBackup 8.3
    3.  
      Performing local, remote, or clustered server upgrades on Windows systems
    4.  
      Performing silent upgrades on Windows systems
    5.  
      Upgrading UNIX and Linux server software to NetBackup 8.3
    6.  
      Post-install procedure for upgrading to NetBackup 8.3
    7.  
      About NetBackup startup and shutdown scripts
    8.  
      Completing your system update after an upgrade
  4. Media server upgrade
    1.  
      Upgrading NetBackup media servers to NetBackup 8.3
    2.  
      Silently upgrading NetBackup media server software on UNIX and Linux
  5. MSDP upgrade for NetBackup
    1.  
      MSDP upgrade considerations for NetBackup 8.1
    2.  
      About MSDP rolling data conversion
    3.  
      About MSDP fingerprinting algorithm changes
  6. Client upgrade
    1.  
      About client upgrades
    2.  
      Upgrading UNIX and Linux clients with the NetBackup upgrade script
    3.  
      Upgrade of the UNIX and Linux client binaries with native installers
  7. NetBackup Deployment Management with VxUpdate
    1.  
      About VxUpdate
    2.  
      Commands used in VxUpdate
    3.  
      Repository management
    4.  
      Deployment policy management
    5.  
      Manually initiating upgrades from the master server using VxUpdate
    6.  
      Manually initiating upgrades from the media server or client using VxUpdate
    7.  
      Deployment job status
  8. Appendix A. Reference
    1.  
      NetBackup master server web server user and group creation
    2.  
      Generate a certificate on the inactive nodes of a clustered master server
    3.  
      About the NetBackup Java Runtime Environment
    4.  
      Add or Remove Java GUI and JRE after upgrade
    5.  
      About the NetBackup web user interface
    6.  
      About the NetBackup answer file
    7.  
      About RBAC bootstrapping
    8.  
      About NetBackup software availability
    9.  
      Additional post-upgrade steps for NetApp clusters
    10.  
      Using NetApp disk arrays with Replication Director
    11.  
      About compatibility between NetBackup versions
    12.  
      Upgrade requirements for UNIX and Linux
    13.  
      Installation and upgrade requirements for Windows and Windows clusters
    14.  
      Requirements for Windows cluster installations and upgrades
    15.  
      Removing a clustered media server by migrating all data to a new media server
    16.  
      Disabling the connection between your OpsCenter server and your NetBackup Master Server
    17.  
      Post upgrade procedures for Amazon cloud storage servers
    18.  
      Upgrading clients after servers are upgraded
  9.  
    Index

Performing local, remote, or clustered server upgrades on Windows systems

Use the following procedure to upgrade to NetBackup 8.3 on a local, a remote, or a clustered computer.

To upgrade the NetBackup binaries for a local, remote, or clustered server on Windows

  1. Log on to the system where you want to initiate the NetBackup upgrade. Be sure to log on with administrator privileges.
    • To upgrade local Windows systems, log on to the computer directly at the console.

    • To upgrade remote Windows systems, log on to a system with network access to all of the hosts where you want to install NetBackup.

    • To upgrade clustered Windows systems, log on to the active node (the node with the shared disk).

  2. Navigate to the directory where the ESD images (downloaded files) reside and run Browser.exe to start the NetBackup Installation Wizard.
  3. On the initial browser screen (Home), click Installation.
  4. On the Installation screen, click Server Software Installation.
  5. On the Welcome screen, review the content and click Next.
  6. (Conditional) If you previously installed NetBackup 8.3 on this host, you see the Program Maintenance dialog.
    • Select Modify to change installation settings for the local host, or to use the local host as a platform to perform push installation to remote hosts.

    • Select Repair to restore NetBackup 8.3 to its original state on the local host.

    • Select Remove to remove NetBackup 8.3 from the local host.

  7. On the License Agreement screen, do the following:
    • I agree to and accept the terms of the license agreement.

      You must select this item to upgrade the software.

    • Click Next.

  8. On the Veritas NetBackup Installation Type screen, provide the following information:

    Where to install

    For a local upgrade, select Install to this computer only.

    For a remote upgrade, select Install to multiple computers on your network.

    For a clustered upgrade, the only option is Install a clustered master server.

    Typical

    Select this option to upgrade NetBackup with the default settings.

    Media server only: By default the typical option looks at the media server's configuration and only upgrades the Java GUI and the JRE packages if they are currently present. Choose Custom if you want to force a state other than what is currently on the media server. If you select to exclude the Java GUI and the JRE, any previous versions are removed.

    Custom

    Select this option to override the default NetBackup settings.

    Click Next.

  9. On the NetBackup License and Server Type screen, provide the following information:
    • License

      For upgrades, the license for the existing installation type determines which components you can select.

      Note:

      For remote upgrades, the license that you enter here gets pushed to the other nodes. Your license may enable add-on products. If you push NetBackup to nodes that have an add-on product already installed, your license works for the add-on product(s).

      For remote or for clustered upgrades, the following occurs during the upgrade process to verify that you have the proper credentials to perform the upgrade:

      • When you select a clustered system for upgrade, NetBackup determines if you have proper administrator credentials on all nodes in the cluster. If you do not have the proper credentials, the system is not added to the list.

      • If you have the proper credentials, NetBackup performs a second check to determine if a license is needed. If a license is needed and one was not entered, the system cannot be added to the list. You must enter a valid license to upgrade on that node. If you enter an invalid license, this screen remains visible until a valid license is entered.

    • Click NetBackup Master Server to proceed to upgrade the master server software.

    • Click NetBackup Media Server to proceed to upgrade the media server software.

  10. On the Customer Registration Key screen, enter the location of the customer registration key. You download this file from the Veritas Smart Meter site and place the file on the appropriate master server. More information about Veritas Smart Meter is available.

    See About Veritas Smart Meter.

    During install and upgrade to NetBackup 8.3, please allow the installer to copy the veritas_customer_registration_key.json file to its final destination. NetBackup can set the file permission and ownership correctly through this process. If you place the file onto your systems outside of the install or the upgrade process, the process may not work correctly.

    Note:

    Be aware that NetBackup does not support the short file name format (8.3 format) for the customer registration key file name.

  11. On the NetBackup Web Services screen, enter the Web Services Password.

    This password is the password for the NetBackup web services user account. You must create this account before you install the master server. More information is available.

    On the NetBackup Web Services screen, specify the account type and the account details.

    What types of acccounts should we use?

    Select either Local or Domain (Active Directory).

    Select Local if you want to associate the web server with a user and a group account that exist on the local host.

    Select Domain (Active Directory) if you want to associate the web server with a user and a group account that exist on a trusted Windows domain.

    What are the existing account details

    Specify the information as shown:

    • Domain - If you chose the Domain (Active Directory) account type, specify the name of the domain to which the user and the group accounts belong.

    • Group - Specify the name of the group account to associate with the web server.

    • User - Specify the name of the user account to associate with the web server. For security reasons, do not specify a user account that has administrative privileges on the host.

    • Password - Specify the password of the user account in the User field.

    More information is available.

    See Installation and upgrade requirements for Windows and Windows clusters.

  12. This step applies only to Custom upgrades. For Typical installations, skip to the next step.

    This step describes how to select and configure the NetBackup Features, NetBackup Port Numbers, and the NetBackup Services.

    • Java GUI and JRE Options

      (Conditional: Media server only) Depending on your upgrade, the options you see include:

      • Include Java GUI and JRE: Install or upgrade the Java GUI and the JRE on the specified computer.

      • Exclude Java GUI and JRE: Exclude the Java GUI and the JRE components from the specified computer. Any preexisting Java GUI and JRE components are removed.

      • Match Existing Configuration: Preserve the current state of the Java GUI and JRE components. The components are upgraded if they are present on the pre-upgraded systems. The components are not installed if they are not present on the pre-upgraded systems.

    • NetBackup Port Numbers

      On this screen, you can change port numbers, if it is necessary in your configuration.

      You may need to change a port number if you encounter conflicts when NetBackup and another industry product try to share the same port. Another example is if a port conflict occurs with a firewall, which may cause security issues.

      To change a port number, select the port number that you want to replace and type the new number.

      Click Next.

    • NetBackup Services

      On this screen, provide the following startup account and startup type information for NetBackup services:

      Log On

      Specify either Local System account or This account.

      By default, the Local System account is selected, so that NetBackup uses the built-in system account. When this option is selected, the fields below it are disabled.

      To specify a different system account:

      • Select This account.

      • Enter the account information in the following fields:

        Domain

        Username

        Password

      Startup Type

      This option determines whether NetBackup services start automatically if you need to restart the NetBackup host. The default is Automatic.

      To start NetBackup services manually after a restart, select Manual.

      Start job-related NetBackup services following installation

      By default, job-related services are set to start automatically after the upgrade has completed.

      To prevent job-related services from starting automatically, click on the box to clear the check mark.

      Safe Abort Option

      This option determines how the upgrade proceeds if a restart is required as part of the upgrade.

      If you select this option and the upgrade process determines that a restart is required, the upgrade stops. The system is then rolled back to its original state.

      If you do not select this option, the upgrade proceeds even if the upgrade process determines that a restart is required.

      Click Next.

  13. On the NetBackup System Names screen, provide the following information:

    Master Server Name

    For master server installations, enter the name of the local computer.

    For media server installations, you must change the name to the master server name to which the media server is configured.

    Note:

    For clustered servers, this field is NetBackup Virtual Host Name. Veritas strongly recommends that you not change this value.

    Additional Servers

    Enter the names of any additional NetBackup master servers and media servers that you want to communicate with this server. Include the names of computers where you plan to install NetBackup later.

    To enter more than one name, separate each name with a comma or press Enter after each name.

    Media Server Name

    This field appears only for NetBackup Enterprise media server installations.

    When you install media server software, this field defaults to the local server name.

    OpsCenter Server Name (Optional)

    OpsCenter is a web-based administration and management tool for NetBackup.

    If you have an OpsCenter server or plan to install one, enter the server name or the IP address for that server here.

    For a clustered server, do not use the virtual name. Instead, use the actual host name of the cluster node.

    Click Next.

  14. (Conditional: For media servers only) If your environment uses an external certificate authority, you receive the External Certificate screen. On the External Certificate screen, select one of the three radio buttons based on how you want to configure the external certificate authority (ECA). Depending on which one you select, you must complete different information:
    • Use Windows certificate store

      You must enter the certificate location as Certificate Store Name\Issuer Distinguished Name\Subject Distinguished Name.

      Note:

      You can use the $hostname variable for any of the names in the certificate store specification. The $hostname variable evaluates at run time to the name of the local host. This option provides flexibility when you push NetBackup software to a large number of clients.

      Alternatively, you can specify a comma-separated list of Windows certificate locations. For example, you can specify: MyCertStore\IssuerName1\SubjectName, MyCertStore\IssuerName2\SubjectName2, MyCertStore4\IssuerName1\SubjectName5

      Then select the Certificate Revocation List (CRL) option from the radio buttons shown:

      • Use the CRL defined in the certificate. No additional information is required.

      • Use the CRL at the following path: You are prompted to provide a path to the CRL.

      • Do not use a CRL.

    • Use certificate from a file

      After you select this option, specify the following:

      • Certificate file: This field requires you to provide the path to the certificate file and the certificate file name.

      • Trust store location: This field requires you to provide the path to the trust store and the trust store file name.

      • Private key path: This field requires you to provide the path to the private key file and the private key file name.

      • Passphrase file: This field requires you to provide the path of the passphrase file and the passphrase file name. This field is optional.

      • CRL option: Specify the correct CRL option for your environment:

        • Use the CRL defined in the certificate. No additional information is required.

        • Use the CRL at the following path: You are prompted to provide a path to the CRL.

        • Do not use a CRL.

    • Proceed without security

      You receive a warning message listing potential issues. Depending on the state of the current security configuration, NetBackup may be unable to perform backups or restores until an external CA certificate has been configured.

    Click Next to continue.

  15. For remote upgrades only, on the Veritas NetBackup Remote Hosts screen, specify the hosts where you want NetBackup installed.

    • Windows Destination Systems

      Right-click Windows Destination Computers and select from the drop-down menu, or use the following methods:

      Browse

      Click here to search the network for the hosts where you want to upgrade NetBackup.

      • On the Available Systems dialog box, select the computer to add and click Next.

      • On the Remote Computer Login Credentials dialog box, enter the user name, the password, and the domain of the account for NetBackup to use on the remote computers.

      • If you plan to upgrade multiple remote computers, click the box next to Remember User Name and Password. Selecting this option prevents the need to enter this information for each remote computer.

        When you provide credentials, you select host nodes and add them to the Windows Destination Systems list. These are the nodes on which you remotely upgrade NetBackup. Make sure that you select your local host when you select systems to install.

        Each time you choose a system, NetBackup performs system and license checks. For example, it verifies the system for a server upgrade that matches the type that you selected, as follows:

        • NetBackup not installed: Considers the remote to be verified.

        • NetBackup already installed: Compares the upgrade type on that system to the upgrade type that you request.

        • Invalid combination: Notifies you of the problem and disallows the choice. One example of an invalid combination is to try to install a Remote Administration Console on a remote system that is already a master server.

        • Remote system not a supported platform or level: Notifies you of the problem and disallows the choice.

        The upgrade procedure also verifies that you have proper administrator credentials on the remote system. If you do not have administrator credentials, the Enter Network Password screen appears, and prompts you to enter the administrator's user name and password.

        Click OK and continue selecting destination systems.

        This process repeats for each node that you select. You can elect to retain the user name and password. In that case, you are prompted only when the user name or password is not valid.

        Note the following about the push-install process in a clustered environment:

        • You can upgrade NetBackup on any number of nodes. However, the clustering service sets the limit for the number of nodes in a cluster, not NetBackup.

        • Language packages and other NetBackup add-on products cannot be upgraded with the push method. Add-on products must be upgraded on each individual node in the cluster group. For instructions on how to upgrade these products, refer to the NetBackup documentation that supports each product.

      Browse (cont.)

      (continued)

      • NetBackup pushes to the other nodes only the license you enter at the beginning of the upgrade. Your license may enable add-on products. If you push NetBackup to nodes that have an add-on product already installed, your license works for that product.

      • Click OK.

      Import

      Click here to import a text file that contains a list of host names. When you create the text file, the host names must be defined in the following format:

      Domain\ComputerName

      Add

      Click here to add a host manually.

      • On the Manual Remote Computer Selection dialog box appears, enter the Domain and the Computer Name, then click OK.

      • On the Remote Computer Login Credentials dialog box, enter the User Name and the Password of the account to be used to perform the upgrade on the remote computers.

        If you plan to add and upgrade multiple remote computers, click the box next to Remember User Name and Password. Selecting this option prevents the need to enter this information for each remote computer.

      • Click OK.

      Remove

      To remove a host from the Destination Systems list, select the host and click here.

      Change

      Click here to change the destination for NetBackup file installation on the selected remote host.

    • Click Next.

  16. For cluster upgrades only, on the Cluster Settings screen, review the information displayed. All information except the Public Network is displayed for informational purposes and cannot be changed. If you need to change the public network, select the correct public network from the drop-down.

    Warning:

    You must not select a private network that is assigned to this cluster.

    Click Cluster Configuration. When the successful cluster configuration message appears, click Next.

  17. On the Ready to Install the Program screen, review the Installation Summary that shows your selections from the previous steps.

    Then select one of the following options:

    • Click Install to start the installation.

    • Click Back to view the previous screens and make any changes, then return to this screen and click Install.

    • Click Cancel to cancel the upgrade.

    After you click Install, the upgrade process begins and a screen appears that shows you the upgrade progress. This process may take several minutes.

    For remote or for cluster upgrades only, right-click on a system in the dialog box to see the upgrade status. Up to five upgrades occur simultaneously. When an upgrade is completed, another one begins so that a maximum of five upgrades are in progress.

  18. For remote upgrades only, when all remote upgrades have completed, click Finish.
  19. On the Installation Complete screen, select from the following options:

    Add Licenses

    Veritas recommends that you enter additional licenses now for any other NetBackup products you plan to install.

    • To enter additional licenses, click Add Keys.

    • When the list of Current License Keys appears, click Add Key to enter a new license key, then click Add.

    • After all license keys are entered, close the Current License Keys window.

    View installation log file

    An upgrade log file provides detailed installation information and shows whether any errors occurred. This log includes information about the optional installation of the Java GUI and the JRE.

    Examine the upgrade log at the following location:

    %ALLUSERSPROFILE%\Veritas\NetBackup\InstallLogs\

    Note:

    When you perform a remote upgrade to multiple computers, this option only lets you view the log for the local computer. Each computer that you selected for upgrade contains its own upgrade log file. To view the log file of a remote computer, open a Windows Explorer window and enter \\<COMPUTERNAME>.

    Search the upgrade log for the following error indications:

    • Strings that include Return Value 3.

    • Important log messages that are color coded as follows:

      Yellow = warning.

      Red = error.

    Finish

    Select one of the following to complete the upgrade:

    • If you are done upgrading software on all servers, click the box next to Launch NetBackup Administration Console now and click Finish.

      The NetBackup Administration Console starts a Configuration Wizard so that you can configure your NetBackup environment.

    • If you have more server software to upgrade, click Finish.

      You can move on to the next computer and upgrade the necessary server software.

  20. If any NetBackup cluster configuration is modified manually or by any external script, make sure that the change is reflected correctly in NetBackup cluster registry. Contact Veritas Enterprise technical support if you have questions.
  21. The binaries are successfully installed. Proceed to the post-installation procedure.

    More information is available.

    See Post-install procedure for upgrading to NetBackup 8.3.