NB_Appliance_D_1.4.1_ET2701800_6 is an Emergency Engineering Binary (EEB) bundle for NetBackup 50x0 Appliances

Article:TECH184691  |  Created: 2012-03-23  |  Updated: 2012-05-03  |  Article URL http://www.symantec.com/docs/TECH184691
Article Type
Technical Solution

Product(s)

Issue



==============================================================================
This Engineering Binary provides features and fixes to the Symantec NetBackup 50X0 Series Deduplication Appliances.
 
WARNING: When you apply this Engineering Binary, all PureDisk services stop and start.  This can cause running jobs to abort.
==============================================================================
 
=================
PACK DEPENDENCIES
=================
 
NetBackup 50X0 Series - version 1.4.1.1 is required to apply this Engineering Binary.
 
**IMPORTANT NOTE**:  This bundle contains fixes for log rotation and PDDO data removal.
Please be aware of the following BEFORE installing the bundle:
 
1. There may be a large number of files in the /Storage/log directory. These will get cleaned up when
the bundle is applied. Please note that log rotation may run for quite some time after the patch is applied.
This is expected and will be a onetime occurrence. Subsequent log rotation actions should take a normal amount of time.
See the Related Article linked below for more details.
 
2. After applying the bundle, there may be an increased number of dereference operations on the content routers, causing CR Queue Processing jobs to take longer than usual.


Solution



==============================================================================
This Engineering Binary provides features and fixes to the Symantec NetBackup 50X0 Series Deduplication Appliances.
 
WARNING: When you apply this Engineering Binary, all PureDisk services stop and start.  This can cause running jobs to abort.
==============================================================================
 
=================
PACK DEPENDENCIES
=================

=============
PRODUCT FIXES
=============
 
Content Router changes and fixes:
---------------------------------
* ET2650154 After configuring storage pool, Compaction is disabled on the additional content router nodes.
* ET2658486 Content Router compaction does not release empty containers back to the file system (compactreleasesp)
* ET2647712 New action for 'crcontrol': tasksinfo (displays internal status information)
* ET2657780 Added ability to change log level dynamically without restarting the content router (crcontrol --loglevel)
* ET2675181 Prevent CR garbage collection from running, when rerouting is active.
* ET2663721 Addresses spoold crashing issue when fiber channel is being used.
* ET2658804 Spoold hangs during DR backups when PDDO duplications taking place
* ET2730036 Addresses race condition between rebasing and compaction threads when writing history
* ET2730996 Long time NBU backup jobs fail sometime.
* ET2749555 FC duplication broken after EEB bundle v5 is applied
* ET2740695 FC memory handling fixes
* ET2750657 Spoold crash experienced during a mode change
 
(PDDO) Data Removal fixes:
--------------------------
* ET2647938 Data Removal workflow fails if Metabase Engine is configured on a node without a Content Router installed.
* ET2656397 PDDODataRemoval not added to cron on non-SPA nodes
* ET2234286 PureDisk Health Checker (MBGC Extensive cleanup test) v2.08
* ET2732692 PDDO Data Removal causes data loss on retried images
 
 
Replication and Optimized Duplications:
---------------------------------------
* ET2624984 Replication job logs and GUI Alerts display "Key not found in INI file /etc/puredisk/agent.cfg" error message
 
Miscellaneous:
--------------
* ET2640824 RemoveNode tool reads topology from incorrect location (/Storage instead of /opt)
* ET2663654 RemoveNode tool tries to delete an non-existing Controller component
* ET2656085 Call Home feature: Numerous root mail messages are generated from callhome.pl.
* ET2673549 Log rotation improvements
* ET2682370 Appliance shell menu mishandles IP addresses of non-storage pool
            authority nodes that match, as regular expressions, the IP address of
            the storage pool authority node
