NetBackup™ Upgrade Guide

Last Published:
Product(s): NetBackup (10.1.1)
  1. Introduction
    1.  
      About the NetBackup 10.1.1 Upgrade Guide
    2.  
      Available NetBackup upgrade methods
    3. About changes in NetBackup 10.1.1
      1.  
        Windows compiler and security requirements for NetBackup 9.1 and later installation and upgrade
      2.  
        Java GUI and JRE installation optional for some computers
      3.  
        Logging directory permissions require reset on rollback
      4.  
        Upgrades from NetBackup 7.6.0.4 and earlier are not supported
      5.  
        External certificate authority certificates supported in NetBackup 8.2 and later
    4.  
      About Veritas Usage Insights
    5.  
      Best practices for Veritas Usage Insights
  2. Planning for an upgrade
    1. General upgrade planning information
      1.  
        About planning a NetBackup 10.1.1 upgrade
      2.  
        How to plan for an upgrade to NetBackup 10.1.1
      3.  
        Legacy logging directory security update
      4.  
        Notifications, Messages, and Resiliency configuration information are not upgraded
      5.  
        Known catalog backup limitation
      6.  
        About security certificates for NetBackup hosts
      7.  
        About automatic file changes from an upgrade
      8.  
        Reduce the job database size before upgrade
      9.  
        Known SUSE Linux primary server upgrade issue
    2.  
      Performance and tuning considerations
    3. About upgrade tools
      1.  
        About Veritas Services and Operations Readiness Tools
      2.  
        Recommended SORT procedures for upgrades
      3.  
        About the NetBackup preinstall checker
    4. Upgrade operational notes and limitations
      1.  
        Creating the user account to support the NetBackup web server
      2.  
        NetBackup IT Analytics Data Collector installed for NetBackup 10.1.1
      3.  
        About NetBackup 10.1.1 support for Fibre Transport Media Server with RHEL 7.5 and later
      4.  
        MSDP changes in NetBackup 8.1
      5.  
        Potential required changes for NetApp clusters
      6.  
        Errors when Bare Metal Restore information is replicated using Auto Image Replication
      7.  
        Upgrade issue with pre-8.1 clients and 8.1 or later media servers
  3. Primary server upgrade
    1.  
      About primary server upgrades
    2.  
      Preinstall procedure for upgrading to NetBackup 10.1.1
    3.  
      Performing local, remote, or clustered server upgrades on Windows systems
    4.  
      Performing silent upgrades on Windows systems
    5.  
      Upgrading Linux server software to NetBackup 10.1.1
    6.  
      Silently upgrading NetBackup primary server software on Linux
    7.  
      Post-install procedure for upgrading to NetBackup 10.1.1
    8.  
      About NetBackup startup and shutdown scripts
    9.  
      Completing your system update after an upgrade
  4. Media server upgrade
    1.  
      Preinstall procedure for upgrading media servers to NetBackup 10.1.1
    2.  
      Upgrading NetBackup media servers to NetBackup 10.1.1
    3.  
      Silently upgrading NetBackup media server software on 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.  
      Preinstall procedure for upgrading clients to NetBackup 10.1.1
    3.  
      Upgrading UNIX and Linux clients with the NetBackup upgrade script
    4.  
      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 primary 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 primary server web server user and group creation
    2.  
      Generate a certificate on the inactive nodes of a clustered primary 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.  
      Manual install or uninstall of the NetBackup IT Analytics Data Collector
    8.  
      Configure Data Collector manually for NetBackup
    9.  
      Persistent Java Virtual Machine options
    10.  
      About RBAC bootstrapping
    11.  
      About NetBackup software availability
    12.  
      Additional post-upgrade steps for NetApp clusters
    13.  
      Using NetApp disk arrays with Replication Director
    14.  
      About compatibility between NetBackup versions
    15.  
      Upgrade requirements for UNIX and Linux
    16.  
      Upgrade requirements for Windows and Windows clusters
    17.  
      Requirements for Windows cluster upgrades
    18.  
      Removing a clustered media server by migrating all data to a new media server
    19.  
      Post upgrade procedures for Amazon cloud storage servers
    20.  
      Upgrading clients after servers are upgraded
    21.  
      Upgrade failure rollback steps
    22.  
      Size guidance for the NetBackup primary server and domain

About the NetBackup answer file

