
Updated: August 11, 2020

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

8.1.2.0_UGA-PATCH-INFRA_2020-08_PSP-268: Patch for OneFS 8.1.2.0. 8.1.2.0_UGA-
PATCH-INFRA 263531 + Patch Framework Improvement.

PREREQUISITES
The patch infrastructure update package must be installed prior to installing 
this patch. For more information about this package, see 
https://support.emc.com/kb/535671 on the Customer Support Site.

IMPORTANT!
This patch cannot be removed until all the other patches have been removed. 
This is the prerequisites patch for OneFS 8.1.2.0.

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

This patch will conflict with the following patches:
8.1.2.0_KDA-CUSTOM_2019-07_256016
8.1.2.0_KDA-CUSTOM_2019-07_254360
8.1.2.0_KGA-RUP_2019-07_252457
8.1.2.0_KGA-RUP_2019-06_250808
8.1.2.0_KGA-RUP_2019-05_249622
patch-248876
patch-248570
patch-246713
patch-245402
patch-243897
patch-240794

This patch will deprecate the following patches:
8.1.2.0_UGA-PATCH-INFRA_2019-12_263531
8.1.2.0_UGA-PATCH-INFRA_2019-09_255624

If any conflicting patches are installed on the cluster, you must remove them
before installing this patch.

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

RESOLVED ISSUES

The patch includes the following new non-security fix:

* Bug ID PSCALE-17384
  The patch system required the available space under the root partition
  ("/") to be more than 4*<patch size>. The patch could not be installed
  due to unavailability of space under "/".

The patch includes the following older non-security fixes:

* Bug ID 263637
  The pre-patched OneFS image was made and could be used for both upgrading
  and initial installation. As a result, it was possible for the upgrade 
  process to speed up and remove certain failure modes during the upgrade.

* Bug ID 251975
  This file improves the patch framework by allowing deprecated patches to be
  automatically uninstalled, without additional reboots, during patch
  installation.
  
********************************************************************************

CHANGED FILES

* /usr/bin/isi_patch
  (MD5 = c060af797c19f5ca1f21b0278e7be0c1)

* /usr/bin/isi_patch_create
  (MD5 = 7cdff9a3b82005bee717fb0135e35729)

* /usr/lib/libisi_papi_patch.so.1
  (MD5 = c7033d20a0c12ecb75b9cd94eb289156)

* /usr/lib/libisi_pkg.so.1
  (MD5 = 6d9926651a0ad2d138cfc6ebb13de749)

* /usr/local/lib/python2.7/site-packages/isi/patch.so
  (MD5 = 800c5640fcb23a57b7410c235bc401a7)

* /usr/local/share/CLI/controllers/isi/upgrade/patches/install.py
  (MD5 = cda6a23c9378254b1947e4b400b77f35)

* /usr/local/share/CLI/controllers/isi/upgrade/patches/uninstall.py
  (MD5 = cdb69524908c37fbaa5f406141db1d3e)

* /usr/local/share/CLI/controllers/isi/upgrade/patches/util.py
  (MD5 = 46f2b0e2af1d1d5d4427724ae7c676c9)

* /usr/sbin/isi_patch_agent
  (MD5 = 10714cbbbce25057f5d3e18074afaffe)

* /usr/share/isi_xsd/pkg_spec.xsd
  (MD5 = 5c6067e774e33cf6f57020817b8d757d)

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

INSTALLATION/REMOVAL IMPACTS

During installation or removal of this patch, the following services are 
restarted:

* isi_join_d
* isi_papi_d

When a patch requires that services be restarted, by default, the 'isi upgrade 
patches install' command performs a rolling installation of this patch, which 
will restart affected services on each node in succession without rebooting.
If a rolling installation is performed and protocols services are affected,
client connections to the cluster over protocols that are configured or 
designed to fail over to another node are not disconnected. However, client 
connections to the cluster over other protocols are disconnected when the 
services on the node they are connected to restart. Clients that are 
disconnected must manually reestablish a connection to the cluster.

You can also configure the command to install this patch on all nodes in the
cluster simultaneously by running the 'isi upgrade patches install' command
with the '--rolling=false' parameter. If you perform a simultaneous
installation of this patch, nodes are still not rebooted. However, the service
that is affected by this patch is simultaneously restarted on all nodes in the
cluster. If the service is restarted, clients and cluster operations that
require this service are temporarily disrupted while the service restarts.

