NetBackup™ Installation Guide

Last Published:
Product(s): NetBackup & Alta Data Protection (10.4)
  1. Preparing for installation
    1. General installation information
      1.  
        Available NetBackup installation methods
      2.  
        About compatibility between NetBackup versions
      3.  
        About NetBackup software availability
      4.  
        Required libraries missing from some Linux distributions
      5. How to install NetBackup
        1.  
          About the NetBackup preinstall checker
        2.  
          About the NetBackup Product Improvement Program
      6.  
        Creating the user account to support the NetBackup web server
      7. About storage device configuration
        1.  
          Locating supported robot types
      8.  
        About security certificates for NetBackup hosts
      9.  
        Environment variable for certificate key size
      10.  
        Restrictions on the NetBackup installation directory
      11.  
        NetBackup database is not supported on the btrfs file system
    2. Installation operational notes and limitations
      1.  
        Windows compiler and security requirements for NetBackup 10.4 and later installation
      2.  
        Java GUI and JRE installation optional for some computers
      3.  
        Enable 8dot3 name file setting for the NetBackup primary servers
      4.  
        NetBackup servers must use a host name that is compliant with RFC 1123 and RFC 952
      5.  
        Host ID-based certificate is not deployed during installation on 8.1 media server or client host with dual stack configuration
      6.  
        External certificate authority certificates supported in NetBackup 8.2 and later
      7.  
        SCCM and Chef deployment tools and documentation now available
      8.  
        Known SUSE Linux primary server install issue
    3.  
      Performance and tuning considerations
    4. SORT information
      1.  
        About Veritas Services and Operations Readiness Tools
      2.  
        Recommended SORT procedures for new installations
    5. Veritas NetInsights Console information
      1.  
        About Veritas Usage Insights
      2.  
        Best practices for Veritas Usage Insights
  2. NetBackup licenses
    1.  
      About NetBackup license requirements
    2.  
      About license entry
    3.  
      Frequently asked questions about licenses
  3. Installing server software on UNIX systems
    1. Installation requirements for UNIX and Linux
      1.  
        Do not mix non-English versions of Windows and UNIX platforms unless primary and media servers are NetBackup appliances
      2.  
        NetBackup installations on environments that run different versions of UNIX-based operating systems
      3.  
        Special installation guidelines for Solaris systems
      4.  
        Special installation guidelines for Linux clustered environments
    2.  
      How the installation script works
    3. Installing NetBackup primary server software on Linux
      1.  
        Silently installing NetBackup primary server software on Linux
      2.  
        Continuing with NetBackup software installation
    4. Installing NetBackup media server software on Linux
      1.  
        Silently installing NetBackup media server software on Linux
    5. About pushing client software from a primary server to clients
      1.  
        Installing client type software on a primary server
  4. Installing server software on Windows systems
    1.  
      Installation requirements for Windows and Windows clusters
    2.  
      Requirements for Windows cluster installations
    3.  
      Performing local, remote, or clustered server installation on Windows systems
    4.  
      Post-installation tasks for NetBackup cluster environments
    5.  
      Verifying Windows cluster installations or upgrades
    6.  
      Installing NetBackup servers silently on Windows systems
  5. About the administrative interfaces
    1.  
      About the NetBackup web user interface
    2.  
      About the NetBackup Administration Console
    3.  
      Installing the NetBackup Administration Console
    4.  
      Installing multiple versions of the NetBackup Administration Console on Windows
    5.  
      Removing earlier versions of the NetBackup Administration Console on Windows
    6.  
      About the NetBackup Remote Administration Console
    7.  
      Installing the NetBackup Remote Administration Console
  6. Installing NetBackup client software
    1.  
      About NetBackup client installation
    2. About NetBackup client installation on Windows
      1.  
        About Windows client installation methods and requirements
      2.  
        Installing NetBackup Windows clients locally or remotely
      3.  
        Installing NetBackup Windows clients silently
      4.  
        How to configure NetBackup clients
    3. About NetBackup client installation on UNIX and Linux
      1.  
        About UNIX and Linux client installation methods
      2.  
        Installing UNIX clients locally
      3.  
        Install of the UNIX and Linux client binaries with native installers
      4. About remote installation methods for UNIX and Linux clients
        1.  
          Installing client software with the ssh method
        2.  
          Installing client software with the sftp method
      5.  
        Adding a UNIX/Linux client after initial server installation
  7. Configuring NetBackup
    1.  
      About NetBackup startup and shutdown scripts
    2. About NetBackup server configuration
      1.  
        Starting the NetBackup Administration Console
      2.  
        About the Device Configuration Wizard
      3.  
        About the Volume Configuration Wizard
      4.  
        About the Catalog Backup Wizard
      5.  
        About the Backup Policy Configuration Wizard
  8. Removing NetBackup server and client software
    1.  
      About NetBackup server software removal on Linux systems
    2.  
      About NetBackup client software removal on UNIX and Linux systems
    3.  
      Removing NetBackup from UNIX and Linux servers and clients
    4.  
      About NetBackup server software removal on Windows systems
    5.  
      Removing NetBackup server and client software from Windows servers, clusters, and clients
    6.  
      About removal of the Java Console state data from Windows servers and Windows clients
    7.  
      Removing a clustered media server by migrating all data to a new media server
  9. Reference
    1.  
      Generate a certificate on the inactive nodes of a clustered primary server
    2.  
      NetBackup database user
    3.  
      About the NetBackup answer file
    4.  
      About the NetBackup IT Analytics Data Collector
    5.  
      Manually install or uninstall NetBackup IT Analytics Data Collector binaries
    6.  
      Manually configure the NetBackup IT Analytics Data Collector
    7.  
      Persistent Java Virtual Machine options
    8.  
      About RBAC bootstrapping
    9.  
      NetBackup primary server web server user and group creation
    10.  
      About the NetBackup Java Runtime Environment
    11.  
      Add or Remove Java GUI and JRE after install
    12.  
      Using NetApp disk arrays with Replication Director
    13.  
      Security updates to the NetBackup database
    14.  
      Size guidance for the NetBackup primary server and domain

