Veritas NetBackup™ Flex Scale Installation and Configuration Guide

Last Published:
Product(s): Appliances (2.1)
Platform: NetBackup Flex Scale OS
  1. Preparing for NetBackup Flex Scale deployment
    1.  
      Deployment overview
    2.  
      Deployment options
    3.  
      NetBackup Flex Scale configuration requirements
    4.  
      Firewall and network ports requirements
    5.  
      Considerations for using IPv6 addresses
  2. Configuring NetBackup Flex Scale
    1.  
      Assigning a public IP address to network adapter eth1 of a node
    2.  
      NetBackup Flex Scale configuration methods
    3.  
      Configuring NetBackup Flex Scale using the setup wizard
    4. Configuring NetBackup Flex Scale using a configuration file
      1.  
        YML configuration file for deploying NetBackup primary and media servers
      2.  
        YML configuration file for deploying media servers
    5.  
      Changing the maintenance user account password
  3. Troubleshooting NetBackup Flex Scale deployment
    1.  
      NetBackup Flex Scale logs
    2.  
      Connection timeout errors during patch installs, upgrades, and rollback operations
    3.  
      Initial configuration wizard displays a driver node not selected error
    4.  
      Initial configuration wizard displays a license error after successfully configuring the cluster
  4. NetBackup Flex Scale upgrades and patch management
    1. About NetBackup Flex Scale upgrades and EEB
      1.  
        Pre-upgrade steps
      2.  
        Considerations for upgrade when disaster recovery is configured
    2.  
      Performing a patch upgrade using GUI
    3.  
      Installing EEBs using GUI
    4.  
      Performing a patch upgrade using REST APIs
    5.  
      Installing EEBs using REST APIs
    6.  
      About rolling upgrade
  5. Removing NetBackup Flex Scale
    1. About disk erasure
      1.  
        Configuring data erasure
      2.  
        Viewing the data erasure status
      3.  
        Aborting data erasure
    2.  
      About NetBackup Flex Scale node factory reset
    3.  
      Performing a factory reset on a node
  6. Appendix A. Installing NetBackup Flex Scale
    1.  
      About NetBackup Flex Scale software installation
    2.  
      Enabling remote IPMI connections
    3.  
      Setting up the RAID configuration on the nodes
    4.  
      Configuring the BIOS settings on the nodes
    5.  
      Downloading the product installer ISO
    6.  
      Mounting the ISO file on the nodes
    7.  
      Installing NetBackup Flex Scale using the ISO
    8.  
      Installing Emergency Engineering Binaries (EEBs)

Pre-upgrade steps

Before you being the upgrade, ensure that you complete the following tasks:

Verify that the account passwords do not expire in seven days

Before upgrading, ensure that the password for the maintenance account and for users with the Appliance administrator role does not expire within seven days. If the password expires within seven days for any of these users, change the password before you start the upgrade; else the pre-upgrade check fails and you cannot proceed with the upgrade.

Verify that the NetBackup license has not expired

Verify that the NetBackup license is valid and has not expired. If the license has expired, contact Veritas Support to renew the license.

To verify if the license is valid:

  1. Log in to one of the nodes using SSH and enter the support elevate command to access the root shell.
  2. Identify the cluster node on which the NetBackup master server is online:

    hagrp -state | grep NBUMasterWorker | grep ONLINE

    For example:

    nbfs-01:~ # hagrp -state | grep NBUMasterWorker | grep ONLINE
    NBUMasterWorker             State          nbfs-04 |ONLINE|
    nbfs-01:~ #
  3. Use SSH to log in to the node where the NetBackup master server is online and enter the support elevate command to access the root shell.
  4. On the node where the NetBackup master server is online, run the following command to view the NetBackup license key information:

    /usr/bin/docker exec -i nb_master bash -c "/usr/openv/netbackup/bin/admincmd/bpminlicense -nb_ufid 20"

    For example:

    nbfs-04:~ # /usr/bin/docker exec -i nb_master bash -c "/usr/openv/netbackup/bin/admincmd/bpminlicense -nb_ufid 20"
    0x05000000;PRID=6 (NetBackup Enterprise Server);FID=20 (Base NetBackup);SERIAL=0;VALUE=2000;DEXPIRE=2022/11/05 01:00:00 0 (Not expired);
    UXDEXPIRE=1667635200 0 (Not expired);UKEY=KLNN-VEIK-SWJT-7MLX-P6P6-BDOS-L4LS-A7SS-AXPP-P36C;
    UKEY=KLNP-JR8T-YX76-4KFF-ZCRP-RNWO-4F4K-4V7G-GVEC-PO4T
    nbfs-04:~ # 
  5. Check for the UXDEXPIRE keyword in the output. If the license is valid, the keyword is set to Not expired. If the license has expired, the keyword is set to Expired along with the expiration value. For example, the following snippet shows the keyword in the above sample output:
    UXDEXPIRE=1667635200 0 (Not expired)  

    To find the exact expiration timestamp, use the following command:

    /bin/date --d='@expiration-value'

    For example, in the above output the expiration-value is 1667635200

    nbfs-04:~ # /bin/date --d='@1667635200'
    Sat Nov  5 01:00:00 PDT 2022
    nbfs-04:~ #

    If the license has expired, contact Veritas Support to get the new license key.