NetBackup provides a way to perform unattended, silent installation, and upgrades with a predefined set of configuration options. These options allow the user to:

  • Override some default values.

  • Avoid answering some questions during interactive installation.

On UNIX and Linux, templates for primary, media, and clients are available at the top level of the NetBackup installation image that is downloaded from Veritas. These templates should be modified as needed and placed in /tmp/NBInstallAnswer.conf for use during installs and upgrades.

On Windows, templates for primary, media, and client are in the windows_x64 directory at the top level of the NetBackup installation image that is downloaded from Veritas. These templates are called silentprimary.cmd, silentmedia.cmd, and silentclient.cmd.

Templates for media and clients are available at the top level of the NetBackup installation image downloaded from Veritas.

Populate the NetBackup answer file on the target host before you run the installation script. Create the file if it does not exist. The supported entries are shown along with any relevant information.

Table: All template options and required computers

Option

NetBackup role

Platform

Required for upgrade?

ABORT_REBOOT_INSTALL

Primary, media, and client

Windows

No

ACCEPT_EULA

Primary, media, and client

UNIX and Linux

No

ACCEPT_REVERSE_CONNECTION

Client

All

No

ADDITIONALSERVERS

Primary, media, and client

Windows

No

ALLOW_PRE_90_UPGRADE

Primary

All

See the option for details.

AUTHORIZATION_TOKEN

Media and client

All

Review About security configuration considerations for details.

CA_CERTIFICATE_FINGERPRINT

Media and client

All

Review About security configuration considerations for details.

CLIENT

Client

Windows

Yes

CLIENT_NAME

Media and client

UNIX and Linux

No

ECA_CERT_PATH

Media and client

All

Review About security configuration considerations for details.

ECA_CERT_STORE

Media and client

Windows

Review About security configuration considerations for details.

ECA_CRL_CHECK_LEVEL

Media and client

All

Review About security configuration considerations for details.

ECA_CRL_PATH

Media and client

All

Only when ECA_CRL_CHECK_LEVEL=USE_PATH is specified.

ECA_KEY_PASSPHRASEFILE

Media and client

All

No

ECA_PRIVATE_KEY_PATH

Media and client

All

Review About security configuration considerations for details.

ECA_TRUST_STORE_PATH

Media and client

All

Review About security configuration considerations for details.

INCLUDE_JAVA_GUI_AND_JRE

Media and clients

All

UNIX and Linux media servers and clients: No

Windows media servers: Yes

INSTALL_PATH

Media and client

All

No

INSTALLDIR

Primary, media, and client

Windows

No

LICENSE

Primary

UNIX and Linux

No

LICENSEKEY

Primary

Windows

No

MACHINE_ROLE

Media and client

UNIX and Linux

No

MEDIA_SERVER

Client

UNIX and Linux

No

MEDIASERVER

Media

Windows

No

MERGE_SERVERS_LIST

Client

UNIX and Linux

No

PRIMARYSERVER

Primary, media, and client

Windows

Yes

PROCEED_WITH_INSTALL

Primary, media, and client

UNIX and Linux

No

RBAC_DOMAIN_NAME

Primary

Linux

No

RBAC_DOMAIN_TYPE

Primary

Linux

No

RBAC_PRINCIPAL_NAME

Primary

Linux

No

RBAC_PRINCIPAL_TYPE

Primary

Linux

No

SECURITY_CONFIGURATION

Media and client

All

No

SERVER

Media and client

UNIX and Linux

No

SERVICES

Client

UNIX and Linux

No

SERVICESTARTTYPE

Primary, media, and client

Windows

No

SERVICE_USER

Primary

Linux

Yes

START_JOB_DAEMONS

Primary

Linux

No

STOP_NBU_PROCESSES

Primary, media, and client

Windows

No

USAGE_INSIGHTS_FILE_PATH

Primary

Windows and Linux

Possibly

VNETD_PORT

Primary, media, and client

Windows

No

WEBSVC_DOMAIN

Primary

Windows

Yes

WEBSVC_GROUP

Primary

All

UNIX and Linux: No

Windows: Yes

WEBSVC_PASSWORD_PLAIN

Primary

Windows

Yes

WEBSVC_USER

Primary

All

UNIX and Linux: No

Windows: Yes

Answer file options by platform and role

These tables show the possible answer file options based on platform and role. Not all listed options are required. Refer to Table: All template options and required computers or the option details for further information.

Table: Windows computers

Primary

Media

Client

