NetBackup Appliance 2.6.1.1 Release
https://support.symantec.com/en_US/article.TECH227005.html
This software update contains changes to the installation procedure to enhance the upgrade process for NetBackup 52xx and 5330 appliances.
NOTE: You can install this software update on an existing appliance that is running version 2.5.x, 2.6.0.x, or 2.6.1. If you are already running version 2.6.1.1, you do not need to apply this patch.
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 NetBackup Appliance 2.6.1.1 Release Notes.
==================
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 2.6.1 or 2.6.1.1 master appliance, or a NetBackup 7.6.1 or 7.6.1.1 master server.
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.3 or higher.
-- After a successful installation, rollback from this version of NetBackup Appliance to version 2.6.1 is supported. However, rollback is not supported for upgrades from version 2.5.x or 2.6.0.x to 2.6.1.1.
-- 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 throughout the duration of the media appliance upgrade. In addition, ensure that the NetBackup processes are started on both the master server and the media server.
===================================
DOWNLOAD AND INSTALL INSTRUCTIONS
===================================
Download notes: Due to the unique file naming extension of these split files, care should be taken in how your browser interacts during the download. When you right click on the file link and select "save link as" or "save target as," ensure that the filename retains the .xof3 extension. (for example, .2of3)
The following procedure describes how to download and install the 2.6.1.1 software update on the NetBackup 52xx or 5330 Appliance and a NetBackup client.
PLEASE NOTE: Client packages must be downloaded separately with 2.6.1.1 and are not automatically included in the 2.6.1.1 release update. See the following instructions on how to download the client packages. The client installation instructions are located further down on this page.
Steps to manually download the NetBackup Appliance software version 2.6.1.1 release update or client packages
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
NOTE: If the automated download method failed, use this method to upload the appliance software release update or client package.
Perform this method from a computer that is connected to the appliance and that also has Internet access. Internet access is needed to download the files or packages from the Symantec Support website to the appliance.
1. Open an SSH session and log on to the appliance as an administrator.
2. Enter the following command to open the NFS and the CIFS shares:
Main_Menu > Manage > Software > Share Open
3. Map or mount the appropriate appliance NFS or CIFS share directory using the steps below:
- Windows: Map the following CIFS share on your computer:
\\<appliance-name>\incoming_patches
NOTE: On Windows systems, you are prompted to provide the user name (admin) and its corresponding password.
- UNIX: Mount the following appliance NFS share:
mkdir -p /mount/<appliance-name>
mount <appliance-name>:/inst/patch/incoming/mount/<appliance-name>
4. Scroll to the bottom of this page and download the release update or the client package. The following will help you determine which files to download:
- For release updates:
For this release, the release update .rpm file name is split into multiple files with the following filenames:
NB_Appliance_N_2.6.1.1-1.x86_64-tar-split.1of3
NB_Appliance_N_2.6.1.1-1.x86_64-tar-split.2of3
NB_Appliance_N_2.6.1.1-1.x86_64-tar-split.3of3
To continue with release update downloading, go to step 5.
- For client packages:
Client packages are not split and use the following naming convention:
SYMC_NBAPP_addon_nbwin_<version>.x86_64.rpm
or
SYMC_NBAPP_addon_nbclient_<platform and version>.x86_64.rpm
where <platform and version> is the specific platform operating system and the NetBackup version of the client package. For example:
SYMC_NBAPP_addon_nbclient_HP-UX-IA64-7.6.1.1-SLES11x86_64.rpm
To continue with client package downloading, go to step 7.
5. Use one of the following commands to join (and extract) the release update .rpm files:
- Windows:
copy /b NB_Appliance_N_2.6.1.1-1.x86_64-tar-split.1of3+NB_Appliance_N_2.6.1.1-1.x86_64-tar-split.2of3+NB_Appliance_N_2.6.1.1-1.x86_64-tar-split.3of3 NB_Appliance_N_2.6.1.1-1.tar
Joined NB_Appliance_N_2.6.1.1-1.tar file has MD5: 48b89b23ed8dd07bead4922060fec0b2 SHA1: 66dbf1d8e4d443f803a6c0d7646d71229347fc42
Use Windows WinRAR utilities to uncompress the resulting tar file, NB_Appliance_N_2.6.1.1-1.tar.
The resulting files are:
SYMC_NBAPP_update-2.6.1.1-1.x86_64.rpm
update.rpm.md5_checksum
update.rpm.sha1_checksum
- UNIX:
cat NB_Appliance_N_2.6.1.1-1.x86_64-tar-split.1of3 NB_Appliance_N_2.6.1.1-1.x86_64-tar-split.2of3 NB_Appliance_N_2.6.1.1-1.x86_64-tar-split.3of3 | tar xvf -
Resulting files from the above command:
SYMC_NBAPP_update-2.6.1.1-1.x86_64.rpm
update.rpm.md5_checksum
update.rpm.sha1_checksum
NOTE: Symantec recommends that you use GNU tar version 1.16 or higher instead of tar to extract packages on UNIX systems. See the following tech note for more information about extracting images:
6. For UNIX systems, run one of the following commands to compute the checksum value for the SYMC_NBAPP_update-2.6.1.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.6.1.1-1.x86_64.rpm
or
sha1sum SYMC_NBAPP_update-2.6.1.1-1.x86_64.rpm
7. Copy this release update or client package .rpm to the mounted share.
NOTE: During the copy process, do not run any commands on the appliance. Doing so can cause the copy operation to fail.
8. After you have successfully copied the release update or client package .rpm into the mounted share, unmap or unmount the shared directory.
9. From the appliance, 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 downloaded release update or client package 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
10. To list the available release updates or client packages on the appliance, enter the following command and note the name of the downloaded files:
Main_Menu > Manage > Software > List Downloaded
Running this command validates and moves the release update or the client package from the share directory to its proper location. You are not notified that this move has occurred.
If you receive a status of Pending when you run the List Downloaded command, wait a few minutes and try again.
Steps to install the uploaded NetBackup Appliance software version 2.6.1.1 release update
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
After you have downloaded a software update to the appliance, it can be installed from the NetBackup Appliance Shell Menu using this procedure.
When you perform an appliance upgrade, Symantec recommends that you take precautions to avoid loss of connectivity. Any loss of connectivity during an upgrade results in failure. The computer that you use to upgrade the appliance should be set up to avoid the following events:
- Conditions that cause the computer to go to sleep
- Conditions that cause the computer to shut down or to lose power
- Conditions that cause the computer to lose its network connection
The following describes operational behavior during and after an appliance upgrade:
- If you perform an upgrade from the NetBackup Appliance Shell Menu, the NetBackup Appliance Web Console is still available for use during the upgrade operation.
- When you upgrade a NetBackup appliance, the FTMS server is restarted automatically. As a result, the Fibre Channel (FC) ports must be rescanned to allow any SAN client computers to reconnect to the Fibre Transport (FT) devices. The last step in the following procedures describes how to rescan the FC ports after the upgrade has been completed.
Use the following commands to view the available release updates, see which update is currently installed, and see the current version of the appliance:
- Main_Menu > Manage > Software > Check
This command checks the Symantec Support website for the latest software update.
- Main_Menu > Manage > Software > List Downloaded
This command shows the available appliance release updates.
- Main_Menu > Manage > Software > List Details All
This command shows all of the software packages that are currently installed on the appliance.
- Main_Menu > Manage > Software > List Details Base
This command shows all of the software packages that were installed on your appliance during the factory installation.
- Main_Menu > Manage > Software > List Version
This command shows the appliance version, the NetBackup version, and the appliance build date.
To install a software update that has been downloaded to the appliance:
1. Log in to the appliance console and enter the following command to install the release update. Use the name of the release update rpm from Step 6.
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.
2. Watch the onscreen progress of the upgrade to see an estimated completion time. To see the current status of the upgrade, enter the following command:
Main_Menu > Manage > Software > UpgradeStatus
NOTE: This command is available only for upgrades from version 2.6.0.1 and later and cannot be used for upgrades from 2.5.x.
3. The upgrade may force the appliance to restart several times. After the upgrade has completed and the disk pool are back online, the appliance runs a self-diagnostic test. Refer to the following file for the test results:
/log/selftest_report_SYM<timedate>.txt
If SMTP is configured, an email notification that contains the self-test result is sent.
4. Complete this step only if your backup environment includes SAN client machines.
The Fibre Channel (FC) ports must be rescanned to allow any SAN client machines to reconnect to the Fibre Transport (FT) devices. The rescan must be done from the NetBackup CLI view on the appliance.
To rescan the FC ports:
- Enter the following command to see a list of NetBackup user accounts:
Manage > NetBackupCLI > List
- Log in to this appliance as one of the listed NetBackup users.
- Run the following command to rescan the FC ports:
nbftconfig -rescanallclients
- If any SAN clients still do not work, run the following commands on each of these clients in the order as shown:
- Windows:
<install_path>\NetBackup\bin\bpdown
<install_path>\NetBackup\bin\bpup
- UNIX:
/usr/openv/netbackup/bin/bp.kill_all
/usr/openv/netbackup/bin/bp.start_all
- If any SAN clients still do not work, you must manually initiate a SCSI device refresh at the OS level. The refresh method depends on the operating system of the client. Once the refresh has completed, attempt the nbftconfig -rescanallclients command again.
- If any SAN clients still do not work, restart those clients.
NOTE: If you have an SLES 10 or SLES 11 SAN clients that still do not work, Symantec recommends that you upgrade the QLogic driver on those clients. For the affected SLES 10 clients, upgrade to version 8.04.00.06.10.3-K. For the affected SLES 11 clients, upgrade to version 8.04.00.06.11.1.
Steps to download and install NetBackup client software from the appliance server packages
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
You can download NetBackup client software from a NetBackup appliance to any client that you want to back up. The logon page of the NetBackup Appliance Web Console provides a Download Packages section to download the client packages. The packages are listed by operating system type in a drop-down box as follows:
- All
- Windows
- Linux
- Solaris
- AIX
- HP
- BSD
- Mac OS
- VMware vCenter Plug-in
NOTE: If you download Linux, UNIX, Solaris, AIX, or BSD images, Symantec recommends that you use GNU tar version 1.16 or higher to extract the .tar packages. For more information, see the following tech note on the Symantec Support website:
In addition to the downloading instructions, this procedure also includes the steps to extract and install the downloaded files on the client.
To download NetBackup client packages from a NetBackup appliance to a client:
1. Log in to the client that you want to back up.
2. Open a browser window and enter the appliance URL.
3. In the middle of the landing page, in the section Download Packages, click on the drop-down box to see the list of packages.
4. Right-click the selected package and specify the location to download it onto the client.
Example locations are as follows:
- On Windows platforms, download the software to C:\temp or to the desktop.
To determine the type of hardware on your Windows system, right-click My Computer and select Properties.
- On Linux or UNIX platforms, download the software to /tmp.
NOTE: If the message "No packages found" appears after you make a selection, the client package is not currently installed on the appliance. Revisit the download instructions at the beginning of this topic.
5. Unzip or untar the software package.
6. Install the client software as follows:
- Windows systems: click the setup.exe file.
- UNIX systems: run the .install script.
7. After you have successfully installed the client software, add the appliance master server name to the client as follows:
- Windows systems:
- After NetBackup has been loaded on the client, open the Backup, Archive, and Restore interface as follows:
Start > All Programs > Symantec NetBackup > Backup, Archive, and Restore
- From the Backup, Archive, and Restore interface, select File > Specify NetBackup Machines and Policy Type...
- From the Specify NetBackup Machines and Policy Type dialog, enter the server name in the Server to use for backups and restores field. Then click Edit Server List and 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 by opening a Windows Command prompt. Then, enter services.msc and press Enter.
- UNIX systems:
- On the client, navigate to the following location:
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
=======================
NOTE: Rollback is not supported for upgrades from version 2.5.xor 2.6.0.x to 2.6.1.1.
You can roll back an appliance to a checkpoint that you choose from the NetBackup Appliance Web Console or the NetBackup Appliance Shell Menu.
From the NetBackup Appliance Web Console, use the Manage > Appliance Restore > Appliance Rollback option.
To roll back to an existing checkpoint from the NetBackup Appliance Shell Menu:
1. Log on to the appliance as an administrator and open the appliance shell menu.
2. Enter the following command:
Main_Menu > Support > Checkpoint Rollback
The shell menu informs you of the components that are reverted during this process. It also lists all of the existing checkpoints.
3. Enter the number of the checkpoint that you want to use for the rollback operation.
4. Enter Yes if you want to automatically restart all appliances after the rollback completes. Enter Yes a second time to confirm that you want to restart the appliance automatically after the rollback operation completes.
5. Enter Yes to begin the rollback to a checkpoint operation.