NetBackup Appliance 2.5b Patch (for NetBackup 5200 and 5220)

Article:TECH198449  |  Created: 2012-10-16  |  Updated: 2012-12-04  |  Article URL http://www.symantec.com/docs/TECH198449
Article Type
Technical Solution

Product(s)

Issue



 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.

     http://www.symantec.com/docs/TECH198390

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:

       http://www.symantec.com/docs/DOC5512 
================================================================================


=================
TABLE OF CONTENTS
=================
- PRODUCT DEPENDENCIES
- DOWNLOAD AND INSTALL INSTRUCTIONS
- ROLLBACK INSTRUCTIONS


Solution



=================================
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.

    

http://www.symantec.com/business/support/index?page=landing&key=58991



    For this release the release update .rpm file name is split into multiple  files with the following filenames:

    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


7. Join (and extract) these files using the command below:

    Windows:
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:
      SYMC_NBAPP_update-2.5-2.x86_64.rpm
      update.rpm.md5_checksum


    UNIX:
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:
      SYMC_NBAPP_update-2.5-2.x86_64.rpm
      update.rpm.md5_checksum


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.

      md5sum SYMC_NBAPP_update-2.5-1-2.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 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:
   - All
   - Windows
   - Linux
   - Solaris
   - AIX
   - HP
   - BSD
   - 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.

        

http://www.symantec.com/docs/TECH154080


 
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:
          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 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.


Attachments

NB_Appliance_N_2.5-2.x86_64-tar-split.1of5 MD5: 2b07b865aca73b6fe1630e77b6d21c24
NB_Appliance_N_2.5-2.x86_64-tar-split.1of5 (1.7 GBytes)
NB_Appliance_N_2.5-2.x86_64-tar-split.2of5 MD5: c3aa8066fd57dcf2d08ffcfd41f1c059
NB_Appliance_N_2.5-2.x86_64-tar-split.2of5 (1.7 GBytes)


NB_Appliance_N_2.5-2.x86_64-tar-split.3of5 MD5: 469e8498bacab38c7b51a4a507979d33
NB_Appliance_N_2.5-2.x86_64-tar-split.3of5 (1.7 GBytes)
NB_Appliance_N_2.5-2.x86_64-tar-split.4of5 MD5: 15986933f98a3fb5b6bb290019e67b43
NB_Appliance_N_2.5-2.x86_64-tar-split.4of5 (1.7 GBytes)
NB_Appliance_N_2.5-2.x86_64-tar-split.5of5 MD5: 0507f161c612eab74dbab3c1b31d52e8
NB_Appliance_N_2.5-2.x86_64-tar-split.5of5 (212.9 MBytes)


Article URL http://www.symantec.com/docs/TECH198449


Terms of use for this information are found in Legal Notices