VMware Validated Design 5.1.2 | 26 MAY 2020

Check for additions and updates to these release notes.

What's in the Release Notes

The release notes cover the following topics:

About VMware Validated Design 5.1.2

VMware Validated Design provides a set of prescriptive documents that explain how to plan, deploy, and configure a Software-Defined Data Center (SDDC). The architecture, the detailed design, and the deployment guides provide instructions about configuring a dual-region SDDC.

VMware Validated Design is tested by VMware to ensure that all components and their individual versions work together, scale, and perform as expected. Unlike Reference Architectures which focus on an individual product or purpose, a VMware Validated Design is a holistic approach to design, encompassing many products in a full stack for a broad set of use case scenarios in an SDDC.

This VMware Validated Design supports a number of use cases, and is optimized for integration, expansion, Day-2 operations, as well as future upgrades and updates. As new products are introduced, and new versions of existing products are released, VMware continues to qualify the cross-compatibility and upgrade paths of VMware Validated Design. Designing with a VMware Validated Design ensures that future upgrade and expansion options are available and supported.

VMware Software Components in the Validated Design

VMware Validated Design 5.1.2 is based on a set of individual VMware products with different versions that are available in a common downloadable package.

The products included in VMware Validated Designs participate in the VMware's Customer Experience Improvement Program ("CEIP"). Join the CEIP because this program provides us with information used to improve VMware products and services, fix problems, and advise you on how best to deploy and use our products.

Details regarding the data collected through CEIP and the purposes for which it is used by VMware are set forth at the Trust & Assurance Center at http://www.vmware.com/trustvmware/ceip.html. To join or leave the CEIP for the products that are part of VMware Validated Design, see the documentation for each product.

Before you deploy or upgrade the SDDC, review the release notes of the software components that are used in this validated design.

VMware Software Components in VMware Validated Design 5.1.2
Product Group and Edition Product Name Product Version
VMware Validated Design VMware Cloud Builder 2.2.1.0
VMware vSphere Enterprise Plus ESXi * 6.7 ESXi670-202004002
vCenter Server Appliance * 6.7 Update 3g
vSphere Update Manager Download Service * 6.7 Update 3g
vSphere Replication 8.2
VMware vSAN Standard or higher vSAN * 6.7 Patch 02
  vSAN Witness Appliance 6.7 Update 3b

Download the appliance OVA file from its location in the download group for VMware vSphere.

VMware NSX Data Center Advanced or higher NSX Data Center for vSphere 6.4.6
VMware vRealize Suite Lifecycle Manager vRealize Suite Lifecycle Manager 2.1 Patch 2
VMware vRealize Operations Manager Advanced or higher vRealize Operations Manager 7.5
vRealize Operations Management Pack for NSX for vSphere 3.5.2
vRealize Operations Management Pack for Storage Devices 7.5
vRealize Operations Management Pack for Site Recovery Manager 8.2.0.1
VMware vRealize Log Insight vRealize Log Insight *** 4.8
vRealize Log Insight Content Pack for NSX for vSphere 3.9
vRealize Log Insight Content Pack for vRealize Automation 7.5+ 1.0
vRealize Log Insight Content Pack for vRealize Orchestrator 7.0.1+ 2.1
vRealize Log Insight Content Pack for vRealize Business 1.5
vRealize Log Insight Content Pack for Linux  2.0.1
VMware Skyline Collector Skyline Collector ** -
VMware vRealize Automation Advanced or higher vRealize Automation 7.6
VMware vRealize Business for Cloud Advanced vRealize Business for Cloud 7.6
VMware Site Recovery Manager Enterprise Site Recovery Manager 8.2

For certain optional add-on guidance, you can also deploy the following products: 

