check-circle-line exclamation-circle-line close-line

VMware Validated Design for Software-Defined Data Center 5.0.1 Release Notes

VMware Validated Design for Software-Defined Data Center 5.0.1 | 19 MAR 2019
VMware Cloud Builder 2.0.1 | 02 MAY 2019 | BUILD 13532358

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 for Software-Defined Data Center 5.0.1

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 for Software-Defined Data Center 5.0.1 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 for the software components that are used in this validated design.

VMware Software Components in VMware Validated Design 5.0.1
Product Group and Edition Product Name Product Version
VMware Validated Design Updated  VMware Cloud Builder * ** 2.0.1
VMware vSphere Enterprise Plus ESXi * 6.7 Patch ESXi670-201901001
vCenter Server Appliance * 6.7 Update 1b
vSphere Update Manager * 6.7 Update 1b
vSphere Update Manager Download Service * 6.7 Update 1b
vSphere Replication 8.1.1
VMware vSAN Standard or higher vSAN * 6.7 Express Patch 6
VMware NSX Data Center Advanced or higher NSX Data Center for vSphere 6.4.4
VMware vRealize Suite Lifecycle Manager vRealize Suite Lifecycle Manager 2.0.0 Patch 2
VMware vRealize Operations Manager Advanced or higher vRealize Operations Manager 7.0
vRealize Operations Management Pack for NSX for vSphere 3.5.2
vRealize Operations Management Pack for Storage Devices 7.0.0
vRealize Operations Management Pack for Site Recovery Manager 8.1.1
VMware vRealize Log Insight vRealize Log Insight 4.7
vRealize Log Insight Content Pack for NSX for vSphere 3.8
vRealize Log Insight Content Pack for vRealize Automation 7.3+ 2.1
vRealize Log Insight Content Pack for vRealize Orchestrator 7.0.1+ 2.0
vRealize Log Insight Content Pack for vRealize Business 1.3
vRealize Log Insight Content Pack for Linux 1.0
vRealize Log Insight Content Pack for Site Recovery Manager 1.7
VMware vRealize Automation Advanced or higher vRealize Automation 7.5
VMware vRealize Business for Cloud Advanced vRealize Business for Cloud 7.5
VMware Site Recovery Manager Enterprise Site Recovery Manager 8.1.1

 

* Updated from the earlier release of VMware Validated Design
** Cloud Builder 2.0.2 available for VMware Cloud Foundation 3.7.2 supports only the bring-up workflow  for VMware Cloud Foundation. To deploy VMware Validated Design 5.0.1, use Cloud Builder 2.0.1.

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

Add-On VMware Software Components in VMware Validated Design 5.0.1
Product Group or Edition Product Name Product Version
VMware NSX Data Center Advanced or higher VMware NSX-T Data Center 2.4
New VMware Skyline VMware Skyline Collector 2.1

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 lifecycle of the VMware software components in this VMware Validated Design, see Lifecycle of the VMware Software Components.

What's New

VMware Validated Design for Software-Defined Data Center 5.0.1 provides a list of new features:

  • Updated Bill of Materials that incorporates new product versions
  • Use of the Cloud Builder appliance in both VMware Validated Design and VMware Cloud Foundation

    At Cloud Builder deployment, you select the option for VMware Validated Design. Then, to deploy the software components of VMware Validated Design, you upload the sddc-vrealize-bundle-x.x.x.x-xxxxxxxx.iso and sddc-dr-bundle-x.x.x.x-xxxxxxxx.iso functionality-specific software bundles.

  • Updated guidance on VMware NSX-T

    NSX-T Manager now implements the centralized control plane and is deployed in cluster mode on the management cluster of the SDDC.

  • New Introduced guidance on VMware Skyline

    You can connect the Standard SDDC to VMware Skyline for proactive VMware support by collecting product usage analytics data.

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.0 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 for Software-Defined Data Center 5.0.1, 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, follow the guidance in the VMware Validated Design 5.0 documentation. See the VMware Validated Design Documentation page.

To deploy VMware Validated Design 5.0.1, consider the following configuration changes in the deployment process:

Changes in the Deployment Documentation for VMware Validated Design 5.0.1
Configuration Change Procedure
When you deploy the appliance of VMware Cloud Builder on a management host in Region A or in Region B for Standard SDDC and on a host in the consolidated cluster for Consolidated SDDC, set the SKU setting to VVD.

Deploy the Virtual Appliance of VMware Cloud Builder on a Management Host in Region A

Deploy the Virtual Appliance of VMware Cloud Builder on a Management Host in Region B

Deploy the Virtual Appliance of VMware Cloud Builder for Consolidated SDDC

  • For Standard SDDC, download the sddc-vrealize-bundle-x.x.x.x-xxxxxxxx.iso and sddc-dr-bundle-x.x.x.x-xxxxxxxx.iso software bundles from my.vmware.com.
  • For Consolidated SDDC, download the sddc-vrealize-bundle-x.x.x.x-xxxxxxxx.iso software bundle from my.vmware.com.

