NetBackup Appliance 52xx 2.5.4 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, 2.5b, 2.5.1, 2.5.2, or 2.5.3. If you are already running version 2.5.4, 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:
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 2.5.4 master appliance, or a NetBackup 7.5 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.3 or higher.
-- This release supports an upgrade from version 2.5, 2.5.1, 2.5.2, or 2.5.3 to 2.5.4 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, 2.5, 2.5.1, 2.5.2, or 2.5.3 version then you should use the NetBackup appliance 2.5.4 version software to upgrade the client. Do not use a non-appliance NetBackup update to upgrade the client.
DOWNLOAD AND INSTALL INSTRUCTIONS
The following procedure describes how to install the 2.5.4 software update on the NetBackup 52xx appliance and a NetBackup 52xx client.
Steps to install the 2.5.4 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 2.5.4 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.4-1.x86_64-tar-split.1of4+NB_Appliance_N_2.5.4-1.x86_64-tar-split.2of4+NB_Appliance_N_2.5.4-1.x86_64-tar-split.3of4+NB_Appliance_N_2.5.4-1.x86_64-tar-split.4of4 NB_Appliance_N_2.5.4-1.tar
Joined NB_Appliance_N_2.5.4-1.tar file has MD5: b151a6c92b0625b8d7ad9ee444c375d2
Use the Windows unzip utility to extract the NB_Appliance_N_2.5.4-1.tar.
The resulting files are:
cat NB_Appliance_N_2.5.4-1.x86_64-tar-split.1of4 NB_Appliance_N_2.5.4-1.x86_64-tar-split.2of4 NB_Appliance_N_2.5.4-1.x86_64-tar-split.3of4 NB_Appliance_N_2.5.4-1.x86_64-tar-split.4of4 | 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-2.5.4-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 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.4.
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.
NOTE: After you have successfully upgraded your appliance, please update the location and the contact information that is currently on Symantec support's file for this appliance. Run the following command from the appliance shell menu to update the location and contact information.
Main > Settings > Alerts > CallHome Registration
NOTE: Please update MIB file on SNMP server. You can use the following command to obtain the latest MIB file from appliance shell menu:
Main_Menu > Settings > Alerts > SNMP ShowMIB
Steps to install the 2.5.4 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.
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.
NOTE: In this release of the NetBackup appliance, after you upgrade your appliance, you cannot change the appliance role. Symantec does not support changing the role of your appliance after you have performed an upgrade. If you want to upgrade and change the role of your appliance, Symantec recommends that you change the role first, and then upgrade the appliance to this version release.
If you upgrade first and then change the role, the role cannot be preserved if for some reason you must roll back the appliance. If you need to rollback your appliance to an earlier version, you must contact Technical support because the Rollback function is not supported in this release.
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.