Add-On VMware Software Components in VMware Validated Design 5.1.2
Product Group or Edition Product Name Product Version
VMware NSX Data Center Advanced or higher VMware NSX-T Data Center * 2.5.1
VMware vRealize Operations Manager vRealize Operations Manager Management Pack for NSX-T 2.2
VMware vRealize Log Insight vRealize Log Insight Content Pack for NSX-T 3.8.2
VMware Enterprise PKS VMware Enterprise PKS ** -
VMware vRealize Operations Manager Advanced or higher vRealize Operations Management Pack for Container Monitoring ** -

 

* Updated from the earlier release of VMware Validated Design
** Not validated for VMware Validated Design 5.1.2. See Guidance in Version 5.1 Not Validated for Version 5.1.2.
*** New To remediate VMSA-2020-0007 (CVE-2020-3953 and CVE-2020-3954) for vRealize Log Insight 4.8, you must apply vRealize Log Insight 4.8 Security Patch. See VMware Knowledge Base article 79168.

VMware makes available patches and releases to address critical security and functional issues for several products. Verify that you are using the latest security and express patches or hotfixes for a given component after deploying VMware Validated Design. Scalability and functionally tests for individual patches, express patches, or hotfixes are not typically performed against VMware Validated Design. If a patch must be applied to your environment, follow the VMware published practices and VMware Knowledge Base articles for the specific patch. If an issue occurs during or after the process of applying a patch, contact VMware Technical Support. If after applying a patch, the new product version no longer adheres to the bill of materials, or interrupts the upgrade to the next published version of the design, you must continue to follow the upgrade path to a version of the design that includes this product version.

VMware Solution Exchange and in-product marketplace store only the latest versions of the management packs for vRealize Operations Manager and the content packs for vRealize Log Insight. The software components table contains the latest versions of the packs that were available at the time this VMware Validated Design was validated. When you deploy the VMware Validated Design components, it is possible that the version of a management or content pack on VMware Solution Exchange and in-product marketplace is newer than the one used for this release.

For information on the life cycle of the VMware software components in this VMware Validated Design, see Life Cycle of the VMware Software Components.

What's New

VMware Validated Design 5.1.2 provides a list of new features:

  • Updated Bill of Materials that incorporates new product versions
  • Starting with this version, VMware Cloud Builder is no longer updated for clean deployments of VMware Validated Design. You use VMware Cloud Builder to deploy VMware Validated Design 5.1.1 and then update the products in your SDDC to the versions in VMware Validated Design 5.1.2.
  • Because of the minor differences between the product versions in VMware Validated Design 5.1.1 and VMware Validated Design 5.1.2, the compatibility of the products in the SDDC is confirmed only by validating the SDDC update to the target product versions in VMware Validated Design 5.1.2.
  • Updated Published a new security and compliance kit for ISO 27001.

For more information, see the VMware Validated Design Documentation page.

Earlier Releases of VMware Validated Design

Features and known issues of VMware Validated Design are described in the release notes for each release. See VMware Validated Design 5.1 Release Notes and VMware Validated Design 5.1.1 Release Notes.

Internationalization

This VMware Validated Design release is available only in English.

Compatibility

This VMware Validated Design guarantees that product versions in the VMware Validated Design 5.1.2, and the design chosen, are fully compatible. Any minor known issues that exist are described in this release notes document.

Installation

To install and configure an SDDC according to this validated design, perform these steps:

  1. Deploy VMware Validated Design 5.1.1 by using VMware Cloud Builder for automated deployment. See Planning and Preparation, Deployment of Region A, and Deployment of Region B.
  2. Update the environment to VMware Validated Design 5.1.2. See VMware Knowledge Base article 79047.

For product download information, and guides access, see the VMware Validated Design Documentation page.

Updating to VMware Validated Design 5.1.2

For information about updating VMware Validated Design 5.1.1 to VMware Validated Design 5.1.2, see VMware Knowledge Base article 79047.

Updating to VMware NSX-T 2.5.1 in an NSX-T Workload Domain