Prerequisites for Automated SDDC Deployment in Region A

Prerequisites for Automated SDDC Deployment in Region B

Prerequisites for Automated SDDC Deployment for Consolidated SDDC

  • For Standard SDDC, upload both the sddc-vrealize-bundle-x.x.x.x-xxxxxxxx.iso and sddc-dr-bundle-x.x.x.x-xxxxxxxx.iso software bundles to the /mnt/hgfs folder on the Cloud Builder appliance.
  • For Consolidated SDDC, upload both the sddc-vrealize-bundle-x.x.x.x-xxxxxxxx.iso to the /mnt/hgfs folder on the Cloud Builder appliance.

Upload the VMware Validated Design Software Bundle and Signed Certificates to VMware Cloud Builder in Region A

Upload the VMware Validated Design Software Bundle and Signed Certificates to VMware Cloud Builder in Region B

Upload the VMware Validated Design Software Bundle and Signed Certificates to VMware Cloud Builder for Consolidated SDDC

For both Standard SDDC and Consolidated SDDC, after you upload the software bundles, configure the Cloud Builder appliance to use the bundles by running the following command:
/opt/vmware/vcf/cloud-builder/install/reconfigure.sh.

Upload the VMware Validated Design Software Bundle and Signed Certificates to VMware Cloud Builder in Region A

Upload the VMware Validated Design Software Bundle and Signed Certificates to VMware Cloud Builder in Region B

Upload the VMware Validated Design Software Bundle and Signed Certificates to VMware Cloud Builder for Consolidated SDDC

Updating to VMware Validated Design 5.0.1

For information about updating VMware Validated Design 5.0 to VMware Validated Design 5.0.1, see VMware Knowledge Base article 67343.

New Updating to Cloud Builder 2.0.1

If you are running Cloud Builder 2.0 in your environment, remove it and deploy the Cloud Builder 2.0.1 appliance. Cloud Builder does not support in-place upgrade.

Lifecycle 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.

Caveats and Limitations

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.

To evaluate, deploy, and manage an SDDC that is compliant with VMware Validated Design 5.0.1, follow the documentation of VMware Validated Design 5.0 considering the installation and upgrade differences that are described in this release notes document. In addition, VMware Validated Design 5.0.1 provides guidance that is specifically related to the software components in this release.

Log of Delivered VMware Validated Design Documentation
Delivery Date Documentation
28 MAY 2019
  • Standard SDDC
    • Design and Deployment of VMware Skyline
19 MAR 2019
  • Standard SDDC
    • Architecture and Design of VMware NSX-T for Workload Domains
    • Deployment of VMware NSX-T for Workload Domains

All documentation is available on the VMware Validated Design Documentation page. For details on the latest available guidance, see Documentation Map for VMware Validated Design.

Resolved Issues

The resolved issues are grouped as follows.

VMware Cloud Builder 2.0.1
  • New Cloud Builder assigns the subnet mask for the secondary storage network for the management cluster to the shared edge and compute cluster

    On the Hosts and Networks tabs of the vvd-rega-deployment-parameter.xlsx deployment parameter spreadsheet for Region A or the vvd-regb-deployment-parameter.xlsx deployment parameter spreadsheet for Region B, you enter different values for the subnet mask of the secondary storage network of the management cluster and of the shared edge and compute cluster. In the generated deployment JSON files, the subnet mask assigned to the storage network of the management cluster is also assigned to the network of the shared edge and compute cluster.

     

  • New Cloud Builder assigns the password of the admin user of vRealize Log Insight to the admin user of vRealize Operations Manager

    In the deployment JSON files generated for either Standard SDDC or Consolidated SDDC, Cloud Builder assigns the password of the admin user of vRealize Log Insight to the admin user of vRealize Operations Manager instead of the password you enter in the vvd-rega-deployment-parameter.xlsx and vvd-regb-deployment-parameter.xlsx, or vvd-consolidated-deployment-parameter.xlsx deployment parameter spreadsheets.

Known Issues

The known issues in VMware Validated Design 5.0.1 has the same known issues in VMware Validated Design 5.0. Because the versions of VMware Cloud Builder in version 5.0 and version 5.0.1 are different, this design also has specific known issues.

The known issues are grouped as follows.

Known Issues from VMware Validated Design 5.0

