NetBackup Appliance 52xx 2.5b README Nov 2012
This software update replaces the original 2.5 patch and contains changes to the
upgrade process for NetBackup 52xx appliances. In addition, this software update
addresses the issue described in the following Technote found on the Symantec
Support Web site.
NOTE: You should only apply this software update to any appliance that has
version 2.0.x installed. You do not need to apply 2.5b to an existing 2.5 install.
If the 52xx appliance is configured as a master server, immediately after
a successful installation of 2.5b, you MUST apply the 2.5.1b patch to avoid system interruption.
For additional information about 2.5 features, product fixes and enhancements,
known issues, and the current release content included in this release update,
refer to the following TechNote on the Symantec Support Web site:
TABLE OF CONTENTS
- PRODUCT DEPENDENCIES
- DOWNLOAD AND INSTALL INSTRUCTIONS
- ROLLBACK INSTRUCTIONS
DOWNLOAD AND INSTALL INSTRUCTIONS
The following procedure describes how to install the 2.5b software update on
the NetBackup 52xx appliance and a NetBackup 52xx client.
Before you begin the upgrade, new messages may appear as you perform the
upgrade operation. These messages ensure that you know the requirements
necessary to complete the upgrade successfully. The following massages may appear:
-- The following message may appear if you are upgrading a master server appliance.
IMPORTANT - PLEASE READ
This is a master server appliance and as such you must perform a NetBackup
catalog image, metadata-migration process to successfully upgrade to the
latest 2.5.x version. You must first upgrade the appliance to version 2.5.
Then, to ensure that the catalog migration completes successfully, you must
upgrade the appliance again with the latest 2.5.x software version before
you start the NetBackup catalog image metadata migration. After you have
successfully upgraded to the latest 2.5.x version and completed the catalog
migration, you can resume backup or restore operations.
Estimated time to migrate the catalog is 0 minutes. This estimation is in
addition to the time it takes to upgrade to 2.5 and then upgrade to the latest 2.5.x version.
Are you sure you want to continue? (yes/[no])
-- The /cat volume that stores the NetBackup catalogs requires at least 50%
free space on the volume to take a backup or checkpoint of the filesystem
before you start the upgrade. If that space is not available, the following message appears:
WARNING: This upgrade requires at least 50% free space on the /cat catalog
partition - this appliance currently has 93% of /cat being used. Symantec
highly recommends that you exit the upgrade at this point and make the
space available. However, if that is not possible you can skip the NetBackup
catalog backup. If you choose to skip the catalog backup, ensure that you
have a disaster recovery backup of the catalog available that you can use
in the event of rollback.
Do you want to skip the catalog backup? (yes/[no])
-- The upgrade operation requires at-least 20% free space, not including
/cat volume requirement. If you do not have the require space the following message appears:
This upgrade requires at least 20% free space on the /cat catalog partition
This appliance currently has xx% of /cat being used. Symantec requires
that you exit the upgrade at this point and make the space available.
[Error] Install script failed.
Steps to install the 2.5b 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 Web site to the appliance.
2. Open an SSH session and log on to the appliance as an administrator.
3. Verify if the 2.5b 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_2.5-2.x86_64-tar-split.1of5+NB_Appliance_N_2.5-2.x86_64-tar-split.2of5+NB_Appliance_N_2.5-2.x86_64-tar-split.3of5+NB_Appliance_N_2.5-2.x86_64-tar-split.4of5+NB_Appliance_N_2.5-2.x86_64-tar-split.5of5 NB_Appliance_N_2.5-2.tar
Use the Windows unzip utility to extract the NB_Appliance_N_2.5-2.tar. MD5sum: 159eeba4e7df58108fa19beb1a978401
The resulting files are:
cat NB_Appliance_N_2.5-2.x86_64-tar-split.1of5 NB_Appliance_N_2.5-2.x86_64-tar-split.2of5 NB_Appliance_N_2.5-2.x86_64-tar-split.3of5 NB_Appliance_N_2.5-2.x86_64-tar-split.4of5 NB_Appliance_N_2.5-2.x86_64-tar-split.5of5 | tar xvf -
Resulting files from the above command:
8. Run the following command to compute the md5 checksum value for the SYMC_NBAPP_update-2.5-2.x86_64.rpm.
Verify that this checksum value matches the content of the update.rpm.md5_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 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.5b.
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_SYMC<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.5b 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:
- 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 Technote on the Symantec Support Web site 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.
You cannot roll back the software version on your appliance to the version level that was last installed.
Rollback is not supported in this release. If you must rollback contact your Symantec Technical Support.