ABORT_REBOOT_INSTALL
ADDITIONALSERVERS 
ALLOW_PRE_90_UPGRADE 
INSTALLDIR
LICENSEKEY
PRIMARYSERVER
SERVICESTARTTYPE 
STOP_NBU_PROCESSES 
USAGE_INSIGHTS_FILE_PATH 
VNETD_PORT 
WEBSVC_DOMAIN 
WEBSVC_GROUP 
WEBSVC_PASSWORD_PLAIN 
WEBSVC_USER
ABORT_REBOOT_INSTALL
ADDITIONALSERVERS
AUTHORIZATION_TOKEN 
CA_CERTIFICATE_FINGERPRINT 
ECA_CERT_PATH 
ECA_CERT_STORE 
ECA_CRL_CHECK_LEVEL 
ECA_CRL_PATH 
ECA_KEY_PASSPHRASEFILE 
ECA_PRIVATE_KEY_PATH 
ECA_TRUST_STORE_PATH 
INCLUDE_JAVA_GUI_AND_JRE 
INSTALL_PATH 
INSTALLDIR 
MEDIASERVER
PRIMARYSERVER
SERVICESTARTTYPE 
STOP_NBU_PROCESSES 
VNETD_PORT
ABORT_REBOOT_INSTALL 
ACCEPT_REVERSE_CONNECTION 
ADDITIONALSERVERS 
AUTHORIZATION_TOKEN 
CA_CERTIFICATE_FINGERPRINT 
CLIENT 
ECA_CERT_PATH 
ECA_CERT_STORE 
ECA_CRL_CHECK_LEVEL 
ECA_CRL_PATH 
ECA_KEY_PASSPHRASEFILE 
ECA_PRIVATE_KEY_PATH 
ECA_TRUST_STORE_PATH 
INCLUDE_JAVA_GUI_AND_JRE 
INSTALL_PATH 
INSTALLDIR
PRIMARYSERVER 
SERVICESTARTTYPE 
STOP_NBU_PROCESSES 
VNETD_PORT

Table: UNIX and Linux computers

Primary

Media

Client

ACCEPT_EULA
ALLOW_PRE_90_UPGRADE 
CLIENT_NAME
INSTALL_PATH
LICENSE
MACHINE_ROLE
MEDIA_SERVER
PROCEED_WITH_INSTALL
RBAC_DOMAIN_NAME 
RBAC_DOMAIN_TYPE 
RBAC_PRINCIPAL_NAME 
RBAC_PRINCIPAL_TYPE 
SERVER
SERVICE_USER 
START_JOB_DAEMONS
USAGE_INSIGHTS_FILE_PATH
WEBSVC_GROUP 
WEBSVC_USER
ACCEPT_EULA
AUTHORIZATION_TOKEN 
CA_CERTIFICATE_FINGERPRINT 
CLIENT_NAME 
ECA_CERT_PATH 
ECA_CRL_CHECK_LEVEL 
ECA_CRL_PATH 
ECA_KEY_PASSPHRASEFILE 
ECA_PRIVATE_KEY_PATH 
ECA_TRUST_STORE_PATH 
INCLUDE_JAVA_GUI_AND_JRE 
INSTALL_PATH  
MACHINE_ROLE
PROCEED_WITH_INSTALL
SERVER
ACCEPT_EULA
ACCEPT_REVERSE_CONNECTION 
AUTHORIZATION_TOKEN 
CA_CERTIFICATE_FINGERPRINT 
CLIENT_NAME 
ECA_CERT_PATH 
ECA_CRL_CHECK_LEVEL 
ECA_CRL_PATH 
ECA_KEY_PASSPHRASEFILE 
ECA_PRIVATE_KEY_PATH 
ECA_TRUST_STORE_PATH 
INCLUDE_JAVA_GUI_AND_JRE 
INSTALL_PATH 
MACHINE_ROLE 
MEDIA_SERVER 
MERGE_SERVERS_LIST
PROCEED_WITH_INSTALL
SERVER 
SERVICES
About security configuration considerations

The version of NetBackup and the operation that is performed determines what security parameters are required in the template file.

Security configuration considerations for initial installation or pre-8.1 upgrade

If this operation is an initial installation or an upgrade from pre-8.1, at least one set of security configuration parameters must be provided. You can skip the security configuration but that requires manual steps on each target host after installation or upgrade.