* ET2673704 Storage Pool Configuration wizard do not detect internal hard disk on HP BL465 G7 machine.
* ET2657705 Puredisk Storage Pool consistency check return 'verification failed. DO does not exist.' for some dataselection.
* ET2691854 Corrects issue where content router size is incorrectly set when /Storage/data is a separate partition.
* ET2701791 Restoring to an agent that is out of space only restores part of the dataset, and reports success.
* ET2709486 Status 2074 due to high swap utilization on the 5020 appliance.
* ET2691854 Storage size for CR in PureDisk 6.6.3a GUI is wrong if /Storage/data is a separate partition.
* ET2707069 PDROE Replication fails: Fatal error: Call to undefined method Exception::getDescription() in /opt/pdmbe/mgmtclass/ReplicationEngine.php on line 177.
* ET2732509 Udevinfo returning incomplete information on 6.6.3 for cciss devices - causing installer to fail.
* ET2661865 Enhancements to controller to kill idle remote client sessions
* ET2744949 Ticking checkbox in Puredisk GUI when adding a data selection to a data removal policy does not appear to save the item you have ticked.
            When going back into the GUI the box is unticked.
* ET2746883 Dcscan verify report "Current Container ID" to stderr for use by recoverCR
* ET2751817 Logrotation fixes can cause excessive patch downtime
* ET2761005 Added remote_kill function to rollback_patch.sh
 
!!! Do not forget to review the INSTALLATION INSTRUCTIONS completely !!!
The section 'UPGRADING PDDO AGENTS ON MEDIA SERVERS' will only be needed with all pre 7.x media servers or pre 7.5 AIX media servers.
 
=======================================
INSTALLATION INSTRUCTIONS for Appliance
=======================================
To Download and prepare the EEB for installation:
 
1. Download the tar file from support to a desktop machine, Extract it to a temporary location in that file there should be the following:
     NB_Appliance_D_1.4.1_ET2701800-bundle_v6.README
     NB_Appliance_D_1.4.1_ET2701800-bundle_v6.tar
     NB_Appliance_D_1.4.1_ET2701800-bundle_v6.md5
 
2. If possible, use md5sum to verify the integrity of the Engineering Binary before uploading to the appliance:
 
    # md5sum NB_Appliance_D_1.4.1_ET2701800-bundle_v6.tar
    - compare this to NB_Appliance_D_1.4.1_ET2701800-bundle_v6.md5 and verify a match
 
To Apply the EEB:
 
1.  Down the Disk pool
    On Linux and UNIX systems, type the following command:
    /usr/openv/netbackup/bin/admincmd/nbdevconfig -changestate -stype PureDisk -dp <disk_pool_name> -state DOWN
    On Windows systems, type the following command:
    <install_path>\NetBackup\bin\admincmd\nbdevconfig -changestate -stype PureDisk -dp <disk_pool_name> -state DOWN
    For <disk_pool_name>, specify the name of the disk pool.
 
2.  Log in to the PureDisk administrative Web UI and make sure that no PureDisk jobs are currently running or are scheduled to be run.
    Perform the following steps:
    Select Monitor > Jobs.
    In the right pane, select the jobs you want to terminate.
    Select Stop job gracefully or Stop job immediately. You might lose data if you select Stop job immediately.
    Confirm the termination in the pop-up window that appears.
    For more information about how to stop jobs, see Terminating a job that is running in the PureDisk Backup Operator Guide, or see the online Help .
 
3.  From a console (IPMI or direct access), log in as sysadmin to the appliance node that hosts the storage pool authority.
 
4.  Type nodeinfo at the appliance shell menu and examine the output.
    Make sure that all nodes are up, running, and accessible from the storage
    pool authority. The status of all nodes should be active.
 
5.  Type admin , and then su to open a root prompt and verify /root/pd-patches exists
    If the directory does not exist, you must mkdir it.
 
6.  From a remote host, use scp to copy the NB_Appliance_D_1.4.1_ET2701800-bundle_v6.tar file to the /root/pd-patches directory.
 
7.  On the appliance type exit to log out of root mode, then type exit again to return to the main menu.
 
8. Type PureDisk at the appliance shell menu prompt.
 
9. Type patch list-downloaded and examine the output.
   The output should include the new file.
 
10. Type patch apply NB_Appliance_D_1.4.1_ET2701800-bundle_v6.tar to install the downloaded patch.  Follow the on screen directions.
 
11. Type patch list-applied and examine the output.
   The newly applied patch (not committed) should appear.
 
12. Type status all and examine the output.
   All the services' statuses are running if the patch was successfully applied.
 