Dell EMC Isilon recommends that you install the patch during an off-hours
maintenance window to minimize the disruption of service to clients.

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

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.

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

PRE INSTALLATION INSTRUCTIONS

REMOVING CONFLICTING AND DEPRECATED PATCHES

NOTE: Removing deprecated patches is no longer necessary, as those patches
will automatically be replaced during the installation process. Conflicting
patches, if any, will still need to be removed.

IMPORTANT!
Read the INSTALLATION/REMOVAL IMPACTS in the README for any patches that are
being removed 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 procedure is being done on a compliance mode cluster,
   log in using the compadmin account.

3. To remove this patch, run the following command, where <ID> is the patch ID
   of the patch to be removed:

   isi upgrade patches uninstall patch-<ID> --rolling=false

   NOTE:The preceding command updates all of the nodes in the cluster
   simultaneously, and then either restarts the affected services on all of the
   nodes simultaneously or reboots all nodes simultaneously, depending on the
   patch being removed. To remove the patch in a rolling manner, omit
   the '--rolling=false' parameter. For more information, see the
   Installation/Removal Impacts section of the README of the patch that is
   being removed.

   Confirm that you want to continue with this operation:

   Are you sure?  (yes/[no]): yes

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

   isi upgrade patches list

5. Confirm that patch-<ID> does not appear in the list of installed packages.

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

INSTALLING THIS PATCH
Follow these instructions to install the 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 8.1.2.0_UGA-PATCH-INFRA_2020-08_PSP-268.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 8.1.2.0_UGA-PATCH-INFRA_2020-08_PSP-268.tgz

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

   isi upgrade patches install 8.1.2.0_UGA-PATCH-INFRA_2020-08_PSP-268.pkg 
   --rolling=false

   NOTE: The preceding command updates all of the nodes in the cluster
   simultaneously, and then restarts the affected services on all of the
   nodes simultaneously. To install the patch and restart affected services
   in succession, omit the '--rolling=false' parameter. For more information,
   see the Installation/Removal Impacts section of the README.

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

   isi upgrade patches list

8. Confirm that 8.1.2.0_UGA-PATCH-INFRA_2020-08_PSP-268 appears in the list of 
   installed packages and the status is set to Installed.

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

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 procedure is being done on a compliance mode cluster,
   log in using the compadmin account.

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

   isi upgrade patches uninstall 8.1.2.0_UGA-PATCH-INFRA_2020-08_PSP-268
   --rolling=false

   NOTE: The preceding command updates all of the nodes in the cluster
   simultaneously, and then restarts the affected services on all of the
   nodes simultaneously. To remove the patch and restart affected services
   in succession, omit the '--rolling=false' parameter. For more information,
   see the Installation/Removal Impacts section of the README.

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

   isi upgrade patches list

5. Confirm that 8.1.2.0_UGA-PATCH-INFRA_2020-08_PSP-268 does not appear in the 
   list of installed packages.

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

TROUBLESHOOTING THIS PATCH

If you have recently installed the patch infrastructure update on your system 
and are receiving error messages when installing this patch, please refer to  
https://support.emc.com/kb/535671 on the Customer Support Site for more details 
and workarounds.

If you received the following output after running the 'isi upgrade patches
list' command during installation or removal of this patch, follow the
additional instructions below.

# isi upgrade patches list
Patch Name                                Description                   Status
8.1.2.0_UGA-PATCH-INFRA_2020-08_PSP-268   Patch Framework Enhancements  Failed
Total: 1

1. Run the following command to create a statuscache file on the cluster:

   isi_upgrade_status > /ifs/.ifsvar/upgrade/statuscache

2. Run the following command to attempt the patch installation or removal
   procedure again:

   isi upgrade retry-last-action --nodes=all

3. Wait for five minutes for the commands to take effect.

4. Run the following command to verify that this patch is installed or removed:

   isi upgrade patches list

5. Confirm that 8.1.2.0_UGA-PATCH-INFRA_2020-08_PSP-268 appears 
   (or does not appear, if the patch is being removed) in the list of installed 
   packages and the status is set to Installed.

6. Should the patch status fail again, please contact Isilon Technical Support
   for further troubleshooting steps.

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