If you have a VMware Validated Design 5.1.1 environment with an NSX-T workload domain, after you update the management and initial workload domains to VMware Validated Design 5.1.2, update the NSX-T and vSphere components of the workload domain by performing these steps.

ESXi Hosts in an NSX-T Workload Domain
ESXi Host FQDN ESXi Host IP Address
sfo01w02esx01.sfo01.rainpole.local 172.16.41.101
sfo01w02esx02.sfo01.rainpole.local 172.16.41.102
sfo01w02esx03.sfo01.rainpole.local 172.16.41.103
sfo01w02esx04.sfo01.rainpole.local 172.16.41.104

Compute vCenter Server in an NSX-T Workload Domain
vCenter Server FQDN vCenter Server IP Address
sfo01w02vc01.sfo01.rainpole.local 172.16.11.67

 

NSX-T Components in an NSX-T Workload Domain
NSX-T Role FQDN IP Address
NSX-T Manager sfo01wnsx01a.sfo01.rainpole.local 172.16.11.82
  sfo01wnsx01a.sfo01.rainpole.local 172.16.11.83
  sfo01wnsx01a.sfo01.rainpole.local 172.16.11.84
  sfo01wnsx01.sfo01.rainpole.local (VIP) 172.16.11.81
NSX-T  Edge Node 1 sfo01wesg01.sfo01.rainpole.local
  • 172.16.41.21 (Management)
  • 172.16.49.21 (Overlay)
  • 172.16.47.2 (Uplink 1)
  • 172.16.48.2 (Uplink 2)
NSX-T Edge Node 2 sfo01wesg02.sfo01.rainpole.local
  • 172.16.41.22 (Management)
  • 172.16.49.22 (Overlay)
  • 172.16.47.3 (Uplink 1)
  • 172.16.48.3 (Uplink 2)
  1. Update the NSX-T appliances and VIBs on the ESXi hosts for the workload domain to NSX-T 2.5.1 by using the NSX-T upgrade coordinator. For a quick reference to the upgrade stages, see NSX-T Data Center Upgrade Checklist in the NSX-T 2.5 Data Center Upgrade Guide.
    • Prepare the workload domain for the NSX-T update. See Preparing to Upgrade NSX-T Data Center in the NSX-T 2.5 Data Center Upgrade Guide.
    • Update the NSX-T software on the NSX-T components for the workload domain. See Upgrading NSX-T Data Center in the NSX-T 2.5 Data Center Upgrade Guide.

      For the update of the NSX-T Edge cluster, select the Serial upgrade path.
    • Verify the update. See Verify the Update in the NSX-T 2.5 Data Center Upgrade Guide.
    • Resolve all issues that occur during the update.
      See Troubleshooting Upgrade Failure in the NSX-T 2.5 Data Center Upgrade Guide.
  2. Apply the patch for the vCenter Server Appliance version in this VMware Validated Design to the Compute vCenter Server in the NSX-T workload domain. See VMware Knowledge Base article 79047.
  3. Apply the patch for the ESXi product version in this VMware Validated Design to the hosts in the shared edge and compute cluster in the NSX-T workload domain. See VMware Knowledge Base article 79047.

Updated Guidance in Version 5.1 Not Validated for Version 5.1.2

The following documentation that is available in VMware Validated Design 5.1 is out of scope for validation in this version of VMware Validated Design:

  • VMware Skyline Design
  • Skyline Manual Deployment in Region A and Skyline Manual Deployment in Region B.

If you want to deploy Skyline Collector instances in the SDDC, see VMware Skyline Documentation.

  • Architecture and Design for VMware Enterprise PKS with VMware NSX-T Workload Domains
  • Deployment of VMware Enterprise PKS with VMware NSX-T Workload Domains

Life Cycle of the VMware Software Components

This VMware Validated Design version is based on one or more VMware products whose versions eventually reach the End of Support Life (EOSL) stage as described by the VMware Lifecycle Policies.Тhose versions are no longer generally supported by VMware. In such a case, upgrade to a later version by using the upgrade procedures in the VMware Validated Design Upgrade documentation.