To use the NetBackup primary server as your Certificate Authority, the CA_CERTIFICATE_FINGERPRINT of the primary server must be provided. The AUTHORIZATION_TOKEN option may be required depending on either the security level of the primary server or if this computer is already configured on the primary server. More information is available: https://www.veritas.com/support/en_US/article.000127129.

To use an external certificate authority on UNIX and Linux, the ECA_CERT_PATH, ECA_CRL_CHECK_LEVEL, ECA_PRIVATE_KEY_PATH, and ECA_TRUST_STORE_PATH values are required. More information is available: https://www.veritas.com/support/en_US/article.100044300

For more information, see the NetBackup Security and Encryption Guide and refer to the chapter on external CA and external certificates.

To use an external certificate authority on Windows: either provide the ECA_CERT_STORE and ECA_CRL_CHECK_LEVEL values or all values previously specified for UNIX and Linux.

The ECA_CRL_PATH and ECA_KEY_PASSPHRASEFILE values are optional. More information is available: https://www.veritas.com/support/en_US/article.100044300.

For more information, see the NetBackup Security and Encryption Guide and refer to the chapter on external CA and external certificates.

Security configuration considerations for upgrades of NetBackup 8.1 or newer

When you upgrade NetBackup from a version that already has secure communications configured (NetBackup 8.1 or newer), the CA_CERTIFICATE_FINGERPRINT and AUTHORIZATION_TOKEN values are ignored.

Security configuration considerations for upgrades of NetBackup 8.2 or newer

When you upgrade NetBackup from a version that already has ECA configured (NetBackup 8.2 or newer), all the ECA* parameters are ignored.

About skipping the external certificate authority configuration

To continue the installation or upgrade without configuring the certificate authority, include the SECURITY_CONFIGURATION key and set it to SKIP. Remove the CA_CERTIFICATE_FINGERPRINT, AUTHORIZATION_TOKEN, and all ECA_ values from the answer file. If you continue the installation or the upgrade without the required certificate authority components, backups and restores fail.

ABORT_REBOOT_INSTALL

  • Description: This option halts the installation or upgrade if a restart is required. Valid values are 0, don't halt and 1, halt.

  • Applicable platforms: Windows only.

  • Default value: 0

  • Required: No.

  • ABORT_REBOOT_INSTALL 0 | 1

  • Return to Table: All template options and required computers.

ACCEPT_EULA

  • Description: This option specifies if you accept the terms of the EULA and want to proceed with the installation or the upgrade.

  • Applicable platforms: UNIX and Linux

  • Default Value: None

  • Required: No

  • ACCEPT_EULA = yes | no

  • Return to Table: All template options and required computers.

ACCEPT_REVERSE_CONNECTION

  • Description: Use this option to identify how a NAT client connects with a NetBackup host. Accepted values are TRUE and FALSE. Set this option to TRUE if NetBackup needs to support NAT, otherwise set it to FALSE. Set ACCEPT_REVERSE_CONNECTION=FALSE if:

    • You do not want NetBackup to support NAT clients.

    • The NetBackup clients are not behind the firewall.

  • Applicable platforms: Both UNIX and Windows.

  • Default value: FALSE

  • ACCEPT_REVERSE_CONNECTION=TRUE | FALSE

  • Return to Table: All template options and required computers.

ADDITIONALSERVERS

  • Description: Use this option to Include NetBackup media servers that are used to proxy security requests to the primary server. List only the servers that were added since the last installation of this host. The install process combines the existing set of servers with the new ones. The use of IP addresses is not supported. Valid input values are a comma-separated list of fully qualified computer names.

  • Applicable platforms: Windows only.

  • Default value: None.

  • Required: No.

  • ADDITIONALSERVERS server1,server2,servern

  • Return to Table: All template options and required computers.

