You can upgrade a cluster to vRealize Log Insight 8.8 from 8.6.x. You can upgrade to version 8.4 from 8.3 or 8.2, and to 8.1 from 4.8 or 8.0. To upgrade a cluster to the rest of the versions, you must follow an incremental path. For example, to upgrade from version 8.1 to 8.3, you apply the 8.2 upgrade to 8.1 and then upgrade from 8.2 to 8.3.
Upgrading vRealize Log Insight must be done from the primary node's FQDN. Upgrading using the Integrated Load Balancer IP address is not supported.
During upgrade, the primary node is upgraded first, and restarts. Each of the cluster nodes is upgraded sequentially. You can see the status of the rolling upgrade on the page. If the integrated load balancer is configured, its IPs are migrated among the cluster nodes so cluster services, including UI, API, and ingestion of incoming events, remain available throughout the rolling upgrade. Low-level details are written to the file /storage/core/loginsight/var/upgrade.log on each individual node. A system notification is sent when the upgrade finishes successfully.
If a problem is encountered affecting one or more of the nodes during the upgrade process, the entire cluster is rolled back to the original, working version. Because configuration changes performed after the upgrade started might be inconsistent or invalid, the configuration is reverted to a known-good state captured before upgrade. No ingested events are lost. Progress is written to the file /storage/core/loginsight/var/rollback.log on each individual node. A system notification is sent when rollback finishes. After the issue is investigated and fixed, you can retry the upgrade.
After upgrade, all nodes are placed in a connected state and brought online even if they were in maintenance before upgrade.
Prerequisites
- Verify that you are applying the correct upgrade to version vRealize Log Insight . For more information about supported upgrade paths, see vRealize Log Insight Upgrade Path.
- Create a snapshot or backup copy of the vRealize Log Insight virtual appliance.
- Obtain a copy of the vRealize Log Insight upgrade bundle .pak file for the release you are upgrading to.
- Verify that you are logged in to the vRealize Log Insight web user interface as a Super Admin user, or a user associated with a role that has the relevant permissions. See Create and Modify Roles for more information. The URL format of the web user interface is https://log-insight-host, where log-insight-host is the IP address or host name of the vRealize Log Insight virtual appliance.
- Make a note of any nodes you are upgrading that are in maintenance mode. When the upgrade is finished, you must move them from the state Connected to Maintenance mode.
Procedure
- Expand the main menu and navigate to Management > Cluster.
- Click Upgrade from PAK to upload the .pak file.
- Accept the new EULA to complete the upgrade procedure.
- vRealize Log Insight participates in VMware’s Customer Experience Improvement Program (CEIP).
- If CEIP was activated for the earlier release, no additional change is required during upgrade. CEIP remains activated after the upgrade is finished.
- If CEIP was not activated for the earlier release, the CEIP check box is displayed when the upgrade is finished, and the check box is selected by default. Deselect the check box to leave the CEIP.
After activating or deactivating CEIP, click OK.
What to do next
After the primary node upgrade process is complete, you can view the remaining upgrade process, which is automatic.
Check for the email sent to the Admin to confirm the upgrade completed successfully.
After upgrade, all nodes are brought online even if they were in maintenance mode before the upgrade. Move these nodes back to maintenance mode as needed.