To add a license:

  1. Check the status of the dedupe_ctrl_ip resource using the hares -display dedup_ctrl_ip -attribute State command. The resource should be online on one of the cluster nodes. If the resource is not online, check the status of the dedupe_ctrl_ip1 resource using the same command.

    For example:

    nbfs-04:~ # hares -display dedup_ctrl_ip -attribute State
    #Resource      Attribute  System   Value
    dedup_ctrl_ip  State      nbfs-01  OFFLINE
    dedup_ctrl_ip  State      nbfs-02  OFFLINE
    dedup_ctrl_ip  State      nbfs-03  OFFLINE
    dedup_ctrl_ip  State      nbfs-04  ONLINE
    nbfs-04:~ #

    For example:

    nbfs-04:~ # hares -display dedup_ctrl_ip1 -attribute State
    #Resource       Attribute  System   Value
    dedup_ctrl_ip1  State      nbfs-01  OFFLINE
    dedup_ctrl_ip1  State      nbfs-02  OFFLINE
    dedup_ctrl_ip1  State      nbfs-03  OFFLINE
    dedup_ctrl_ip1  State      nbfs-04  ONLINE
    nbfs-04:~ #
  2. Use the following command to find the IP address assigned to the resource.

    For example, if the dedup_ctrl_ip resource is online:

    nbfs-04:~ # hares -value dedup_ctrl_ip Address
    172.16.0.65
    nbfs-04:~ # 

    For example, if the dedup_ctrl_ip1 resource is online:

    nbfs-04:~ # hares -value dedup_ctrl_ip1 Address
    172.16.1.65
    nbfs-04:~ # 
  3. Run the following commands. The controller-ip is the IP address that is assigned to the resource that is online:
  • List the existing NetBackup license key:

    curl -K /opt/VRTSnas/conf/va_dd_curl.conf -s -X GET https://controller-ip:10100/v1/system/netbackup/license_keys

    nbfs-04:~ # curl -K /opt/VRTSnas/conf/va_dd_curl.conf -s -X GET 
    https://172.16.0.65:10100/v1/system/netbackup/license_keys 
    {"id":"uss-controller", "nb_license_keys":
    ["KLNP-JR8T-YX76-4KFF-ZCRP-RNWO-4F4K-4V7G-GVEC-PO4T"],"status":"ok"}
    nbfs-04:~ # 
  • Delete the existing NetBackup license key:

    curl -K /opt/VRTSnas/conf/va_dd_curl.conf -s -X DELETE https://controller-ip:10100/v1/system/netbackup/license_keys/license-key

    nbfs-04:~ # curl -K /opt/VRTSnas/conf/va_dd_curl.conf -s -X DELETE 
    https://172.16.0.65:10100/v1/system/netbackup/license_keys/KLNP-JR8T-YX76-
    4KFF-ZCRP-RNWO-4F4K-4V7G-GVEC-PO4T {"id":"uss-controller","status":"ok"} 
    nbfs-04:~ #
  • List the NetBackup license key again to ensure that the license key has been deleted successfully:

    curl -K /opt/VRTSnas/conf/va_dd_curl.conf -s -X GET https://controller-ip:10100/v1/system/netbackup/license_keys

    nbfs-04:~ # curl -K /opt/VRTSnas/conf/va_dd_curl.conf -s -X GET https://172.16.0.65:10100/v1/system/netbackup/license_keys 
    {"id":"uss-controller","nb_license_keys":[],"status":"ok"}
    nbfs-04:~ #
  • Create a new file /var/VRTSvcs/log/nbu_lic with the following content:

    {         
            "license_keys" : [ "<license-key>" ],
             "force" : true
    }
    nbfs-04:~ # cat /var/VRTSvcs/log/nbu_lic
    {         
            "license_keys" : [ "KLNP-CELL-O9NT-KFFZ-CRPR-NWO4-F4K4-V7GG-VECP-PPZ3" ],
             "force" : true
    }
    nbfs-04:~ #
  • Add the NetBackup license:

    curl -K /opt/VRTSnas/conf/va_dd_curl.conf -H "Content-Type: application/json" -s -X PUT https://controller-ip:101000/v1/system/netbackup/license_keys -d @/var/VRTSvcs/log/nbu_lic

    nbfs-04:~ # curl -K /opt/VRTSnas/conf/va_dd_curl.conf -H 
    "Content-Type: application/json" -s -X PUT 
    https://172.16.0.65:10100/v1/system/netbackup/license_keys -d 
    @/var/VRTSvcs/log/nbu_lic {"id":"uss-controller","nb_license_keys": 
    ["KLNP-CELL-O9NT-KFFZ-CRPR-NWO4-F4K4-V7GG-VECP-PPZ3"],"status":"ok"} 
    nbfs-04:~ #
  • List the NetBackup license:

    curl -K /opt/VRTSnas/conf/va_dd_curl.conf -s -X GET https://controller-ip:10100/v1/system/netbackup/license_keys

    nbfs-04:~ # curl -K /opt/VRTSnas/conf/va_dd_curl.conf -s -X GET 
    https://172.16.0.65:10100/v1/system/netbackup/license_keys 
    {"id":"uss-controller","nb_license_keys":
    ["KLNP-CELL-O9NT-KFFZ-CRPR-NWO4-F4K4-V7GG-VECP-PPZ3"], "status":"ok"}
    nbfs-04:~ #