ALLOW_PRE_90_UPGRADE

  • Description: This field is for primary servers only. This value determines if the upgrade from pre-NetBackup 9.0 releases to NetBackup 9.0 and later can proceed. The upgrade includes the infinite expiration conversion process. This conversion only takes place when you upgrade from pre-NetBackup 9.0 to NetBackup 9.0 or later. The upgrade behavior and need for this option depend on your primary server platform.

    • Windows

      This value is required for silent upgrades of Windows primary servers. Specify 1 to allow the upgrade to continue, specify 0 to prevent the upgrade. This value is ignored during an interactive Windows primary server upgrade. Depending on the size of the NetBackup catalog and the required conversion time, you may be asked if you want to continue the upgrade.

    • Linux

      For Linux primary servers, specify yes or no to eliminate user prompts. If the infinite expiration conversion is expected to add length to the upgrade process, a value of yes means the upgrade proceeds. A value of no means the upgrade stops. If this value is not specified, NetBackup prompts you if you want to continue with the upgrade.

    NetBackup 9.0 and later versions support the expiration dates that extend beyond the year 2038. To ensure compatibility with previous NetBackup versions, all items with an infinite expiration date are updated to reflect the new infinite expiration date value. This conversion may extend the time that is required to complete the upgrade. Review the article that is shown for more information:

    https://www.veritas.com/support/en_US/article.100048600

  • Applicable platforms: Both UNIX and Windows.

  • Default value: None

  • Required: Platform and upgrade method dependent.

  • ALLOW_PRE_90_UPGRADE=yes|no (UNIX)

    ALLOW_PRE_90_UPGRADE=1|0 (Windows)

  • Return to Table: All template options and required computers.

AUTHORIZATION_TOKEN

  • Description: This option specifies that NetBackup should automatically use an authorization or a reissue token when it retrieves the host certificate. The AUTHORIZATION_TOKEN is 16 upper case letters. Some environments require an authorization token for backups and restores to work correctly. If this information is required and is not provided in the answer file, the installation fails. If SKIP is specified, the installer attempts to retrieve a host certificate without including a token. In some environments this choice may result in additional manual steps following the installation.

    Be aware that AUTHORIZATION_TOKEN is ignored under either of these conditions:

    • ECA is in use on the primary server.

    • The primary server's security level is set lower than High.

  • Applicable platforms: Both UNIX and Windows.

  • Default value: None.

  • Required: Review About security configuration considerations for details.

  • AUTHORIZATION_TOKEN=ABCDEFGHIJKLMNOP | SKIP

  • Return to Table: All template options and required computers.

CA_CERTIFICATE_FINGERPRINT

  • Description: This option specifies the Certificate Authority (CA) Certificate Fingerprint. Both SHA-1 and SHA-256 fingerprints are supported. The Certificate Fingerprint is retrieved from the CA during installation or upgrade. The fingerprint format is 59 or 95 characters and is a combination of the digits 0-9, the letters A-F, and colons. For example, 01:23:45:67:89:AB:CD:EF:01:23:45:67:89:AB:CD:EF:01:23:45:67. The fingerprint value must match the fingerprint for the server value that is specified in the first SERVER=server_name option.

    Be aware that CA_CERTIFICATE_FINGERPRINT is ignored under either of these conditions:

    • ECA is in use on the primary server.

    • The primary server's security level is set lower than High.

  • Applicable platforms: Both UNIX and Windows.

  • Default value: None.

  • Required: Review About security configuration considerations for details.

  • CA_CERTIFICATE_FINGERPRINT=fingerprint

  • Return to Table: All template options and required computers.

CLIENT

  • Description: This option specifies the name that NetBackup uses to identify this client host. The %COMPUTERNAME% value lets the local host provide the computer name. If this value is used, it may be possible to use the same answer file on all computers within a single primary server domain. The use of IP addresses is not supported.

  • Applicable platforms: Windows only.

  • Default value: None.

  • Required: Yes.

  • CLIENT=client_name | %COMPUTERNAME%

  • Return to Table: All template options and required computers.

CLIENT_NAME

  • Description: This option specifies the name that NetBackup uses to identify this computer. The XLOCALHOSTX value lets the local host provide the computer name. If this value is used, it may be possible to use the same answer file on all computers within a single primary server domain. This value is added to the bp.conf file.

    If CLIENT_NAME is specified on upgrade, a check is made to validate that the name that is provided in the answer file matches the value that is configured in the bp.conf file.

  • Applicable platforms: UNIX and Linux only.

  • Default value: None.

  • Required: No

  • CLIENT_NAME=name | XLOCALHOSTX

  • Return to Table: All template options and required computers.

ECA_CERT_PATH
ECA_CERT_STORE
ECA_CRL_CHECK_LEVEL

  • Description: This option specifies the CRL mode. Supported values are:

    • USE_CDP: Use the CRL defined in the certificate.

    • USE_PATH: Use the CRL at the path that is specified in ECA_CRL_PATH.

    • DISABLED: Do not use a CRL.

    • The ECA_CERT_PATH option is ignored on upgrade if ECA is already configured on the host or if NBCA only is in use on the primary server.

  • Applicable platforms: All.

  • Default value: None.

  • Required: Review About security configuration considerations for details.

  • ECA_CRL_CHECK_LEVEL=value

  • Return to Table: All template options and required computers.

