Problem
This software update provides fixes for the NetBackup 52xx appliance series.
For additional information about new features, product fixes and enhancements,
known issues, and the current release content included in this release update,
refer to the following article on the Veritas Support Web site:
https://www.veritas.com/docs/000003383
================================================================================
=================
TABLE OF CONTENTS
=================
- PRODUCT DEPENDENCIES
- DOWNLOAD AND INSTALL INSTRUCTIONS
- ROLLBACK INSTRUCTIONS
Solution
====================
PRODUCT DEPENDENCIES
====================
-- If you use the appliance in a media server role, this upgrade requires a
NetBackup 7.5.0.4 master server or higher.
Note: If you use the appliance to communicate with a deduplication appliance
over Fibre Channel, ensure that the deduplication appliance version
is at 1.4.2 or higher.
-- This release supports and upgrade from version 2.5 to 2.5.1 on the appliance.
-- Rollback from this version of the NetBackup appliance to the previous version
is supported.
-- Before you begin the upgrade process, ensure that there are no backup jobs
currently running or scheduled to run during the process.
-- During installation of this release update, all NetBackup services and Web
services are shut down and restarted automatically.
-- Please make sure that the NetBackup master server is turned on and running.
In addition, ensure that the NetBackup processes are started on both the
master server and the media server.
-- The following dependencies pertain to client upgrades:
- If you have a client that is installed with a non-appliance version of
NetBackup, do not upgrade it from the appliance. Make sure that you
upgrade that client with a non-appliance version of NetBackup.
- If you have clients that were installed from a NetBackup appliance 2.0,
2.0.x, or 2.5 version then you should use the NetBackup appliance
2.5.1 version software to upgrade the client. Do not use a non-appliance
NetBackup update to upgrade the client.
- For Windows and UNIX client installs, you can use the same NetBackup
appliance 2.5.1 (7.5.0.4) package for clean installations and upgrades.
=================================
DOWNLOAD AND INSTALL INSTRUCTIONS
=================================
The following procedures describe how to install the 2.5.1 software update on
the NetBackup 52xx appliance and a NetBackup 52xx client. To download and
install a 2.5.1 software update, you have two options. You can use an automated
download procedures or a manual download procedure. Both procedures are
available to you below.
Steps to install the 2.5.1 software update using an automated download procedure:
--------------------------------------------------------------------------------
1. You should perform this procedure from a computer that is connected to the
appliance and make sure the appliance is connected to the Internet. That
ensures that you can download the release update from the Veritas Support
Web site to the appliance.
2. Open an SSH session and log on to the appliance as an administrator.
3. Enter the following commands to determine if a software update is available
from the Veritas Support Web site.
a. Main_Menu > Manage > Software > Check
Enter the "Download" command with the available RPM to download.
b. Main_Menu > Manage > Software > Download SYMC_NBAPP_update-2.5.1-1.x86_64.rpm
Run the verification of the RPM by running the List Downloaded command.
c. Main_Menu > Manage > List Downloaded
4. Switch to the appliance console and enter the following command to install
the software update. Use the name of the release update rpm from Step 3c.
Main_Menu > Manage > Software > Install <patch_name>
Where <patch_name> is the name of the software update to install. You must
ensure that the name you enter matches the name of the software update that
you downloaded on the appliance.
5. The installation takes approximately 45 minutes to complete and the
appliance reboots after the installation is completed. You can use the
following command to check that the appliance version is 2.5.1.
Main_Menu > Manage > Software > List Version
6. After the reboot, the appliance runs a self-diagnostic test after the
disk pools are back online. You can refer to the results in
/log/selftest_report_SYM<timedate>.txt for the results of this self test.
(If the self test failed, you can run the self test again to verify that
the test failed.)
If SMTP is configured, an email notification that contains the self
test result is sent.
Note: If the file transfer failed during this procedure, you can restart the
automated procedure or you can attempt to download and install the
software update using the manual download procedure.
Steps to install the 2.5.1 software update using a manual download procedure:
--------------------------------------------------------------------------------
Note: You can use this procedure to download and install a software update. If
the automated procedure failed for some reason, you may want to try this
procedure.
1. You should perform this procedure from a computer that is connected to the
appliance as well as to the Internet. This ensures that you can download the
release update from the Veritas Support Web site to the appliance.
2. Open an SSH session and log on to the appliance as an administrator.
3. Enter the following command to determine if a software update is available
from the Veritas Support Web site.
a. Main_Menu > Manage > Software > Check
4. Enter the following command to open the NFS and the CIFS shares:
Main_Menu > Manage > Software > Share Open
5. Map or mount the appropriate appliance NFS or CIFS share directory using the
steps below:
- UNIX: mkdir -p /mount/<appliance-name>
mount <appliance-name>:/inst/patch/incoming /mount/<appliance-name>
- Windows: Map the network drive "\\<appliance-name>\incoming patches"
on your computer.
Note: On Windows systems, you are prompted to provide the user name,
"admin", and its corresponding password.
6. Download and unzip or untar the release update from the Veritas Support
site. The following URL indicates the download location for the
NetBackup 52xx release updates.
https://www.veritas.com/support/en_US/58991.html
For this release the release update .rpm file name is split into multiple
files with the following filenames:
NB_Appliance_N_2.5.1.x86_64-tar-split.1of4
NB_Appliance_N_2.5.1.x86_64-tar-split.2of4
NB_Appliance_N_2.5.1.x86_64-tar-split.3of4
NB_Appliance_N_2.5.1.x86_64-tar-split.4of4
7. Join (and extract) these files using the command below:
Windows:
copy /b NB_Appliance_N_2.5.1.x86_64-tar-split.1of4+NB_Appliance_N_2.5.1.x86_64-tar-split.2of4+NB_Appliance_N_2.5.1.x86_64-tar-split.3of4+NB_Appliance_N_2.5.1.x86_64-tar-split.4of4 NB_Appliance_N_2.5.1.tar
Use the Windows unzip utility to extract the NB_Appliance_N_2.5.1.tar.
The resulting files are:
SYMC_NBAPP_update-2.5.1-1.x86_64.rpm
update.rpm.md5_checksum
update.rpm.sha1_checksum
UNIX:
cat NB_Appliance_N_2.5.1.x86_64-tar-split.1of4 NB_Appliance_N_2.5.1.x86_64-tar-split.2of4 NB_Appliance_N_2.5.1.x86_64-tar-split.3of4 NB_Appliance_N_2.5.1.x86_64-tar-split.4of4 | tar xvf -
Resulting files from the above command:
SYMC_NBAPP_update-2.5.1-1.x86_64.rpm
update.rpm.md5_checksum
update.rpm.sha1_checksum
8. Run one of the following commands to compute the checksum value for the
SYMC_NBAPP_update-2.5.1-1.x86_64.rpm. Verify that this checksum value matches
the content of the update.rpm.md5_checksum or update.rpm.sha1_checksum file.
md5sum SYMC_NBAPP_update-2.5.1-1.x86_64.rpm
or
sha1sum SYMC_NBAPP_update-2.5.1-1.x86_64.rpm
9. Copy this update rpm to the mounted share.
Note: During the copy process do not run any commands on the appliance.
Doing so might cause the update install to fail.
10. Unmap or unmount the shared directory after you have copied the update rpm
into the mounted share.
11. Enter the following command to close the NFS and the CIFS shares:
Main_Menu > Manage > Software > Share Close
Note: If you run any of the following commands before you run the "Share
Close" command, the update is moved from the share directory
location to its proper location. You must still run the "Share Close"
command to ensure that the NFS and the CIFS shares are closed.
- List Version
- List Details All
- List Details Base
- Share Open
- Share Close
12. Enter the following command to list the available release updates on
the appliance. Note the name of the uploaded release update.
Main_Menu > Manage > Software > List Downloaded
This validates and moves the update from the share directory to its
proper location. (You are not notified that this move has occurred.)
13. Switch to the appliance console and enter the following command to install
the release update. Use the name of the release update rpm from Step 8.
Main_Menu > Manage > Software > Install <patch_name>
Where <patch_name> is the name of the release update to install. You must
ensure that the name you enter matches the update name that you uploaded on
the appliance.
14. The installation takes approximately 45 minutes to complete and the
appliance reboots after the installation is completed. You can use the
following command to check that the appliance version is 2.5.1.
Main_Menu > Manage > Software > List Version
15. After the reboot, the appliance runs a self-diagnostic test after the
disk pools are back online. You can refer to the results in
/log/selftest_report_SYM<timedate>.txt for the results of this self test.
(If the self test failed, you can run the self test again to verify that
the test failed.)
If SMTP is configured, an email notification that contains the self
test result is sent.
Steps to install the 2.5.1 software update on the NetBackup 52xx client:
--------------------------------------------------------------------------------
1. Log into the client that you want to upgrade.
2. Open the administrative Web UI on the master server. In the right pane of
the landing page, click Software. The following list shows the choices that
you can choose using the Web browser:
- All
- Windows
- Linux
- Solaris
- AIX
- HP
- BSD
- Mac OS
Note: If you choose to extract Linux, UNIX, Solaris, AIX, or BSD images,
Veritas recommends that you use GNUtar version 1.16 or higher to
extract all .tar packages.
3. Choose All or select an operating system from the Operating System drop-down.
4. Right-click the appropriate file under Software to download the agent
software.
The browser writes the software files to the location you specify.
The following are example locations:
- On Windows platforms, download the software to C:\temp or to the desktop.
- On Linux or UNIX platforms, download the software to /tmp.
To determine the type of hardware on your Windows system, right-click
"My Computer" and select "Properties".
5. Unzip or untar the software package.
6. Install the client software
- For Windows, click on the Windows executable, setup.exe
- For UNIX systems, run the .install script.
7. For a clean install of the client, after you have successfully installed the
client software, you should add the appliance master server name to the
client.
- On Windows systems, you can use the Backup, Archive, and Restore interface
to add the appliance master server name on the client. Perform the
following steps:
- After NetBackup has been loaded on the client, open the Backup, Archive,
and Restore interface.
Start > All Programs > Veritas NetBackup > Backup, Archive, and Restore
- From the Backup, Archive, and Restore interface, select File > Specify
NetBackup Machines and Policy Type...
- From the "SpecifyNetBackupMachinesandPolicyType" dialog, enter the
server name in the "Server to use for backups and restores" field.
- Click "Edit Server List" and then click OK.
- In the dialog box that appears, enter the fully qualified host name of
the appliance master server and click OK.
- Close the Backup, Archive, and Restore interface.
- Restart the NetBackup Client Services.
- Open a Windows Command prompt.
- Enter "services.msc" and press Enter.
- On UNIX systems, add the appliance master server name to the bp.conf file
on the client. Perform the following steps:
- On the client, type the following command:
cd /usr/openv/netbackup
- Type ls to see the contents of the directory.
- Open the bp.conf file in a text editor.
- Enter the fully qualified host name of the appliance master server.
- Save your changes and close the file.
=====================
ROLLBACK INSTRUCTIONS
=====================
You can use the appliance shell menu to roll back to the previous version of
NetBackup on your appliance. The following procedure explains how to roll back
to a previous version.
1. Make sure that you have logged off and logged on to the appliance. That
ensures that the Rollback command is present in the appliance shell menu
if you decide that you want to roll back immediately after you have installed
a software release update.
2. From the appliance shell menu, enter the following command:
Main_Menu> Manage> Software> Rollback
3. At the following prompt, press the Y key to answer yes.
Do you want to rollback to x.x.x.x? (y/n)
Where x.x.x.x is the number of the previous software version.
The rollback process requires various processes to be stopped and started.
In addition, the previous version that is found, is displayed for you to see.
4. After Rollback has completed, log off and then log on to your appliance again.