NetBackup Appliance 52xx 220.127.116.11 README
This software update contains changes to the installation procedure to enhance the upgrade process for NetBackup 52xx appliances.
NOTE: You can install this software update on an existing appliance that is running version 2.5.x. If you are already running version 18.104.22.168, 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 following document on the Symantec Support website:
ABOUT NETBACKUP APPLIANCE 22.214.171.124 VERSION NUMBERING
To ensure a quality release, Symantec chose to incorporate the 126.96.36.199 maintenance release into the 2.6 release. Therefore, NetBackup Appliance 2.6 has been delivered as a downloadable package that is labeled as version 188.8.131.52. This package provides a one-step upgrade process for customers running previous versions of NetBackup Appliance (2.5.x). The following list describes some key points about the NetBackup Appliance 184.108.40.206 release:
-- The release of NetBackup Appliance 2.6 is versioned as 220.127.116.11.
NOTE: The NetBackup Appliance 18.104.22.168 release is based off of the NetBackup 22.214.171.124 release. A NetBackup 7.6 release was not made generally available.
-- References to version 2.6 in the NetBackup Appliance software and documentation apply to the 126.96.36.199 release.
TABLE OF CONTENTS
- PRODUCT DEPENDENCIES
- DOWNLOAD AND INSTALL INSTRUCTIONS
- ROLLBACK INSTRUCTIONS
-- If you use the appliance in a media server role, this upgrade requires a NetBackup 188.8.131.52 master appliance, or a NetBackup 184.108.40.206 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.
-- This release supports an upgrade from version 2.5.x to 220.127.116.11 on the appliance. For more information on upgrades, refer to the Symantec NetBackup Appliance Administrator's Guide on the Symantec Support website:
-- After a successful installation, rollback from this version of the NetBackup appliance to the previous version is not 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.x or 2.5.x version then you should use the NetBackup appliance 18.104.22.168 version software to upgrade the client. Do not use a non-appliance NetBackup update to upgrade the client.
DOWNLOAD AND INSTALL INSTRUCTIONS
Download notes: Due to unique file naming extension of these split files, care should be taken in how your Browser interacts during the download. Certainly for Internet Explorer 8 and older. As you right click on the file link, and select "save link as" or "save target as", ensure the File-name retains the ".xof6" extension. (e.g .2of6)
The following procedure describes how to install the 22.214.171.124 software update on the NetBackup 52xx appliance and a NetBackup 52xx client.
Steps to install the 126.96.36.199 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 Symantec Support website to the appliance.
2. Open an SSH session and log on to the appliance as an administrator.
3. Verify if the 188.8.131.52 software update is available to download.
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 Symantec Support site. The following URL indicates the download location for the NetBackup 52xx release updates:
For this release the release update .rpm file name is split into multiple files with the following filenames:
7. Join (and extract) these files using the command below:
copy /b NB_Appliance_N_184.108.40.206-1.x86_64-tar-split.1of6+NB_Appliance_N_220.127.116.11-1.x86_64-tar-split.2of6+NB_Appliance_N_18.104.22.168-1.x86_64-tar-split.3of6+NB_Appliance_N_22.214.171.124-1.x86_64-tar-split.4of6+NB_Appliance_N_126.96.36.199-1.x86_64-tar-split.5of6+NB_Appliance_N_188.8.131.52-1.x86_64-tar-split.6of6 NB_Appliance_N_184.108.40.206-1.tar
Joined NB_Appliance_N_220.127.116.11-1.tar file has MD5: 03dd17e6a72a95f69e98ebf6640dc8c0 SHA1: d25e74ad4d9daae22e718b0b1bd18da2f334d485
Use the Windows unzip utility to extract the NB_Appliance_N_18.104.22.168-1.tar.
The resulting files are:
cat NB_Appliance_N_22.214.171.124-1.x86_64-tar-split.1of6 NB_Appliance_N_126.96.36.199-1.x86_64-tar-split.2of6 NB_Appliance_N_188.8.131.52-1.x86_64-tar-split.3of6 NB_Appliance_N_184.108.40.206-1.x86_64-tar-split.4of6 NB_Appliance_N_220.127.116.11-1.x86_64-tar-split.5of6 NB_Appliance_N_18.104.22.168-1.x86_64-tar-split.6of6 | tar xvf -
Resulting files from the above command:
8. Run one of the following commands to compute the checksum value for the SYMC_NBAPP_update-22.214.171.124-1.x86_64.rpm.
Verify that this checksum value matches the content of the update.rpm.md5_checksum or update.rpm.sha1_checksum file.
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 Details All
- List Details Base
- List Downloaded
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 three hours to complete but can extend beyond that, depending on the environment. The appliance reboots after the installation is completed. You can use the following command to check that the appliance version is 126.96.36.199.
Main_Menu > Manage > Software > List Version
You can also use the Main_Menu > Manage > Software > UpgradeStatus command to monitor the status of the upgrade. This command provides a percentage of completion while the upgrade operation runs.
15. After the restart, 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 SMTP is configured, an email notification that contains the self test result is sent.
16. 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:
- If any SAN clients still do not work, run the following commands on each of these clients in the order as shown:
- If any SAN clients still do not work, you must manually initiate a SCSI device refresh at the OS level. The method to accomplish this depends on the operating system that the client is running. 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 install the 188.8.131.52 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:
- Mac OS
Note: If you choose to extract Linux, UNIX, Solaris, AIX, or BSD images, Symantec recommends that you use GNUtar version 1.16 or higher to extract all .tar packages.
See the following tech note on the Symantec Support website for more information:
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 > Symantec 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:
- 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.