Important Update: Cohesity Products Documentation

All Cohesity product documentation are now managed via the Cohesity Docs Portal: https://docs.cohesity.com/HomePage/Content/home.htm. Some documentation available here may not reflect the latest information or may no longer be accessible.

NetBackup™ Installation Guide

Last Published:
Product(s): NetBackup (11.1)
  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
      6.  
        About the NetBackup preinstall checker
      7.  
        About the NetBackup Product Improvement Program
      8.  
        Creating the user account to support the NetBackup web server
      9. About storage device configuration
        1.  
          Locating supported robot types
      10.  
        About security certificates for NetBackup hosts
      11.  
        Restrictions on the NetBackup installation directory
      12.  
        Windows compiler and security requirements for NetBackup 11.1 and later installation
    2. Installation operational notes and limitations for NetBackup 11.1
      1.  
        About log file directory changes
      2.  
        About the NetBackup DirectIO
      3.  
        Enable 8dot3 name file setting for the NetBackup primary servers
    3.  
      Performance and tuning considerations
    4. SORT information
      1.  
        About Cohesity Services and Operations Readiness Tools
      2.  
        Recommended SORT procedures for new installations
    5. Cohesity NetInsights Console information
      1.  
        About Cohesity Usage Insights
      2.  
        Best practices for Cohesity 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.  
      About the NetBackup answer file
    2.  
      Add or remove the NetBackup DirectIO package after install
    3. Previous installation operational notes and limitations
      1.  
        About binaries installed on primary and media servers
      2.  
        Environment variable for certificate key size
      3.  
        NetBackup database is not supported on the btrfs file system
      4.  
        Ansible supported playbooks for NetBackup
      5.  
        Client push staging area no longer populated
      6.  
        NetBackup Administration Console and JRE installation optional for some computers
    4.  
      Generate a certificate on the inactive nodes of a clustered primary server
    5.  
      NetBackup database user
    6.  
      About the IT Analytics Data Collector
    7.  
      Manually install or uninstall IT Analytics Data Collector binaries
    8.  
      Manually configure the IT Analytics Data Collector
    9.  
      Persistent Java Virtual Machine options
    10.  
      About RBAC bootstrapping
    11.  
      NetBackup primary server web server user and group creation
    12.  
      About the NetBackup Java Runtime Environment
    13.  
      Add or remove Java components after install
    14.  
      Using NetApp disk arrays with Replication Director
    15.  
      Security updates to the NetBackup database
    16.  
      Size guidance for the NetBackup primary server and domain

Manually configure the IT Analytics Data Collector

The primary server installation deploys the IT Analytics Data Collector binaries automatically as part of a successful NetBackup installation. The binaries are installed to install_path\AnalyticsCollector (Windows) or /usr/openv/analyticscollector (Linux). This section details the steps that are required to manually configure the Data Collector.

Keep the following details handy when you configure the Data Collector:

  • Name of the Data Collector (as configured on the Cohesity Alta or IT Analytics Portal).

  • Passcode of the Data Collector (as configured on the Cohesity Alta or IT Analytics Portal).

  • Data receiver URL (generated when you create the Data Collector on the Cohesity Alta or IT Analytics Portal). Ensure the NetBackup primary server can resolve the host name of the Data Receiver URL.

  • Key file path (generated when you create the Data Collector on the Cohesity Alta or IT Analytics Portal and copied to the NetBackup primary server).

See the Add/Edit Data Collectors section in the IT Analytics User Guide for more information.

To configure the Data Collector manually on Windows:

  1. Create a response file as a batch script responsefile.cmd with the contents shown. These are the responses to the user input required to configure the Data Collector.
    SET DATACOLLECTOR_NAME=name_of_the_data_collector
SET DATACOLLECTOR_PASSCODE=passcode_for_the_data_collector
SET DATARECEIVER_URL=data_receiver_URL
SET DATACOLLECTOR_KEY_FILE_PATH=path_to_the_key_file
SET HTTP_PROXY_CONF=N
SET PROXY_HTTP_URL=
SET PROXY_HTTP_PORT=
SET PROXY_HTTPS_URL=
SET PROXY_HTTPS_PORT=
SET PROXY_USERID=
SET PROXY_PASSWORD=
SET PROXY_NOT_FOR=
  2. Update the value for each field with appropriate data. A sample response file is also available in the installer media in x64\ITA_DC\responsefile.cmd.
  3. Run the command shown:
    "C:\ProgramData\Veritas\NetBackup IT Analytics\DC\configure.cmd"
\RESPFILE:response_file_path \INSTALL_TYPE:CONFIG
  4. Validate the Data Collector integration with IT Analytics by going to install_path\analyticscollector\mbs\bin\ and running this command:
    checkinstall.bat

    If the Data Collector is configured with the Portal, the response is displayed as SUCCESSFUL.

    Note:

    If there is a version mismatch of aptare.jar between the Data Collector and the portal, execution of the checkinstall.bat command starts an auto-update of the Data Collector.

To configure the Data Collector manually on Linux:

  1. Create a response file with the contents shown. These are the responses to the user input required to configure the Data Collector:
    COLLECTOR_NAME=name_of_the_data_collector
COLLECTOR_PASSCODE=passcode_for_the_data_collector
DR_URL=data_receiver_URL
COLLECTOR_KEY_PATH=path_to_the_key_file
HTTP_PROXY_CONF=N
HTTP_PROXY_ADDRESS=
HTTP_PROXY_PORT=
HTTPS_PROXY_ADDRESS=
HTTPS_PROXY_PORT=
PROXY_USERNAME=
PROXY_PASSWORD=
PROXY_EXCLUDE=
  2. Update the value for each field with appropriate data.

    A sample response file is available on the install media and from /usr/openv/analyticscollector/installer/responsefile.sample on the primary server.

  3. Run the command: 
    /usr/openv/analyticscollector/installer/dc_installer.sh -c responsefile_path
  4. Validate the Data Collector integration with IT Analytics by navigating to /usr/openv/analyticscollector/mbs/bin/ and running ./checkinstall.sh

    If the Data Collector is able to communicate with the IT Analytics Portal, the response is displayed as SUCCESSFUL.

    Note:

    If there is a version mismatch of aptare.jar between the Data Collector and the portal, execution of the checkinstall.sh command starts an auto-update of the Data Collector.

Start, stop, and get the status of the Data Collector

On Linux:

  • To start the Data Collector processes, run:

    /usr/openv/analyticscollector/mbs/bin/aptare_agent start

  • To stop the Data Collector processes, run:

    /usr/openv/analyticscollector/mbs/bin/aptare_agent stop

  • To get the status of the Data Collector processes, run:

    /usr/openv/analyticscollector/mbs/bin/aptare_agent status

On Windows: Review the status of Aptare Agent, Aptare Kafka, and Aptare Zookeeper services on the Windows service panel.

Note:

If the Data Collector is configured with an on-premises IT Analytics Portal, then to edit any of the Data Collector properties on the Portal, refer to Edit IT Analytics Data Collector credentials section in the IT Analytics User Guide.