ECA_CRL_PATH

  • Description: This option specifies the path and the file name of the CRL associated with the external CA certificate.

    The ECA_CERT_PATH option is ignored on upgrade if ECA is already configured on the host or if NBCA only is in use on the primary server.

  • Applicable platforms: All.

  • Default value: None.

  • Required: Only when ECA_CRL_CHECK_LEVEL=USE_PATH is specified.

  • ECA_CRL_PATH=path

  • Return to Table: All template options and required computers.

ECA_KEY_PASSPHRASEFILE

  • Description: This option specifies the path and the file name of the file that contains the passphrase to access the keystore.

    The ECA_CERT_PATH option is ignored on upgrade if ECA is already configured on the host or if NBCA only is in use on the primary server.

  • Applicable platforms: All.

  • Default value: None.

  • Required: No

  • ECA_KEY_PASSPHRASEFILE=path/filename

  • Return to Table: All template options and required computers.

ECA_PRIVATE_KEY_PATH
ECA_TRUST_STORE_PATH
INCLUDE_JAVA_GUI_AND_JRE

  • Description: Used to determine how to handle the optional Java and JRE components during install or upgrade. Supported values are:

    • INCLUDE: Include the Java GUI and JRE as part of the installation or upgrade.

    • EXCLUDE: Exclude the Java GUI and JRE. This option also removes all previous versions of the Java GUI and the JRE if they are present on the host.

    • MATCH: Match the existing configuration on the host. If you specify this option on an initial installation, the components are not installed.

  • Applicable platforms: All.

  • Default value: None

  • Required: UNIX and Linux, no. Windows media servers, yes.

  • Return to Table: All template options and required computers.

INSTALL_PATH

  • Description: This option specifies the location to install the NetBackup binaries. Only the absolute path to a base directory is required for this option. The installer automatically appends /openv. This option cannot be used to change the location of NetBackup during an upgrade.

    Be aware that the INSTALL_PATH option is ignored on upgrade.

  • Applicable platforms: UNIX and Linux only.

  • Default value: /usr

  • Required: No

  • INSTALL_PATH = path

  • Return to Table: All template options and required computers.

INSTALLDIR

  • Description: This option specifies the location to install NetBackup. The fully qualified path to the base directory is required.

  • Applicable platforms: Windows only.

  • Default value: None.

  • Required: Yes

  • INSTALLDIR=C:\Program Files\Veritas

  • Return to Table: All template options and required computers.

LICENSE

  • Description: This option specifies the license key string to apply to the primary server. Additional LICENSE = key_string lines may be added if more licenses are to be applied. This option only adds additional keys - no existing keys are removed.

  • Applicable platforms: UNIX and Linux only.

  • Default value: None.

  • Required: No.

  • LICENSE = key_string

  • Return to Table: All template options and required computers.

LICENSEKEY

  • Description: This option specifies the NetBackup license key for the primary server installation.

  • Applicable platforms: Windows only.

  • Default value: None.

  • Required: Yes for primary servers. Not required for media servers and clients.

  • LICENSEKEY=NetBackup_license_key

  • Return to Table: All template options and required computers.

MACHINE_ROLE

  • Description: This option specifies the NetBackup role to install and configure on this computer. For upgrades, this value must match the configured role on the computer.

  • Default value: None. Supported values are PRIMARY, MEDIA, and CLIENT.

  • Applicable platforms: UNIX and Linux only.

  • Required: No.

  • MACHINE_ROLE = PRIMARY | MEDIA | CLIENT

  • Return to Table: All template options and required computers.

MEDIA_SERVER

  • Description: This option specifies that NetBackup may use the named host to tunnel secure web requests for this client. A tunnel is required when communication between the client and the NetBackup Web Service on the primary server is blocked. This communication is required to obtain a host certificate during the NetBackup installation or upgrade. You can have multiple MEDIA_SERVER entries in the answer file.

  • Applicable platforms: UNIX and Linux only.

  • Default value: None.

  • Required: No.

  • MEDIA_SERVER=media_server_name

  • Return to Table: All template options and required computers.

