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

Manually initiating upgrades from the master server using VxUpdate

You can manually initiate upgrades with VxUpdate using one of two methods. You can manually initiate an upgrade based on an existing policy. You can also initiate an upgrade without an associated policy.

Manually initiate deployment policies when you are logged into the master server locally and need to force an immediate update. Or you can initiate an immediate upgrade for emergency binaries. VxUpdate also provides the ability to launch upgrades from the media server or client with the command line. More information is available.

See Manually initiating upgrades from the media server or client using VxUpdate.

To manually initiate an upgrade of all media servers or clients in a policy from the administration console

  1. In the NetBackup Administration Console, navigate to Deployment Management > Deployment Policies.
  2. In the middle pane, expand the master server, and select the policy you want to run.
  3. Right-click on the policy you want to start, and select Manual Deployment.
  4. Alternatively, after selecting the policy you want to run, you can select Actions > Manual Deployment.

To manually initiate an upgrade of a specific host in a policy from the administration console

  1. Select NetBackup Management > Host Properties > Media Servers or NetBackup Management > Host Properties > Clients in the NetBackup Administrative Console.
  2. Right click on the host you want to upgrade in the right pane.
  3. Select Upgrade Host.
  4. In the Upgrade Host dialog:
    • Select the package you want to use from the Package drop-down.

      Note:

      Specifying a package that supports external certificate authority certificates presents you with an additional button titled Configure. That button is covered in the next step.

    • Specify the type of schedule you want to run from the Type drop-down.

    • Select the media server you want to use from the Media server drop-down.

      When you upgrade media servers, the Media server drop-down is automatically set to the master server and cannot be changed.

    • Confirm that the host you want upgraded is listed under Selected hosts.

  5. (Conditional) If present, click on the Configure button to configure external certificate authority information.

    By default, the Use existing certificates when possible option is selected. This option instructs NetBackup to use the existing NetBackup CA or external CA certificates, if certificates available.

    Note:

    If you specify this option and certificates are not available, the upgrade fails.

    Deselecting the Use existing certificates when possible option lets you specify the location for external certificate authority information for both UNIX and Linux computers and Windows computers.

  6. Windows clients have Use Windows certificate store selected by default.

    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:

    • Do not use a CRL. No additional information is required.

    • 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.

  7. For both UNIX and Linux clients and Windows clients that select the From certificate file path (for file-based certificates) option, specify the information as shown:
    • 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.

    • Then specify the correct CRL option for your environment:

      • Do not use a CRL. No additional information is required.

      • 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.

  8. Select OK to launch the upgrade.

    Note:

    You can also launch a client upgrade job from the Policies section of the NetBackup Administrative Console. Select NetBackup Management > Policies in the NetBackup Administrative Console. In the middle pane, select Clients. Then right-click on the client you want to upgrade in the right pane and select Upgrade Host. Then follow the procedure shown. This procedure is only applicable to clients, not media servers.

To manually initiate an upgrade from the command line for all media servers or clients in a policy

Use this procedure to manually start an upgrade for all media servers or clients in a policy.

Note:

This procedure starts the upgrade for all media servers or clients in the specified policy. You can start an upgrade on selected media servers or clients. More information is available.

To manually initiate an upgrade from the command line for selected hosts in a policy

  1. Open a command prompt and navigate to the directory shown:

    Windows: install_path\netbackup\bin

    UNIX or Linux: /usr/openv/netbackup/bin

  2. Use the nbinstallcmd command as shown to launch a policy:

    nbinstallcmd -policy policy_name -schedule schedule [-master_server master]

    Where policy_name is the name of the deployment policy, schedule is the name of the schedule, and master is the name of the master server.

To manually initiate an upgrade from the command line for selected hosts in a policy

Use this procedure to manually start an upgrade for selected hosts in a policy.

Note:

This procedure starts the upgrade on selected media servers and client in the specified policy. You can start an upgrade for all media servers and clients in a policy. More information is available.

To manually initiate an upgrade from the command line for all media servers or clients in a policy

  1. Open a command prompt and navigate to the directory shown:

    Windows: install_path\netbackup\bin

    UNIX or Linux: /usr/openv/netbackup/bin

  2. Use the nbinstallcmd command as shown:

    nbinstallcmd -policy policy_name -schedule schedule {-host_filelist filename|-hosts client1, client2, clientN}

    Where:

    • policy_name is the name of the deployment policy

    • schedule is the name of the schedule

    • filename is the name of a file that contains a list of media servers or clients to upgrade.

    • client1, client2, clientN is a list of media servers or clients to upgrade.

You can manually initiate the upgrade of a single client from the command line without an associated policy. The options required for the nbinstallcmd command vary depending on your security configuration. Please refer to the nbinstallcmd command documentation for a list of all possible options and examples of command usage.

NetBackup Commands Reference Guide