* * * READ ME * * *
                          * * * CPI 8.0 * * *
                         * * * Patch 300 * * *
                         Patch Date: 2022-04-12


This document provides the following information:

   * PATCH NAME
   * OPERATING SYSTEMS SUPPORTED BY THE PATCH
   * PACKAGES AFFECTED BY THE PATCH
   * BASE PRODUCT VERSIONS FOR THE PATCH
   * SUMMARY OF INCIDENTS FIXED BY THE PATCH
   * DETAILS OF INCIDENTS FIXED BY THE PATCH
   * INSTALLATION PRE-REQUISITES
   * INSTALLING THE PATCH
   * REMOVING THE PATCH


PATCH NAME
----------
CPI 8.0 Patch 300


OPERATING SYSTEMS SUPPORTED BY THE PATCH
----------------------------------------
AIX
RHEL7 x86-64
RHEL8 x86-64
SLES12 x86-64
SLES15 x86-64
Solaris 11 SPARC
Solaris 11 X86



BASE PRODUCT VERSIONS FOR THE PATCH
-----------------------------------
   * InfoScale Availability 8.0
   * InfoScale Enterprise 8.0
   * InfoScale Foundation 8.0
   * InfoScale Storage 8.0


SUMMARY OF INCIDENTS FIXED BY THE PATCH
---------------------------------------
Patch ID: 8.0.0.300
* 4065168 (4065169) The InfoScale product installer fails to upgrade the VRTSveki package from the base Infoscale version.
* 4065279 (4065280) The product installer uninstalls the VRTSrest package during an upgrade from the base InfoScale version to a InfoScale patch bundle.
* 4068297 (4068298) Installer fails to configure the REST server while using the -rest_server option.
* 4068710 (4071333) On a Solaris system, cluster formation fails after performing a rolling upgrade phase 1 from 6.2.1 to 8.0 with patch_path option and rebooting the system.
* 4068713 (4071331) On a Solaris system, while upgrading to Infoscale 8.0 with patch by using patch_path option;  some of the services fail to stop.
* 4070269 (4071337) On Solaris, after upgrading Infoscale from 6.2.1 to 8.0 with a patch_path option; system goes in a panic while starting the vxfen service.
* 4070643 (4070427) After upgrading InfoScale from 6.2.1 to 8.0, installer fails to start services.


DETAILS OF INCIDENTS FIXED BY THE PATCH
---------------------------------------
This patch fixes the following incidents:

Patch ID: 8.0.0.300

* 4065168 (Tracking ID: 4065169)

SYMPTOM:
The product installer fails to upgrade the VRTSveki package from the base Infoscale version.

DESCRIPTION:
This issue occurs because the product installer does not stop the veki service before it upgrades the base version of its package to a patched version.

RESOLUTION:
The InfoScale product installer is enhanced to stop the veki service before an upgrade so that the patch is installed successfully.

* 4065279 (Tracking ID: 4065280)

SYMPTOM:
The product installer uninstalls the VRTSrest package during an upgrade from the base InfoScale version to a InfoScale patch bundle.

DESCRIPTION:
The base VRTSrest package version (2.0.0.0000) is not defined in the installer scripts. Therefore, the product installer incorrectly assumes the base VRTSrest version to be 8.0.0.0000 and uninstalls the VRTSrest package that has the version 2.0.0.0000.

RESOLUTION:
The product installer scripts are updated to define the correct VRTSrest base version.

* 4068297 (Tracking ID: 4068298)

SYMPTOM:
Installer fails to configure the REST server while using the -rest_server option.

DESCRIPTION:
Installer fails to configure the REST server on the running cluster from any node other than node0 and the following error message is displayed - CPI ERROR V-9-20-1072 Failed to copy <<log directory>>/rest_server.sh from <<system name>> to <<log directory>>/rest_server.sh on <<system name>>. 
When the installer is invoked on any node in the cluster other than node0 to configure the REST server, installer tries to copy 'rest_server.sh' from node0 to to that node. 'rest_server.sh' is not generated on node0, causing the installer to fail.

RESOLUTION:
Installer does not copy 'rest_server.sh' from one node to another as installer needs to execute 'rest_server.sh' on node0 only.

* 4068710 (Tracking ID: 4071333)

SYMPTOM:
On a Solaris system, cluster formation fails after performing a rolling upgrade phase 1 from 6.2.1 to 8.0 with patch_path option and rebooting the system.

DESCRIPTION:
Installer tries to stop services after the 8.0 packages are installed, before installing the patches. When upgrade is performed from 6.2.1 to 8.0 with patches on Solaris, gab service fails to stop and recommends a reboot. The disabled services which were stopped because of stop operation are not enabled. As services are disabled/unloaded, those are not online automatically after a reboot and hence cluster is not formed.

RESOLUTION:
Code changes implemented in the Installer to check whether a reboot required is due to failure of services to stop after installation of the 8.0 packages. In such a case, installer allows start of the services. Modules are enabled and after a reboot all services come up.

* 4068713 (Tracking ID: 4071331)

SYMPTOM:
On a Solaris system, while upgrading to Infoscale 8.0 with patch by using patch_path option;  some of the services fail to stop.

DESCRIPTION:
On a Solaris system while upgrading Infoscale using patch_path option to 8.0 version with patch; installer first installs the 8.0 packages, stops services, and installs patches. When 8.0 packages are installed, on some of the systems it might take more time to load modules. After 8.0 installation is complete, installer runs the command to stop the services which creates a race condition. add_drv/rem_drv goes in busy state resulting in a failure to stop services.

RESOLUTION:
To avoid race condition, Installer code checks and waits if the needed services are started by using package level scripts. Stop commands from the installer are run only then.

* 4070269 (Tracking ID: 4071337)

SYMPTOM:
On Solaris, after upgrading Infoscale from 6.2.1 to 8.0 with a patch_path option; system goes in a panic while starting the vxfen service.

DESCRIPTION:
On Solaris, upgrade from 6.2.1 to 8.0 with patch_path option tries to stop the services after 8.0 packages are installed, but before installing the patches. While starting the services, vxfen goes in a panic and reboots the system.  Here, gab stop fails which keeps the 6.2.1 module loaded. But with the vxfen package/patch installation , vxfen is on 8.0 version. While starting vxfen it tries to find the needed dependencies from gab modules but fails as gab module is not upgraded. This inconsistency makes system panic.

RESOLUTION:
Installer checks if upgrade is from 6.2.1 to 8.0 with patch_path option and in that case, installer only enables services but does not start the services to avoid panic. A system reboot is recommended.

* 4070643 (Tracking ID: 4070427)

SYMPTOM:
After upgrading InfoScale from 6.2.1 to 8.0, installer fails to start services.

DESCRIPTION:
This issue occurs because the installer does not stop the veki service before upgrading the base version to 8.0.

RESOLUTION:
Installer modified to stop the veki service before upgrading.



INSTALLING THE PATCH
--------------------
1. Copy the hot-fix CPI_8.0.0_P3.pl to /tmp
2. Run installation scripts with the hot-fix
   Example:
   ./installer -require /tmp/CPI_8.0.0_P3.pl


REMOVING THE PATCH
------------------
NONE


SPECIAL INSTRUCTIONS
--------------------
NONE


OTHERS
------
NONE