MEDIASERVER

  • Description: This option specifies the name of the host this computer recognizes as its media server. The use of IP addresses is not supported.

  • Applicable platforms: Windows only.

  • Default value: None.

  • Required: No.

  • MEDIASERVER=media_server_name

  • Return to Table: All template options and required computers.

MERGE_SERVERS_LIST

  • Description: Merge the servers present in bp.conf on the primary with the server list contained in this client's bp.conf.

  • Applicable platforms: UNIX and Linux only.

  • Default value: NO

  • Required: No.

  • MERGE_SERVERS_LIST = yes | no

  • Return to Table: All template options and required computers.

PRIMARYSERVER

  • Description: This option specifies the server name this computer recognizes as the current NetBackup primary server. If this host is the primary server, %COMPUTERNAME% can be used for the value. The use of IP addresses is not supported. Additional primary servers can be specified with the ADDITIONALSERVERS option.

  • Applicable platforms: Windows only.

  • Default value: None.

  • Required: Yes.

  • PRIMARYSERVER=primary_server_name

  • Return to Table: All template options and required computers.

PROCEED_WITH_INSTALL

  • Description: This option lets you proceed or stop the installation after the preinstallation checks. You may want to resolve some of the non-critical checks that failed before you proceed. Any critical check failure still causes the installation or upgrade to abort.

  • Applicable platforms: UNIX and Linux

  • Default Value: None

  • Required: No

  • PROCEED_WITH_INSTALL = yes | no

  • Return to Table: All template options and required computers.

RBAC_DOMAIN_NAME

  • Description: This option specifies the domain name of the principal that is configured to have the role-based access control (RBAC) permissions for the Administrator role.

  • Default value: None.

  • Applicable platforms: UNIX and Linux only.

  • Required: No

  • RBAC_DOMAIN_NAME = domain_name

  • Return to Table: All template options and required computers.

RBAC_DOMAIN_TYPE

  • Description: This option specifies the domain type of the principal that is configured to have the role-based access control (RBAC) permissions for the Administrator role.

  • Applicable platforms: UNIX and Linux only.

  • Default value: None.

  • Required: No

  • RBAC_DOMAIN_TYPE = domain_type

  • Return to Table: All template options and required computers.

RBAC_PRINCIPAL_NAME

  • Description: This option specifies the name of the principal that is configured to have the role-based access control (RBAC) permissions for the Administrator role. This user or the user group must already exist on the system.

  • Applicable platforms: UNIX and Linux only.

  • Default value: None.

  • Required: No

  • RBAC_PRINCIPAL_NAME = principal_name

  • Return to Table: All template options and required computers.

RBAC_PRINCIPAL_TYPE

  • Description: This option specifies the type of the principal that is configured to have the role-based access control (RBAC) permissions for the Administrator role.

  • Applicable platforms: UNIX and Linux only.

  • Default value: None.

  • Required: No

  • RBAC_PRINCIPAL_TYPE = USER | USERGROUP

  • Return to Table: All template options and required computers.

SECURITY_CONFIGURATION

  • Description: Applicable only if neither NetBackup certificate authority nor external certificate authority are configured on the host. Set this option to SKIP to continue the installation or upgrade without configuring the host to use NBCA or ECA. If you skip security, you must take additional manual steps on all target hosts when the installation or the upgrade finishes. When this option is set to SKIP, values cannot be specified for CA_CERTIFICATE_FINGERPRINT, AUTHORIZATION_TOKEN, and the ECA_ options.

  • Applicable platforms: All.

  • Default value: None.

  • Required: No.

  • SECURITY_CONFIGURATION = SKIP

  • Return to Table: All template options and required computers

SERVER

  • Description: This option specifies the server name this computer recognizes as the current NetBackup primary server. Additional SERVER= lines may be added if there are other servers that should be recognized. In the case where multiple SERVER= lines are present, the first occurrence is the primary server. These entries are added to the bp.conf file.

  • Applicable platforms: UNIX and Linux only.

  • Default value: None.

  • Required: No.

  • SERVER=primary_server_name

  • Return to Table: All template options and required computers.

SERVICES

  • Description: This option specifies whether NetBackup services should be started upon completion of the client installation or upgrade. If no is specified, the NetBackup services are not started. Additional manual configuration steps may be performed after the install or upgrade but before the NetBackup services are started.

  • Applicable platforms: UNIX and Linux only.

  • Default value: YES

  • Required: No.

  • SERVICES=no

  • Return to Table: All template options and required computers.

