How to upgrade vRealize Log Insight in VMware Cloud Foundation 3.5
search cancel

How to upgrade vRealize Log Insight in VMware Cloud Foundation 3.5

book

Article ID: 316901

calendar_today

Updated On:

Products

VMware Cloud Foundation

Issue/Introduction

This article provides instructions for how to upgrade vRealize Log Insight in VMware Cloud Foundation 3.5.

Environment

VMware Cloud Foundation 3.5.x

Resolution

Notes:
  • Take snapshots of all vRealize Log Insight VMs prior to beginning this procedure.
  • Download the VMware vRealize Log Insight 4.7.0- Upgrade Package (VMware-vRealize-Log-Insight-4.7.0-<build>.pak) from customerconnect.vmware.com.

Disable Pre-Upgrade Verification in vRealize Log Insight

  1. Log in to the vRealize Log Insight user interface on the Log Insight master node as the admin user.
  2. Open a second tab in the same browser and connect to https://<Log Insight master node>/internal/config.
  3. Add the following line inside the <upgrade></upgrade> stanza:

<upgrade-prevalidation-enabled value="false" /> #

  1. Click the SAVE button.

Upgrade vRealize Log Insight

  1. Log in to the vRealize Log Insight user interface as the admin user.
  2. Click the configuration drop-down menu icon  and select Administration.
  3. Under Management, click Cluster and click Upgrade Cluster.
  4. Browse to the location of the VMware-vRealize-Log-Insight-4.7.0-<build>.pak file on your local file system and click Open.
  5. In the Upgrade Log Insight dialog box, click Upgrade and wait until the .pak file uploads to the master node.
  6. On the End User License Agreement page, click Accept.

    Note: The Upgrade Log Insight progress dialog box opens.

  7. After the upgrade of the master node completes, in the Upgrade Successful dialog box that appears, click OK.

    Notes:

  • The upgrade of the remaining nodes in the cluster starts automatically.

  • After the upgrade process for the cluster completes, the Integrated Load Balancer comes online and display as Available.

Upgrade the Content Packs on vRealize Log Insight

  1. Log in to the vRealize Log Insight user interface as the admin user.
  2. Click the configuration drop-down menu icon  and select Content Pack.
  3. In the Content Pack pane, under Content Pack Market Place, click Updates.
  4. In the Log Insight Content Pack Marketplace pane, click Update All to upgrade all content packs to the latest version.
  5. After you upgrade the content packs, click each of the items under Installed Content Packs and verify that the Version number of each content pack matches the version, or is newer than the version in the VMware Cloud Foundation 3.5 Release Notes.

Upgrade the vRealize Log Insight Agents on the Windows Nodes

Note: These steps are only required for vRealize Automation Windows nodes. The process can be used on other Windows nodes where the vRealize Log Insight agent is installed.
  1. Log in to the vRealize Log Insight user interface as the admin user.
  2. Click the configuration drop-down menu icon  and select Administration.
  3. Under Management, click Agents.
  4. Click the Download Log Insight Agent Version link.
  5. In the Download Log Insight Agent Version 4.7.0 dialog box, download the Windows MSI (32-bit/64-bit) vRealize Log Insight Agent file to the Windows host that you use to access the environment
  6. Upgrade the vRealize Log Insight Agents for Windows.
    1. Open a Remote Desktop Protocol (RDP) connection to each of the following Windows virtual machines and log in with the vRealize Automation service account.
vRealize Automation Web Server VMs (2)
vRealize Automation IasS Manager Service and DEM Orchestrator VMs (2)
vRealize Automation IaaS DEM Worker VMs (2)
vRealize Automation IaaS Proxy Agent VMs (2)
Microsoft SQL Server VM (1)
  1. Copy the VMware-Log-Insight-Agent-4.7.0-<build>.msi file from the Windows host to the vRealize Automation Windows VM.
  2. Open an administrative command prompt window, and navigate to the directory to where you saved the .msi file.
  3. Run the following command to install the vRealize Log Insight agent with custom values. 
     
    VMware-Log-Insight-Agent-4.6.0-<build>.msi SERVERPORT=9000 AUTOUPDATE=yes LIAGENT_SSL=no
  1. In the VMware vRealize Log Insight Agent Setup wizard, accept the license agreement and click Next.
  2. With the Log Insight host name shown in the Host text box, click Install.
  3. When the installation is complete, click Finish.
  4. Repeat the steps on the remaining vRealize Automation IaaS virtual machines.
  1. After you upgrade the vRealize Log Insight agents, verify that the agent version in the vRealize Log Insight cluster is 4.7.0.<build>.
    1. Log in to the vRealize Log Insight user interface as the admin user..
    2. Click the configuration drop-down menu icon  and select Administration.
    3. Under Management, click Agents.
    4. On the Agents page, verify that the Version column shows 4.7.0.<build>.