13. Type exit to exit from PureDisk mode.
    Note: After you apply the upgrade, the storage pool is in checkpoint mode.
    Checkpoint mode lets you review the functionality of the patch in the storage pool and perform a patch rollback if necessary.
    While in checkpoint mode, some functionality is disabled. For more information about checkpoint mode, see
    About checkpoints on page 27 of the Deduplication Appliance Release Notes.
 
14. (Conditional) Change the state of the disk pool to UP.
 
    On Linux and UNIX systems, type the following command:
    /usr/openv/netbackup/bin/admincmd/nbdevconfig -changestate -stype PureDisk -dp <disk_pool_name> -state UP
    On Windows systems, type the following command:
    <install_path>\NetBackup\bin\admincmd\nbdevconfig -changestate -stype PureDisk -dp <disk_pool_name> -state UP
    For <disk_pool_name>, specify the name of the disk pool.
 
15. Commit or roll back the patch.
    Only commit when you are confident the patch was applied properly.
 
    Log into the appliance with the sysadmin account.
    Type PureDisk at the appliance shell menu.
 
    Type the following command:
    patch commit NB_Appliance_D_1.4.1_ET2701800-bundle_v6
 
    To rollback a patch:
    Type patch rollback NB_Appliance_D_1.4.1_ET2701800-bundle_v6
    This will  roll back the software to the previous version.
 
    Type patch list-applied to verify that the patch was removed.
    The patch name should no longer appear.
 
 
======================================
UPGRADING PDDO AGENTS ON MEDIA SERVERS
======================================
This will only be needed with all pre 7.x media servers or pre 7.5 AIX media servers.
 
1.  Make sure that the storage pool software for the PDDO clients has been upgraded.
 
2.  Refresh the PureDisk landing page.
 
    The landing page can be found on:
 
        https://<your-puredisk-spa>/
 
    For <your-puredisk-spa>, type the hostname or the IP address of your
    PureDisk Storage Pool Authority.
 
    Be aware that this release update includes both the PureDisk 6.6
    base release agents and revised agents for Linux, Solaris, and Windows
    clients.  The revised agents include updates for PDDO agent installation
    only.  A later step in this procedure instructs you to download the
    revised agents if you want to upgrade the PDDO agent on a client.
 
3.  Log in to each PDDO client.
 
4.  From the PDDO media server client, download the new PDDO agent software.
 
    The landing page includes more than one software version of the PDDO
    agent, so take care to download the most recent agent.
 
5.  Stop all NetBackup services on the NetBackup media server.
 
6.  Install the agent software included with this release update.
 
    * On Windows systems, double-click the PureDisk agent icon.  This starts
      the Windows installation Wizard.
 
    * On Linux or Solaris systems, you can use either the attended or the
      unattended installation method.  The installer prompts you to confirm
      the upgrade.  For example, type the following command to upgrade the
      Solaris 10 agent:
 
      # sh pdagent-Solaris_10_sparc-6.6.0.NNNNN.run
 
      For NNNNN, type the name of the PureDisk upgrade release number.
 
    NOTE:  The upgrade software removes the old PDDO agent software
    automatically.
 
    For more information about how to install the PDDO agent, see the Veritas
    NetBackup PureDisk Deduplication Option Guide.
 
7.  Start all the NetBackup services on the NetBackup media server.
=================
 
NetBackup 50X0 Series - version 1.4.1.1 is required to apply this Engineering Binary.
 
**IMPORTANT NOTE**:  This bundle contains fixes for log rotation and PDDO data removal.
Please be aware of the following BEFORE installing the bundle:
 
1. There may be a large number of files in the /Storage/log directory. These will get cleaned up when
the bundle is applied. Please note that log rotation may run for quite some time after the patch is applied.
This is expected and will be a onetime occurrence. Subsequent log rotation actions should take a normal amount of time.
See the Related Article linked below for more details.
 
2. After applying the bundle, there may be an increased number of dereference operations on the content routers, causing CR Queue Processing jobs to take longer than usual.


Attachments

NB_Appliance_D_1.4.1_ET2701800_6.tar
NB_Appliance_D_1.4.1_ET2701800_6.tar (61.2 MBytes)

Supplemental Materials

SourceETrack
Value2701800
Description

1.4.1.1 EEB bundle




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


Terms of use for this information are found in Legal Notices