SERVICESTARTTYPE

  • Description: This option specifies if the NetBackup services are restarted after the host server reboots.

  • Applicable platforms: Windows only.

  • Default value: Automatic

  • Required: No.

  • SERVICESTARTTYPE=Automatic | Manual

  • Return to Table: All template options and required computers.

SERVICE_USER

  • Description: This option specifies the service user account is used to start most of the NetBackup services or daemons on the primary server. Be aware of the items shown:

    • Veritas recommends you do not use the root user as the service user.

    • Veritas recommends you do not use the nbwebsvc user as the service user.

    • The nbwebgrp group must be a secondary group of the service user.

    • Ownership of the /usr/openv directory changes to the new service user account that you specify with this option.

    • Use the nbserviceusercmd --changeUser command to change this user after installation.

    • For cluster servers, the service user and the service user ID must be same on all cluster nodes.

    • If the SERVICE_USER value is provided in the answer file and it exists in the bp.conf file, the values must match.

    • More information about the service user account is available: https://www.veritas.com/docs/100048220

  • Applicable platforms: Linux only.

  • Default value: None.

  • Required: Yes.

  • SERVICE_USER=name

  • Return to Table: All template options and required computers.

START_JOB_DAEMONS

  • Description: This option specifies whether the NetBackup daemons that control the execution of jobs should be started.

  • Applicable platforms: Linux only.

  • Default value: yes

  • Required: No.

  • START_JOB_DAEMONS=yes|no

  • Return to Table: All template options and required computers.

STOP_NBU_PROCESSES

  • Description: This option specifies if the install process should stop any active NetBackup processes automatically if detected. Be sure to confirm there are no active NetBackup jobs and that all NetBackup databases are shut down before installation or upgrade. Valid input values are 0 for don't stop, and 1 for stop.

  • Applicable platforms: Windows only.

  • Default value: 0

  • Required: No.

  • STOP_NBU_PROCESSES = 0 | 1

  • Return to Table: All template options and required computers.

USAGE_INSIGHTS_FILE_PATH

  • Description: This option specifies the path and the file name of the Usage Insights customer registration key file.

  • Applicable platforms: All.

  • Default value: None.

  • Required: Upgrades from pre-NetBackup 8.1.2 require this option. Upgrades from 8.1.2 and later do not require this option.

  • USAGE_INSIGHTS_FILE_PATH = path_and_file_name

  • Return to Table: All template options and required computers.

VNETD_PORT
WEBSVC_DOMAIN

  • Description: Use this option to associate the web server with Domain (Active Directory) accounts. Provide the domain name in this field. If you plan to associate the web server with local accounts, leave this field blank.

  • Applicable platforms: Windows only.

  • Default value: None.

  • Required: No.

  • WEBSVC_DOMAIN=domain_name

  • Return to Table: All template options and required computers.

WEBSVC_GROUP

  • Description: This option specifies the group name of the account that the NetBackup web server uses. This group must already exist on the system.

  • If the WEBSVC_GROUP value is provided in the answer file and it exists in the bp.conf file, the values must match.

  • Applicable platforms: All.

  • Default value: nbwebgrp

  • Required: Linux primary servers, no. Windows primary servers, yes.

  • WEBSVC_GROUP=custom_group_account_name

  • Return to Table: All template options and required computers.

WEBSVC_PASSWORD_PLAIN

  • Description: This option specifies the password for the Windows WEBSVC_USER account. If your websvc password contains any special characters (% ^ & < > | ' ` , ; = ( ) ! " \ [ ] . * ?), add the appropriate escape characters to the password. For example if the websvc password is abc% you must enter abc%%.

    Caution:

    This option places the password for this account in clear text and can potentially be a security concern.

  • Applicable platforms: Windows only.

  • Default value: None.

  • WEBSVC_PASSWORD_PLAIN=password

  • Return to Table: All template options and required computers.

WEBSVC_USER

  • Description: This option specifies the user name of the account that the NetBackup web server uses. This user must already exist on the system.

    If the WEBSVC_USER value is provided in the answer file and it exists in the bp.conf file, the values must match.

  • Applicable platforms: All.

  • Default value: nbwebsvc

  • Required: Linux primary servers, no. Windows primary servers, yes.

  • WEBSVC_USER=custom_user_account_name

  • Return to Table: All template options and required computers.