Originated: March 18, 2016
********************************************************************************

Patch-167964: Patch for 7.2.1.2. This patch addresses an issue where the 
package_info.xml file produced by running the isi_gather_info command did not 
contain well-formed XML content.

--------------------------------------------------------------------------------

This patch can be installed on clusters running the following OneFS version: 
7.2.1.2

********************************************************************************

RESOLVED ISSUES

* Bug ID 168171
  The isi_gather_info command incorrectly wrote traceback information to the 
  package_info.xml file rather than well-formed XML content. As a result, EMC
  Isilon Technical Support could not easily determine which node the files were
  gathered from nor the date and time the files were gathered.
 
********************************************************************************

CHANGED FILES

* /usr/bin/isi_gather_info
  (MD5 = cae130805a9dbbf4530b34b708b3210c)

********************************************************************************

INSTALLATION/REMOVAL IMPACTS

No services are affected during installation or removal of this patch.

********************************************************************************

IMPORTANT!  
VERIFY CLUSTER-FREE SPACE
If there is insufficient free space and you attempt to install or remove a
patch, the process might not complete successfully. An incomplete patch
installation or patch removal can leave the cluster in an inaccessible state.

Before installing or removing a patch, verify that your cluster has enough
free space to perform the procedure. For more information about maintaining
sufficient free space on an Isilon cluster, see the Best Practices Guide for
Maintaining Enough Free Space on Isilon Clusters and Pools:
https://support.emc.com/docu48119.
   
********************************************************************************

INSTALLING THIS PATCH

IMPORTANT!
Read INSTALLATION/REMOVAL IMPACTS before performing this procedure.
   
1. Verify that your cluster has enough free space to install this patch.

2. Open an SSH connection on any node in the cluster and log in by using the
   root account.

   NOTE: If the patch is being installed on a compliance mode cluster, log in
   using the compadmin account.

3. Copy the patch-167964.tgz file to the /ifs/data directory on the cluster.

4. Run the following command to change to the /ifs/data directory:
   
   cd /ifs/data

5. To extract the patch file, run the following command:

   tar -zxvf patch-167964.tgz

6. To install this patch, run the following command:

   isi pkg install patch-167964.tar

7. To verify that this patch is installed, run the following command:
  
   isi pkg info

8. Confirm that patch-167964 appears in the list of installed packages.

********************************************************************************

REMOVING THIS PATCH

If you need to remove this patch, complete the steps below.

IMPORTANT!
Read INSTALLATION/REMOVAL IMPACTS before performing this procedure.

1. Verify that your cluster has enough free space to remove this patch.

2. Open an SSH connection on any node in the cluster and log in using the
   root account.

   NOTE: If the patch is being removed from a compliance mode cluster, log in
   using the compadmin account.

3. To remove this patch, run the following command:

   isi pkg delete patch-167964

4. To verify that this patch was removed, run the following command:

   isi pkg info

5. Confirm that patch-167964 does not appear in the list of installed packages.

********************************************************************************