If you are using an earlier version in your environment, upgrade your environment according to the following scenarios:

Scenarios for Upgrade from a Version that Has Reached EOSL
Scenario Upgrade Approach
The version of VMware Validated Design that you are using has already entered the EOSL stage but the next VMware Validated Design version is still supported. Apply the VMware Validated Design Upgrade documentation to bring the VMware environment to a fully supported state
The version of VMware Validated Design that you are using and the next version have both already entered the EOSL stage Because the VMware Validated Design Upgrade documentation supports upgrade only from one release to the next one, the transition across multiple releases might be complex. Contact a VMware sales representative to plan and perform a custom upgrade procedure with the assistance of VMware Professional Services.

For more information about current and expired product releases, refer to the VMware Lifecycle Product Matrix

Documentation Delivery Log

The VMware Validated Design documentation is published in several iterations. On the release date, the core documents that introduce VMware Validated Design and provide guidance on the SDDC design, planning, and deployment are published live. The remaining documents are released in groups until the entire set is compliant with the Bill of Materials of the VMware Validated Design release.

Log of Delivered VMware Validated Design Documentation
Delivery Date Documentation
08 OCT 2020
  • Security and Compliance
    • Security and Compliance Configuration Guide for ISO 27001
    • Security and Compliance Kit for ISO 27001
14 JUL 2020
  • Workload Domain
    • Architecture and Design for VMware NSX-T Workload Domains with Multiple Availability Zones
    • Deployment of VMware NSX-T Workload Domains with Multiple Availability Zones
26 MAY 2020
  • Release Notes
  • VMware Knowledge Base article 79047 about updating VMware Validated Design 5.1.1 to VMware Validated Design 5.1.2

All documentation is available on the VMware Validated Design Documentation page.

Known Issues

VMware Validated Design 5.1.2 inherits all known issues of VMware Validated Design 5.1.1. See VMware Validated Design 5.1.1 Known Issues.
VMware Validated Design 5.1.2 also has additional known issues that are identified during the validated update processes from VMware Validated Design 5.1.1.

  • After you upgrade ESXi hosts by using vSphere Update Manager, one or more hosts might be in maintenance mode and the remaining ESXi hosts not be upgraded

    When you upgrade the ESXi hosts from version ESXi670-201912001 to ESXi670-202004002 by using vSphere Update Manager, one or more ESXi hosts might remain in maintenance mode after the upgrade process finishes. This causes vSphere Update Manager to skip the upgrade on the remaining hosts in the cluster and the Remediate entity task shows the following error message: 

    There are errors during the remediation operation. Check the events and log files for details
    

    Workaround: Exit maintenance mode for the ESXi hosts and remediate the remaining ESXi hosts that are not yet upgraded.

    1.  Exit maintenance mode for the ESXi hosts that are in maintenance mode after the upgrade process is completed.
      1. Open a Web browser and go to https://sfo01m01vc01.sfo01.rainpole.local/ui.
      2. Log in by using the following credentials.
        Setting Value
        User name administrator@vsphere.local
        Password

        vsphere_admin_password

      3. From the Home menu of vSphere Web Client, click Hosts and Clusters, expand the sfo01-m01-dc data center, and expand the sfo01-m01-mgmt cluster.
      4. Click the host in maintenance mode and click the Update tab.
      5. Verify that the host is compliant with the baseline.
      6. Right-click the host in maintenance mode and select Maintenance mode > Exit Maintenance Mode.
      7. Repeat Step 4 to Step 6 for all ESXi hosts that are still in maintenance mode. 
    2. Remediate the ESXi hosts that are not upgraded by following Step 3 from the Updating the VMware Validated Design 5.1.1 to version 5.1.2 (79047) procedure.
check-circle-line exclamation-circle-line close-line
Scroll to top icon