Veritas NetBackup™ Flex Scale Installation and Configuration Guide
Pre-upgrade steps
Before you being the upgrade, ensure that you complete the following tasks:
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:
- Log in to one of the nodes using SSH and enter the support elevate command to access the root shell.
- 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:~ #
- 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.
- 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:~ #
- 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:
- 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:~ #
- 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:~ #
- 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:~ #