The known issues in VMware Validated Design 5.0.1 are the same as in VMware Validated Design 5.0. See VMware Validated Design for Software-Defined Data Center 5.0 Release Notes.

    VMware Cloud Builder 2.0.x
    • New An attempt to deploy the SDDC in Region B without including vRealize Operations Manager results in a deployment failure

      On the Run Parameters tab of the vvd-regb-deployment-parameter.xlsx deployment parameters spreadsheet, deselect vRealize Operations Manager. Then, in the user interface of the Cloud Builder appliance, generate the JSON deployment file and start the deployment of the SDDC in Region B. The deployment fails immediately with the following error message:

      Missing users and groups in AD specification: SvcVrliVrops user is required in components [LogInsight]

      Workaround: On the VMware Cloud Builder appliance, add the SvcVrliVrops account object to the vvd-std-regb-comp.json file and start the deployment again.

      1. Open an SSH connection to the lax01cb01.lax01.rainpole.local appliance and log in as the admin user. 
      2. To open the vvd-std-regb-comp.json file for editing, run the following command.
        vi /opt/vmware/sddc-support/cloud_admin_tools/Resources/std-regb/vvd-std-regb-mgmt.json
      3. Add the SvcVrliVrops object to the users list under the adSpec section of the JSON file and save the file.
        "adSpec": {
          "users": {
            "SvcVrliVrops": {
              "userName": "svc-vrli-vrops",
              "password": "VMware1!"
            },

          . . .
        }
      4. Open a Web browser and log in to https://sfo01cb01.sfo01.rainpole.local as the admin user.
      5. Click the Deployment Wizard icon.
      6. On the Deploy an SDDC tab, click Retry.
    • An attempt to deploy the SDDC in Region A or Region B might fail at the step for deploying Site Recovery Manager

      In the user interface of VMware Cloud Builder, you might see that the Deploy Site Recovery Manager task has failed.

      In the Windows virtual machine of Site Recovery Manager, the latest installation log file C:\srmMsiLog-*.log contains the following error stack trace:

      VMware: Srm::Installation::Utility::LaunchApplication: INFORMATION: Executable finished executing. Result code=1603
      VMware: Srm::Installation::Database::InstallvPostgres: ERROR: Failed to install vPostgres, Code=1603
      VMware: Srm::Installation::VMInstallEmbeddedDatabaseServer: ERROR: Failed to install the embedded database server.CustomAction VMInstallEmbeddedDatabaseServer returned actual error code 1603 (note this may not be 100% accurate if translation happened inside sandbox)

      Workaround:

      1. Log in to the Windows virtual machine of Site Recovery Manager by using a Remote Desktop Protocol (RDP) client.
        1. Open an RDP connection to one of these FQDNs. .
          Region FQDN of the Site Recovery Manager Instance
          Region A sfo01m01srm01.sfo01.rainpole.local
          Region B lax01m01srm01.lax01.rainpole.local
        2. Log in by using the following credentials.
          Setting Value
          User name Windows administrator user
          Password Windows_administrator_password
      2. Install manually Site Recovery Manager by running the C:\srm.bat file.
      3. After the installation is complete, in the user interface of Cloud Builder, retry the deployment in the region.
    • New After SDDC deployment is complete, some vRealize Log Insight Content Packs are not installed

      During SDDC deployment, Cloud Builder skips the installation of some vRealize Log Insight Content Packs. The dashboards of these content packs are missing in the user interface of vRealize Log Insight:

      • Standard SDDC and Consolidated SDDC
        • VMware - Linux
        • VMware - NSX-vSphere
        • VMware - vRA
        • VMware - vRealize Business for Cloud
      • Standard SDDC
        • VMware - SRM

      Install manually these content packs from VMware Marketplace by using vRealize Suite Lifecycle Manager.

      1. Log in to the user interface of vRealize Lifecycle Manager.
        1. Open a Web browser and go to https://vrslcm01svr01a.rainpole.local/vrlcm.
        2. Log in by using the following credentials.
          Setting Value
          User name admin@localhost
          Password vrslcm_admin_password
      2. Register the vRealize Suite Lifecycle Manager instance with My VMware.
        See Register vRealize Suite Lifecycle Manager with My VMware in VMware Validated Design 4.3.
      3. Click Marketplace and click the VMware Marketplace tab.
      4. Locate the content pack and click Download.
        • Linux Content Pack
        • NSX-v for vSphere Content Pack
        • vRealize Automation 7.3+ Content Pack
        • VMware vRealize Business for Cloud 7.3+ Content Pack for Log Insight
        • SRM Content Pack

        For example, to locate the content pack for NSX for vSphere, filter by vRealize Log Insight and search for linux.

      5. After the download is complete, on the Download tab, click the vertical ellipsis icon at the top right corner of the content pack tile and click Install.
      6. On the Datacenter Details page of the dialog box for the content pack installation, set the target data center and environment in vRealize Suite Lifecycle Manager and click Install.
        Setting Value for Region A Value for Region B Value for Consolidated SDDC
        Select Datacenter sfo01-m01dc lax01-m01dc sfo01-m01dc
        Select Environment sfo01-Region-Env lax01-Region-Env sfo01-Region-Env
      7. In the message window, click OK.
      8. Repeat this procedure for the other content packs.