NB_PDE_6.6.3_ET2657689_6 is an Emergency Engineering Binary (EEB) bundle for PureDisk 6.6.3.

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


Issue



==============================================================================
This Engineering Binary provides features and fixes to the Symantec NetBackup PureDisk 
 
WARNING: When you apply this Engineering Binary, all PureDisk services stop and start.  This can cause running jobs to abort.
==============================================================================
 
=================
PACK DEPENDENCIES
=================
 
NetBackup PureDisk - Install PureDisk 6.6.3a before you install this bundle.
 
**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.  Please 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 PureDisk 
 
WARNING: When you apply this Engineering Binary, all PureDisk services stop and start.  This can cause running jobs to abort.
==============================================================================

 

=============
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 PureDisk
======================================
---------------------------------------------------------------------------------------------
PUREDISK Web GUI installation instructions (recommended):

1.  Download the Attachment to a desktop machine.  Extract it to a temporary location - the following files should be created:

  • NB_PDE_6.6.3_ET2657689-bundle_v6.README
  • NB_PDE_6.6.3_ET2657689-bundle_v6.tar
  • NB_PDE_6.6.3_ET2657689-bundle_v6.md5

2.  If possible, use md5sum to verify the integrity of the Engineering Binary before upgrading:

# md5sum NB_PDE_6.6.3_ET2657689-bundle_v6.tar

Confirm this output matches the contents of NB_PDE_6.6.3_ET2657689-bundle_v6.md5.

3.  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.
 
4.  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 .
 
5.  (Conditional) Freeze PD service groups for clustered PD server.
 
    Perform this step if the storage pool is installed with VCS cluster
    software.  Use the Cluster Manager Java Console, and freeze all the service
    groups.
 
    For information about how to freeze and unfreeze clustered storage pools,
    see the NetBackup PureDisk Storage Pool Installation Guide.
 
6. with you browser go to http://<SPA_hostname>/Installer
 
7. Authenticate at the login page
 
8. On the right hand pane, click on Manage patches
 
9. This will open a pop-up window Upgrade and Roll Back
 
10. Select the Available Software tab
 
11. Click on Choose File and upload NB_PDE_6.6.3_ET2657689-bundle_v6.tar
 
12. Wait while it is verified and then click on Ok
 
13. The file will be uploaded at this point, please wait
 
14. Once uploaded it should be visible with an option to install
 
15. Click Install and follow the prompts from the install wizard

  • If prompted to create a checkpoint, only select this if PureDisk is using Storage Foundation
  • If a checkpoint is created, verify the install and when comfortable commit it via the Installed software tab in Upgrade and Roll Back

16. (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.
 
17.  (Conditional)  Upgrade the PDDO agent software on PDDO media server
    clients.
 
    Perform the procedure called "UPGRADING PDDO AGENTS ON MEDIA SERVER
    CLIENTS", which follows.  The release update includes upgraded
    PDDO agents for Linux, Solaris, and Windows clients.
 
18. Upgrade the PureDisk Installer GUI
    /opt/pdinstall/replaceInstallerGUI-NB_PDE_6.6.3_ET2657689-bundle_v6.sh  
 

-------------------------------------------------------------------------------------------
Optional command line installation (Use this only when the web GUI method is unavailable)

1.  Use rcp or scp to copy the tar file NB_PDE_6.6.3_ET2657689-bundle_v6.tar to the /root directory of the node that hosts the storage pool authority.
 
2.  Log on as root to the node that hosts the storage pool authority
 
3.  Type the following command to verify the integrity of the Engineering Binary:
 
    # md5sum /root/NB_PDE_6.6.3_ET2657689-bundle_v6.tar
    compare this to NB_PDE_6.6.3_ET2657689-bundle_v6.md5 and verify a match
 
4. Type the following command to unpack the Engineering Binary software:
 
    # tar -C / -xf /root/NB_PDE_6.6.3_ET2657689-bundle_v6.tar ./
 
5.  Type the following command to run and install the Engineering Binary:
 
    # /opt/pdinstall/apply-NB_PDE_6.6.3_ET2657689-bundle_v6.sh
 
    If the topology.ini file is encrypted, the software prompts you for the
    password to decrypt this file.
 
    The Engineering Binary automatically pushes the software to all nodes in the
    storage pool and to all clients.
 
    At the end of a successful installation, the software prompts you to encrypt
    the topology.ini file.
 
6.  (Conditional) Unfreeze PD service groups for clustered PD server.
 
    Perform this step if the storage pool is installed with VCS cluster
    software.
 
    The Veritas Cluster Server (VCS) software might detect some faults
    during the upgrade process.  If any upgrade actions generate a VCS fault,
    use the Cluster Manager Java Console to clear the fault and probe that
    resource group before you unfreeze the cluster.
 
7.  Monitor the client agent update jobs.
 
    Take the following actions to monitor the client agent upgrade jobs:
 
    A.  Invoke the Web UI.
    B.  Click the Workflows tab.
    C.  Select the Agent update workflow.
 
    If one of the upgrade jobs fails, PureDisk deactivates those client agents.
    You will need to activate these agents again and to select the client to
    upgrade to. Follow the steps below:
 
    A.  Invoke the Web UI.
    B.  Click the Data management tab.
    C.  In the middle pane, select the Deactivated client agents by storage pool view,
        which is the third view from the left.
    D.  Select the storage pool level in the middle pane
        and choose Activate Agents from the left hand pane.
    E.  Refresh the middle pane.
        It will switch back to the default view with all clients.
    F.  Select the storage pool level in the middle pane
        and choose Upgrade Agents from the left hand pane.
        Choose the version you want to upgrade to.
 
    Monitor these upgrade jobs again.  Start over if they fail or time-out.
 
8. (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.
 
9.  (Conditional)  Upgrade the PDDO agent software on PDDO media server
    clients.
 
    Perform the procedure called "UPGRADING PDDO AGENTS ON MEDIA SERVER
    CLIENTS", which follows.  The release update includes upgraded
    PDDO agents for Linux, Solaris, and Windows clients.
 
10. Upgrade the PureDisk Installer GUI
    # /opt/pdinstall/replaceInstallerGUI-NB_PDE_6.6.3_ET2657689-bundle_v6.sh
 
======================================
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.

=================
PACK DEPENDENCIES
=================
 
NetBackup PureDisk - Install PureDisk 6.6.3a before you install 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.  Please 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_PDE_6.6.3_ET2657689_6.tar
NB_PDE_6.6.3_ET2657689_6.tar (61.2 MBytes)

Supplemental Materials

SourceETrack
Value2657689
Description

EEB bundle




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


Terms of use for this information are found in Legal Notices