Removing NetBackup from UNIX and Linux servers and clients

Use this procedure to remove NetBackup from UNIX and Linux servers and clients. You may also need to reference other documents for procedures of specific tasks to remove NetBackup successfully.

Use the following guidelines when you remove NetBackup from UNIX and Linux servers and clients:

NetBackup relational database (NBDB) location

If you moved the NBDB files in /usr/openv/db/data from their default installation location, this procedure includes a step that describes how to remove these files.

Clustered environments

Before you begin to remove NetBackup, you must remove NetBackup from the cluster application. Follow the instructions in your cluster documentation on how to remove a group, then you can remove NetBackup.

The virtual host name security certificates are automatically removed from the shared drive of the cluster as a part of NetBackup server software removal.

You must remove NetBackup from each node in the cluster.

PBX

When you remove NetBackup, PBX is not removed. You must remove PBX manually. This procedure includes a step that describes how to perform this task.

Warning:

Do not remove PBX if your server uses other Veritas software products that require PBX to run.

NetBackup Administration Console

The NetBackup Administration Console must be closed when you remove NetBackup. Otherwise, NetBackup may cause a failure that forces you to restart the procedure.

NetBackup IT Analytics Data Collector install location

NetBackup IT Analytics Data Collector is installed at /usr/openv/analyticscollector by default. If IT analytics DC is installed at any other location, a symbolic link is created at /usr/openv/analyticscollector.

Note:

Since the VRTSpddeu.rpm package is optional, you may not need to remove it.