Upgrade the vRealize Log Insight Agent on the SDDC Manager VM

  1. ssh to the SDDC Manager VM as the vcf user and then issue the su - command to switch to the root user.
  2. Issue a command similar to the following to download the Log Insight agent package:
wget http://<vRLI_cluster_FQDN>:9000/api/v1/agent/packages/types/rpm -O /tmp/li-agent.rpm
  1. Issue the following commands to upgrade the Log Insight agent:
chmod +x /tmp/li-agent.rpm
rpm -Uhv /tmp/li-agent.rpm


Upgrade the vRealize Log Insight version recorded in VMware Cloud Foundation 3.5

  1. Download the attached 60278_vrli_version_updater.zip file.
  2. Use a file transfer utility to copy the 60278_vrli_version_updater.zip file to the /home/vcf folder on the SDDC Manager VM.
  3. Log in to the SDDC Manager VM as the vcf user.
  4. Issue the following command to extract the contents of the 60278_vrli_version_updater.zip file:
unzip 60278_vrli_version_updater.zip
  1. Issue the following command to run the extracted vrli_version.updater.py script:
python vrli_version_updater.py

Note: You will see output similar to the following:

Verifying VRLI version and updating it in SDDC manager logical inventory, if needed
Checking VRLI version
API response: [{"id":"618a2421-edca-11e8-8b0f-6d7f5b3308a7","domainId":"60b5bd20-edca-11e8-8b0f-6d7f5b3308a7","loadBalancerHostname":"vrli.vcf.corp.local","nodeSize":"MEDIUM","enhancedLoggingEnabled":false,"masterNode":{"id":"6189d600-edca-11e8-8b0f-6d7f5b3308a7","hostName":"vrli-1.vcf.corp.local","managementIpAddress":"192.168.16.17","vmName":"vrli-1"},"workerNodes":[{"id":"6189fd10-edca-11e8-8b0f-6d7f5b3308a7","hostName":"vrli-2.vcf.corp.local","managementIpAddress":"192.168.16.18","vmName":"vrli-2"},{"id":"6189fd11-edca-11e8-8b0f-6d7f5b3308a7","hostName":"vrli-3.vcf.corp.local","managementIpAddress":"192.168.16.19","vmName":"vrli-3"}],"version":"DefaultVersion","status":"ACTIVE"}]
API response: [{"id":"a037ffeb-3749-4d40-a23b-79daf2a23e36","entityId":"618a2421-edca-11e8-8b0f-6d7f5b3308a7","entityType":"VRLI","credentialType":"API","username":"admin","secret":"VMware123!"}]
Successful authentication to vRLI node with IP address vrli.vcf.corp.local
API response: {"releaseName":"GA","version":"4.6.1-8597028"}
Found the following version for vRLI: 4.6.1-8597028
Found version 4.6.1-8597028
Updating vRLI version in logical inventory
 

Enable Pre-Upgrade Verification in vRealize Log Insight

  1. Log in to the vRealize Log Insight user interface on the Log Insight master node as the admin user.
  2. Open a second tab in the same browser and connect to https://<Log Insight master node>/internal/config.
  3. Remove the following line inside the <upgrade></upgrade> stanza:

<upgrade-prevalidation-enabled value="false" /> #

  1. Click the SAVE button.


Additional Information

Impact/Risks:
It is not supported to update vRealize Log Insight beyond version 4.7. Doing so my negatively affect VMware Cloud Foundation's ability to manage this product.

Attachments

60278_vrli_version_updater get_app
Powered by Wolken Software