OneFS patch infrastructure update
Summary: This article contains information about the OneFS patch infrastructure update.
Instructions
Overview
Information about the patch infrastructure update for your OneFS cluster.
How does this patch infrastructure update make my life easier?
This update improves the patch infrastructure by allowing newer rollup patches to be installed on top of existing rollup patches, instead of uninstalling the older ones first. This reduces the need for reboots and service restarts.
This functionality is only available in situations where the new patch fully deprecates a previous patch.
Deprecates a patch, meaning that the latest patch contains all fixes from all previous patches.
Conflicting patches are different and must still be uninstalled manually.
Prerequisites
The patch infrastructure update for your version of OneFS must be installed on your cluster prior to any rollup (RUP) patch being installed. If you attempt to install a new rollup patch on a system that does not have the infrastructure update already installed, the patch installation fails with an error similar to: Error: Incomplete REST response on socket 4.
The patch infrastructure update cannot be removed from your OneFS cluster until all other patches are removed.
OneFS infrastructure updates
The infrastructure update must be installed on any clusters running the following OneFS versions:
- OneFS 9.5.x
- OneFS 9.4.x
- OneFS 9.2.1.x
- OneFS 9.1.x
- OneFS 9.0.x
- OneFS 8.2.0.x
- OneFS 8.1.2.x
Note: OneFS 9.3.x, 9.2.0.x, 8.2.2.x, and 8.2.1.x do not have infrastructure updates to install.
Note: OneFS 8.1.1.x and earlier do not have infrastructure updates to install and do not have this feature.
For the latest infrastructure update for your version of OneFS, see the PowerScale OneFS Current Patches article or the OneFS Drivers and Downloads page.
Confirm the infrastructure update is installed.
You can confirm that the update is installed by running the following command:
isi upgrade patches list
All updates have INFRA in the patch filename.
Example: PowerScale OneFS 9.1.0.x GA INFRA_2021-12
Troubleshooting Scenario 1:
If you attempted to install a new RUP on a system that did not have the patch infrastructure update installed, OneFS logs an error similar to the following on the console:
Error: Incomplete REST response on socket 4
Workaround: Install the patch infrastructure update prior to installing the RUP.
FOR 8.1.2.0:
Please note that 8.1.2.0_UGA-PATCH-INFRA_2019-09_255624 needs to be installed **first**, and then install 8.1.2.0_UGA-PATCH-INFRA_2020-08_PSP-268 in order to upgrade OneFS further
Troubleshooting Scenario 2:
If you attempted to install a new RUP for the first time after installing the patch infrastructure update, a message similar to the following will appear on the console:
Stack: --------------------------------------------------
/lib/libc.so.7:thr_kill+0xa
/lib/libc.so.7:abort+0x49
/usr/lib/libisi_util.so.1:isi_assert_halt+0x80
/usr/lib/libisi_pkg.so:read_patch_from_db+0x58d
/usr/lib/libisi_pkg.so:pkg_action_required+0xd9
/usr/lib/libisi_upgrade.so.1:_ZN10isiUpgrade7Package10isRequiredEi+0x12a
/usr/sbin/isi_upgrade_agent_d:_ZN10isiUpgrade5Agent14populateStatusERN4Json5ValueE+0x4a4
/usr/sbin/isi_upgrade_agent_d:_ZN10isiUpgrade15PersistentState9getStatusENS_7Process5ValueE+0x753
/usr/sbin/isi_upgrade_agent_d:_ZN10isiUpgrade5Agent6StatusERNS_7MessageEPNS_8MetaDataEPNS_8ResponseE+0x181
/usr/lib/libisi_upgrade.so.1:_ZN10isiUpgrade11VerbExecute7executeERNS_7MessageEPNS_8MetaDataEPNS_8ResponseE+0x219
/usr/lib/libisi_upgrade.so.1:_ZN10isiUpgrade9UdpServer14executeMessageEv+0x227
/usr/lib/libisi_upgrade.so.1:_ZN10isiUpgrade9UdpServer10ioCallbackERN2ev2ioEi+0x47c
/usr/local/lib/libev.so.4:ev_invoke_pending+0x6e
/usr/local/lib/libev.so.4:ev_run+0xbd9
/usr/sbin/isi_upgrade_agent_d:main+0x5a3
/usr/sbin/isi_upgrade_agent_d:_start+0x17f
In addition, the following message appears in the /var/log/messages log file:
WARNING: After this infrastructure patch is deployed, 'isi_upgrade_agent_d' will be restarted at the first time of installing another patch and will generate a core file, which is a known issue and won't impact patch installation.
Solution: This is by design for the initial RUP installation following the OneFS patch infrastructure update installation. There are no issues with the isi_upgrade_d service.
Troubleshooting Scenario 3:
If you attempted to install a new RUP on a 9.4.0.0 system that did not have the patch infrastructure update installed, the RUP patch installation will be failed. OneFS logs an error similar to the following on the console:
ERROR: No infra patch found. Pls make sure the latest infra patch installed
Please refer to the following link for the workaround and recovery solution: https://www.dell.com/support/kbdoc/en-us/000206184