To remove NetBackup from Linux servers

  1. Log on as the root user on the server or the client.
  2. (Conditional: servers only) Perform a catalog backup.
  3. If the NetBackup Administration Console is open, you must close it now.
  4. (Conditional: servers only) Save all important data from any add-on products that you have installed.
  5. Stop the NetBackup/Media Manager daemons with the following command:

    /usr/openv/netbackup/bin/bp.kill_all

  6. Identify any installed add-on products by using the following command:

    AIX

    lslpp -L

    Linux

    rpm -qa

    Solaris

    pkginfo

    Look for any of the seven add-on products listed:

    VRTSfrnb (Applies only to servers)
    VRTSfrnbclt
    VRTSjanb (Applies only to servers)
    VRTSjanbclt
    VRTSzhnb (Applies only to servers)
    VRTSzhnbclt
    VRTSnbsds (Applies only to servers)

    Remove any add-on products found.

  7. To unregister NetBackup from the VxUL primary configuration that is stored in the /etc/vx/vrtslog.conf file, run the following command:

    /usr/openv/netbackup/bin/vxlogcfg -r -p 51216

    The -p option specifies the product ID, which is 51216 for NetBackup.

  8. (Conditional: servers only) If BMR is supported and enabled on the server, remove the associated files with the following command:

    /usr/openv/netbackup/bin/bmrsetupmaster -undo -f

  9. (Conditional: servers only) If you moved the NBDB files from their default installation location, you must delete these files manually as follows:
    • Navigate to the following directory where the NBDB files reside:

      /usr/openv/db/data

    • Open the vxdbms.conf file.

      This file contains a list of the database-related files and the path for each file.

    • Delete each of the database-related files.

  10. (Conditional: servers only) If NetBackup Fibre Transport is supported and enabled on the server, remove the associated files.
    • If NetBackup Fibre Transport is enabled with BSI driver on Red Hat 7.x, run the command shown:

      /usr/openv/netbackup/bin/admincmd/nbftsrv_config -d

    • If NetBackup Fibre Transport is enabled with SCST driver, run the command shown:

      /usr/openv/netbackup/bin/admincmd/nbftsrv_config -scst -uninstall

  11. (Conditional: servers only) To remove the NetBackup server libraries, run the command shown.

    Note:

    The virtual host name security certificates are automatically removed from the shared drive of the cluster as a part of NetBackup server software removal.

    More information about this topic is available. Please refer to the information on retaining host ID-based certificates when reinstalling NetBackup in the NetBackup Security and Encryption Guide.

    Linux: rpm -e VRTSnbslibs

  12. (Conditional: primary servers only) Remove the packages shown, in the order shown, with the listed command:
    • rpm -e VRTSnbweb

    • rpm -e VRTSnbmqbrkr

  13. (Conditional: servers only) To remove the NetBackup server package, run the commands shown.

    Note:

    The virtual host name security certificates are automatically removed from the shared drive of the cluster as a part of NetBackup server software removal.

    More information about this topic is available. Please refer to the information on retaining host ID-based certificates when reinstalling NetBackup in the NetBackup Security and Encryption Guide.

    • Linux primary server:

      rpm -e VRTSnbprimary

      rpm -e VRTSnetbp

    • Linux media server:

      rpm -e VRTSnetbp

  14. (Conditional: primary servers only) Remove the package shown with the command shown:

    rpm -e VRTSpostgresql

  15. Remove the NetBackup configuration package with the appropriate command as follows:

    AIX

    installp -u VRTSnbcfg

    Linux

    rpm -e VRTSnbcfg

    Solaris

    pkgrm VRTSnbcfg

  16. For the clients that support PureDisk, remove all PureDisk files with the following command:

    /opt/pdde/pddeuninstall.sh -forceclean

  17. (Conditional: servers only) For the clients that support MSDP, remove all MSDP files with the following command:

    /opt/pdde/pddeuninstall.sh -basedir /usr/openv/pdde/ -ostdir /usr/openv/lib/ost-plugins/ -forceclean

    Note:

    Be aware the preceding command is a single command which takes three parameters (basedir, , ostdir, and forceclean), and two directory parameters take paths as input.

  18. Remove the NetBackup-Java Display Console by using the appropriate native command as follows:

    AIX

    installp -u VRTSnbjava

    Linux

    rpm -e VRTSnbjava

    Solaris

    pkgrm VRTSnbjava

  19. Remove the NetBackup Java Runtime Environment by using the appropriate native command as follows:

    AIX

    installp -u VRTSnbjre

    Linux

    rpm -e VRTSnbjre

    Solaris

    pkgrm VRTSnbjre

  20. Remove the NetBackup client libraries by using the appropriate native command as shown.

    Note:

    As part of the removal of the NetBackup server software, the security certificates are automatically deleted. If you want to retain the certificates, please save them before removing NetBackup.

    More information about this topic is available. Please refer to the information on retaining host ID-based certificates when reinstalling NetBackup in the NetBackupSecurity and Encryption Guide.

    AIX

    installp -u VRTSnbclibs

    Linux

    rpm -e VRTSnbclibs

    Solaris

    pkgrm VRTSnbclibs

  21. Remove the NetBackup client by using the appropriate native command as shown.

    Note:

    As part of the removal of the NetBackup server software, the security certificates are automatically deleted. If you want to retain the certificates, please save them before removing NetBackup.

    More information about this topic is available. Please refer to the information on retaining host ID-based certificates when reinstalling NetBackup in the NetBackupSecurity and Encryption Guide.

    AIX

    installp -u VRTSnbclt

    Linux

    rpm -e VRTSnbclt

    Solaris

    pkgrm VRTSnbclt

    Note:

    If there are running NetBackup processes and daemons, terminate them manually for a successful NetBackup removal.

  22. Remove PBX with the appropriate native command as follows:

    Note:

    Remember, you should not remove PBX if your server uses other Veritas software products that require PBX to run.

    AIX

    installp -u VRTSpbx

    Linux

    rpm -e VRTSpbx

    Solaris

    pkgrm VRTSpbx

  23. Remove NetBackup Pre-Check package with the appropriate command as follows:

    AIX

    installp -u VRTSnbpck

    Linux

    rpm -e VRTSnbpck

    Solaris

    pkgrm VRTSnbpck

  24. (Conditional: Linux only): Remove the Veritas PDDE package with the command shown:

    rpm -e VRTSpddei

  25. Remove PostgreSQL package

    rpm -e VRTSpostgresql.rpm

  26. Run the script that is shown to remove NetBackup IT Analytics Data Collector on Linux.

    /usr/openv/analyticscollector/UninstallerData/uninstall_dc.sh -r

    Remove the symbolic link from /usr/openv/analyticscollector if it exists.

    If the uninstall_dc.sh script is unavailable for any reason, complete the steps shown:

    1

    Stop the NetBackup IT Analytics Data Collector services:

    /usr/openv/analyticscollector/mbs/bin/aptare_agent stop
    systemctl stop aptare_kafka.service
    systemctl stop aptare_zookeeper.service
    systemctl disable aptare_zookeeper.service
    systemctl disable aptare_kafka.service

    2

    Delete the files. If /usr/openv/analyticscollector/ is a symbolic link, follow the link and identify the actual install path:

    rm -rf /usr/openv/analyticscollector/

    If /usr/openv/analyticscollector/ is symbolic link, be sure to delete the actual DC install path.

    rm -f /etc/systemd/system/aptare_kafka.service
    rm -f /etc/systemd/system/aptare_zookeeper.service
    systemctl daemon-reload
    rm -f /etc/init.d/aptare_agent

    3

    Remove the RC scripts if they exist:

    rm -f /etc/rc3.d/K*aptare_agent
    rm -f /etc/rc3.d/S*aptare_agent
    rm -f /etc/rc5.d/K*aptare_agent
    rm -f /etc/rc5.d/S*aptare_agent

    4

    If any stale processes are active on the system, stop them with the kill -9 pid command.

    ps -ef | grep aptare
    kill -9 pid
  27. Remove the /usr/openv directory.

    Warning:

    The rm commands used remove any add-on products that are installed on the computer where you perform this command.

    • Determine if /usr/openv is a symbolic link with the command shown. If /usr/openv is a symbolic link, make note of the actual path. The path is required for a later command.

      file -h /usr/openv

      /usr/openv: symbolic link to /opt/openv

    • If /usr/openv is a symbolic link, run the commands shown:

      cd /usr/openv

      This command changes you into the directory that symbolic link points to, such as /opt/openv.

      ls

      List the contents of the directory. Review this information to confirm what you are about to delete.

      Warning:

      Before you continue, make sure that you are at the correct location and verify that the subdirectories are what you expect them to be. To help prevent removing the wrong directories, the previous commands verify your current location and list the files in that directory. After you verify the directory location and its contents, remove the directory with the next commands.

      cd /

      Change to the root directory.

      rm -rf directory

      For the directory value, enter the information from the file command. This command deletes the directory that contains the NetBackup binaries.

      Example: rm -rf /opt/openv

      rm -f /usr/openv

      Delete the symbolic link.

    • If /usr/openv is the actual directory, run the command shown:

      rm -rf /usr/openv

      Note:

      Depending on your operating system, you may need to use the rmdir command to remove the /usr/openv directory.

      rmdir /usr/openv

  28. For Linux systems only:

    If you modified the startup and the shutdown scripts, run the following command:

    /sbin/chkconfig --del netbackup

    Depending on the distribution of Linux, the startup and the shutdown scripts may already be deleted.

    See About NetBackup startup and shutdown scripts.

  29. Remove the scripts shown. Depending on the operating system, the startup and the shutdown scripts may already be deleted.

    On AIX systems:

    /etc/rc.netbackup.aix

    On Linux Debian systems:

    /etc.init.d/netbackup
    /etc/rc0.d/K01netbackup
    /etc/rc1.d/K01netbackup
    /etc/rc2.d/S95netbackup

    On Linux Red Hat systems:

    /etc/rc.d/init.d/netbackup
    /etc/rc.d/rc0.d/K01netbackup
    /etc/rc.d/rc1.d/K01netbackup
    /etc/rc.d/rc2.d/S77netbackup
    /etc/rc.d/rc3.d/S77netbackup
    /etc/rc.d/rc5.d/S77netbackup
    /etc/rc.d/rc6.d/K01netbackup

    The following startup scripts are only on servers and appear only if NetBackup Fiber Transport was enabled on the server:

    /etc/rc.d/init.d/nbftserver
    /etc/rc.d/rc0.d/K03nbftserver
    /etc/rc.d/rc1.d/K03nbftserver
    /etc/rc.d/rc2.d/S21nbftserver
    /etc/rc.d/rc3.d/S21nbftserver
    /etc/rc.d/rc5.d/S21nbftserver
    /etc/rc.d/rc6.d/K03nbftserver

    On Linux SUSE systems:

    /etc/init.d/netbackup
    /etc/init.d/rc0.d/K01netbackup
    /etc/init.d/rc2.d/S77netbackup
    /etc/init.d/rc3.d/S77netbackup
    /etc/init.d/rc5.d/S77netbackup
    /etc/init.d/rc6.d/K01netbackup

    The following startup scripts are only on servers and appear only if NetBackup Fiber Transport was enabled on the server:

    /etc/init.d/nbftserver
    /etc/init.d/rc2.d/K01nbftserver
    /etc/init.d/rc2.d/S05nbftserver
    /etc/init.d/rc3.d/K01nbftserver
    /etc/init.d/rc3.d/S05nbftserver
    /etc/init.d/rc5.d/K01nbftserver
    /etc/init.d/rc5.d/S05nbftserver

    On other servers and clients:

    /etc/init.d/netbackup
    /etc/rc0.d/K01netbackup
    /etc/rc1.d/K01netbackup
    /etc/rc2.d/S77netbackup

    The following startup scripts are only on servers and appear only if NetBackup Fiber Transport was enabled on the server:

    /etc/init.d/nbftserver
    /etc/rc0.d/K03nbftserver
    /etc/rc1.d/K03nbftserver
    /etc/rc2.d/S21nbftserver
  30. For AIX systems only:

    • In the /etc/inittab file, remove the following NetBackup entry:

      /etc/rc.netbackup.aix
    • In the /etc/rc.shutdown file, remove the following line:

      /etc/rc.netbackup.aix stop
  31. Remove the LiveUpdate components as follows:

    • First, examine the following file to see if NetBackup is the only product that uses LiveUpdate:

      /etc/Product.Catalog.JavaLiveUpdate

    • If NetBackup is the only product that currently uses LiveUpdate, run the following command:

      /opt/Symantec/LiveUpdate/uninstall.sh -a

    • If LiveUpdate is the only product installed in the /opt/Symantec directory, remove the following files:

      rm -f /etc/Symantec.conf

      Note:

      Before you remove the following product catalog file, make sure that it is empty. The empty file size is equal to 0 bytes. If the product catalog file is not empty, do not remove it because other products still require it.

      rm -f /etc/Product.Catalog.JavaLiveUpdate

  32. To remove the NetBackup-Java application state data for the root account, run the appropriate command as follows:

    Warning:

    Do not insert a space between the slash character (/) and the period or the dot character (.) of /.veritas. A space between these characters removes all of your files from the root level and beyond.

    • To remove the NetBackup-Java application state data for the root account for all releases, run the following command:

      /bin/rm -rf /.veritas

    • To remove the NetBackup-Java application state data for the root account for a specific release, run the following command:

      /bin/rm -rf /.veritas/java/version

      Where version is the six-digit NetBackup version number. For example, NetBackup version 8.0 with no upgrades applied would be entered as 800000.

  33. Inform NetBackup-Java users that they can remove their $HOME/.veritas directory.

    The $HOME/.veritas and the $HOME/.veritas/java directories contain application state information, that is saved when the user exits NetBackup-Java applications. The saved information includes table column order and size. The process removes this directory for the root user only.

    The common subdirectory in $HOME/.veritas/java/.userPrefs/vrts can be removed.

  34. If you enabled NetBackup Access Control, NetBackup placed several files on clients and servers. These files can be divided into the following categories:
    • NetBackup application temporary files

      These files are removed with NetBackup.

    • Individual user (cache) files

      These cache files reside in the $HOME/.vxss directory. Inform all users that they can remove this directory.

      Files are generated in the /.vxss directory by a Single Sign-On operation of the NetBackup Administration Console on the host where the console runs. The NetBackup Administration Console cleans these files when an exit function is performed, so the directory does not always contain temporary files. However, if a system crash were to occur, any files in the directory may be left behind. With the console shutdown , you can delete these files safely with no data loss.

      NetBackup also creates cached certificates for client and server NetBackup applications. These files reside within the /.vxss directory. These files typically have a name that is consistent with a DNS entry for a network interface, as in machine.company.com. Example directory entries are as follows:

      /usr/openv/var/vxss/credentials/machine.company.com

      /usr/openv/var/vxss/credentials/dhcp

      These files are created with the command bpnbat -LoginMachine. If you plan to reinstall NetBackup on the same computer at a later date, do one of the following:

      • Preserve the certificates in the vxss/credentials directory.

      • If you do not preserve the certificates, you must provide the computer identity password as originally set on the Root+AB broker. As an alternative, you can reset the password on the Root+AB broker when you reinstall.

      For more information on Root+AB brokers, see the .NetBackup Security and Encryption Guide

      For more information on NetBackup Access Control and how to remove it, see the NetBackup Security and Encryption Guide.