Vrealize Lifecycle Manager 8.6 Installation Upgrade and Management
Vrealize Lifecycle Manager 8.6 Installation Upgrade and Management
6
Installation, Upgrade, and Management
Guide
You can find the most up-to-date technical documentation on the VMware website at:
https://docs.vmware.com/
VMware, Inc.
3401 Hillview Ave.
Palo Alto, CA 94304
www.vmware.com
©
Copyright 2021 VMware, Inc. All rights reserved. Copyright and trademark information.
VMware, Inc. 2
Contents
VMware, Inc. 3
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
VMware, Inc. 4
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
VMware, Inc. 5
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
6 Upgrading vRealize Suite Lifecycle Manager and vRealize Suite Products 188
Upgrade vRealize Suite Lifecycle Manager 8.x 188
Support for Additional Product Versions 190
Upgrade VMware Identity Manager 190
Migrating Windows Connector 192
Upgrade vRealize Automation 8.x with vRealize Suite Lifecycle Manager 193
Upgrade Functionality of vRealize Automation 195
Upgrade a vRealize Suite Product 196
Upgrade Existing Products Using Pre-Upgrade Checker 198
Upgrade vRealize Operations Manager 200
Upgrade vRealize Automation 7.x 201
Upgrade vRealize Network Insight 202
Upgrade vRealize Log Insight 203
VMware, Inc. 6
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
7 Performing a Disaster Recovery Plan for vRealize Suite Lifecycle Manager 206
VMware, Inc. 7
About vRealize Suite Lifecycle Manager
Installation, Upgrade, and Management
Guide
The vRealize Suite Lifecycle Manager Installation and Management guide provides instructions
for installing VMware vRealize Suite Lifecycle Manager and using vRealize Suite Lifecycle
Manager to install and manage vRealize Suite products.
Intended Audience
This information is intended for anyone who wants to use vRealize Suite Lifecycle Manager to
deploy and manage the vRealize Suite products to monitor and manage a software-defined data
center (SDDC). The information is written for experienced virtual machine administrators who are
familiar with enterprise management applications and data center operations.
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 Customer Experience Improvement Program (CEIP), see Configure
Environment Settings for a New Private Cloud
VMware, Inc. 8
Installing vRealize Suite Lifecycle
Manager 1
vRealize Suite Lifecycle Manager helps you to install the vRealize Suite products in a shorter time
frame than installing individual products. You can also manage and upgrade your vRealize Suite
products through vRealize Suite Lifecycle Manager.
n System Requirements
The following hardware and operating system requirements are required for vRealize Suite
Lifecycle Manager.
System Requirements
The following hardware and operating system requirements are required for vRealize Suite
Lifecycle Manager.
VMware, Inc. 9
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Virtual CPU 2
n vRealize Automation
The VMware Product Interoperability Matrix provides details about the supported product
versions and the compatibility matrix of vRealize Suite Lifecycle Manager with vRealize Suite
products.
For more information about vRealize Suite, see vRealize Suite Overview. You can onboard a
supported vRealize product version that supports import in vRealize Suite Lifecycle Manager, and
then can upgrade the same to a supported product versions by vRealize Suite Lifecycle Manager.
VMware, Inc. 10
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
vRealize Automation 7.2, 7.3.0, 7.3.1, 7.4, 7.5.0, 7.6.0, 8.0.0, 8.0.1, 8.1.0, 8.2.0, 8.3.0, 8.4.0, 8.4.1, 8.5, 8.5.1, and 8.6.0
vRealize Automation 8.4.1 is supported with vRealize Suite Lifecycle Manager 8.4.1.
vRealize Automation 8.4.2 is supported with vRealize Suite Lifecycle Manager 8.4.1 Patch 1.
vRealize Automation 8.5.0 is supported with vRealize Suite Lifecycle Manager 8.4.1 product
support pack 3.
vRealize Automation 8.5.1 is supported with vRealize Suite Lifecycle Manager 8.4.1 product
support pack 4.
vRealize Business for 7.2, 7.3.0, 7.3.1, 7.4, 7.5.0, and 7.6.0
Cloud
vRealize Operations 6.3, 6.4, 6.5.0, 6.6.0, 6.6.1, 6.7.0, 7.0.0, 7.5.0, 8.0.0, 8.0.1, 8.1.0, 8.1.1, 8.2.0, 8.3.0, 8.4.0, 8.5.0,
Manager and 8.6.0
vRealize Operations Manager 8.5.0 is supported with vRealize Suite Lifecycle Manager 8.4.1
product support pack 2.
vRealize Log Insight 4.5.1, 4.6.0, 4.6.1, 4.7.0, 4.7.1, 4.8.0, 8.0.0, 8.1.0, 8.1.1, 8.2.0, 8.3.0, 8.4.0, 8.4.1, 8.5.0, 8.6.0
vRealize Log Insight 8.4.1 is supported with vRealize Suite Lifecycle Manager 8.4.1 product
support pack 1.
vRealize Network 4.0, 4.1, 4.1.1, 4.2.0, 5.0, 5.1.0, 5.2.0, 5.3.0, 6.0.0, 6.1.0, 6.2.0, 6.3.0 and 6.4.0 vRealize Network
Insight Insight 6.3.0 is supported with vRealize Suite Lifecycle Manager 8.4.1 Product Support Pack 2.
For the product interoperability, see Interoperability Matrix. For more information about vRealize
Suite, see vRealize Suite Overview.
Supported Browsers
n Google Chrome
n Internet Explorer
n Mozilla Firefox
VMware, Inc. 11
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Table 1-1. Required Ports and Endpoints for Integration and Communication with VMware
Services in Cloud
*.akamaiedge.net
Note
n vRealize Suite Lifecycle Manager always initiates the communication to retrieve or to send
data to the VMware services in Cloud. You can configure your network to permit outbound
traffic and block inbound traffic to the specified port without impacting the vRealize Suite
Lifecycle Manager features that integrate with the VMware services in Cloud.
n Ensure that any downloads or API host URLs that are redirected from Market Place are
allowed.
Table 1-2. Required Ports for Integration and Communication with VMware Products On-Premise
VMware, Inc. 12
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Table 1-2. Required Ports for Integration and Communication with VMware Products On-Premise
(continued)
Note For vRealize Suite Lifecycle Manager 8.x and later, ICMP protocol must be enabled
between vRealize Suite Lifecycle Manager and products that are being managed.
Note For more information on ports, see vRealize Suite Lifecycle Manager 8.x Security
Hardening Guide and VMware Ports and Protocol tool.
n VMware vRealize Suite Lifecycle Manager Easy Installer for vRealize Automation and
VMware Identity Manager: This installer helps to install vRealize Suite Lifecycle Manager,
vRealize Automation, and VMware Identity Manager (also known as VMware Workspace ONE
Access). The OVA bundle of this package contains the binaries of vRealize Suite Lifecycle
Manager, vRealize Automation, and VMware Identity Manager.
n VMware vRealize Suite Lifecycle Manager Easy Installer: This installer helps to install only
vRealize Suite Lifecycle Manager. This package contains the OVA bundle of only vRealize
Suite Lifecycle Manager.
You can download the executable file of one of these installers from the My VMware download
page.
VMware, Inc. 13
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
How to run the vRealize Suite Lifecycle Manager Easy Installer for
vRealize Automation and VMware Identity Manager
The vRealize Suite Lifecycle Manager Easy Installer for vRealize Automation and VMware Identity
Manager is downloadable from the My VMware download page.
Procedure
1 Download the vRealize Suite Lifecycle Manager Easy Installer for vRealize Automation and
VMware Identity Manager executable file from the My VMware download page.
4 The folder contains three subfolders for three operating systems. Based on your operating
system, browse to the corresponding operating system folder inside the vrlcm-ui-
installer folder.
Windows lcm-installer\vrlcm-ui-installer\win32
Mac vrlcm-ui-installer/mac/Installer
The vRealize Suite Lifecycle Manager Easy Installer for vRealize Automation and VMware
Identity Manager UI is specific to the operating system. Ensure that you are using the valid UI
folder path to run the installer.
Results
You can now install your applications using the vRealize Suite Lifecycle Manager Easy Installer for
vRealize Automation and VMware Identity Manager.
If the vRealize Suite Lifecycle Manager Easy Installer for vRealize Automation and VMware
Identity Manager fails to launch, and you see this error message "A problem occurred during
installation.Check the installer logs and retry", it is because:
n A host rebooted during installation. Select the Host to return to a healthy state.
n The datastore was 100% full during installation. Clear the datastore memory and retry
launching the Easy Installer.
VMware, Inc. 14
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
n The vRealize Suite Lifecycle Manager Easy Installer for vRealize Automation and VMware
Identity Manager could not connect to the ESXI host. Add target vCenter Server
and all cluster associated ESXI servers DNS FQDN entries to the system host's file:
C:\Windows\System32\drivers\etc\hosts. For Linux and Mac, /etc/hosts.
If you want to customize your VMware Identity Manager configuration, which can include
deployment of VMware Identity Manager in a standard or a cluster mode, customized mode of
Network, storage, you can skip the installation of VMware Identity Manager. If you have skipped,
you are still prompted to configure the VMware Identity Manager on the vRealize Suite Lifecycle
Manager UI. With vRealize Suite Lifecycle Manager Easy Installer for vRealize Automation and
VMware Identity Manager, you either import an existing VMware Identity Manager into vRealize
Suite Lifecycle Manager or a new instance of VMware Identity Manager can be deployed. For
more information on Hardware re-sizing for VMware Identity Manager, see Re-sizing Hardware.
Prerequisites
Verify that you have a static IP address before you begin your configuration.
Procedure
2 Enter the required text boxes under Virtual Machine Name, IP Address, Hostname, and
Default Configuration Admin.
Note The vRealize Suite Lifecycle Manager Easy Installer for vRealize Automation and
VMware Identity Manager creates the Default Configuration Admin user as a local user in
VMware Identity Manager and the same user is used to integrate products with VMware
Identity Manager.
a Enter the Hostname, Admin Password, System Admin Password, SSH User Password,
Root Password, Default Configuration Admin, and Default Configuration Password.
b Select the Sync group members to the Directory when user want to sync group
member while adding a group for the global configuration of VMware Identity Manager.
VMware, Inc. 15
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Note VMware Identity Manager will be supported if the scenarios are one of the following:
n VMware Identity Manager 3.3.2 and 3.3.3 with the given deployment type.
Note VMware Identity Manager will not be supported if the scenarios are one of the
following:
n Single or cluster instance with additional connectors (Windows and external connectors)
other than the embedded ones.
Note If the older version of vRealize Suite Lifecycle Manager does not have VMware Identity
Manager, it can either be installed or imported.VMware Identity Manager Lifecycle and
extended day-2 functionalities are not supported from the vRealize Suite Lifecycle Manager if
the imported VMware Identity Manager not in supported form factor:
Upgrade support from an older VMware Identity Manager version (3.3.0 and earlier) to the
latest is only available if it is a single instance or a node vRealize Identity Manager with
embedded postgres database.
Else you can upgrade outside vRealize Suite Lifecycle Manager. Once upgraded, it can any
time be reimported by triggering Inventory Sync in vRealize Suite Lifecycle Manager .
4 Click Next.
If you cannot deploy vRealize Suite Lifecycle Manager VMware Identity Manager or vRealize
Automation in VMC vCenter Server using vRealize Suite Lifecycle Manager Easy Installer for
vRealize Automation and VMware Identity Manager, then use the vCenter Server that has an
administrator privilege to deploy products.
VMware, Inc. 16
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Lifecycle Manager can be installed and configured using vRealize Suite Lifecycle Manager
Easy Installer for vRealize Automation and VMware Identity Manager. You can refer to the
Installing vRealize Automation using vRealize Suite Lifecycle Manager Easy Installer for vRealize
Automation and VMware Identity Manager.
Prerequisites
n Verify if a vCenter Server is available for deploying Lifecycle Manager and products.
n A static IPv4 with accurate FQDN is used for a Lifecycle Manager deployment.
n To prevent unwanted internal ports outside after vRealize Suite Lifecycle Manager Virtual
appliance reboot, login to vRealize Suite Lifecycle Manager Virtual appliance through SSH and
run the command rm -rf /etc/bootstrap/everyboot.d/10-start-services, after deploying
vRealize Suite Lifecycle Manager Virtual appliance from the easy installer.
Procedure
1 Deploy Lifecycle Manager using vRealize Suite Lifecycle Manager Easy Installer for vRealize
Automation and VMware Identity Manager.
VMware, Inc. 17
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
2 To deploy a new product, after you log in to vRealize Suite Lifecycle Manager, click Lifecycle
Operations on the Dashboard - My Services.
6 Add the required license keys for future use in vRealize Suite Lifecycle Manager Locker.
7 Extend the Lifecycle Manager appliance disk space to accommodate product binaries and
other necessary components to be used in future.
8 (Optional) Configure the proxy settings in Lifecycle Manager for an internal network
connectivity.
Installing vRealize Suite Lifecycle Manager with Easy Installer for vRealize
Automationand VMware Identity Manager
You can install vRealize Suite Lifecycle Manager using vRealize Suite Lifecycle Manager Easy
Installer for vRealize Automation and VMware Identity Manager.
Watch the vRealize Suite Lifecycle Manager Installation with Easy Installer video.
Prerequisites
You must meet these prerequisites before you can install vRealize Suite Lifecycle Manager:
n Ensure you have a vCenter Server set up and access to the credentials.
n Ensure you have the network configuration details for vRealize Automation
Procedure
3 Accept the License Agreement and click Next. Read the Customer Experience Improvement
Program and select the checkbox to join the program.
4 To specify vCenter Server details, enter these details on the Appliance Deployment Target
tab.
5 Click Next and you are prompted with a Certificate Warning, click Accept to proceed.
VMware, Inc. 18
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
b Expand to any data center and map your deployment to a specific VM folder.
a Expand the data center tree to an appropriate resource location and click Next.
8 On the Select a Storage Location tab, select a datastore to store your deployment and click
Next.
9 On the Network Configuration and Password Configuration tabs, set up your Network and
Password configuration by entering the required fields, and clicking Next.
a For a vRealize Suite Lifecycle Manager VM, enter the NTP Server for the appliance and
click Next.
The network configurations provided for all products are a one time entry for your
configuration settings. The password provided is also common for all products and you need
not enter the password again while you are installing the products.
Password should have minimum one upper case, one lower case, one number and one
special character. Special characters can be !@#$%^&*(). Colon(:) is not supported in the
password for vRealize Automation 8.0 and 8.0.1.
b Provide configuration information. Enter the Data Center Name, vCenter Name and
Increase the Disk Space fields.
d Click Next.
What to do next
VMware, Inc. 19
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Note
n Without installing or importing a VMware Identity Manager, you cannot access any other
environment from vRealize Suite Lifecycle Manager.
n If you are installing vRealize Automation, ensure that you deploy VMware Identity Manager
with the recommended size for vRealize Automation.
n Refer to the vRealize Suite Lifecycle Manager Easy Installer for vRealize Automation and
VMware Identity Manager documentation for the software and hardware requirements to
deploy VMware Identity Manager.
Prerequisites
n Verify that you have a static IP address and Active Directory details before you begin your
configuration.
n Verify that an external load balancer is installed with a valid certificate and the requirements
are met. For load-balancing specific information for VMware Identity Manager, see the
VMware Identity Manager Load Balancing documentation.
Procedure
a Enter the required text boxes under Virtual Machine Name, IP Address, Hostname, and
Default Configuration Admin.
a Enter the Hostname, Admin Password, System Admin Password, SSH User Password,
Root Password, Default Configuration Admin, and Default Configuration Admin
Password.
Note This is a local user that you create on the default tenant in VMware Identity
Manager and provide the admin access in the default tenant. The same user is used for all
product integration with VMware Identity Manager and the admin role is assigned in the
corresponding product. For example, when vRealize Automation 8.x is getting registered
with VMware Identity Manager, this default configuration user is made the organization
admin and is given with appropriate roles. Once vRealize Automation 8.x is deployed, the
configuration user is the initial user to log in with. With other products when they are
integrated with VMware Identity Manager, the same user is assigned an admin role in the
product. More of SSO use-case where the default configuration admin has access to all
deployed products.
3 Click Next.
VMware, Inc. 20
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
When you install vRealize Suite products in VMware vRealize Suite Lifecycle Manager, integrate
the desired product with VMware Identity Manager (optional) to create a catalog application in
the VMware Workspace ONE Access. With a single sign-on to VMware Workspace ONE Access,
view the list of catalogs that are created for the vRealize Suite products. You can choose to open
any product from the catalog with the catalog single sign-on feature.
The vRealize Suite products that support the use of catalog applications are vRealize Automation,
vRealize Log Insight, vRealize Network Insight, vRealize Operations Manager, vRealize Business
for Cloud, and vRealize Suite Lifecycle Manager.
Note
n When installing a single node vRealize Automation 8.x, the catalog application directs you to
the vRealize Automation primary host name.
n When installing a clustered vRealize Automation 8.x, the catalog application directs you to
the vRealize Automation Load Balancer host name.
n When scaling out a single node vRealize Automation 8.x to a clustered setup, the catalog
application directs you to the newly added vRealize Automation Load Balancer host name.
VMware, Inc. 21
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
The installer provides you with minimal or a clustered deployment options before you start your
vRealize Automation configuration. Manual installation of vRealize Automation through OVA or
ISO is not supported.
Note The master node is now referred to as the primary node. The master replica node is now
referred to as the primary replica node.
Prerequisites
n Verify that you have the primary vRealize Automation credentials before installing vRealize
Automation. vRealize Automation 8.4 requires an external VMware Identity Manager 3.3.2 or
later.
n Verify that an external load balancer is installed and the requirements are met. For more
information, see vRealize Automation Load Balancing.
Procedure
3 After configuring your VMware Identity Manager settings, you can opt to install vRealize
Automation.
4 For a standard deployment with a primary node, perform the following steps.
a Enter the Virtual Machine Name, IP Address, and FQDN Hostname of vRealize
Automation.
b Provide configuration information. Enter the Data Center Name, vCenter Name and
Increase the Disk Space fields. For more information, refer to the vRealize Suite Lifecycle
Manager Easy Installer for vRealize Automation and VMware Identity Manager.
d Skip to Step 6.
5 For a cluster deployment with three nodes, enter the Load Balancer IP address and
Hostname.
7 For a cluster deployment, create secondary nodes, enter the required text boxes, and
proceed.
8 Under Advanced Configuration for vRealize Automation, you can either choose the Use
Default option to enable the default values for internal pods and services configuration in
CIDR format, or use the Use Custom option to enter the values for K8S Cluster IP Range and
K8S Service IP Range in CIDR format.
9 Click Next.
VMware, Inc. 22
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
10 Read the Summary page with the entered data and click Submit.
After submitting your details, the installer takes about 30 minutes to install the Lifecycle
Manager, copy binaries and then start the installation process. You can enable the multi-
tenancy for vRealize Automation, refer to Tenant Management in vRealize Suite Lifecycle
Manager.
You can migrate vRealize Suite Lifecycle Manager 2.1 to 8.x or later. The migration also requires
inputs, such as legacy vRealize Suite Lifecycle Manager hostname, user name, password, and
SSH password. For more information, watch the Migration of vRealize Suite Lifecycle Manager
with Easy Installer video:
Migration of vRealize Suite Lifecycle Manager with Easy Installer
(http://link.brightcove.com/services/player/bcpid2296383276001?
bctid=ref:video_LCM_migrate)
Prerequisites
n Verify that you have vRealize Suite Lifecycle Manager 2.1 version or later.
n Legacy vRealize Suite Lifecycle Manager must have SSH enabled for the root user.
Procedure
2 Enter the vCenter details where the new vRealize Suite Lifecycle Manager 8.x is installed.
3 Select the data center in the vCenter Server, Compute Resource, and Storage.
5 In the Password configration, enter the password which can be set to the vRealize Suite
Lifecycle Manager root and admin password.
6 If you want to deploy Identity Manager, then enter the password for admin, sshuser, and
root credential.
7 Enter the vRealize Suite Lifecycle Manager 8.x VMname, Hostname, and the IP details.
8 Enter the legacy vRealize Suite Lifecycle Manager Hostname, Username, and Password.
VMware, Inc. 23
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
If you have selected to install New Identity Manager, then it is deployed in the same vCenter
Server mentioned in step 2. If you import an existing Identity manager, verify that the identity
manager is already registered in the vRealize Suite Lifecycle Manager legacy VM and identity
manager SSH is enabled for the root user.
Note A new installation of vRealize Suite Lifecycle Manager 8.x supports only VMware
Identity Manager 3.3.4. The earlier versions of VMware Identity Manager will be supported
only for an existing vRealize Suite Lifecycle Manager instance that is being migrated to
vRealize Suite Lifecycle Manager 8.x and later. Upgrade support from earlier VMware
Identity Manager version to the latest is only available if they conform to the vRealize
Suite Lifecycle Manager supported criteria. Any earlier versions of vRealize Suite Lifecycle
Manager 8.x allows only single instance of VMware Identity Manager to be deployed with
the embedded connector and embedded postgresql database. Upgrade of VMware Identity
Manager withinvRealize Suite Lifecycle Manager 8.x to the latest versions will be supported if
it conforms to the mentioned criteria. Else the upgrade has to be performed outside vRealize
Suite Lifecycle Manager. After you upgrade, it can any time be reimported by triggering
Inventory Sync in vRealize Suite Lifecycle Manager 8.x.
10 Click Submit.
11 When the migration is successful, click the vRealize Suite Lifecycle Manager URL or the
migration request to view the progress by logging in with admin@local with the password
given in step 5.
12 All the environments with data centers, vCenter Servers, Settings (such as NTP, DNS, and so
on), content endpoints that are managed by older Lifecycle Manager are migrated and the
environments are imported to the latest version.
Results
As part of migration, create a global environment based on installation or import when you
import legacy vRealize Suite Lifecycle Manager VMware Identity Manager to vRealize Suite
Lifecycle Manager 8.x. If there is a failure in the global environment, it can be due to the missing
ssh user password in the legacy vRealize Suite Lifecycle Manager. Enter the SSH password
details by selecting the correct password on retry and submit the changes to create a global
environment. Once a global environment is created, you can resume the migration operation.
With migration you can create environments, settings, certificate and so on. You can check the
status of migration on the Request status.
Note If you import an existing VMware Identity Manager and if the admin password is different
from the SSH user for the VMware Identity Manager, then the global environment request fails.
In this case, add the SSH password in the locker app manually and retry the request with this
password.
VMware, Inc. 24
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Procedure
1 Download the vRealize Suite Lifecycle Manager Easy Installer executable file from the My
VMware download page.
4 The folder contains three subfolders for three operating systems. Based on your operating
system, browse to the corresponding operating system folder inside the vrlcm-ui-
installer folder.
Windows lcm-installer\vrlcm-ui-installer\win32
Mac vrlcm-ui-installer/mac/Installer
6 The vRealize Suite Lifecycle Manager Easy Installer UI is specific to the operating system.
Ensure that you are using the valid UI folder path to run the installer.
Results
You can now install vRealize Suite Lifecycle Manager using the vRealize Suite Lifecycle Manager
Easy Installer.
Prerequisites
n Ensure you have a vCenter Server set up and access to the credentials.
VMware, Inc. 25
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Procedure
1 Click Install on the vRealize Suite Lifecycle Manager Easy Installer window.
3 Accept the End User License Agreement and click Next. Read the Customer Experience
Improvement Program and select the checkbox to join the program.
4 To specify vCenter Server details, enter these details on the Appliance Deployment Target
tab.
5 Click Next and you are prompted with a Certificate Warning, click Accept to proceed.
b Expand to any data center and map your deployment to a specific VM folder.
a Expand the data center tree to an appropriate resource location and click Next.
8 On the Select a Storage Location tab, select a datastore to store your deployment and click
Next.
9 On the Network Configuration and Password Configuration tabs, set up your Network and
Password configuration by entering the required fields, and clicking Next.
a For a vRealize Suite Lifecycle Manager VM, enter the NTP Server for the appliance and
click Next.
The network configurations provided for all products are a one-time entry for your
configuration settings. The password provided is also common for all products and you
need not enter the password again while you are installing the products.
Password should have minimum one upper case, one lower case, one number and one
special character. Special characters can be !@#$%^&*(), and colon(:) is not supported in
the password.
b Provide configuration information. Enter the Data Center Name, vCenter Name and
Increase the Disk Space fields.
d Click Next.
VMware, Inc. 26
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Prerequisites
n Verify that you have vRealize Suite Lifecycle Manager 2.1 version or later.
n Legacy vRealize Suite Lifecycle Manager must have SSH enabled for the root user.
Procedure
1 From the vRealize Suite Lifecycle Manager Easy Installer, click Migrate.
2 Enter the vCenter details where the new vRealize Suite Lifecycle Manager 8.4 is installed.
3 Select the data center in the vCenter Server, Compute Resource, and Storage.
5 In the Password configuration, enter the password which can be set to the vRealize Suite
Lifecycle Manager root and admin password.
6 Enter the vRealize Suite Lifecycle Manager VMname, Hostname, and the IP details.
7 Enter the legacy vRealize Suite Lifecycle Manager Hostname, Username, and Password.
8 Click Submit.
9 When the migration is successful, click the vRealize Suite Lifecycle Manager URL or the
migration request to view the progress by logging in with admin@local with the password
given in step 5.
10 All the environments with data centers, vCenter Servers, Settings (such as NTP, DNS, and so
on), content endpoints that are managed by older Lifecycle Manager are migrated and the
environments are imported to the latest version.
Note During migration, installing or importing VMware Identity Manager is optional. Select
Skip VMware Identity Manager install and import where the VMware Identity Manager
integrated with Legacy vRLCM would not be imported toggle bar to enable this option.
Prerequisites
VMware, Inc. 27
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Procedure
1 Use a supported Web browser (Chrome, IE or Mozilla FireFox) to connect to your vRealize
Suite Lifecycle Manager appliance by using the appliance's IP address or host name.
https://IP address/vrlcm
Note You can also access vRealize Suite Lifecycle Manager using the URL https://IP address.
The URL http://IP address does not successfully redirect to vRealize Suite Lifecycle Manager.
admin@local
Admin password will be the default password given in the Easy installer while deploying
vRealize Suite Lifecycle Manager.
What to do next
If you are logging in to vRealize Suite Lifecycle Manager for the first time, set the vRealize Suite
Lifecycle Manager root password. If you want to reset the password, go to Settings tab to make
the change.
Configure a new administrator password and other vRealize Suite Lifecycle Manager settings,
such as SSH settings.
Lifecycle Operations
Use this application on the dashboard to access the vRealize Suite Lifecycle Manager to
manage the Day 0 to Day N operations of the vRealize Suite Products, including vRealize
Network Insight.
Locker
Use this application to manage certificates, licenses, and passwords. You can create and
import certificate including CSR. You can also validate the certificates before applying or
replacing the certificates.
You can manage active directories and tenants, and assign roles to users or groups.
Content Management
VMware, Inc. 28
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
You can use this application to access the content lifecycle in vRealize Suite Lifecycle
Manager to manage software-defined data center (SDDC) content, including capturing,
testing, and release to various environments, and source control capabilities through GitLab
or bit bucket integration. You can capture multiple contents from a source control and check
in those contents to another source-control or a different branch.
Marketplace
Use the vRealize Suite Lifecycle Manager to add and manage content from Marketplace.
vRealize Cloud
You can use this application to manage your Cloud subscriptions and Cloud proxies.
The following types of notifications are available in vRealize Suite Lifecycle Manager:
n License Health
n Certificate Health
n Product Upgrade
n Product Patch
n VCF notifications
To view the notifications, navigate to Home Page and click Bell icon. To list all the notifications,
click on the View List icon on the right corner of the Notification window.
Note vRealize Suite Lifecycle Manager should be connected to internet to get notifications from
online source.
VMware, Inc. 29
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Procedure
4 Enter the SMTP Hostname/IP Address, and then select Encryption from the list.
6 If you select the Requires Authentication toggle, you must provide the authentication details.
Select the plus (+) sign or the key symbol to add the password details.
8 Click Save.
9 After a successful SMTP configuration, click SEND TEST EMAIL to validate if the configured
SMTP server is correct. Enter your email ID to start receiving email notifications.
What to do next
Procedure
1 To create an Incoming Webhook on Teams, go to the channel where you want to add the
webhook and select the More Options ellipsis (...).
4 Select Configure, and provide a name. You can also upload an image for the webhook, if
required.
5 A unique URL is generated that maps to the channel. Copy and save the webhook URL, and
then click Done.
6 To create an Incoming Webook on Slack, create your Slack app, and then select the
Incoming Webhooks feature.
VMware, Inc. 30
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Prerequisites
n Ensure that SMTP server is configured prior to configuring email outbound notifications.
Procedure
4 Enter the Webhooks URL that you created for the Slack and Teams channels, and then enter
the recipient's email IDs.
6 Click Save.
VMware, Inc. 31
Configuring vRealize Suite
Lifecycle Manager 2
After you install vRealize Suite Lifecycle Manager, you can perform certain post-installation
tasks, such as configuring your settings, licenses, and passwords in the vRealize Suite Lifecycle
Manager UI.
The first time you view the settings page, you must provide data for all available settings to save
any settings. Only a user admin has access to the System Admin Applications. The settings page
contains the following applications.
Logs SNMP
VMware, Inc. 32
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Change Password
Proxy
Change Certificate
Authentication Provider
Outbound Notifications
Note The UI session inactivity timeout value is now configurable. If you are inactive for a certain
period, you can select the time out in minutes before getting logged out of the session.
VMware, Inc. 33
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
The Authentication Provider Information section displays the type of the existing authentication
provider, the authentication provider endpoint, the registered FQDN of the application, client ID,
and the name of the catalog application.
The Authentication Provider Action section offers syncing and re-registering capabilities. When
you change or update the host name or FQDN of vRealize Suite Lifecycle Manager, the
authentication provider must sync with the host name. The Sync button ensures that the current
host name or FQDN of vRealize Suite Lifecycle Manager is synced with VMware Identity Manager.
After syncing, you can verify the target URL and the redirect URI in the Catalog tab of VMware
Identity Manager.
The RE-REGISTER button allows re-registering of vRealize Suite Lifecycle Manager with VMware
Identity Manager by creating new OAuth clients and catalog applications. The re-registering
occurs when VMware Identity Manager is present in globalenvironment of vRealize Suite
Lifecycle Manager.
When upgrading vRealize Suite Lifecycle Manager 8.1 and earlier releases, the catalog application
ID for updating the existing catalog application is not saved, so a duplicate catalog application is
created. The new hostname and catalog application ID is saved in the inventory which is used for
the subsequent operations.
Procedure
1 In the My Services dashboard, click Lifecycle Operations, and then click Settings.
2 To extend the disk space for vRealize Suite Lifecycle Manager, navigate to System Details,
click Extend Storage.
a Enter the vCenter Host Name, User Name, and Password for the first time.
a To schedule a weekly server restart, toggle the Schedule a restart and select the day of
the week, and time for the weekly restart.
4 Click Save.
VMware, Inc. 34
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
As a best practice, disable SSH in a production environment, and activate it only to troubleshoot
problems that you cannot resolve by other means. Leave it enabled only while needed for
a specific purpose and in accordance with your organization's security policies. If content
management is enabled, then SSH is enabled automatically and it cannot be disabled. Force
disablement of SSH causes failure of Content Lifecycle Management functionality.
Procedure
1 From the vRealize Suite Lifecycle Manager dashboard, click Lifecycle Operations and click
Settings.
2 Click System Details, under Network Information, enter the Host Name, IP Address, IP
Address Type, Netmask and Gateway fields.
4 Click SAVE.
In the vRealize Suite Lifecycle Manager user interface, perform the following steps.
1 Select Lifecycle Operations, and then select Settings, and navigate to System
Administration > Logs.
2 To create a vRealize Suite Lifecycle Manager log bundle, click GENERATE LOG BUNDLE.
1 Connect Secure Shell (SSH) to vRealize Suite Lifecycle Manager VA using root credentials.
2 Create a vRealize Suite Lifecycle Manager log bundle directory using the command mkdir
-p /data/lcm-logbundle.
3 Generate a vRealize Suite Lifecycle Manager log bundle directory using the
command /var/lib/vlcm-common/vlcm-support -w /data/lcm-logbundle.
VMware, Inc. 35
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Prerequisites
Verify that you already have the vRealize Log Insight server details before you set the properties
of the Log Insight agent.
VMware, Inc. 36
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Procedure
a Open a Web browser and go to https://vRSLCMIP/vrlcm and log in with your user
credentials.
b Click to Lifecycle Operations and from the Home page, click Settings > Logs > Logs
Insight Agent Configuration.
c Update the following parameters in the vRealize Suite Lifecycle Manager UI section and
save your changes.
[server]
hostname= vRealize Log Insight hostname proto=cfapi port=9000 SSL=no
When vRealize Log Insight Server is not configured to accept an SSL connection, enabling
SSL for Log Insight Agents in vRealize Suite Lifecycle Manager is optional.
Or
When vRealize Log Insight Server is configured to accept an SSL connection, Log Insight
Agents must be configured to use the SSL connection in vRealize Suite Lifecycle Manager.
Or
Set the rules for how the Log Insight client handles the validation of the Log Insight server
certificate. Certificates received by the Log Insight agent are stored locally on the agent
host machine.
Accept Any
Accept Any Trusted
Common Name: (Self-signed server certificate is accepted if its Common Name matches
this value)
Certificates acceptance rules:
VMware, Inc. 37
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Note Log Insight agents that receive a new self-signed certificate with the same public
key as the existing locally stored self-signed certificate will accept the new certificate. For
instance, a self-signed certificate may be regenerated with an existing private key but
with a new expiration date.
If the Agent has a locally stored self-signed certificate and receives a valid CA-signed
certificate, the Agent silently accepts the CA-signed certificate.
Agents that have a CA-signed certificate will reject self-signed certificates. The agent
accepts self-signed certificates only when it initially connects to the Log Insight server.
If an agent with a locally stored CA-signed certificate receives a valid certificate signed by
another trusted CA, it is rejected by default. You can select Accept Any Trusted to accept
the certificate.
Reconnection Time: 30 min (Time in minutes to force reconnection to the server. This
option mitigates the imbalances caused by long-lived TCP connections).
Max Buffer Size: 200 (Max local storage usage limit(data+logs) in MBs. Valid range:
100-2000 MB. Default: 200 MB).
b Log in with the credentials - User name as admin and Password as vrli_admin_password.
Note The content pack is not pre-installed in vRealize Log Insight. You must install the
pack by downloading it from the marketplace and then configure the agents.
e From the drop-down menu on the top, select vRealize Lifecycle Management 8.0.1 from
the Available Templates section.
g After copying the template provide vRealize Suite Lifecycle Manager Ipv4 or FQDN, and
save the configuration.
h Once the configuration is complete, the vRealize Suite Lifecycle Manager events or logs
start to flow into vRealize Log Insight and the relevant widgets displays the data.
1 To change the time settings, navigate to My services dashboard, click Lifecycle Operations
and click Settings.
VMware, Inc. 38
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
3 For Applicable Time Sync Mode, select Use Time Server (NTP) or Use Host Time.
a To add a server, click Add New Server and enter the name, and FQDN address of the
server.
b To edit, click the edit icon on the list of NTP servers. You cannot edit the FQDN/ IP
Address, you can only edit the name of the NTP server.
For more information on adding NTP server, see Configure NTP Servers.
FIPS Compliance is a new and secured opt-in mode adhering to the Enterprise Readiness
Initiatives (ERI) in VMware vRealize Suite Lifecycle Manager. To learn more about support for
FIPS 140-2 in VMware products, see FIPS Security Policies and Certifications.
Procedure
1 From My Service dashboard, select Lifecycle Operations, and then select the Settings page.
3 Enable or disable the FIPS Mode Compliance check box, as required. Click Update. vRealize
Suite Lifecycle Manager restarts when you enable or disable FIPS Mode Compliance.
Note When you enable FIPS Mode Compliance, vRealize Suite Lifecycle Manager does not
upgrade to the next version. You must disable the FIPS Mode Compliance, and upgrade
vRealize Suite Lifecycle Manager, and then re-enable FIPS Mode Compliance.
Prerequisites
VMware, Inc. 39
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Procedure
1 On the Lifecycle Operations dashboard and navigate to Settings > NTP Servers.
4 Click ADD.
Note Starting with vRealize Suite Lifecycle Manager 8.2, NTP servers can be set for vRealize
Automation 8.2 and later.
Prerequisites
Verify that the SSH service on the vRealize Suite Lifecycle Manager appliance is enabled.
Procedure
1 Log in to vRealize Suite Lifecycle Manager by using the Secure Shell (SSH) client.
b Log in using following credentials, with Setting as value, User Name as root and
Password as root_password for the user.
b Remove the comment for the NTP configuration, add the NTP settings, and save the
changes. For example, NTP=ntp.sfo01.rainpole.local ntp.lax01.rainpole.local
a Run the timedatectl set-ntp true command to enable the network time
synchronization.
VMware, Inc. 40
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Prerequisites
Procedure
5 Click Add.
You can record SNMP configurations, that are relevant to vRealize Network Insight. Click Add
Configuration to add SNMP for both 2c and 3 SNMP type. The configured SNMP is then used
while you are adding vRealize Network Insight data source for Routers and Switches.
Note From vRealize Network Insight 4.0 and later, a new brick size is introduced in vRealize
Suite Lifecycle Manager, extra large for both platform and collector node. When you have three
nodes in a clustered environment, the brick size should be extra large. All platform nodes in a
clustered environment should be of same brick size either large or extra large. But you cannot
have both large and extra large in the same cluster.
If a clustered environment is deployed with large brick size and if you want to add one more
platform nodes, then you have to manually increase the CPU and the RAM size from vCenter
server. You can then import the environment and scale out with an extra large brick size.
Procedure
a If you have selected v3, enter the Username and Context Name.
b When you select the Authentication type, you are then prompted to enter to the Auth
Password and Privacy Type.
4 Click Add.
VMware, Inc. 41
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Prerequisites
n A X509 PEM base-64 encoded certificate and private key. Make sure the private key is not
encrypted.
n A machine with an SSH access to vRealize Suite Lifecycle Manager, and software such as
PuTTY and an SCP software such as WinSCP installed on it.
Procedure
2 Open a Secure Shell connection vRealize Suite Lifecycle Manager appliance as root user.
3 Copy the certificate files server.crt and server.key to the /opt/vmware/vlcm/cert folder.
You can use an SCP software like WinSCP on Windows. Make sure to backup the original files
before copying.
4 After copying the certificates, restart the vRealize Suite Lifecycle Manager proxy services to
update the appliance certificate.
a Restart the system services by executing the following command in the SSH session:
systemctl restart nginx.
b Check the status of the system services by executing the following command in the SSH
session: systemctl status nginx.
5 After restarting the services, verify that the certificate is updated on the appliance, open a
browser and go to https://<lcm-server-host>.
You can download binaries outside of Lifecycle Manager and make them available on the NFS
path.
Prerequisites
To use a Product Binary downloaded from My VMware, verify that you have registered with My
VMware and registered My VMware services with vRealize Suite Lifecycle Manager. See Register
with My VMware.
VMware, Inc. 42
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Procedure
n Local - You can map the binaries to the vRealize Suite Lifecycle Manager locally
downloaded copy.
n NFS - You can map to a downloaded product binary with products dependent on the
product binary location.
n My VMware Downloads - You can map to product binary downloaded from My VMware.
n Windows ISO - You can map ISO binary which is required for Windows deployment from
Lifecycle Manager.
Note The automatic product OVA mappings are mapped based on the check sum of the
binary files. When you select all the OVA files in the NFS share and try to map the product
binaries, then it takes long time to map and the data disk might fill faster. NFS represents the
local where the OVA files are copied in the NFS shared drive, user should provide the NFS
location in the format, NFS-IP:<nfs hostname/ip>:<folder path>/x/y/z. For example,
10.11.12.134:/path/to/folder.
5 Enter the location of the Product Binary to use in the Base Location text box, and click
Discover.
6 To provide Windows ISO, select the location type as Windows ISO and enter the Windows
ISO Mapping Details.
7 Select the Product Binary file from the Product Binary list.
Note By default, all the My VMware downloads from vRealize Suite are automatically
mapped with no user intervention. If you have already downloaded the product binaries
using vRealize Suite My VMware integration but the mapping does not exist in the list under
Product Binary then you can select My VMware Downloads option under Add Product
Binaries window. To manually copy the OVA files from the vRealize Suite virtual appliance,
you can select Local option from the Add Product Binaries window and provide the location
that is residing within vRealize Suite appliance itself. For either of the scenarios, when you
click Discover, the relevant binaries is listed in the table within the window.
8 Click Add.
VMware, Inc. 43
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
9 With vRealize Suite Lifecycle Manager 2.0 and later, you can also view the list of Patches
available for Products.
Note You can now delete the unsupported product binaries which are not in use. To delete
the binaries, click Delete Unsupported Binaries, select the binaries, and then click Delete All.
You can perform following actions using patches from the notifications icon:
Note Starting with vRealize Suite Lifecycle Manager 8.2, if you select vRealize Automation 8.x for
patching, a precheck option is available for validation.
Procedure
3 To map a patch offline, download the patch from My VMware portal and place it in the data
folder in vRealize Suite Lifecycle Manager appliance, and then map the offline patch using the
local folder option in vRealize Suite Lifecycle Manager UI.
4 To check if there are patches available on the internet, click CHECK PATCHES ONLINE.
5 Trigger the patch install from the product card in the environment page.
The patches must be downloaded from the Product Binaries page. Only the downloaded
patches are listed here.
7 Click Next.
VMware, Inc. 44
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
The vRealize Log Insight product patch history has no content even when the vRealize Log
Insight patches are applied successfully. This is caused due to the minor version of vRealize
Log Insight after the patch is installed. For example, if patch 1 is applied for vRealize Log
Insight 4.6.0, then the vRealize Log Insight version is changed to vRealize Log Insight 4.6.1,
and the product card is updated to 4.6.1 and no patch history is visible. Installing patch on
vRealize Suite Lifecycle Manager is only supported from the following versions of products.
Prerequisites
Ensure the OVA bundle corresponding to the patched product is downloaded from My VMware
Portal to vRealize Suite Lifecycle Manager appliance and is placed in the data folder. For
example: /data/patchovabundles/. For more information on downloading the OVA bundles,
click My VMware portal. You can also see the detailed procedure for vRealize Automation at KB
79105.
Procedure
You are directed to My VMware page where you can download the required patch or a OVA
bundle.
Source location is the directory path in the vRealize Suite Lifecycle Manager appliance
where the OVA bundle files are retrieved.
b Select the required OVA bundle from the list and click ADD.
VMware, Inc. 45
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
5 To delete a product patch, click the Delete icon on the selected patch.
Enter your My VMware user name and password to enable vRealize Suite Lifecycle Manager to
download product Binary through My VMware. You can also enter using the proxy server under
My VMware Settings. Configuring My VMware Settings is optional if you do not have internet
connectivity.
Prerequisites
Verify the account details being entered has the following entitlements.
n vRealize Suite 2017 or later or vCloud Suite 2017 or later entitlement with download and view
license permissions to download vRealize Suite products.
n vRealize Network Insight or NSX Data Center Enterprise Plus entitlement with download and
view license permissions to download vRealize Network Insight.
The configured My VMware user must have permissions to download and view licenses.
Download the support pack from the VMware Solution Marketplace.
Procedure
3 Enter your My VMware user name and password, and click Submit.
Note To download Product Binary, click the download arrow under Actions for the Product
Binary to download. If your network requires proxy settings to access external Websites, you
can provide those details in the Configure Proxy section. For more information on configuring
proxy settings, see Configure Your Proxy Settings.
Normal Proxy (with or without Credential) and Proxy with AD configuration, are supported by
vRealize Suite Lifecycle Manager.
VMware, Inc. 46
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Prerequisites
You must have installed and configured a proxy server in your network before using it in vRealize
Suite Lifecycle Manager and the proxy server IP should have a host name that is resolvable from
vRealize Suite Lifecycle Manager appliance console.
Note
n If you are unable to configure proxy in vRealize Suite Lifecycle Manager, ensure that ICMP is
allowed from vRealize Suite Lifecycle Manager to the Proxy host and that there are forward
and reverse DNS entries for the Proxy host.
n If the proxy server does not have a resolvable host name, then the procedure to add proxy
fails.
Procedure
2 Click Proxy.
3 Toggle Configure Proxy to use a proxy server for vRealize Suite Lifecycle Manager, or
deselect it to remove an existing proxy server.
vRealize Suite Lifecycle Manager does not save proxy server settings when you disable
proxy.
4 If you are enabling proxy, enter the Server, Port, User name, and Credential.
5 Click Save.
If vRealize Suite Lifecycle Manager is already configured to use a proxy server, those proxy
details are displayed.
Prerequisites
n Certificates that are about to expire in less than 15 days cannot be imported.
n To manage the certificate for an imported environment, add the certificate in the vRealize
Suite Lifecycle Manager and perform inventory sync so that the certificate is mapped to the
imported environment, after which replace certificate and scale-out wizards will be aware of
the existing certificate.
Procedure
VMware, Inc. 47
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Option Description
Note Generate CSR downloads a PEM file. This file can be taken to the
certificate authority for signing and can be made as a trusted certificate. The
pem file downloaded will have the private key and certificate request chain.
You must be cautious and share only the CSR part of the pem file but not
the key for the certificate signing.
3 Click Generate.
4 You can click the certificate from the inventory to view the details and its associated
environments with their products.
5 To download or replace the certificate, click the vertical ellipses on the certificate.
Results
vRealize Suite Lifecycle Manager generates a new certificate for the specific domain provided by
the user.
VMware, Inc. 48
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Prerequisites
Procedure
Starting with vRealize Suite Lifecycle Manager 8.4.0, vRealize Cloud licenses can be added
directly into the vRealize Suite Lifecycle Manager locker from the user interface.
7 To update an existing license, click any license from the license table.
a If the Lifecycle Manager is having one or more My VMware accounts configured, then the
corresponding license keys are automatically synced. To sync licenses from My VMware
account, click REFRESH. However, if you have manually added the same license key to
the locker then the corresponding entry from My VMware account cannot be captured.
b When any product is imported into vRealize Suite Lifecycle Manager, the license keys
present in the product is also captured and stored in the Locker under Licenses. If the
same license key is already present, then it cannot be imported.
c If any product is associated to a license in vRealize Suite Lifecycle Manager then the
license entry cannot be deleted from the locker.
d vRealize Suite Lifecycle Manager does not restrict applying multiple licenses to any
product, however, the product behavior does allow to set only one license key as active
at anytime.
e License deletion from vRealize Suite Lifecycle Manager locker does not remove the
license key from the product itself.
VMware, Inc. 49
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
9 License keys can be applied to products managed by vRealize Suite Lifecycle Manager
from Home > Environments under Lifecycle Operations. Select a product from any Lifecycle
Operations managed environment, click the horizontal ellipses on the product name and
select Add License, and follow the steps.
Procedure
5 To confirm, re-enter the Password and enter Password Description, and a valid User Name.
Note The user name text box is mandatory for adding the vCenter server into vRealize Suite
Lifecycle Manager.
6 Click Add.
You can add a new password on the Passwords page under Locker. Click Add and enter the alias
and password details to add a new password.
For the existing passwords on the Passwords page, click the ellipsis (...), and then select one of
the following options:
Functionality Description
View Password You can view the selected password in plain text if you are
an Admin user, after you authenticate the vRealize Suite
Lifecycle Manager SSH root password. The view password
is not available for the VMware Identity Manager users.
VMware, Inc. 50
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Functionality Description
Edit Password You can edit a password that does not have a reference to
an existing password. For example, if you use a password
in an environment, such as vCenter server or MyVMware,
the edit password option for that password is disabled.
Delete Password You can delete a password that is no longer used and
does not have any references. For example, if you use a
password in an environment, such as vCenter server or
MyVMware, the delete password option for that password
is disabled.
If you select an existing password, you can view the password details and the references
for the selected password. The Details tab displays the password identifier, username,
password description, password creation and last updated dates for the selected password. The
References tab displays the references for environments at the product and node level, vCenter
passwords in data centers, and other passwords that are used in the Settings tab.
You can also update a password for products, nodes, MyVMware, proxy, and vCenter servers. To
update the password, click the vertical ellipses (⋮) for the selected password.
Note
n When you update a password that is managed by vRealize Suite Lifecycle Manager, such
as products, nodes, or root user, the password is updated on the Passwords page and the
vRealize Suite Lifecycle Manager inventory.
n When you update a password for vCenter, MyVMware, proxy, or VMware Identity Manager
configuration administrators, the password is updated only in the vRealize Suite Lifecycle
Manager inventory.
Procedure
1 On the left pane, click Data Centers and click Manage Data Centers.
You can see all the data centers with its products that are associated with them. You can also
click the product icons that directs you to the view details page of that particular product.
3 Enter the Data Center Name and provide a Location even if the location is not available in the
drop-down menu.
4 Click ADD.
VMware, Inc. 51
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
What to do next
Add a vCenter to the data center. See Add a vCenter to a Data Center.
Prerequisites
Verify that you have administrative privileges to add a role to a user or a user group. You must
have administrative privileges to use vCenter Server.
If you are using vCenter deployed on VMC SDDC, then you must use the available CloudAdmin
role. For more information on VMC on vCenter, refer to the VMware Cloud on AWS
documentation. When you deploy a VMC on vCenter, you can use the default CloudAdmin
role. To learn more about cloud administrator privileges, refer to CloudAdmin Privileges
documentation.
Procedure
3 Create a role for all system interactions between vRealize Suite Lifecycle Manager and
vCenter Server.
VMware, Inc. 52
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
5 In the Create Role dialog box, configure the role using the following configuration settings,
and click Next.
Setting Value
Privilege n Datastore
n You can select All privileges.
n Host.Local
n Operations- Add Host to vCenter
n Operations - Create Virtual Machine
n Operations - Delete Virtual Machine
n Operations - Reconfigure Virtual Machine
n Inventory - Modify - Cluster
n Network
n Assign Network
n Resource
n Assign vApp to Resource Pool
n Assign Virtual Machine to Resource Pool
n vApp
n You can select All privileges.
n Virtual Machines
n You can select All privileges.
n Content Library
n You can select All privileges.
This role inherits the System Anonymous, System View, and System Read privileges.
Note You should have permissions to create a content library. Content library uses a
datastore to store all templates, so you require permission to access, read, and write on
the same datastore. Therefore, all privileges under datastore and content library are needed.
9 Select the user and role that you have created, and click OK.
Prerequisites
Ensure that you have the vCenter Server fully qualified domain name, user name, and password.
Procedure
VMware, Inc. 53
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
a You can either search for an existing vCenter credentials or add new credentials using the
+ sign .
b Click the + sign on the right corner to assign a password for the selected vCenter
credential.
n Management: All VMware SDDC Suite products are managed by this vCenter type.
n Workload: All the payload or business related VMs are managed by this vCenter type.
n Consolidated Management and Workload: Is a vCenter type, where both VMware SDDC
Suite products and payload VMs are managed together.
vCenter Type selection is currently used only for classification; the setting has no associated
product functionality.
a Select the .CSV file and click Import. You can upload only one file at a time for a bulk
import of VCs in a selected datacenter.
b Click Submit.
What to do next
Go to the Requests page to see the status of this request. When the status is Completed,
you can use this vCenter Server to create environments. For more information on vCenter user
privileges, see Assign a User Role in vCenter Server
Remove vCenter Server from vRealize Suite Lifecycle Manager Data Center
You can delete a vCenter server from vRealize Suite Lifecycle Manager Data Center that is not
used by the environment.
Prerequisites
Ensure that the vCenter does not have a reference, such as a fully qualified domain name or
a user name associated with an environment. If vCenter is associated with an environment, the
delete option is disabled for the vCenter.
VMware, Inc. 54
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Procedure
1 On the Data Center page, select the vCenter, and click Delete vCenter.
You can install vRealize Suite Lifecycle Manager on a VMC environment using Easy Installer.
For more information, refer to the Easy Installer documentation. Configure a virtual machine
on the vCenter of a VMC software-defined data center (SDDC) to launch the Easy Installer.
To create cloud SDDC using VMC on AWS and to connect SDDC to the data center of your
product, refer to the Getting Started with VMware Cloud on AWS documentation. After you
have successfully deployed vRealize Suite Lifecycle Manager on VMC, you can also install other
VMware vRealize Suite products, such as VMware Identity Manager and vRealize Automation on
the VMC environment to perform the Day 2 operations.
On a VMC environment, you must add the SDDC vCenter as an endpoint only. Adding any
vCenter external to the SDDC is not recommended. When you deploy a VMC vCenter, ensure
that you have cloud administrator privileges. To learn more about cloud administrator privileges,
refer to CloudAdmin Privileges documentation.
With this accessbility, you can also allow non-admin users to perform actions like replace the
certificate.
Prerequisites
n Verify that there are users or group of users available and such users should not have any
prior roles mapped.
Procedure
VMware, Inc. 55
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
If a user already has a role mapped from the selected user, then select another user.
4 Click Next.
6 Click Submit.
7 Log out from vRealize Suite Lifecycle Manager and log in as VMware Identity Manager user to
access the services as an assigned admin.
Prerequisites
Verify that you have an existing vRealize Suite Lifecycle Manager certificate available.
Procedure
You can view the certificate details that are used by the vRealize Suite Lifecycle Manager.
c Click Run Precheck to validate your certificate details and click Finish.
4 After you click Finish, you can view the progress of the certificate changing on the Request
Details page.
Deployment of an identity manager through vRealize Suite Lifecycle Manager is either through
a single node or a cluster with an Internal PostgreSQL database embedded in the appliance
and does not support an external database like Microsoft SQL. vRealize Suite Lifecycle Manager
supports scale-out of the VMware Identity Manager. For more information, see Scale-Out
VMware Identity Manager .
VMware, Inc. 56
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
After you deploy a global environment successfully, under Identity and Tenant Management
Service you can view.
n Directory Management
n User Management
n Tenant Management
n Content Developer
n Certificate Administrator
Even though the vRealize Suite Lifecycle Manager Cloud Admin has access to the Lifecycle
Operations service, only a few services in Settings tab like NTP Server Setting, SNMP, DNS,
My VMware, and Binary Mapping are accessed. Only LCM Admin, the admin@local has the
privilege to access all the settings in the Lifecycle Operations service. The default admin@local
user is the only application admin who can access the User Management service, where
Directory Management and Identity Management are handled.
Note With migration from earlier versions of vRealize Suite Lifecycle Manager to the current
vRealize Suite Lifecycle Manager version, the LCM Admin and LCM Cloud Admin roles are
converged into LCM Cloud Admin. All users who were part of LCM Admin in the previous versions
of vRealize Suite Lifecycle Manager would now become LCM Cloud Admin in vRealize Suite
Lifecycle Manager.
Adding VMware Identity Manager is an optional step and by configuring VMware Identity
Manager with single sign-on across vRealize Suite Lifecycle Manager and products can be
achieved.
Note When VMware Identity Manager is used with vRealize Suite Lifecycle Manager, only Active
Directory over LDAP and Active Directory with IWA are used to sync users and groups to the
VMware Identity Manager service. Active Directory over LDAP and Active Directory with IWA are
the only supported directory integration.
VMware, Inc. 57
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
n Directories - You can create and manage Active Directories on vRealize Suite Lifecycle
Manager. You can create one or more directories and sync them with their enterprise
directories. With view directory, you can check sync logs and sync alerts apart from showing
basic directory metadata. The directory edit allows an update for the mapped attributes,
user, and group DNs. You can delete a directory configuration from vRealize Suite Lifecycle
Manager.
n User Attribute Definitions - The user attributes lists the default user attributes that sync
in the directory and you can add other attributes that you can map to Active Directory
attributes.
Note Directory Management is managed by the default vRealize Suite Lifecycle Manager admin
user - admin@local. Directory Management will be available in vRealize Suite Lifecycle Manager
8.0 only if the VMware Identity Manager version available in the global environment is higher than
or equal 3.3.0.
Supported Directories
n Active Directory over LDAP - If you plan to connect to a single Active Directory domain
environment, create this directory type
n Active Directory, Integrated Windows Authentication - Create this directory type if you plan
to connect to a multi-domain or multi-forest Active Directory environment.
n Secure LDAP
Note For a FIPS-enabled VMware Identity Manager version 3.3.5, the bind password must be
of fourteen characters.
n Create a directory of the same type as your enterprise directory and specify the connection
details.
n Map the VMware Identity Manager attributes to attributes used in your Active Directory or
LDAP directory.
After you integrate your enterprise directory and perform the initial sync, you can update the
configuration and resync at any time.
VMware, Inc. 58
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Changing the default attributes from a required to non-required and marking an attribute to be
required can be done only if there are no directories created. Once the directories are created
and synced, they cannot be changed. You can mark the required and non-required attributes
before adding any directory in the directories page. When you add new custom attributes
after the directories are created, to map them you have to edit the directory and update the
directory attribute mapping. The change will be effective when the directory gets synced to
Active Directory next time.
Prerequisites
Verify if you have any of the user groups for vRealize Suite Lifecycle Manager.
Procedure
4 To select a user from the populated list in the table, enter an existing user or a group and
click Next.
If a user or a group already has a mapping, then a warning appears and you are then asked
to edit the role mapping rather create again.
5 Select a role for the newly created user and click Next.
VMware, Inc. 59
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Prerequisites
n List the Active Directory groups and users to sync from Active Directory.
n Verify that you have specified the required default attributes and add additional attributes on
the User Attributes definition.
n Verify that you have the required user credentials to add a directory.
Procedure
3 Click Add Directory, and select Add Active Directory Over LDAP.
Fields Description
Directory Sync and Authentication Select the connector to sync with Active Directory. Connector is a VMware
Identity Manager service component that synchronizes users and group
data between Active Directory and VMware Identity Manager service.
When used as an identity provider, it also authenticates users. Each VMware
Identity Manager appliance node contains a default connector component.
When required a dedicated connector can also be deployed through a
global environment scale-out.
Authentication Enabled If you want the connector to perform authentication, select Yes.
You can indicate whether the selected connector also performs
authentication. If you are using a third-party identity provider to
authenticate users, click No.
Directory Search Attribute Select an account attribute from the drop-down menu that contains a user
name.
VMware, Inc. 60
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Fields Description
Server Location Select Directory supports DNS Service Location check box.
n If your Active Directory requires access over SSL/TLS, select the
Directory requires all connections to use STARTTLS or SSL check box
in the Certificates section, and copy and paste the domain controllers
intermediate (if used) and Root CA certificates into the SSL Certificate
text box. Enter the intermediate CA certificate first, then the Root
CA certificate. Ensure that each certificate is in the PEM format and
includes the BEGIN CERTIFICATE and END CERTIFICATE lines. If the
domain controllers have certificates from multiple Intermediate and Root
Certificate Authorities, enter all the Intermediate-Root CA certificate
chains, one after another. If your Active Directory requires access over
SSL/TLS and you do not provide the certificates, you cannot create the
directory.
n If you do not want to use DNS Service Location, verify that the Directory
supports DNS Service Location check box is not selected and enter the
Active Directory server host name and port number.
Certificates If your Active Directory requires access over SSL/TLS, select the Directory
requires all connections to use SSL check box in the Certificates section
and copy and paste the domain controller's Intermediate (if used) and Root
CA certificate into the SSL Certificate text box. Enter the Intermediate CA
certificate first, then the Root CA certificate. Ensure that the certificate is in
the PEM format and includes the BEGIN CERTIFICATE and END CERTIFICATE
lines. If your Active Directory requires access over SSL/TLS and you do not
provide the certificate, you cannot create the directory.
Bind User Details n Base DN - Enter the DN to start account searches. For
example, OU=myUnit,DC=myCorp, DC=com. The Base DN is used for
authentication. Only users under the Base DN can authenticate. Ensure
that the group DNs and user DNs that you specify later for sync are
under this Base DN.
n Bind User DN - Enter the account details. For example,
CN=binduser,OU=myUnit,DC=myCorp, DC=com. Use a Bind user account
with a non-expiring password.
n Bind Password: Click Test Connection to verify that the directory can
connect to your Active Directory.
For Active Directory over LDAP, the domains are listed with a check mark.
6 On the Domain Selection Detail tab, select the domain and click Next.
7 To map the directory attribute to the Active Directory, on the Map Attribute tab, select the
required attribute and click Save and Next.
VMware, Inc. 61
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
8 On the Group Selection tab, to sync from Active Directory to the VMware Identity Manager
directory specify the Group DN details and click Next.
You can also select all the active directory groups that are already available in the list to sync
to the directory.
a To select groups, click Add Group Distinguished Name, and specify one or more group
DNs. Select the groups under them. Specify group DNs that are under the Base DN that
you entered in the “Base DN” text box in the Add Directory page. If a group DN is outside
the Base DN, users from that DN will be synced but will not be able to log in.
b Click Find Groups. The Actions column lists the number of groups found in the DN. To
select all the groups in the DN, click Select All, or click the number and select the specific
groups to sync. When you sync a group, any users that do not have Domain Users as
their primary group in Active Directory are not synced.
9 On the User Selection tab, enter the User DN details and click Next.
Suite administrators is a user name in the Active Directory who acts as an Admin user for the
deployed suite products, Logs, and AD table.
10 Select the Sync Nested Group Members option and enter the Suite Administrators.
When this option is enabled, all the users that belong directly to the group you select and all
the users that belong to the nested groups under it are synced when the group is entitled.
Note that the nested groups are not synced; only the users that belong to the nested groups
are synced. In the VMware Identity Manager directory, these users will be members of the
parent group that you selected for sync. If the “Sync nested group members” option is
disabled, when you specify a group to sync, all the users that belong directly to that group
are synced. Users that belong to nested groups under it are not synced. Disabling this option
is useful for large Active Directory configurations where traversing a group tree is resource
and time intensive. If you disable this option, ensure that you select all the groups whose
users you want to sync.
11 Click Save and Next. In User Selection page, click Add User and specify the users DNs to
sync. Specify user DNs that are under the Base DN that you entered in the Base DN text box
in the Add Directory page. If a user DN is outside the Base DN, users from that DN will be
synced but will not be able to log in. Click Save and Next.
12 Review the Dry Run Check tab, read the summary, click Sync and Complete to start the sync
to the directory. The connection to Active Directory will be established, and users and group
names are synced from the Active Directory to the VMware Identity Manager directory.
13 Click Submit.
14 To edit, click the Edit icon on the specific active directory in the list of active directories. Any
information added is appended to the configuration on VMware Identity Manager. However,
any removal through editing only removes the configuration from the vRealize Suite Lifecycle
Manager inventory and not from the VMware Identity Manager.
VMware, Inc. 62
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
15 To delete, click the Delete icon on the specific active directory in the list of active directories.
The delete action deletes the active directory only from the vRealize Suite Lifecycle Manager
inventory and not from VMware Identity Manager.
Prerequisites
Verify that you have the required user credentials to add a directory.
Procedure
3 Click +Add Directory and click Add Active Directory Over IWA.
Fields Description
Directory Sync and Authentication Select the connector to sync with Active Directory. Connector is a VMware
Identity Manager service component that synchronizes users and group
data between Active Directory andVMware Identity Manager service. It
authenticates users. Each VMware Identity Manager appliance node contains
a default connector component. If necessary, a dedicated connector can
also be deployed through a global environment scale-out.
Authentication Enabled You can indicate whether the selected connector also performs
authentication. If you are using a third-party identity provider to
authenticate users, click No.
Directory Search Attribute Select a search attribute from the drop-down menu.
Certificates n If your Active Directory requires access over SSL/TLS, select the
Directory requires all connections to use STARTTLS check box in
the Certificates section, and copy and paste the domain controllers
Intermediate (if used) and Root CA certificates into the SSL Certificate
text box. Enter the Intermediate CA certificate first, then the Root
CA certificate. Ensure that each certificate is in the PEM format and
includes the BEGIN CERTIFICATE and END CERTIFICATE lines. If the
domain controllers have certificates from multiple Intermediate and Root
Certificate Authorities, enter all the Intermediate-Root CA certificate
chains, one after the other. If your Active Directory requires access over
SSL/TLS and you do not provide the certificates, you cannot create the
directory.
VMware, Inc. 63
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Fields Description
Join Domain Details Enter the Domain Name, Domain Admin user name, and Domain Password.
Bind User Details n Enter the Bind Username and Bind Password of the bind user who has
permission to query users and groups for the required domains. Enter
the user name as sAMAccountName@domain, where domain is the fully
qualified domain name. Using a Bind user account with a non-expiring
password.
You can select the domains that should be associated with the Active Directory connection.
6 On the Domain Selection Detail tab, select the domain and click Submit and Next.
The Active Directory with IWA populates the list of domains and you can select or edit the
domains as required.
7 To verify that the VMware Identity Manager directory attribute names are mapped to the
correct Active Directory attributes, on the Map Attribute tab, select the required attribute
and click Submit and Next.
8 On the Group Selection tab, specify the Group DN details and click Next.
To select groups, click Add Group Distinguished Name, and specify one or more group DNs
and select the groups under them. Specify group DNs that are under the Base DN that you
entered in the Base DN text box in the Add Directory section. If a group DN is outside the
Base DN, users from that DN will be synced but you cannot log in.
When you sync a group, any users that do not have Domain Users as their primary group in
Active Directory are not synced.
a Select the Sync Nested Group Members option.
9 On the User Selection tab, enter the User DN details and click Next.
Note When this option is enabled, all the users that belong directly to the group you select
and all the users that belong to nested groups under it are synced when the group is entitled.
Note that the nested groups are not synced; only the users that belong to the nested
groups are synced. In the VMware Identity Manager directory, these users are members of
the parent group that you selected for sync. If the Sync nested group members option is
disabled, when you specify a group to sync, all the users that belong directly to that group
are synced. Users that belong to nested groups under it are not synced. Disabling this option
is useful for large Active Directory configurations where traversing a group tree is resource
and time intensive. If you disable this option, ensure that you select all the groups whose
users you want to sync.
Suite administrators is a user name in the Active Directory who acts as an Admin user for the
deployed suite products, Logs, and AD table.
VMware, Inc. 64
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
11 Click Sync and Complete to start the sync to the directory. The connection to Active
Directory will be established and users and group names are synced from the Active
Directory to the VMware Identity Manager directory.
12 Click Submit.
13 To edit, click the Edit icon on the specific active directory in the list of active directories.
Any information added, gets appended to the configuration on VMware Identity Manager.
However, if remove through editing you can only remove the configuration from the vRealize
Suite Lifecycle Manager inventory and not from the VMware Identity Manager.
14 To delete, click the Delete icon on the specific active directory in the list of active directories.
You can delete the active directory only from vRealize Suite Lifecycle Manager inventory and
not from VMware Identity Manager.
Multi-Tenancy Overview
This section describes the key concepts and terminologies required to be understood before
starting with multi-tenancy.
n Primary Tenant - There is always at least one tenant (primary, default or base) present in the
VMware Identity Manager which is called as primary tenant.
For vRealize Automation 7.x users, this is the 'vsphere.local' that was present out of the box
in a vRealize Automation 7.x deployments. The primary tenant in vRealize Automation 7.x
was by default bootstrapped with 'vsphere.local' as its name. But this does not happen in
a standalone deployment of VMware Identity Manager. The primary tenant name is formed
based on the first VMware Identity Manager node that gets deployed and bootstrapped. For
example, if 'idm1.vmwlab.local' is the first VMware Identity Manager node that gets deployed,
VMware, Inc. 65
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
then when you bootstrap VMware Identity Manager, primary tenant is created with name
'idm1'. Nodes further getting scaled-out like 'idm2.vmwlab.local' and 'idm3.vmwlab.local' does
not effect. The primary tenant name is formed only once and remains the same in a single or
clustered instance.
n Primary Tenant Alias - You cannot create sub tenants in VMware Identity Manager under the
primary tenant until a few configurations are set and enabled. Setting an alias name for the
primary tenant is one such important configuration. An alias must be created on the primary
tenant and the primary tenant should always be accessed through the primary tenant alias
FQDN on a single node or a clustered instance.
n Provider Admin - An admin who owns the management infrastructure, that includes VMware
Identity Manager, vRealize Automation and other products. The admin creates and manages
all the tenants and associates products with tenants. The vRealize Suite Lifecycle Manager
admin user, 'admin@local' is the only provider admin and is authorized to perform tenant
management functionalities.
n Tenant Admin - An admin with the highest level of administrative permission in each VMware
Identity Manager tenant. This permission can be assigned to both local VMware Identity
Manager users and Active Directory users present within the VMware Identity Manager
tenant.
n Tenant Aware Products - Products that support multi-tenancy and maintains proper isolation
with each logical tenant instance are tenant aware products. They have one to one mapping
with VMware Identity Manager tenants. As of vRealize Suite Lifecycle Manager 8.1 release,
only vRealize Automation 8.1 is tenant aware.
n Directory - Directories are second level of objects in VMware Identity Manager. It represents
an external identity store or provider like Active Directory (AD) or an OpenLDAP server.
There are multiple variants of directory supported in VMware Identity Manager. You can add
Active Directory Over LDAP and Active Directory with IWA in the Directory Management
section.
n Directories in tenant - Each tenant can contain several directories. The same directory
configuration can be present in multiple tenants, however, it is considered a separate
directory. For example: You have added Directory A in primary tenant with some directory
configurations (User DNs, Group DNs, Sync configurations). And you have two sub-tenants
VMware, Inc. 66
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
named Tenant-1 and Tenant-2. The same directory configurations of directory A can be used
on to add directories A1 and A2 on each of the sub-tenants respectively, so that the same
set of users and groups are synced in sub-tenants - Tenant-1 and Tenant-2. After adding, any
changes to the sync configurations of directory A in primary tenant will not affect directories
A1 and A2 and its synced users and groups in Tenant-1 and Tenant-2. All three directories
and its configurations are independent of each other. All three directories are affected only
if the external identity store or provider changes. For example, if users or groups are getting
removed directly from the Identity provider then it influences all three directories in all three
tenants.
VMware, Inc. 67
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Multi-Tenancy Model
This section describes multi-tenancy model explaining how tenants can be accessed through
tenant FQDNs and the importance of enabling multi-tenancy along with the certificate, and DNS
requirements.
Enabling Multi-Tenancy
The master tenant is now referred to as primary tenant. Even though on day-0, the out-of-the-
box VMware Identity Manager includes a primary tenant already available, this is kept at a
minimal configuration and further creation of tenants below the primary tenant is not possible. A
sequence of configurations and API calls are to be performed on the VMware Identity Manager
to enable multi-tenancy. There must be an alias name created for the primary tenant when you
enable multi-tenancy. For more information on enabling multi-tenancy, see Enable Multi-Tenancy.
For example, a VMware Identity Manager with FQDN 'idm1.vmwlab.local' can already have a
primary tenant with name 'idm1'. Before enabling multi-tenancy, it is mandatory to create an alias
for the primary. For example, 'master-tenant' set and use the same alias name everywhere the
primary tenant is referred.
Tenant FQDNs
By default, tenants created on VMware Identity Manager are accessed through tenant URLs
which are nothing but FQDNs mapped to the VMware Identity Manager server. Every
tenant has its own tenant FQDN. For example, on a single node VMware Identity Manager
with hostnameidm1.vmwlab.local, with the primary tenant name (idm1) and primary tenant
alias (master-tenant), the primary tenant should be accessed through its FQDN master-
tenant.vmwlab.local. If a new tenant (tenant1) is created, then it must be accessed only
through tenant1.vmwlab.local.
Since every tenant requires a dedicated FQDN, creating tenants on VMware Identity Manager
mandatorily requires a A-type DNS record mapping the tenant FQDN to the VMware Identity
Manager server IP address. For a clustered VMware Identity Manager deployment, every tenant
FQDN must be having an A-type record mapping to the VMware Identity Manager load balancer
IP address.
The same model applies to vRealize Automation as well. When vRealize Automation is associated
with a tenant, the vRealize Automation tenant must be accessed by vRealize Automation
tenant FQDNs. For example, VMware Identity Manager with FQDN idm1.vmwlab.local having
a tenant 'tenant1' accessible through tenant1.vmwlab.local and vRealize Automation 8.1
VMware, Inc. 68
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
vra1.vmwlab.local integrated with this VMware Identity Manager and associated with 'tenant1'.
As mentioned, vRealize Automation tenant and VMware Identity Manager tenant maps 1:1, so the
primary tenant vRealize Automation can still be accessed by vra1.vmwlab.local and 'tenant 1'
vRealize Automation must be accessed by tenant1.vra1.vmwlab.local.
Note There is a difference between VMware Identity Manager and vRealize Automation
tenant FQDNs. For a VMware Identity Manager instance, the tenant FQDN format is tenant
name (tenant1) followed by the VMware Identity Manager domain name (vmwlab.local). For
example, tenant1.vmwlab.local. Since it is tenant name followed by domain, it remains the
same even for clustered VMware Identity Manager. For a vRealize Automation, the vRealize
Automation tenant FQDN format is tenant name (tenant1) followed the vRealize Automation
server FQDN (vra1.vmwlab.local) For example, tenant1.vra1.vmwlab.local. For a clustered
vRealize Automation behind a load-balancer vra-lb.vmwlab.local, tenant 1 must be accessed
through tenant1.vra-lb.vmwlab.local.
Similar to VMware Identity Manager, even vRealize Automation tenant FQDNs require DNS
mapping. But for a vRealize Automation it should be CNAME type record mapping the vRealize
Automation tenant FQDNs to the vRealize Automation server FQDN. For a clustered vRealize
Automation deployment, all vRealize Automation tenant FQDNs must be having a CNAME type
DNS record pointing to the vRealize Automation load balancer FQDN.
Apart from having DNS mappings as a mandatory pre-requisite, certificates are also mandatory
for tenancy to work. Both VMware Identity Manager, vRealize Automation servers and its
load balancers depending on the deployment architecture should have their corresponding
certificates holding all the required tenant FQDNs.
VMware, Inc. 69
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Note After you enable multi-tenancy, VMware Identity Manager should only be accessed
through its tenant FQDNs. The old FQDNs and hostnames (idm1.vmwlab.local, idm2.vmwlab.local,
idm3.vmwlab.local & idm-lb.vmwlab.local) becomes invalid.
VMware, Inc. 70
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
added as part of both VMware Identity Manager and vRealize Automation certificates. Enabling
multi-tenancy on VMware Identity Manager also requires VMware Identity Manager certificates
updated as the primary tenant gets a new alias name and primary tenant FQDN undergoes a
change.
VMware, Inc. 71
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Note
n When you change the certificates on VMware Identity Manager to enable multi-tenancy
or creating tenants, this brings down the service and leads to a downtime. If VMware
Identity Manager certificate is changed, then it goes for a service downtime. The products
or services integrated with VMware Identity Manager for their authentication purpose cannot
use VMware Identity Manager auth log-in during the downtime. Also, changing VMware
Identity Manager certificate requires retrust on all product or services which again lead to
a downtime for the products.
n For every new tenant that is created and associated with vRealize Automation, even vRealize
Automation certificates must be changed and this causes service downtime for vRealize
Automation.
n To avoid service down-times on vRealize Automation, VMware Identity Manager and other
products or services integrated with VMware Identity Manager, it is generally recommended
to have wild-card certificates. For a new tenant, any change made in the VMware Identity
Manager certificate or vRealize Automation certificate, can create a downtime in vRealize
Automation.
n If wild-card certificates are not used, then specific SAN entries are to be created for each
tenant FQDN on all required certificates.
n The vRealize Suite Lifecycle Manager locker service helps in managing certificates on
the VMware Identity Manager and vRealize Automation server nodes. With vRealize Suite
Lifecycle Manager, when you replace VMware Identity Manager certificate, the retrust of
VMware Identity Manager certificate on all products is performed automatically.
n Products or services external to vRealize Suite Lifecycle Manager is handled manually. Locker
service does not handle updating load balancer certificates. They are to be done by the user
manually. Whenever load-balancer certificates are changed, the same had to be re-trusted on
the products.
n For VMware Identity Manager, the VMware Identity Manager Certificate update or replace
operation in vRealize Suite Lifecycle Manager internally makes sure the VMware Identity
Manager load balancer certificate is re-trusted before updating the VMware Identity
Manager server certificates. So, it is recommended to first change the VMware Identity
Manager load balancer certificate manually and then do a VMware Identity Manager
certificate to update or replace through vRealize Suite Lifecycle Manager locker service.
n For a vRealize Automation 8.x, when SSL is terminated at vRealize Automation load
balancer and load balancer certificate is changed manually, then make sure to click
'Re-trust Load Balancer' under the vRealize Automation 8.x product card to re-trust the
load-balancer certificate in vRealize Automation. For more details, see Day 2 Operations
with Other Products in vRealize Suite Lifecycle Manager.
VMware, Inc. 72
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
For vRealize Automation, for a single node, CNAME type DNS records are required pointing
vRealize Automation tenant FQDNs to the vRealize Automation server FQDN. And for a clustered
vRealize Automation, CNAME type DNS records pointing vRealize Automation tenant FQDNs to
the vRealize Automation load-balancer FQDN.
Figure 2-2. Single node VMware Identity Figure 2-3. Both VMware Identity Manager and
Manager and vRealize Automation vRealize Automation Cluster
icm.vmwlab.local idm1.vmwlab.local idm2.vmwlab.local idm3.vmwlab.local vra1.vmwlab.local vra2.vmwlab.local vra3.vmwlab.local Master-Tenant Tenant-1 Tenant-2
192.168.110.49 192.168.110.50 192.168.110.54 192.168.110.55 192.168.110.51 192.168.110.52 192.168.110.53 (master tenant alias = master-tenant)
tenant-1.vra-lb.vmwlab.local -> vra.vmwlab.local • You have the option to use Wildcard for vIDM LB as
tenant-2.vra-lb.vmwlab.local -> vra.vmwlab.local (*vmwlab.local) and for vRA as (*.vmwlab.local, * vralb.vmwlab.local)
to make things simplier to manage.
Figure 2-4. vIDM Single and vRA Clustered Figure 2-5. VMware Identity Cluster and
vRealize Automation Single
icm.vmwlab.local icm.vmwlab.local vra1.vmwlab.local vra2.vmwlab.local vra3.vmwlab.local Master-Tenant Tenant-1 Tenant-2
192.168.110.49 192.168.110.50 192.168.110.51 192.168.110.52 192.168.110.53 (master tenant alias = master-tenant)
Enable Multi-Tenancy
Multi-tenancy feature is not enabled out-of-the-box. You can opt-in for enabling multi-tenancy.
Prerequisites
n The VMware Identity Manager global environment version should be 3.3.2 or later.
VMware, Inc. 73
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
n Verify if the inventories are synchronized for all the environments in vRealize Suite Lifecycle
Manager and all environments and products are up to date. This is to discover all the VMware
Identity Manager-product integrations required for VMware Identity Manager re-register.
n Verify if the VMware Identity Manager global environment certificate is managed through the
vRealize Suite Lifecycle Manager Locker service.
n For a clustered VMware Identity Manager, verify VMware Identity Manager cluster health
status is green by triggering cluster health. For more information, Day 2 Operations with
Other Products in vRealize Suite Lifecycle Manager
n Verify the VMware Identity Manager certificate is updated with the primary tenant alias
FQDN. Also ensure that the A-type DNS record is added mapping the primary tenant alias
FQDN. For more information about Mandatory Certificate and DNS requirements, see Multi-
Tenancy Model.
Procedure
Ensure such a hostname or FQDN does not already exist. While enabling multi-tenancy, this
FQDN is assigned to the primary tenant.
Ensure all products currently integrated with global environment VMware Identity Manager
are already listed and selected for re-registration against the new primary tenant alias FQDN
in the 'Product Re-registration' table. For more information on Product References, see
Product References.
After you enable multi-tenancy on the VMware Identity Manager, it can only be accessed
through its tenant FQDNs, and at this point as the primary tenant is the only available tenant,
primary tenant alias FQDN is the only endpoint through which VMware Identity Manager
can be accessed. Once the vRealize Suite Lifecycle Manager enable multi-tenancy request is
completed, create tenants from the Tenant Management tab.
Tenant Management
This section describes all the tenant management functionalities available for vRealize Suite
Lifecycle Manager.
While you are managing your tenants, you can add, delete, search and manage your tenants
also.
VMware, Inc. 74
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Add Tenants
Add Tenant allows you to add tenants to VMware Identity Manager along with creating a tenant
admin and optionally add directories to the created tenant and associate tenant-aware products
to the newly created tenant.
When you add a tenant, the workflow also contains a pre-check step which validates all the given
inputs and selected environments to make sure tenant creation and product associations work
seamlessly.
Prerequisites
n Verify that you have DNS configured in both vRealize Automation and VMware Identity
Manager. To access a tenant, the DNS server must be configured correctly before starting
the vRealize Suite Lifecycle Manager flow 'Add Tenant' flow.
n Ensure that the A-type DNS record is added for the new tenant FQDN. For a multi-SAN
environment, ensure that VMware Identity Manager certificate is updated with the new tenant
FQDN that is to be created. For more details, see Multi-Tenancy Model. For all the vRealize
Automation instances that are to be associated with the new tenant ensure that the CNAME
type DNS records are added and certificate requirements are met.
n For all the vRealize Automation instances that are to be associated with the new tenant
ensure that the CNAME type DNS records are added and certificate requirements are
entered.
Procedure
3 Enter a tenant name and under the Administrator Details, enter Username, First Name, Last
name, Email ID, and Password of the Tenant Admin.
4 Click Next.
5 (Optional) On the Directory Details tab, choose the directories from primary tenant that are
to be migrated to the new tenant being created.
You can find the existing directory names listed in the directory column.
a Opt-in for migrate directories lists all the existing directories from the primary tenant. Only
AD Over LDAP and AD with IWA directories is listed.
VMware, Inc. 75
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
7 Select that products that are should be associated with the new tenant. For vRealize Suite
Lifecycle Manager 8.1 and later releases, vRealize Automation 8.1 and later releases can be
listed.
Note Verify that you have considered the recommendation given for both certificate and
DNS.
9 Click Run a Precheck to the validate the tenant details and certificate details.
n Tenant Name validation Check – To validate the entered tenant name matches criteria.
b If the pre-check validations are green, click Save and Next. A summary of the whole
selection appears.
10 Click Next and Create Tenant changes after reading the summary.
You can view the tenant creation under the Request Details page. Both VMware Identity
Manager and vRealize Automation tenants can be accessed through its tenant FQDNs. For
more information, see Tenant Management in vRealize Suite Lifecycle Manager. You can log
in to both VMware Identity Manager tenant FQDN and vRealize Automation tenant FQDN
with the tenant admin credentials. The VMware Identity Manager tenant admin is also made
the organization owner in new tenant vRealize Automation.
Delete a Tenant
Delete tenant operation deletes the tenant from VMware Identity Manager including the
resources crated under that tenant. As of vRealize Suite Lifecycle Manager 8.1, delete tenant
option is only available for a tenant if there are no product associations.
VMware, Inc. 76
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
1 Navigate to Identity and Tenant Management service and click Tenant Management.
3 Click ADD TENANT ADMIN. The create tenant admin page loads
4 Enter the details for the new tenant admin and click Create Tenant Admin.
After you submit, a request is created that can be tracked for completion and user is listed in the
tenant admin list.
Manage Tenant Admins - Search and Assign
This option is used when there are users already present in the VMware Identity Manager under
the concerned tenant and requires tenant admin permission. The search can find both local
VMware Identity Manager users and Active Directory Users that are synced in the concerned
tenant. Multiple users can be searched and assigned with tenant admin permission. To search
users.
1 Navigate to Identity and Tenant Management service and click Tenant Management.
4 When all the users are selected, click Assign Tenant Admin.
After you submit, a request is created that can be tracked for completion and user is listed in the
tenant admin list
Associate Products
When the tenants are created, as a day-2 operation at any point, you can associate more
products. For vRealize Suite Lifecycle Manager 8.1 and later releases, only vRealize Automation
8.1 and later releases can be associated. Product Associations lists the current products that are
associated with the tenant. To add more association, click Add Product Association. Select the
product and check the recommendations given. For vRealize Automation 8.x, ensure that the
Certificate and DNS requirements are entered. Select the tenant admins from the list available.
The tenant admin is made the organization owner for the new tenant vRealize Automation. Run
pre-check to validate your entries and click Submit. Once the request completes, the associated
product is listed under the Product Association list.
Migrate Directories
Migrate directories day-2 is similar to the Add Tenant wizard. The directories tab inside the
tenant view lists the current directories that are present in the tenant.
Note These directories are read-only. vRealize Suite Lifecycle Manager does not allow complete
directory management for subtenant directories. Directory management is only available for
directories present in the primary tenant.
VMware, Inc. 77
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
When you click Add Directories, all the directories from the primary tenant are retrieved. Select
directories that are to be migrated, validate them, and then submit.
Tenant Migration is supported for vRealize Suite Lifecycle Manager 8.2 Patch 1 and later releases.
It involves close coordination between VMware Identity Manager, vRealize Suite Lifecycle
Manager, and vRealize Automation.
vRealize Suite Lifecycle Manager migrates the following data of VMware Identity Manager for
vRealize Automation 7 environment to Global Environment of VMware Identity Manager version
3.3.3 and later releases:
n Tenants
n Directories
n Custom groups
n User attributes
n Access policies
n Network ranges
Prerequisites
n The SMTP information of the source tenant must be configured on the Global Environment of
VMware Identity Manager. This information is required to receive email instructions to reset
the password for all local users. Prior to tenant migration, all local users in the source tenant
must have valid email IDs.
n For custom group migration, you must enable remote connection from the Global
Environment of VMware Identity Manager to the vRealize Automation 7.x database. Refer
to KB 81219 for more information on enabling remote connection.
n Ensure that you have DNS configured in vRealize Automation and VMware Identity Manager.
n Ensure that the source vRealize Automation 7.x environment is in a healthy state and
directories are synced before tenant migration.
VMware, Inc. 78
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Procedure
1 On the My Services dashboard of vRealize Suite Lifecycle Manager, click Identity and Tenant
Management.
3 Read the information on VMware Identity Manager Tenant Migration and vRealize Automation
Tenant Mapping, and then click Continue.
4 On the Environment Selection tab, select the Source Environment and Target Environment.
Based on your source and the target environment selection, you can view a tabular
representation of the available tenants on the source vRealize Automation. You can also view
the status of the migrated or merged tenants on the vRealize Automation 8 environment.
5 Click Next.
6 On the Tenant Migration Workflow page, you can view the workflow of Tenant Migration and
Tenant Merge, and understand the correlation between the two operations.
vRealize Suite Lifecycle Manager also creates 7.x endpoint when adding a new tenant on
vRealize Automation 8 environment. In Tenant Merge, the directories and tenants are already
created on the source vRealize Automation 8 environment. vRealize Suite Lifecycle Manager
creates the 7.x endpoint to the existing tenants on vRealize Automation 8 environment,
so that you can migrate the business groups, infrastructure, and other specific tenants on
vRealize Automation.
7 Click SAVE AND NEXT and read the list of manual steps which must be performed to
proceed with the migration. Select the check box to confirm that you have read and verified
the prerequisites and limitations.
8 To specify the Tenant Migration Workflow, enter these details on the Tenant Details tab.
The source tenants listed are not the migrated or merged tenants.
c Under Target Tenant administrator details, enter the Target Tenant Username, First
Name, Last Name, valid Email ID, and Password.
Note To migrate a directory is a one-time operation, select all the directories which must
be migrated. If the required directories are not selected during migration, you have to
perform this operation manually.
9 To specify a directory that must be migrated from the source vRealize Automation 7 version
to vRealize Automation 8 version tenant, select one of these directories on the Directory
Migration tab.
n System Directory: Connector selection and password creation are not required.
VMware, Inc. 79
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
n JIT directory: Connector selection and password creation are not required.
n Active Directory over LDAP: Select a Windows or Linux target Connector and enter the
Bind Password.
n OpenLDAP: Select a Windows or Linux target Connector and enter the Bind Password.
n Active Directory with IWA: You can only select a Windows target Connector for the
VMware Identity Manager version 3.3.3. Enter the Bind Password and Domain Admin
Password that is required for migration.
Note
n For a FIPS-enabled VMware Identity Manager version 3.3.5, the AD users and bind
user password should be of length fourteen characters.
n To migrate a directory is a one-time operation, select all the directories which must
be migrated. If the required directories are not selected during migration, you have to
perform this operation manually.
11 Click Run Precheck to validate the tenant details and certificate details. Click SAVE AND
NEXT.
12 On the Summary Step tab, you can view the summary of your selections.
If the validations are not successful and you want to make changes, and then resume the
tenant migration operation, click SAVE AND EXIT. The same wizard can be opened anytime
to rerun the precheck to proceed.
You can view the tenant migration details under the Request Details page. Both VMware
Identity Manager and vRealize Automation tenants can be accessed through its tenant
FQDNs.
Merging Tenants
In the Tenant Merge operation, the directories and tenants are already created on the target
vRealize Automation 8 environment.
vRealize Suite Lifecycle Manager creates the vRealize Automation 7.x endpoints to the
existing tenants on vRealize Automation 8 environment. You can migrate the business groups,
infrastructure, and other specific tenants on vRealize Automation.
Prerequisites
n vRealize Automation 8.1 did not require you to accept a source certificate during migration
assessment. To merge or manage the tenant using vRealize Suite Lifecycle Manager, you can
delete the manually added source environment from vRealize Automation.
n Ensure that the VMware Identity Manager specific data is migrated to the target data in the
Global Environment.
VMware, Inc. 80
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Procedure
1 On the My Services dashboard of vRealize Suite Lifecycle Manager, click Identity and Tenant
Management.
3 Read the information on VMware Identity Manager Tenant Migration and vRealize Automation
Tenant Mapping, and then click Continue.
4 On the Environment Selection tab, select the Source Environment and Target Environment.
Based on your source and the target environment selection, you can view a tabular
representation of the available tenants on the source vRealize Automation. You can also view
the status of the migrated or merged tenants on vRealize Automation 8 environment.
5 Click Next and on the Tenant Migration Workflow page, you can view the workflow of Tenant
Migration and Tenant Merge.
6 On the Merge Details tab, you can select one or multiple tenant mappings for vRealize
Automation 7.x and merge it with the same or different destination tenants for vRealize
Automation 8.x.
If you cannot view the target tenant, perform an inventory sync, or perform a product
association for the tenant.
7 Click Next and you can view the summary of your selections on the Summary Step tab.
Note If the validations are not successful and you want to make changes, and then resume
the tenant merge operation, click SAVE AND EXIT. The same wizard can be opened anytime
to rerun the precheck to proceed.
VMware, Inc. 81
Creating an Environment in
vRealize Suite Lifecycle Manager 3
You can create an environment and install vRealize Suite products.
For more information on the supported vRealize Suite products and versions, see System
Requirements.
Prerequisites
n Configure Product Binaries for the products to install. See Configure Product Binaries.
n Ensure that you have added a vCenter server to the data center with valid credentials and
the request is complete.
n Generate a single SAN certificate with host names for each product to install from the
Certificate tab in the UI.
n Verify that your system meets the hardware and software requirements for each of the
vRealize Suite products you want to install. See the following product documentation for
system requirements.
VMware, Inc. 82
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
n vRealize Automation SaltStack Config (formerly known as Salt Stack Enterprise) offers two
setup options:
For more information on installing and configuring Salt Stack in an vRealize Automation
environment, refer to the Salt Stack documentation.
When installing vRealize Automation SaltStack Config, you require the following licenses.
n If you are installing vRealize Automation, you must meet the following additional
prerequisites.
n Configure the vRealize Automation load balancer. See vRealize Automation Load
Balancing.
n Disable the second member of each pool in the vRealize Automation load balancer. You
can re-enable these members after installation is complete.
n The cloud administrator has added all IaaS nodes and the Windows database server to
the domain.
n The Windows database server and IaaS meet all vRealize Automation prerequisites. See
IaaS Windows Servers.
Add the domain user as part of User Rights Assignment under Local Security Policies for
Log on as a Service and Log on as a batch job.
n The domain user has added the SQL server to the domain.
n Add the domain user as part of the SQL DB user Logins list with the sysadmin privilege.
n Install latest JRE (Java 1.8 or later) and create a JAVA_HOME environment variable on all
Windows nodes.
VMware, Inc. 83
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
If you use Internet Explorer for the download, verify that Enhanced Security
Configuration is disabled. Navigate to res://iesetup.dll/SoftAdmin.htm on the
Windows server.
n Set User Access Control settings to Never Notify on both Windows and database server
virtual machines.
n Take a snapshot of the database machine and all Windows IaaS machines after
configuration and before triggering the deployment in vRealize Suite Lifecycle Manager.
n Configure one NSX Edge as Active and one as Passive for the Windows machine. For
detailed information on how to configure the NSX Load Balancer, see Load Balancing the
Cloud Management Platform in Region A.
n On all of the windows IaaS machines used in vRealize Automation deployment, log in to
windows machine at least once as a domain user. If you do not login at least once to the
IaaS machines, then the following error appears:
Private key is invalid: Error occurred while decoding private key. The computer must
be trusted for delegation
and the current user must be configured to allow delegation.
n Ensure that the IaaS nodes do not have any vRealize Automation components already
installed. Follow the steps in the KB article 58871 to uninstall any vRealize Automation
components in the IaaS node.
n Update the registry key on both Windows and database server virtual machines.
1 Use the default PowerShell and run the following command as administrator
on all Windows and database server virtual machines: Set-ItemProperty -Path
"HKLM:\Software\Microsoft\Windows\CurrentVersion\Policies\System" -Name
"EnableLUA" -Value "0"
n Verify that the TLS 1.0 and 1.1 values are not
present in the IaaS windows machine registry path HKLM
SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols.
VMware, Inc. 84
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
n If you are importing an existing vRealize Operations Manager installation, set a root password
for that installation.
Procedure
VMware, Inc. 85
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
In the previous releases, VMware Identity Manager installation was mandatory prior to creating
an environment in vRealize Suite Lifecycle Manager. If an VMware Identity Manager instance was
not created, then you were automatically directed to install it on the vRealize Suite Lifecycle
Manager UI.
Now, you can either enable or disable the VMware Identity Manager toggle button.
Note Prior to installing or importing vRealize Automation 8.x, ensure that globalenvironment
for VMware Identity Manager is present in vRealize Suite Lifecycle Manager. If globalenvironment
is not installed, you cannot proceed with the vRealize Automation 8.x deployment. To install
globalenvironment, enable the toggle button in the Create Environment page.
Procedure
2 Enable the Install Identity Manager toggle button to install VMware Identity Manager. Disable
the Install Identity Manager toggle button to proceed with any other vRealize Suite product
installation.
e Enable or disable the JSON Configuration toggle bar, as required. When you enable the
JSON configuration, you can paste the JSON file text manually or you can import the file
from your local system.
f Click Next.
4 If you enabled Install Identity Manager in step 2, select the New Install option to install
VMware Identity Manager. If the toggle is disabled, select the New Install option for other
vRealize Suite products.
5 Select the required supported version for VMware Identity Manager and click Next.
VMware, Inc. 86
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Results
For more information on configuring VMware Identity Manager, see sections under Install
vRealize Suite Products.
Procedure
1 Log in to vRealize Suite Lifecycle Manager as an administrator and click Create Environment.
2 In the Environment Name, enter a descriptive name for the new private cloud environment.
This name must be unique among environments on this instance of vRealize Suite Lifecycle
Manager.
3 (Optional) Enter the Environment Description, which can be a maximum of 1024 characters.
Note The default password is not applied to vRealize Business for Cloud application
password if vRealize Business for Cloud is deployed in a standalone mode. In standalone
mode, vRealize Business for Cloud application credentials remain as admin/admin. To
integrate vRealize Business for Cloud with vRealize Automation, add vRealize Automation
to the private cloud environment before or at the same time you add vRealize Business for
Cloud.
5 From Data Center, select an existing data center for this environment, or click + to add a data
center to vRealize Suite Lifecycle Manager.
For information on adding a data center, see Add a Data Center to vRealize Suite Lifecycle
Manager .
6 Enable or disable the JSON Configuration toggle bar, as required. When you enable the
JSON configuration, you can paste the JSON file text manually or you can import the file from
your local system.
7 (Optional) Select Join the VMware Customer Experience Program to join CEIP for this
environment.
This product participates in the VMware Customer Experience Program (CEIP). 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.
8 Click Next.
VMware, Inc. 87
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Prerequisites
Verify that you have a data center and environment credentials already created.
Procedure
a Select which individual vRealize Suite products to add to the private cloud environment
and whether to do a new install of each product or import and existing installation of the
product. For each new install, select the product Version and Size to deploy.
2 Click Next.
Note Starting with 8.2, vRealize Lifecycle Manager enables continuous availability (CA) for
vRealize Operations Manager. For more information, see Continuous Availability for vRealize
Operations Manager.
Procedure
1 Read the end-user license agreement, select I agree to the terms and conditions, and click
Next.
a To select the license keys from the locker, click Select to open the list of licenses which
are applicable to the selected products and versions. If not, select all the keys available
from the listing.
b Click Add, to add a new license key to the locker from within the installation flow.
c Click Validate to validate the license. If multiple license keys are available for a product
then this action will suggest to choose one per product selected for the deployment.
You can now view the applicable license keys in the table. The next step will not be enabled
until all the products deployed are having appropriate license selected for them.
Note Valid standalone product licenses or vRealize Suite licenses or a combination of both is
allowed for product deployment in vRealize Suite Lifecycle Manager. License validation does
not check the functionality allowed by the licenses themselves. Therefore, select the license
key considering the combination of products being deployed and their inter connectivity.
VMware, Inc. 88
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Prerequisites
Verify that the imported or created certificate has all the IP addresses and domain or host names
added.
Procedure
1 Under the Certificate Details, select the Certificate from the drop-down menu.
If you want to provide certificate details at product level, you can specifiy the certificate
at the product properties of each product. The action can override the certificates that are
selected at the infrastructure level.
Fields Description
Country Code Enter a country code which must be in two characters only.
Key Length Select the length of the key. You can select 2048 or 4096 bits.
IP Address Enter the IP address in which you are assigning the certificate.
3 Click Generate.
Fields Description
Passphrase Enter the Passphrase field, type <Cert- Password> (if applicable).
Enter Private Key When you upload a PEM file, the private key details are populated automatically.
Enter Certificate Chain When you upload a PEM file, the certificate details are populated automatically.
5 Click Import.
6 Click Next.
VMware, Inc. 89
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Prerequisites
If the selected data center does not have a vCenter Server associated with it, then you must add
a vCenter Server.
Procedure
Note There should be at least one vCenter Server associated with a data center.
2 Select a Cluster.
3 When you click Select a Folder, all the folders that are associated in the vCenter Server are
listed.
If the folders are not displayed, then refresh the vCenter data collection from the vRealize
Suite Lifecycle Manager settings page.
All the resource pools that are associated with the selected cluster are listed.
Note You can select a resource pool to deploy your VM. Both folder and resource pool
selection are optional. If you do not specify any resource pool, the VM is deployed in the root
default resource pool of the selected cluster. If you do not specify the folder details for both
vCenter Server and resource pool, the deployment of the VM is saved in the root default VM
folder of the data center inside the vCenter .
Note vRealize Operations Manager deployment fails when you provide incorrect
infrastructure details such as wrong DNS or gateway details without running a pre-check
while you create an environment flow. If the deployment fails, you might not see the correct
cause of deployment failure using the error or code message that appears in vRealize Suite
Lifecycle Manager UI, and you cannot proceed further with that deployment. As a result, you
might have to delete the Environment card from vRealize Suite Lifecycle Manager with all the
products or nodes that were deployed as part of that environment. You can run Pre-check so
that the Infrastructure-related issues are detected and can be corrected before triggering the
deployment.
VMware, Inc. 90
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
6 With Lifecycle Manager 8.0, to integrate with VMware Identity Manager, select Integrate with
Identity Manager toggle button.
Note The default configuration admin given while installing VMware Identity Manager (global
environment) will be made the admin for the product as well while integrating with VMware
Identity Manager.
VMware Identity Manager acts as an identity provider and manages SSO for the vRealize
Suite products and vRealize Suite Lifecycle Manager when integrated with vRealize Suite
Lifecycle Manager. SSO provides a single set of credentials to access all vRealize Suite
applications and vRealize Suite Lifecycle Manager. With SSO, you are only required to log
in once, and then you can seamlessly access all vRealize Suite applications.
7 Select the Use Content Library to use OVFs hosted on vCenter's Content Library, if there is a
network latency from vRealize Suite Lifecycle Manager to vCenter server
Copying OVF and VMDK files for deployment from vRealize Suite Lifecycle Manager to
vCenter Server might take more time and lead to a deployment failure if there is a Network
latency from vRealize Suite Lifecycle Manager to target vCenter Server. Content Libraries in
vCenter can be used to host OVFs and the same can be used from vRealize Suite Lifecycle
Manager to deploy products. You can perform the steps before you trigger a vCenter
Inventory Sync in vRealize Suite Lifecycle Manager:
vRealize Suite Lifecycle Manager supports deployment only from Publisher or Local Content
Libraries.
Ensure to map the correct library items for the respective products. If none are selected for a
product then a default binary from vRealize Suite Lifecycle Manager will be used to deploy that
product.
Procedure
2 You can either search for a library item or open the content library tree to select one.
Note You can add multiple content library and associate suite products as per your
requirement.
3 Click Select.
VMware, Inc. 91
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Note vRealize Suite Lifecycle Manager validates the OVF package in the specified content
library item corresponding to the selected product.
5 Click Next.
Note Content Library item for a particular node, if it needs to be deployed into a different
vCenter server, it can be selected in Advanced Settings.
Results
After submitting your binaries maps, click next to configure your network settings.
Prerequisites
n Static IP address set is required for any product deployment from vRealize Suite Lifecycle
Manager. This is applicable for starting from vRealize Suite Lifecycle Manager 1.0 and above.
n Verify that you have Domain Name mapped for the IP addresses used for deployed.
Procedure
4 The DNS Servers are automatically listed, if they aren't then click Add New Server or Edit
Server Selection.
Option Description
Use Time Server (NTP) When you select the NTP Server, you have to select the assigned time
server from the NTP list. If an NTP server is not added, then to add one, click
Global Settings. You are then directed to the Settings page to add an NTP
server. For more information, see Configure NTP Servers.
Use Host Time When you select the Host time, then the environment proceeds with the
system time.
6 After you have added NTP servers, you can click Select Servers to add an NTP at an
Infrastructure level.
VMware, Inc. 92
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
7 Select the NTP servers from the list and you can reorder the NTP servers based on the
precedence by clicking the arrows.
When you select a vRealize Suite product, you can configure using these Time servers for the
selected component.
VMware, Inc. 93
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Procedure
u Under the Product Details, select the products for a new installation.
Product Function
vRealize Automation a To monitor health of vRealize Automation, select the Monitor with
vROps check box.
b To manage the workload using load balancer and reclaim unused
resources from the resource pool, select the Workload Placement and
Reclamation check box.
If vRealize Operations Manager is not present, then you can integrate the
products outside of LCM.
Cross-product integration for vRealize Automation with vRealize
Operations Manager is not applicable for an import of vRealize
Automation. And is only applicable if there is a new installation of
vRealize Automation.
Note Starting with 8.2 release, when you newly install vRealize
Automation, select the Configure internal pods and service subsets
checkbox, and then enter the values for K8 Cluster IP Range and K8
Service IP Range.
Note For more information on database creation, see Create a New Private
Cloud Environment Using the Installation Wizard.
vRealize Automation Salt Stack a For vRA Integrated vRealize Automation Salt Stack Config, select the
Config Tenant ID from the drop-down menu under Product Properties.
n vRA Integrated
n Standalone
VMware, Inc. 94
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Product Function
Note
n For vRealize Automation SaltStack Config vRA-Integrated setup, you
can only perform a single node SaltStack Config installation at a time.
For vRealize Automation deployment along with SaltStack Config vRA-
Integrated, the tenant ID is selected by default. Any additional SaltStack
Config deployment can be performed based on the tenant as organic
growth.
n In the 8.4 release, Federal Information Processing Standard 140-2
Support (FIPS) is supported for vRealize Automation SaltStack Config.
vRealize Business for Cloud a Under Product Properties section, enter the VM Name, Hostname, and
IP Address.
vRealize Log Insight Note In the 8.3 release, Federal Information Processing Standard 140-2
Support (FIPS) is supported for vRealize Log Insight. It is also supported as a
Day-2 operation.
VMware, Inc. 95
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Product Function
vRealize Operations Manager Note In the 8.3 release, Federal Information Processing Standard 140-2
Support (FIPS) is supported for vRealize Log Insight.It is also supported as a
Day-2 operation.
a Under Product Properties, select the Disable TLS version from the
drop-down menu.
b (Optional) Select ON or OFF to enable or disable the FIPS Compliance
Mode.
c Select the Certificate from the drop-down menu.
d (Optional) Click Anti-Affinity / Affinity Rule check box to create host
rules in the vCenter for the deployed VMs.
e Add the Product Password.
f (Optional) Click Integrate with Identity Manager check box.
g Select the Applicable Time Sync Mode.
h For Continuous Availability (CA) based deployment, under Components,
enter the Infrastructure and Network details for Witness Domain.
i For Continous Availability (CA) based deployment, enter the
Infrastructure and Network details for Fault Domain 1 and Fault Domain
2.
j If you want to add additional data nodes for a cluster, click the Add
Components tab.
Note If you select Use Global Configuration, the field data is populated
based on the information provided in the Infrastructure tab. You can
select this option for Witness Domain, Fault Domain 1, or Fault Domain
2. Ensure that each domain is in different physical location so that if one
fault domain fails, nodes from the other fault domain remains active.
k If you want to add remote collectors, click Add Collector Group, and
then add the details for the new collector nodes.
VMware, Inc. 96
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Product Function
vRealize Network Insight a Under the Product Properties, select the node size from the drop-down
menu.
b Select the Applicable Time Sync Mode.
c Under components, enter the vrni platform and vrni collector details.
d (Optional) Click Anti-Affinity / Affinity Rule check box to create host
rules in the vCenter for the deployed VM's.
VMware Identity Manager a Under the Product Properties, select the certificate from drop-down
menu.
b Select the Admin Password from the locker.
c Set Default Configuration Admin Username. This will be created as local
user in VMware Identity Manager and is used for vRealize Suite Product
Integration.
d Select the password for Default Configuration Admin user.
e Check Sync Group Members. When enabled, members of the groups are
synced from the Active Directory. When this is disabled, group names
are synced to the directory, but members of the group are not synced.
f For a cluster deployment, under Cluster Virtual IP enter Cluster VIP
FQDN, this is used to load balance the application.
g For a cluster deployment, enter Database IP used internally for proxying
to the postgres master (primary).
Note This is not same as the one used to load-balance the application
and the IP address should be free, and available.
h Under Components, enter the VMware Identity Manager single or
Cluster Node details.
Configuration tabs appear only for the products you selected to install. You can access advanced
properties if you want to update the advanced configurations like adding different vCenter,
enabling or disabling the registration withVMware Identity Manager and so on.
VMware, Inc. 97
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
Procedure
1 Click the vRealize Automation check box to configure installation details for vRealize
Automation.
a If you select 8.x, enter the fully qualified domain name in the form and the IP address for
the vRealize Automation appliance.
b Enter the fully qualified domain name in the form and the IP address for the vRealize
Automation appliance.
For more information about the vRealize Automation appliance, see the vRealize
Automation Appliance and KB article 55706.
2 When installing vRealize Automation SaltStack Config (formerly known as Salt Stack
Enterprise), you have two setup options:
3 Click the vRealize Business for Cloud check box to configure installation details for vRealize
Business for Cloud.
b (Optional) To add an additional component, click the plus sign to Add components and
select the type of component to add.
c Enter the host name in the form of a fully qualified domain name and the IP address for
each component.
If vRealize Automation is not present in the environment and is not getting deployed along
with vRealize Business for Cloud, then specify the Deploy Standalone vRealize Business for
Cloud property to true in Advanced Properties. If VMware Identity Manager is present in
vRealize Suite Lifecycle Manager, then vRealize Business for Cloud will be registered with
vIDM automatically.
There is only one deployment type with the Standard node cluster in vRealize Business for
Cloud.
VMware, Inc. 98
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
4 Click the vRealize Operations check box to configure installation details for vRealize
Operations Manager.
b (Optional) Click the plus sign to Add components and then select the type of component.
c Enter the host name in the form of a fully qualified domain name and the IP address for
each component.
d Select the Node Count or Node Size for vRealize Operations deployment. vRealize
Operations recommends that the number of analytic nodes available for a selection,
depends on the selected node size.
The default type of deployment for vRealize Operations Manager is a node size and node
count.
5 Click the vRealize Log Insight check box to configure installation details for vRealize Log
Insight.
a (Optional) Click the plus sign to Add components and select the type of component to
add.
b Enter the host name in the form of a fully qualified domain name and the IP address for
each component.
c If you are adding cluster virtual IPS, optionally enter load balancer settings.
d Click Components + icon, to add and enable any of the configuration during the
deployment.
The deployment type available for vRealize Log Insight is Standalone and Cluster.
6 Click the vRealize Network Insight check box to configure installation details for vRealize
Network Insight.
a (Optional) Click the plus sign to Add components and select the type of component to
add.
b Select the License key if registered in My VMware or enter the License key manually.
e Under the Product Details, click Add component to add a vRealize Network Insight
platform or a collector. This option is dependant on what type of vRealize Network Insight
you are selecting initially. If you have selected a cluster of vRealize Network Insight, then
you can have two platforms and one collector by default.
The deployment type available for vRealize Network Insight is Standard and Cluster.
7 Click Next.
VMware, Inc. 99
vRealize Suite Lifecycle Manager 8.6 Installation, Upgrade, and Management Guide
n When the vRealize Automation 8.x replace certificate fails intermittently at initialize cluster
after replacing the certificate, retry the failed vRealize Automation 8.0 replace certificate.
n vRealize Automation 8.0 HA replace certificate fails at the initial cluster after replacing the
certificate, when SAN certificate has additional hostnames. At this instance, replace the
vRealize Automation HA certificate with SAN certificate which has the required hostnames
like vRealize Automation Load Balancer hostname and three vRealize Automation hostnames.
n When vRealize Automation 8.0 scale out fails at initialize cluster due to liquibase locks then
click the retry option in the failed vRealize Automation 8.0 scale out request to retry the
initialize cluster step.
n Verify if the SAN certificate is used instead of wild card certificate for vRealize Automation
8.0 deployment.
n Verify to provide all four hostname including 3 vRealize Automation nodes hostname and
vRealize Automation Load Balancer hostname in the SAN certificate when the custom
certificate is used.
Note The master node is now referred to as the primary node. The master replica node is now
referred to as the primary replica node.
CA segregates the vRealize Operations Manager cluster into two fault domains, stretching across
vSphere clusters, and protects the analytics cluster against the loss of an entire fault domain. The
two fault domains are Fault Domain 1 and Fault Domain 2. By default, the primary node and
the replica node are assigned to Fault Domain 1 and Fault Domain 2. If Fault Domain 1 fails, the
functionality is not disrupted as the other pair node ensures that the incident results in no data
loss.
The Witness Node is the third network domain that exists independently and identifies network
partitioning across the two fault domains. If network connectivity between the two fault domains
is lost, the cluster goes into a split-brain situation, which is detected by the Witness Node.
Immediately, one of the fault domains goes offline to avoid data inconsistency problems.
Note A minimum of three pairs of nodes are required to enable CA. You can add a maximum of
16 data nodes, including the primary and replica nodes.
Prerequisites
Verify that you have a data center and environment credentials already created.
Procedure
1 Under Select Product, select vRealize Operations Manager, and then select New Install.
4 Select the Deployment Type from the drop-down menu, and based on the selection of the
Deployment Type, select the number of nodes from the Node Count drop-down menu.
Note For more information about the sizing guidelines for vRealize Operations Continuous
Availability, see KB article 78495.
Procedure
1 Enter the details of the vCenter server where you are installing the vRealize Suite and the
names of the cluster, network, and datastore to use for this environment.
The vCenter server name must be in the form of a fully qualified domain name.
Option Description
3 Enter the default gateway, domain, domain search path, DNS server, and netmask details for
the environment, and click Next.
5 Enter certificate chain for the SAN certificate to import or select the Generated Certificate
option, and click Next.
For information on generating a SAN certificate, see Configure Certificate Within Locker.
6 Enter the product details for each of the vRealize Suite products that you have selected to
install by providing its Windows hostname and IP Address.
7 Click the PRE-CHECK to run and validate the properties for each of the vRealize Suite
products.
Note If the Pre-Check fails, you are required to check the recommendations and fix the
issues of the selected product and run the pre-check again.
Pre-Check Validation
Based on the pre-check validation you can change your input anytime in the previous steps and
run the pre-validation check again.
n Check Name
You cannot go further unless the pre-validation run is successfully complete. The pre-validation
request progress can be tracked in the Request tab through a request that gets created with a
name VALIDATE_CREATE_ENVIRONMENT. Once the pre-validation is run and the NEXT button
is enabled, you can SUBMIT the request for deployment. When you are submitting, you can skip
the pre-validation. By default, this flag is enabled. This verifies pre-validations are anyway run
before deployment is triggered. If you want to skip this, then you can deselect the flag and then
click submit. Pre-validations check does not run again before the deployment begins.
If you click Submit with the pre-validation flag enabled, a request by name
VALIDATE_AND_CREATE_ENVIRONMENT is created. If you click SUBMIT only by deselecting
the pre-validation flag, a request by name CREATE_ENVIRONMENT is created. You can track
the progress of pre-validation requests in the Request tab that vRealize Suite Lifecycle Manager
provides Out of the box. Before you run a pre-check on vRealize Automation, verify all the
IaaS component VMs are communicating with Lifecycle Manager appliance. After you enable
pre-check and submit the create environment, if the pre-check fails then user can resume the
wizard from the Request page with a request state as PRE_VALIDATION_FAILED. From the
report, if the failure is due to the wrong IaaS credential then rerunning pre-check on updating
the windows password in the Product details page still results in the wrong IaaS credential. To fix
this, update the Windows password in the product details page at each node level and rerun the
Pre-Check.
Note Pre-Check in LCM does not take extended storage into account. This means if the
extended storage option is used to deploy vRealize Operations Manager nodes using vRealize
Suite Lifecycle Manager, then the precheck might succeed but the actual deployment can still fail
due to insufficient disk space. For more information, see KB article 56365.
Only Automate checks is automated to run a manual pre-requisite for vRealize Suite in vRealize
Suite Lifecycle Manager 1.2. You can DOWNLOAD SCRIPT and run on all the windows machine.
The zip contains a Readme file, which explains how to run the script. This step is mandatory if you
have selected vRealize Automation as one of the products during an environment creation.
When the user initiates pre-validation, the LCM agent gets deployed and bootstrapped on all
the windows servers along with some configuration metadata. The agent binaries are kept at a
default folder C:\Program Files (x86)\VMware\LCMAgent\ in the windows machine.
Once the agent binaries are pushed a service is started with a name vRealize Suite Lifecycle
Manager Agent Service pointing to the binaries which ultimately starts the agent. The agent
works pull-based, where it polls in vRealize Suite Lifecycle Manager appliance to see if there are
any commands tagged for the current node to be executed. After receiving a command, the
agent updates back the command on every status change and finally updates the result after
completion. The agent service is stopped after a complete pre-validation.
Prerequisites
n New certificates must be in PEM format and the private key cannot be encrypted. By default,
the vRealize Automation appliance management site SSL certificate and private key are
stored in a PEM file located at /opt/vmware/etc/lighttpd/server.pem.
Procedure
cp /opt/vmware/etc/lighttpd/server.pem /opt/vmware/etc/lighttpd/server.pem-bak
3 Copy the new certificate to your appliance by replacing the content of the file /opt/
vmware/etc/lighttpd/server.pem with the new certificate information.
6 Log in to the management console and validate that the certificate is replaced. You might
need to restart your browser.
Note By default, vRealize Log Insight installs a self-signed SSL certificate on the virtual
appliance. vRealize Suite Lifecycle Manager generates custom certificates for products during
environment creation, but custom certificate generation fails for vRealize Log Insight. For
more information, see KB article 55705.
Procedure
1 Verify that the listed environment and installation settings are accurate.
2 (Optional) Click Back or click the relevant page in the navigation pane to change any settings.
3 (Optional) Click Export to export a configuration file with all the product and user data for this
private cloud.
You can use the exported configuration file to create a private cloud. See Create a Private
Cloud Environment Using a Configuration File. Modify the exported configuration file as
required before using it create another private cloud. The Private and primary key is not
included in the exported config file while deploying an exported file. You need to manually
insert those keys.
Update/modify the exported configuration file as required before using it create another
private cloud.
4 (Optional) Select the Topology tab for a high-level view and integration flow of the available
vRealize Suite products in vRealize Suite Lifecycle Manager. Click on a specific vRealize Suite
product, group, or node to view the product or node properties, such as FQDN, IP address,
network, DNS, and more.
5 Click Finish.
vRealize Suite Lifecycle Manager creates the private cloud environment and begins installing
the selected vRealize Suite products in the background.
What to do next
To monitor product installation progress, click Home. Installation progress appears under Recent
Requests.
Prerequisites
Note Certificate is not required for importing an existing environment, however, it is required
when you select both import and new install in one flow while creating an environment.
Procedure
1 Log in to vRealize Suite Lifecycle Manager as an LCM Admin or LCM Cloud Admin and click
Create Environment.
2 After entering the environment data fields, under each of the required vRealize Suite product,
select Import and click the required vRealize Suite product checkbox on the top of the suite
product name.
3 Click Next.
4 In the launched Install wizard, under Products Details page, update the details and select all
the vCenters where all product components are installed.
If you select a combination of import and install for two or more products while creating
an environment, then enter the details as a new Install of product. If you are opting for an
organic growth by adding another product after creating an Environment with New Install
or combination of Import and New Install, then the details in Install wizard is already pre-
populated. You can go ahead and click Next. If you are opting for an organic growth by
adding another product after creating an Environment with Import only, then the details in
Install Wizard are not be pre-populated. As you have never provided those details while
creating the environment.
After you import a product for a scale out, you need to add a certificate. To manage a
certificate you need to add the certificate from the settings tab and then import during scale
out.
Procedure
1 After creating an environment on the Create Environment page, on the products card, select
VMware Identity Manager check box.
3 Enter a valid FQDN address. To import a clustered VMware Identity Manager use load
balancer host name.
4 To import Tenancy Enabled VMware Identity Manager, enter the Default Tenant Alias Host
Name.
5 The System Admin. Admin, SSH User, and Root passwords are listed automatically.
7 (Optional) Select the Sync Group Members check box and vCenter Server list.
9 Click Submit.
Prerequisites
Procedure
1 After creating an environment on the Create Environment, on the products card, select
vRealize Business for Cloud check box.
3 Enter the vRealize Business for Cloud FQDN and select Root Password from the existing
locker entries. If the password does not exist in the locker, then you can create entries in the
locker. Click Add Password from the top-right corner of the window.
4 Select the valid authentication type for the vRealize Business for Cloud instance.
b If an authentication type is VMware Identity Manager, then provide the identity manager
FQDN, admin User Name and select the admin User Password.
c If an authentication type is vRealize Automation, then provide relevant details for the vRA
Cafe FQDN, vRA Cafe SSO Admin User name, and select vRA Cafe SSO Password from
the list of the pre-populated passwords.
5 Select a valid vCenter Server from the list. If the vRealize Business for Cloud instance has
collector nodes spread across multiple vCenters, then all those vCenters should be selected,
else the import operation fails.
For creating a global environment, you will still be prompted to install VMware Identity Manager
if you have skipped this step when you initally installed vRealize Suite Lifecycle Manager. To
install VMware Identity Manager, see Install VMware Identity Manager in vRealize Suite Lifecycle
Manager. To import the vRealize Automation 8.0 brownfield environment, verify that the VMware
Identity Manager present in vRealize Suite Lifecycle Manager is same as the VMware Identity
Manager registered with vRealize Automation. Ensure to use the same configuration admin user
for both VMware Identity Manager and vRealize Automation in vRealize Suite Lifecycle Manager.
Prerequisites
Procedure
1 After creating an environment on the Create Environment page, on the products card, select
vRealize Automation check box.
3 Under Products Details, enter the required fileds to configure the vRealize Automation
properties, select the Import version.
Note If each node has different passwords then the import request fails. You can provide
the correct password in the retry of each failed request.
c Select the vCenter Server where product nodes are residing. For more information on
configuring vRealize Automation, see Points to remember while Configuring vRealize
Automation.
6 Click Submit.
Prerequisites
Procedure
1 After creating an environment on the Create Environment page, on the products card, select
the vRealize Automation SaltStack Config check box.
3 Enter the Master Node IP Address, Root, and Admin Password of the vRealize Automation
SaltStack Config.
Prerequisites
Verify that there is an instance of vRealize Network Insight along with its user credentials
available.
Procedure
1 After creating an Create Environment page, on the products card, select the vRealize
Network Insight check box.
3 On the Product Details page, enter the vRNI Admin user name.
All authorization token and csrf tokens are generated using admin user name and password.
With console user and support user credentials, you can run vRealize Network Insight specific
commands and debug your environment.
Note Support password of all nodes must be same. Although, import of vRNI can
be successful but future operations like upgrade precheck, upgrade, password update,
clustering fails. You have to change the support password of all nodes to one single
password. Similarly, console passwords of all nodes must be same. However, console and
support password can be same across all nodes. If each node has different passwords then
the import request fails. You can provide the correct password in the retry of each failed
request.
6 Select the vCenter Server Instance from the drop-down menu and click Next.
Prerequisites
Procedure
1 After creating an environment on the Create Environment page, on the products card, select
vRealize Operations Manager check box.
3 Enter the vRealize Operations Manager, Master Node IP Address, Root, and Admin
Password.
Note The admin password should be for a local user only, not a user with administrator
permissions.
Note If each node has different passwords then the import request fails. You can provide
the correct password in the retry of each failed request.
Note If you are importing an existing vRealize Operations Manager installation, then SSH
should be enabled for all the vRealize Operations Manager nodes and set root passwords in
all nodes.
Prerequisites
Procedure
1 After creating an environment on the Create Environment page, on the products card, select
vRealize Log Insight check box.
3 Enter the vRealize Log Insight Master Node FQDN, Root, and Admin Password.
Note The admin password should be for a local user only, not a user with administrator
permissions.
Note If each node has different passwords then the import request fails. You can provide
the correct password in the retry of each failed request.
Know more about Private Cloud, before you configure your environment.
When you are creating an environment using a JSON spec, if the Locker ID for the passwords is
used, you must make sure to use respective locker ID from the current vRealize Suite Lifecycle
Manager. Navigate to Locker > Passwords and copy the Password ID, and use in the spec. There
is no action required for a plain text password.
While using JSON spec, ensure to update all the parameters under each node's advanced
settings as required. If you do notupdate, then it takes the original values from the JSON spec.
Prerequisites
n Configure OVA settings for the products to install. See Configure Product Binaries.
n Ensure that you have added a vCenter to the data center with valid credentials and the
request has completed.
Procedure
1 Log in to vRealize Suite Lifecycle Manager as administrator and click Create Environment.
2 From Data Center, select an existing data center for this environment, or click + to add a data
center to vRealize Suite Lifecycle Manager.
For information on adding a data center, see Add a Data Center to vRealize Suite Lifecycle
Manager .
3 Enable or disable the JSON Configuration toggle bar, as required. When you enable the
JSON configuration, you can paste the JSON file text manually or you can import the file from
your local system.
4 (Optional) Select Join the VMware Customer Experience Program to join CEIP for this
environment.
This product participates in the VMware Customer Experience Program (CEIP). 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.
6 Paste the text of the product configuration JSON file into the Product Config JSON text box,
and click Next.
You can download the configuration file from the summary page to create a JSON file for
the product or the solution with the latest inputs that were provided while configuring the
environment.
The create installation wizard is launched and the JSON data is populated. You can validate
the data before you click submit. For more information on getting a sample JSON file, see KB
article 75255.
What to do next
To monitor product installation progress, click the Home button. vRealize Suite Lifecycle Manager
displays installation progress for the environment under Recent Requests and on the Requests
tab.
Procedure
1 Log in to vRealize Suite Lifecycle Manager as an administrator and click vRealize Cloud.
3 In the Environment Name, enter a descriptive name for the new Cloud Proxy environment.
6 From Data Center, select an existing data center for this environment, or click + to add a data
center.
7 Enable or disable the JSON Configuration toggle bar, as required. When you enable the
JSON configuration, you can paste the JSON file text manually or you can import the file from
your local system.
8 Select Join the VMware Customer Experience Program to join CEIP for this environment.
This product participates in the VMware Customer Experience Program (CEIP). 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.
Prerequisites
Verify that you have a data center and environment credentials already created.
Procedure
1 Select the Cloud Proxy products to add to the private cloud environment, and then select the
Installation Type. You can perform a fresh installation of a product or import from an existing
installation of the product.
3 Click Next.
What to do next
After installing the Cloud products, follow the steps listed under Create a New Private Cloud
Environment Using the Installation Wizard for EULA and license selection, configuring your
certificate details, and configuring your network details.
Product Function
Install Cloud Extensibility Proxy 1 Under Product Properties, enter the Proxy Name.
2 Select the Product Password.
3 Select the Refresh Key.
4 Under Components, enter the VM Name, FQDN, and
IP Address.
5 Click Next.
Install VMware Cloud Services Data Collector 1 Under Product Properties, enter the Proxy Name.
2 Select the Cloud Assembly and Log Insight check
boxes, as applicable.
3 Select the Product Password.
4 Select the Refresh Key.
5 Under Components, enter the VM Name, FQDN, and
IP Address.
6 Click Next.
Install vRNI Cloud Proxy 1 Under Product Properties, enter the Proxy Name.
2 Select the Product Password.
3 Select the Refresh Key.
4 To add a new server, enter the following details.
a Add the server Name and FQDN/IP Address.
b Click Submit.
5 To edit an existing server, enter the following details.
a Select the NTP Servers.
b Click Next.
c Change Server Priority, as required.
d Click Finish.
6 Under Components, enter the VM Name, FQDN, and
IP Address.
7 Click Next.
What to do next
After configuring your Cloud Proxy Product details, follow the steps listed under Create a New
Private Cloud Environment Using the Installation Wizard for validating your Cloud details and to
complete your installation process.
Prerequisites
For more information on activating your subscription license and to get started with an express
onboarding experience, see the vRealize Cloud Universal Onboarding guide. To manage your
vRealize Cloud licenses in vRealize Suite Lifecycle Manager, see Managing vRealize Cloud
Licenses in vRealize Suite Lifecycle Manager.
n Delete an Environment
the VMware Identity Manager cluster. To view the list of inter-product configurations, click the
Product References.
After an upgrade, all products currently integrated with global environment VMware Identity
Manager are shown in the list. The global environment VMware Identity Manager View Details
page contains the day-2 operations:
n Topology - The Topology Viewer is introduced to help you view the group and node
structure, vCenter, and product integration details between VMware Identity Manager and
vRealize Suite products.
n Trigger Cluster Health - Triggers instant health check on the VMware Identity Manager cluster
nodes and provides a notification on vRealize Suite Lifecycle Manager UI.
Based on the health status of the cluster nodes, 'vIDM vPostgres Cluster Health' notification is
either marked CRITICAL or OK. For the notification to be precise, verify that VMware Identity
Manager can communicate to all the VMware Identity Manager nodes in the cluster and
the global environment VMware Identity Manager inventory is up-to-date in vRealize Suite
Lifecycle Manager.
The health check includes postgres service status check, pgpool service (responsible for
automatic failover) status check and Delegate IP (database load balancer IP) availability check
apart from basic the VMware Identity Manager service availability checks.
If VMware Identity Manager is clustered through vRealize Suite Lifecycle Manager, then the
Power ON option can also be used to remediate the critical cluster heath.
n Power ON - Turns up the VMware Identity Manager nodes and ensures all the required
services are bootstrapped. For a clustered instance (vRealize Suite Lifecycle Manager
clustered VMware Identity Manager), this operation fixes any inconsistency in the cluster.
For example, fixing the Delegate IP (database load balancer IP), correcting any replication
delays in the secondary nodes . If VMware Identity Manager is clustered through vRealize
Suite Lifecycle Manager, then use this option for any use case which involves powering on
the cluster like snapshot revert, reboot, power on .
n Power OFF - Brings down all the VMware Identity Manager services by shutting them down
and also brings down the services that are responsible for an automatic failover, and its
related components in a clustered deployment. This option is provided for both single node
and clustered node VMware Identity Manager.
If VMware Identity Manager is clustered through vRealize Suite Lifecycle Manager, then it
is always recommended to use this option for a scenario which involves bringing down the
cluster, such as reboot and shut down. Creating VMware Identity Manager snapshot through
vRealize Suite Lifecycle Manager stores the snapshot after bringing down the VMware
Identity Manager services gracefully.
Note A change in VMware Identity Manager certificate requires retrust of VMware Identity
Managercertificate on all products or services currently integrated with it. While updating
certificate, you can select all currently referenced products to opt in for retrust. For more
information on product references, see Product References. To know more about the
hardware requirements depending on the number of users in the directory, see System and
Network Configurations Requirements.
Procedure
After the cluster health collection is complete, the health status is displayed in the vRealize
Suite Lifecycle Manager under the notification lists on the top right of the UI.
Note If the status is red, to remediate click Power ON or see the KB article 75080.
3 You can scale up to the required size by performing a vertical scale up. For more information
on vertical scale up, see Scale-Up vRealize Suite Products.
Results
For more information on hardware requirements for VMware Identity Manager when integrated
with vRealize Automation, see the hardware requirements in the vRealize Automation 8.1
Reference Architecture. To know more about the hardware requirements depending on the
number of users in the directory, see System and Network Configurations Requirements.
n Topology - The Topology viewer is introduced to help you view the node structure and
understand the integration between different vRealize Suite products within vRealize Suite
Lifecycle Manager. You can select the available vRealize Suite product and view the version,
certificate, and license details. You can also select on a primary or secondary node to view
the FQDN, IP address, network, DNS, and other node properties.
n New Collector Group - New collector groups are available for vRealize Operations Manager.
The new collector group enables you to add new collectors, group the new collector nodes,
and move the collector nodes into new collector groups. You can add remote collector and
cloud proxy to the collector group.
Note It is recommended that you do not add cloud proxy to a collector group from remote
collectors. For cloud proxy, a separate cloud proxies group can be created which contains
only cloud proxies.
n Re-Trust With Identity Manager - Whenever VMware Identity Manager certificate changes
there is a need for all products/services currently integrated with VMware Identity Manager
to retrust the VMware Identity Manager certificate. Even though starting from vRealize Suite
Lifecycle Manager 8.1, when replacing or changing VMware Identity Manager certificate all
products integrated with VMware Identity Manager that are linked in Product References are
opted-in for an automatic retrust. This button can be used anytime when you want to retrust
VMware Identity Manager certificate on the product explicitly.
Note This option is only applicable if a product is integrated with global environment
VMware Identity Manager and shows up in the Product References table under global
environment VMware Identity Manager.
n Re-Register With Identity Manager - When products integrate with VMware Identity Manager,
it gets registered against a VMware Identity Manager endpoint which in general is with the
FQDN of VMware Identity Manager. Whenever VMware Identity Manager FQDN changes,
there is a need for products or services currently integrated with VMware Identity Manager to
re-register with the new VMware Identity Manager FQDN.
n Enable FIPS Compliance Mode – Starting with vRealize Suite Lifecycle Manager 8.3, FIPS
Compliance Mode is available for vRealize Log Insight and vRealize Operations Manager.
You can enable or disable the FIPS mode during product deployment. Alternatively, you can
select the Enable FIPS Compliance option for the product level operation from the Manage
Environments page.
Note If you enable the FIPS mode for a vRealize Suite product, you cannot revert and run it
on a non-FIPS mode.
n Update NTP Configuration – Starting with vRealize Suite Lifecycle Manager 8.6, you can
update the NTP Configuration details after deploying the vRealize Suite products. The Time
Sync Mode offers two configuring options, using NTP server or using the EXSi host time.
When you choose the NTP Server, you can add the new server details or you can edit the
existing server details, such as the server name and FQDN/IP address. Click Submit to view
the new NTP server details. Under Change NTP Server Priority, you can change the priority of
the servers. Next, run precheck to view the details of the successfully passed checks and the
failed entries. Once you click Submit, the NTP configuration update request is submitted.
Note This operation primarily checks vRealize Suite Lifecycle Manager inventory of the clustered
vRealize Automation 8.x before performing the retrust. The inventory data for clustered vRealize
Automation 8.x will have a parameter - vra-va- SSL terminated at load-balancer under
the Cluster VIP section of product properties. The parameter decides whether the SSL is
terminated at the vRealize Automation load balancer or not. For all green text box vRealize
Automation 8.x deployments, this option is provided as an input to be filled by the user and for
an existing brown field deployment, the value for the parameter is automatically computed.
Note The start up and shutdown operations are also available for vRealize Automation, which
helps to gracefully start and shut down the vRealize Automation services.
Prerequisites
Verify that a product has existing internal IP range values. For information on K8 service and
cluster IP range, see Install and Configure vRealize Automation Using vRealize Suite Lifecycle
Manager Easy Installer for vRealize Automation and VMware Identity Manager .
Procedure
1 From the Environment page, select a product card, and then click the vertical ellipses.
3 Enter internal IP range values for K8 Cluster IP Range and K8 Service IP Range.
4 Click Next.
5 To validate the IP range information, click RUN PRECHECK , and click Finish.
Organic growth allows you to import an existing vRealize Suite product to an existing
environment or to trigger a fresh deployment of the product to add to an existing environment.
An environment can contain only one instance of each supported vRealize Suite product.
Prerequisites
Have an existing private cloud environment in vRealize Suite Lifecycle Manager that does not
already contain all of the supported vRealize Suite products.
Procedure
2 Click the ellipsis (...) for the environment, and select Add Products to perform organic growth.
3 Select the products to add and enter the necessary configuration information.
Prerequisites
Have an existing vRealize Network Insight instance in vRealize Suite Lifecycle Manager.
Procedure
2 Click View Details of Environments where you must add the data source.
3 Click the ellipsis (...) for vRealize Network Insight, and select Add Data Source.
VMware vCenter You can enter the vCenter related information in the provided fields along with the proxy details.
VMware NSX You can enter the NSX Manager related information in the provided fields along with the proxy
Manager details.
Routers and Switches You can enter the SNMP configuration details in the provided fields by clicking the Advanced
Settings.
Note You can add similar data sources to the vRealize Network Insight that are specific to its
respective products or functionalities.
Prerequisites
Procedure
1 From a vRealize Network Insight environment card, right click on the vertical ellipses and
select Add Data Sources > Bulk.
2 Select CSV or JSON format to import the data sources in a defined report format.
3 Click SELECT File , and then select the JSON file, and click Next.
5 To update the CSV file in the required format, click Download Template.
Prerequisites
Verify that you have created a vRealize Network Insight data source in vRealize Suite Lifecycle
Manager.
Procedure
1 In the vRealize Suite Lifecycle Manager 8.2 dashboard, click Manage Environments.
2 In the Environments page, select the vRealize Network Insight product card, and then click
View Details.
a If you click DELETE DATA SOURCE, the selected data source is deleted.
Note If a data source is referenced in any other data source of vRealize Suite Lifecycle
Manager, you cannot delete the referenced data source.
b If you click EDIT DATA SOURCE, you can edit the Collector (Proxy) VM, data source
username, data source password, and the data source nickname.
4 Click SUBMIT.
Prerequisites
Verify if you have already created vRealize Network Insight data source passwords in vRealize
Suite Lifecycle Manager.
Procedure
2 Select vRealize Network Insight product card, and click the vertical ellipses for the
environment, and then click Change Data Sources Password.
3 Under Select Data Sources, select the data sources that you want to update, and then click
Next.
4 Under Update Credentials, click New Password to change the existing password, and then
click Next.
Note If you select multiple data sources to update passwords, the new password applies to
all the selected data sources.
5 Under Precheck details, click RUN PRECHECK to validate the new passwords, and then click
Next.
6 Under Summary, you can verify the changes for the data sources.
7 Click Finish.
Note When you perform a bulk password update and one or more passwords fail to update,
the request is marked complete, but you will receive a warning message for the passwords
which are not updated. Click the data source details for information, and then retry updating
the bulk passwords.
n Ensure to take snapshots of VMware Identity Manager nodes before you perform scale-out
operations. VMware Identity Manager cluster is always three node including an existing node.
n Verify that there is a certificate already added in the locker and also perform the replace
certificate on the standalone VMware Identity Manager node. The certificate should also
have SAN entries of all the three nodes or wild-card certificate. For information on replacing
certificate, see Replace Certificate for vRealize Suite Lifecycle Manager Products
n Scale-In is not supported when you deploy VMware Identity Manager cluster through
vRealize Suite Lifecycle Manager.
Prerequisites
For a VMware Identity Manager cluster and replace certificate actions, ensure to take a snapshot
of the VMware Identity Manager nodes.
Procedure
Verify that the primary node and the additional components use the same default gateway
and they are connected with each other.
5 On the Components tab, you have two options, so you can select Take product snapshot
and Retain product snapshot taken. If the Take product snapshot is set to true, the snapshot
is taken prior to starting scale-out, and can be rolled back to its initial state during a scale-out
failure, the snapshot is taken with the prefix LCM_AUTOGENERATED. If the Retain product
snapshot taken is set to true, it can be retained.
Note Snapshot Rollback action is available for the failed scale-out request in the Requests
page.
Note The delegate IP address is used internally as a proxy to postgres master (primary) and
it should be free or an available IP address. This is not same as the one used to load-balance
the application.
Note You can add two components of type secondary and provide FQDN, and IP address.
It is recommended for a VMware Identity Manager cluster to contain of three nodes behind a
load balancer.
9 Click Submit.
Note It is very important to reboot the appliance, otherwise the scale-out procedure fails
with unable to find root certificate error. The errors occurs because of an existing
product issue after you replace the certificates to reboot the appliance.
There are various checks that are important from a postgres cluster perspective that requires
attention.
1 VMware Identity Manager nodes reachability from vRealize Suite Lifecycle Manager.
All the above checks are captured and appropriate description messages are displayed in the
notification that pops-ups with a message like vIDM postgres cluster health status is
critical. For more information on the steps, see the KB article 75080.
If all the checks are validated, vRealize Suite Lifecycle Manager gives a notification with a
message as vIDM postgres cluster health status is ok that provides a healthy cluster
status. On a Day-2 operation, you can click the Trigger Cluster Health on the Global Environment
for VMware Identity Manager in addition to scheduling the health check on an hourly basis.
For more information on trigger cluster health, see Day 2 Operations for Global Environment in
vRealize Suite Lifecycle Manager.
As a Day-2 operation, Pause Cluster Health Check is introduced to pause the health notifications
when troubleshooting issues, such as VMware Identity Manager password management,
replacing certificates, upgrade related issues, and more. When performing an hourly check or
during a maintenance, you can click the Pause Cluster Health Check, and then click Submit to
pause the health notifications. Once these functions are up and running, you can resume the
health check in the environment product card.
All the VMware Identity Manager tenant FQDNs must now point to the load balancer IP address
instead of VMware Identity Manager a single node IP address. And VMware Identity Manager
load balancer certificate must hold all the tenant FQDNs. For more information on Mandatory
Certificates and DNS Requirements, see Multi-Tenancy Model.
The same recommendations are provided to you as a manual pre-requisite to select before
scaling-out global environment VMware Identity Manager from vRealize Suite Lifecycle Manager
UI. For more information on Tenant FQDNs, see Multi-Tenancy Model.
Prerequisites
Follow these prerequisites for a Windows system in which the connector will be installed.
n The supported Windows Server versions are 2012 R2, 2016, and 2019.
n A unique Windows system is required for the migration and it must be connected to a
domain server.
Procedure
1 Navigate to Environments on the environment page, and then click Add Components .
Verify that the primary node and the additional components use the same default gateway
and they are connected with each other.
b Enter FQDN.
c Enter a user-defined Windows Connector Name, and then select the Connector Admin
Password.
7 Click Submit.
Prerequisites
vRealize Suite Lifecycle Manager does not allow you to add a component of a product until
the certificate mapping for that product is created in the locker. When you replace the vRealize
Automation certificate using the new certificate added to locker, the new certificate contains
additional host entries for new components which should be added as part of scale-out. After
you import or create a certificate in the locker, apply this certificate in the product, only then the
additional components will be visible in the product.
To map the certificate for the product in the locker, import the product certificate in the locker
and trigger the inventory sync for that product. This creates a reference for that product with the
certificate in the locker. This is applicable for an import scenario.
Verify that the certificate is replaced in the product where the certificate contains all the product
components host names including the Load Balancer host name and a new additional component
host names that are added is also specified. For more information on replacing certificates, see
Replace Certificate for vRealize Suite Lifecycle Manager Products. For more information on load
balance, see vRealize Automation Load Balancing.
Procedure
1 On the environment card, select a product, click the vertical ellipses, and select Add
Component.
For an imported environment, manually enter the text boxes for the selected product.
Note At times, scaling out patched products from vRealize Suite Lifecycle Manager might
fail. This is because joining the cluster fails due to version mismatch in the product appliances.
You can download and use the OVA corresponding to the patch. When you click Add
Component, a warning message appears indicating whether the OVA required to scale out
the patched product is available or not in the vRealize Suite Lifecycle Manager. The required
OVA bundle can be downloaded from My VMware Portal into the vRealize Suite Lifecycle
Manager appliance and mapped. You can download and map the patched product binaries.
For more information on how to download the patch product binaries, see Configure Your
Patched Product Binaries.
2 Under the Infra details, select the required vCenter Server, Cluster, Network, Datastore, and
Disk Format from the drop-down menus.
4 Under the Network details, if the environment is a newly created, then the text boxes are
auto-populated. If the environment is imported, you have to manually enter the text boxes.
5 Click Next.
6 Select the Applicable Time Sync Mode and under the components section, select the node.
The advanced setting provides more information on configuring the selected node in a
cluster. For an imported environment in 2.0 where a product is scaled out, ensure that the
provided certificate is primary-node certificate, as the pre-check matches the primary node
certificate. For environments from older vRealize Suite Lifecycle Manager versions, you can
add the older certificate during a scale-out by clicking Add button. This populates the older
certificate data from the environment's Infrastructure properties.
7 On the Components tab, you have two options, so you can select Take product snapshot
and Retain product snapshot taken. If the Take product snapshot is set to true, the snapshot
is taken prior to starting scale-out, and can be rolled back to its initial state during a scale-out
failure, the snapshot is taken with the prefix LCM_AUTOGENERATED. If the Retain product
snapshot taken is set to true, it can be retained.
Note Snapshot Rollback action is available for the failed scale-out request in the Requests
page.
8 Under Component > Product properties, select the required text boxes.
9 Enter the required text boxes and click Next, and run Precheck.
For more information on Tenant FQDNs, see Multi-Tenancy Model. After you scaled-out, vRealize
Automation tenants must be accessed through load-balancer tenant FQDNs and DNS, and
certificates changes are to be made accordingly. The same recommendations are shown to the
user as a manual pre-requisite to be taken care before scaling-out vRealize Automation 8.x from
vRealize Suite Lifecycle Manager UI.
Day 2 operations include the Vertical Scale Up operation to manage environments and avoid
any performance degradation. Vertical Scale Up is supported for vRealize Log Insight, vRealize
Automation, vRealize Operations, vRealize Network Insight, and VMware Identity Manager. You
can increase the storage capacity for a product by scaling up the current size and adding a disk
with the required capacity.
Prerequisites
Verify that you have an existing private cloud environment in vRealize Suite Lifecycle Manager
that contains supported vRealize Suite products.
Procedure
1 From the vRealize Suite Lifecycle Manager dashboard, click Manage Environments.
3 Click the ellipsis (...) for the product level operation, and then select Vertical Scale Up.
4 In the Proceed to Vertical Scale Up pop-up window, click Trigger Inventory Sync.
7 Under Vertical Scale-Up Details, select Scale Up Size from the drop-down menu. You can
select the Additional Disk Size (optional).
8 Under Advanced Settings, select the appropriate datastore for the nodes from the drop-
down menus, and then click Next.
Note If the validation is successful, a successful validation message appears. If you see an
error message, follow the instructions provided in the Recommendations tab, and then click
RE-RUN PRECHECK.
10 When the validation succeeds, click Submit to view the details of your request.
Note
n For VMware Identity Manager (vIDM), the default vIDM deployment option and vRealize
Automation specified size of 8 CPU and 16 GB memory are supported. To increase the
storage capacity from the additional disk space provided to vIDM 3.3.2, 70% can be
assigned to /db and 30% to /var. To increase the storage capacity from the additional
disk space provided to vIDM 3.3.3, 70% can be assigned to /db and 30% to /opt.
n The requiredCpuCount and requiredMemory parameters are the overall CPU and memory
parameters that are available for a node.
n For vRealize Suite products, you provide the extra disk size to increase the capacity. The
requiredCapacity parameter adds an extra disk to the available capacity.
n For vRealize Automation, you select the required disk for expansion and choose how
much to expand the existing disk.
n If you are installing vRealize Automation, ensure that you deploy vIDM with the suggested
size for vRealize Automation.
n For VMware Identity Manager version 3.3.3 or later releases, you must be connected to
the internet to perform the vertical scale up operation. If you are not connected to the
internet and want to perform the vertical scale up operation offline, you must install the
parted packages from packages.vmware.com.
If any data source is added in vRealize Network Insight environment, exporting of config file of
this environment will have data source details. The config file can be used to create new vRealize
Network Insight environment and data sources will be added automatically.
Procedure
2 Click the ellipsis (...) for the environment, and select Export Configuration.
3 Select the configuration file type to export from Simple or Advance, based on your
requirement
Earlier, the export configuration file feature was available at the LCM environment level.
Starting with vRealize Suite Lifecycle Manager 1.3, you can export the configuration file at the
product level also for the selected product.
What to do next
Use the configuration file to create new private cloud environments. See Create a Private Cloud
Environment Using a Configuration File.
Procedure
2 Click the ellipsis (...) for the environment, and select Download Logs.
Note When you click download logs on the Manage Environments page in vRealize Suite
Lifecycle Manager, the link to download the support bundle does not appear. For more
information, see KB article 55744.
Results
Downloaded logs are stored /data/support-bundle inside vRealize Suite LCM appliance.
Delete an Environment
You can delete an existing environment from vRealize Suite Lifecycle Managerand not individual
products. You cannot select a specific product within an environment to delete.
You can delete both successful and failed environment deployments. You can delete
environments that are failed to deploy or you can delete an initiated environment.
Note You can edit an existing environment that is in progress or failed deployment state in
vRealize Suite Lifecycle Manager. Select any product card under Environments, click the vertical
ellipses for the chosen product, and select Edit Environment Details to edit the environment. You
have the option to edit the environment name or the environment description. However, you
cannot edit the environment name for globalenvironment.
VMware Identity Manager installation is optional when creating an environment. If you delete a
VMware Identity Manager environment:
n You cannot use VMware Identity Manager as an authentication source for vRealize Suite
Lifecycle Manager.
n You cannot access Identity and Tenant management. The user and active directory
management becomes inaccessible. The existing roles and user mappings of VMware Identity
Manager from vRealize Suite Lifecycle Manager is removed.
Procedure
2 Click the three dots in the upper right corner of the environment tile, and select Delete
Environment.
3 (Optional) Select Delete related virtual machines from vCenter to delete all virtual machines
associated with this environment from vCenter server.
If you do not select this option, all virtual machines associated with this environment remain in
vCenter after the environment is deleted from vRealize Suite Lifecycle Manager.
4 (Optional) Select Delete related Windows machines to delete Windows machines associated
with vRealize Automation this environment.
This option is available only for vRealize Suite Lifecycle Manager 7.x releases if you choose
to delete all related virtual machines from vCenter. Ensure to confirm this action before you
proceed.
5 Select Delete related virtual machines from vCenter to delete virtual machines associated
with the environment.
This option is available only if you have virtual machine associated with an environment
in vCenter server. If selected, then virtual machines associated to the environment is also
deleted from the vCenter server. If it is not selected, then only the record of this environment
is deleted from the vRealize Suite Lifecycle Manager inventory.
6 Click DELETE.
7 If you chose to delete virtual machines associate with the environment, verify that the list of
virtual machines to delete is correct, and click CONFIRM DELETE.
Note If the delete operation fails, an option is enabled in the environment card Delete
environment from vRealize Suite Lifecycle Manager. This action deletes the environment from
vRealize Suite Lifecycle Manager and you can delete the VMs manually from the vCenter
server. For brownfield import, if you fail to add a vCenter list, then delete environment
confirmation dialog box does not show the VM list in that particular vCenter and you have to
clean them up manually. For an organic growth, the environment card from the recent activity
home page is not deleted or dimmed.
8 Click CLOSE.
Results
What to do next
You can view the progress of the delete operation on the Requests page.
n Product References
Starting from vRealize Suite Lifecycle Manager 8.1, product details has a new vertical tab
named Product References listing all inter-product integrations. For example: If product A is
integrated with product B or the other way, the View Details page of both product A and B
has an entry in Product References table, pointing reference to each other.
This procedure does not apply to snapshots of vRealize Automation 7.x database virtual
machines. Snapshots of vRealize Automation 7.x database virtual machines must be taken
manually rather than through vRealize Suite Lifecycle Manager.
Managing snapshots are restricted to vRealize Suite Lifecycle Manager version 8.6 triggered
snapshots. If you trigger a snapshot directly, the snapshot is no longer managed in vRealize Suite
Lifecycle Manager.
Procedure
3 Click the ellipses icon next to the name of the product to snapshot and select Create
Snapshot.
4 Under Snapshot Details, enter the Snapshot Prefix and the Snapshot Description details.
5 (optional) For certain vRealize Suite products, you can select the Snapshot With Memory
toggle.
6 (optional) You can select the Shutdown before taking snapshot toggle, as required.
7 Click Next.
Note Day 2 operations that depend on vCenter Server, such as creating a snapshot, might
fail if the guest tools are not running or if the IP address/Hostname is not visible in vCenter
Server. vRealize Operations Manager setup is not accessible after reverting the snapshot of
vRealize Operations Manager as the vRealize Operations Manager cluster can be inconsistent
state. For more information, see KB article 56560.
11 Click the ellipses icon next to the name of the product to snapshot and select Manage
Snapshot.
12 You can view the snapshot tree structure and the snapshot details. Click Delete to
permanently delete a snapshot.
Results
Note
n The partial or inconsistent snapshot does not provide the revert option.
n You can rollback or revert a snapshot that you created during an upgrade or a scale-out in
the Requests tab.
n When you deploy vRealize Suite products, a custom attribute is created on vCenter to
support the snapshot inventory from vRealize Suite Lifecycle Manager.
vRealize Suite Lifecycle Manager saves state and configuration details for the product's virtual
appliance. For more information, see KB article 56361.
What to do next
After you create a product snapshot, you can revert the product virtual appliance to the state of
the snapshot.
If the product upgraded outside or if there is any failure in vRealize Automation or vRealize
Operations Manager, inventory sync updates the correct primary node in vRealize Suite Lifecycle
Manager.
If any components of products are added or deleted outside of vRealize Suite Lifecycle Manager,
inventory sync is used to update them. If a product password changed outside can be updated in
vRealize Suite Lifecycle Manager by syncing it with the inventory, but the request eventually fails.
However, you can provide the right password when you retry.
To change the root password of vRealize Operations Manager, then you have to create a root
password in the Locker and use the same to replace the vRealize Operations Manager root
password through vRealize Suite Lifecycle Manager. You need not change the root password in
the vRealize Operations Manager.
Also, if you modify the password directly in the application, for example, vRealize Operations
Manager then you should run the inventory sync of the product in vRealize Suite Lifecycle
Manager so that the modified passwords are synchronized with vRealize Suite Lifecycle Manager
again. This action prompts you to provide the modified passwords during an inventory sync.
You can sync your inventories for each product and for all the products across all environments.
n Instead of navigating into each product to synchronize your inventories, you can click the
horizontal ellipses on the product card and click Trigger Inventory Sync.
n If there are multiple environments and there are multiple products within an environment, you
can click the Trigger Inventory Sync on the Environment page. This triggers the inventory
sync on all the products in all environments.
n You can click the View Details of the product and then click the Trigger Inventory Sync. This
would trigger the inventory sync for the required product alone.
Product References
Starting from vRealize Suite Lifecycle Manager 8.1, product details has a new vertical tab named
Product References listing all inter-product integrations. For example: If product A is integrated
with product B or the other way, the View Details page of both product A and B has an entry in
Product References table, pointing reference to each other.
For vRealize Suite Lifecycle Manager, the table only shows VMware Identity Manager
Authentication Provider references. If a product, for example vRealize Automation is integrated
with global environment VMware Identity Manager and is using it as an authentication provider,
then both vRealize Automation and the global environment VMware Identity Manager will have a
reference linking each other in their View Details > Product References table.
The Product Reference entries are created when you create an environment and during an
Inventory Sync. If the expected product does not show up in the VMware Identity Manager
global environment Product Reference table, then validate if the Inventory Sync for the related
product is selected and is completed successfully.
In-case of global environment VMware Identity Manager, the Product References are used while
performing following day-2 operations:
n Enabling tenancy. Once tenancy is enabled, VMware Identity Manager can be accessed
only through tenant FQDNs. All the existing products or services currently integrated with
VMware Identity Manager must go for a re-register of VMware Identity Manager against its
primary tenant alias FQDN. While enabling tenancy, you are provided an option to choose all
the currently referenced products to opt-in for re-register.
With Manage Environments feature in the vRealize Suite Lifecycle Manager UI, a complete
inventory about each product is listed.
The Product References once found are later used in day-2 operations to ensure a life-cycle
operation performed on one product does not break the current integration with other product
that is linked and referenced.
To change the password, on the product card environment, click View Details > Change
Password.
The following table shows the different password change option available on the product details
page.
You can delete a product deployment from a vCenter Server. The Lifecycle Manager can delete
Product Integration in a given environment for the selected product, if it is done within Lifecycle
Manager while deploying products.
In case of an environment where products are imported, Lifecycle Manager does not gather
information about an existing product integration within products. Therefore, you can manually
remove the product integration while deleting products.
Prerequisites
Procedure
1 From the Environment home page, select any product instance and right-click on the vertical
ellipses.
Note When there are products that are internally integrated within a product, then verify
the integrations before deleting the product. However, Lifecycle Manager cannot remove the
external integrations in the products.
3 To delete all associated VMs from vCenter Server for the selected product, select the Delete
associated VMs check box.
4 If you want to delete windows machines, then select Delete associated Windows Machines
check box and click Delete.
Before you delete associated VMs from the vCenter Server on the Delete Product window,
review the list of VMs and then click Confirm Delete.
Results
The selected suite product and its associated VMs from an environment are deleted.
For replacing a vRealize Suite Lifecycle Manager VAMI/VA certificate, see Replace Certificate for
vRealize Suite Lifecycle Manager. For re-trust of Identity Manager, see Day 2 Operations with
Other Products in vRealize Suite Lifecycle Manager.
Prerequisites
Verify that a product has an existing certificate. You can either create or import a certificate in
the locker. For information on creating certificates, see Configure Certificate Within Locker.
Procedure
1 From the Environment page, select a product card and click on the vertical ellipses.
5 Select a certificate and review the certificate summary, and click Next.
6 To replace a VMware Identity Manager certificate, you must re-trust the products that are
already configured. Select the product instance here and click Next.
By default, all the products are listed under the Re-Trust Product Certificate wizard.
Note This options enables you to take snapshots for products which do not have certificate
rollback built-in. You can use this option to revert the snapshot in case of a failure to replace
a certificate. And this is only applicable for vRealize Business for Cloud, VMware Identity
Manager, and vRealize Network Insight.
If the replace certificate request has failed and you have selected to take a snapshot, then
you can set the revertToSnapshot flag to true and then submit the failed request to rollback
the operaton.
8 To validate the certificate information, click RUN PRECHECK and click Finish.
Prerequisites
n Verify that you have the vRealize Automation instance in vRealize Suite Lifecycle Manager.
n Ensure that you have added a license in the Locker. For more information on adding licenses,
see Configure License Within Locker.
Procedure
2 Select the Environments tab, and then click View Details for a vRealize product card.
3 Select the product options (...) icon, and then click Add License from the drop-down list. You
can view the list of current licenses.
4 Click Next .
5 Select a new license from the drop-down list, and then verify the license details.
6 (Optional) In vRealize Automation 8.0 and later releases, vRealize Operations Manager, and
vRealize Log Insight, you can delete the older licenses after selecting a new license. Select
the licenses to be removed under Terminate Licenses.
Note This option is applicable for vRealize Suite Lifecycle Manager 8.4.1 and later versions.
7 Click Finish.
The License requests can be tracked in the vRealize Suite Lifecycle Manager Requests tab.
What to do next
For more information on configuring the license, see Configure License Within Locker.
Health status information in vRealize Suite Lifecycle Manager is available only for vRealize
Suite Lifecycle Manager supported products: vRealize Automation, vRealize Operations Manager,
vRealize Log Insight, and vRealize Business for Cloud.
Prerequisites
Verify that you have a private cloud environment that contains VMware vRealize Operations
Manager. For information on adding to an existing environment, see Add a Product to an Existing
Cloud Environment. For information on creating an environment, see Creating a Private Cloud
Environment.
n View the SDDC Health Overview Dashboard in VMware vRealize Operations Manager
With vRealize Suite Lifecycle Manager, you can view detailed health status in vRealize
Operations Manager.
n Enable or Disable Health Check for Products in vRealize Suite Lifecycle Manager
Procedure
1 Configure vRealize Operations Manager with the VMware SDDC Management Health Solution
Management Pack. See VMware SDDC Management Health Solution microsite on the
VMware Solution Exchange.
2 Configure adapter instances for vRealize Log Insight, vRealize Business for Cloud, and
vRealize Automation in vRealize Operations Manager.
For information on configuring adapters in vRealize Operations Manager, see the following
topics:
3 If you have an instance of vRealize Automation in your environment, install End Point
Operations Management agents on all nodes on vRealize Automation applications and on
any new node added to the vRealize Automation cluster later.
Results
vRealize Suite Lifecycle Manager displays the health status of the vRealize Suite management
stack as provided by VMware SDDC Management Health Solution Management Pack.
vRealize Suite Lifecycle Manager retrieves health status information from one instance of vRealize
Operations Manager in a given private cloud environment. The health displayed applies only to
the vRealize Suite products configured in the target vRealize Operations Manager instance within
the private cloud environment. Do not configure additional vRealize Suite products from other
private cloud environments in the same instance of vRealize Operations Manager.
What to do next
View the health status of vRealize Suite in vRealize Suite Lifecycle Manager. See Health Status in
vRealize Suite Lifecycle Manager.
Color Status
Green vRealize Operations Manager is reporting health as Green, as per its policies, for all configured
products.
Yellow vRealize Operations Manager is reporting health as Yellow, as per its policies, for at least one
configured product.
Red vRealize Operations Manager is reporting health as Orange or Red, as per its policies, for at least
one configured product.
Health status in vRealize Suite Lifecycle Manager continues to display these colors, even when
you only partially configure vRealize Suite products in vRealize Operations Manager. vRealize
Suite Lifecycle Manager does not attempt to determine health status of vRealize Suite products
that are not configured in the private cloud environment.
Prerequisites
Verify that you have a valid VMware vRealize Operations Manager credentials or have VMware
Identity Manager configured.
Note For SDDC management pack 4.0, there is no requirement of installing End point agents for
vRealize Automation 7.4 and IaaS node.
Procedure
1 In vRealize Suite Lifecycle Manager, click the health status for the private cloud environment
to open the SDDC Health Overview Dashboard for the environment in VMware vRealize
Operations Manager.
2 In vRealize Suite Lifecycle Manager, click the health status for an individual product to open
the summary page for that product in VMware vRealize Operations Manager. For more
information, see the VMware Marketplace.
You can enable the health check option to check the health of an existing environment. You
can use this option on a scenario when you want to evaluate vRealize Suite Lifecycle Manager
environment with vRealize Operations Management Suite is installed along with SDDC MP.
This health check is only available on the vRealize Operations Manager instance with a SDDC
Management pack to monitor the health of the entire system.
This option first checks whether there is an environment to run at first place. Once the
health checks run, it checks if there is a SDDC management health solution available and then
verifies the last status of the health solution. A health check runs periodically at a scheduled
interval. When you want to avoid resource usage in development environments or production
environments, you might want to disable a health check.
Once the health check is disabled, the environment health is not evaluated anymore. A message
is displayed on the environment card, suggesting the user to enable health check to monitory
the health of environment. When a health check has run, you can see the current status of the
environment. If the status is ok and the data is fetched, then you can view a message on the card
as Health OK.
Marketplace contains content plugins for vRealize Orchestrator, including vRealize Automation
blueprints and OVAs, vRealize Operations Manager management packs, and vRealize Log Insight
content packs, that you can download and deploy in your vRealize Suite environments.
The VMware Marketplace displays the content details for the available vRealize Suite products.
The Available tab provides the Sync option, if you are syncing marketplace for the first time.
vRealize Suite Lifecycle Manager 8.1 supports vRealize Automation 7.6, OVA installation. Each
OVA are in GBs in Marketplace. If you want to download more OVAs from Marketplace then
increase the data folder size to avoid the Disk Full alert. OVAs in Marketplace have large file size.
If multiple OVAs are downloaded and to avoid disk storage alert, extend the storage from the
system settings page.
Prerequisites
Verify that you have performed an initial Marketplace sync to load Marketplace content. See
#unique_150.
Procedure
vRealize Suite Lifecycle Manager displays all content available for vRealize Suite in
Marketplace.
2 (Optional) To filter the list of available content by search terms, enter search terms into the
Search text box.
3 (Optional) To filter the list of available content by product, publisher, or technology, click
Filter and select the appropriate filters.
4 Click View Details for to learn more about the downloadable content, including what
products and version the content is compatible with, user ratings for the content, and a list of
related content.
Results
What to do next
Install the content you downloaded. See Install Downloaded Marketplace Content.
Procedure
vRealize Suite Lifecycle Manager displays all content downloaded to vRealize Suite Lifecycle
Manager from Marketplace.
2 If there is an update available for content, you can download a newer version of the content.
a Mouseover the notification icon in the upper left corner of the content tile to verify that
there is an available update.
If there are no notifications for the content, the notification icon does not appear.
If there is a newer version of the content available, vRealize Suite Lifecycle Manager
displays the message New version updates are available for the app.
b Click the three dots on the upper right corner of the content tile, and select Upgrade.
3 Click View Details to view information about the content, including related content and the
date the content was last modified.
Prerequisites
n Download the content to install from Marketplace. See Find and Download Content from
Marketplace.
n Verify that the environment which you are installing have the entitlement matching the
entitlement which the content supports.
Procedure
vRealize Suite Lifecycle Manager displays all content that has been downloaded to vRealize
Suite Lifecycle Manager from Marketplace.
2 Click the three dots in the upper right corner of the tile for the content to install, and click
Install.
3 Select the data center and environment to install the content, if you are installing a blueprint
or OVA in an vRealize Automation, and click Next.
vRealize Automation and vRealize Operations Management Suite contents are tagged with
license entitlements.
4 After selecting a data center and environment, select the tenant in which the content needs
to be installed and click Submit.
What to do next
Procedure
2 Click the vertical dots in the upper right corner of the tile for to delete and click Delete.
3 Click Yes.
Results
The content is deleted from vRealize Suite Lifecycle Manager and no longer appears under
downloaded content on the Marketplace page.
Migration of contents or versions is not supported from an older instance to vRealize Suite
Lifecycle Manager. The latest content version can be either source control or deploy to an
endpoint before moving to vRealize Suite Lifecycle Manager . So that the same content can be
re-captured from the endpoint in the new instance.
n All the endpoints are migrated along with source control user tokens.
Note When a cloud admin user gets a role of release manager or content developer, the cloud
admin can only view the content management app inside the vRealize Suite Lifecycle Manager.
But the cloud admin does not have permission to view other applications. Whereas a Release
manager and a content developer user can view the content management app. As a workaround,
you can perform all the cloud admin operations using cloud admin role only and do not provide
additional permission or role mapping.
You can use the content lifecycle management to dispense with the time-consuming and error-
prone manual processes required to manage the software-defined content. Supported content
includes entities from:
Source Control servers n GitHub Enterprise Server: 2.20.15, 2.19.21, 2.21.6, and 3.0
(GitHub Cloud is not supported)
n GitLab: 12.2.12 (Enterprise Edition), 12.7, and 12.8
n Bitbucket Server 6.10 and 7.0
n Bitbucket Cloud: Version 2.0
Content lifecycle management in vRealize Suite Lifecycle Manager is similar to content lifecycle
management with the vRealize Code Stream Management Pack for DevOps, with the following
differences.
n Updated Pipeline services: Advanced capability to manage content to work with source
control to support a multi-developer use case.
If there are dependencies between captured content packages, all the dependencies are
captured as first class objects in vRealize Suite Lifecycle Manager. Each content version shows all
its dependencies associated with it. For example, if a vRealize Automation Composite Blueprint
has a dependency on Property-Definition, there are two items in the content catalog, one for
each content package. With independent version control for each content package, you can
edit, capture, and release dependencies independently so that the content is never old. vRealize
Automation allows you to define multiple named value sets within the Size and Image component
profile types. You can add one or more of the value sets to machine components in a blueprint.
We cannot deploy or release Automation-Component Profiles in vRealize Suite Lifecycle Manager
to a target end point if the corresponding value set already exists on the end point.
n Managing Content
Content is a collection of files that contains definitions that represent software defined
services.
n Content Pipelines
Starting with vRealize Suite Lifecycle Manager 8.3, the Content Pipelines page is redesigned
to display the status of the content capture, test, and release of the content pipelines. You
can view all the content pipelines that are displayed in the completed, in progress, or failed
state.
You add a content endpoint to an environment to capture, test, deploy or check-in software-
defined content in the form of a content package. A content package is a file that contains
definitions for software-defined services, such as blueprints, templates, workflows, and so on.
Each content endpoint can support more than one type of content package. For example, a
vRealize Automation content endpoint can support both composite blueprints and software.
Content Lifecycle Management provides the following policies for vRealize Orchestrator, vRealize
Automation, vRealize Automation Cloud, vCenter Server, and vRealize Operations content
endpoints.
Policy Description
Allow content to be captured from this endpoint Allows you to capture content from this endpoint.
Allow unit tests to be run on this endpoint Allows you to release content for the endpoint and
run test workflows against the endpoint. A vRealize
Orchestrator marked as test endpoint also acts as unit
test server.
Allow releasing content packages to this endpoint Allows you to release content for the endpoint.
Source controlled content only Allows you to release only source controlled content to
the endpoint.
Policy Description
Enable code review This policy applies only to the source control endpoints.
Allows a manual review for the developers. vRealize Suite
Lifecycle Manager content lifecycle management creates
a branch with changes that require a code review. A code
reviewer accepts or rejects the merge request into the
branch of the respective source control.
Enable vCenter template support Requests you for information required for deploying
templates. This option is available only when you mark a
vCenter server as production endpoint.
Prerequisites
If you are using this vRealize Orchestrator endpoint for unit testing, verify that the vRealize
Orchestrator instance has been configured as a unit test server.
Procedure
For an Orchestrator content, you can capture workflows, configuration elements, and actions
individually or in a folder where they reside.
Note If a folder is captured, a temporary content name starting with [FOLDER] is displayed.
You can start a Content Pipeline to capture all content, this is then added to the vRealize
Orchestrator Package provided as input.
a In the Name text box, enter a unique name for the endpoint.
b In the Tags text box, enter tags associated with the endpoint.
Using tags allow you to deploy content to multiple endpoints at the same time. When you
deploy content, you can select a tag instead of individual content endpoint names, and
the content deploys to all endpoints that have that tag.
To add multiple tags, press Enter after you enter each tag.
c In the Sever FQDN/IP field, enter the fully qualified server name, IP address, or host name
for the content endpoint server.
If the vRealize Orchestrator instance is not embedded in vRealize Automation, include the
port number in the server FQDN/IP. Typically the port number is 8281. The port number
8281 is required for vRealize Orchestrator 7.x versions. For vRealize Orchestrator 8.x and
above, the port is not required.
vRO-Server-FQDN:Port
d Enter a user name and password to use to access this content endpoint.
If the connection test fails, verify that the information you entered for the content endpoint is
correct and try again.
The vRealize Orchestrator package can be captured from an endpoint and is associated with
the content endpoint. Mark the version as Production ready. Selection of a vRO package is
a post deployment capability that imports the package once any other content has been
deployed allowing maintained localized or regional settings.
n A vRO package name cannot contain special characters and can cause issues when you
capture, release or check-in a content. If you have a vRO package name with a space in
between the name, then the space is converted to an underscore (_) during a capture
and fails during a test and deploy.
7 Select the appropriate policies for the content endpoint, and click Next. For more information
on policies, refer to the policy table provided in Working with Endpoints.
8 Verify that the content endpoint details are correct, and click Submit.
Prerequisites
Verify that you have added at least one vRealize Automation endpoint.
Note If the vRealize Orchestrator is embedded, then there is no need of a separate instance of
vRealize Orchestrator endpoint. vRealize Orchestrator endpoint creation is needed only if you are
using an external vRealize Orchestrator endpoint for vRealize Automation.
Procedure
3 Click Automation.
b Select the product version of the endpoint from the Endpoint Version drop-down menu.
With tags, you can deploy content to multiple endpoints at the same time. When you
deploy content, you can select a tag instead of individual content endpoint names, and
the content deploys to all endpoints that have that tag.
To add multiple tags, press Enter after you enter each tag.
d In the Sever FQDN/IP field, enter the fully qualified server name, IP address, or host name
for the content endpoint server.
While adding an endpoint for a particular tenant, tenant based FQDN has to be used as
a server. However, for a system based domain, user FQDN without a tenant should be
used.
IP addresses are not supported while adding vRealize Automation 8.x endpoints.
e Enter a tenant name, user name, and password to use to access this content endpoint.
If the connection test fails, verify that the information you entered for the content endpoint is
correct and try again.
6 Click Next.
7 Select the appropriate policies for the content endpoint, and click Next. For more information
on policies, refer to the policy table provided in Working with Endpoints.
8 Verify that the content endpoint details are correct, and click Submit.
4 Enter the endpoint details for the vRealize Automation Cloud endpoint.
b In the Tags field, enter tags associated with the endpoint, so that you can deploy content
to multiple endpoints at the same time. When you deploy content, you can select a tag
instead of individual content endpoint names. The content deploys all endpoints that have
the selected tag. When you want to add multiple tags, press Enter after you enter each
tag.
d In the vRO Server Endpoint field, select External vRO or vRA Cloud Extensibility
appliance.
e To associate a vRO Server, select a vRealize Orchestrator (vRO) endpoint from the drop-
down menu.
5 To test the connection to the content endpoint, click TEST CONNECTION. If the connection
test fails, verify that the information you entered for the content endpoint is correct, and then
retry.
6 Click Next.
7 Under Policy Settings, select the appropriate vRealize Orchestrator Package policy for the
content endpoint, and click Next. For more information on policies, refer to the policy table
provided in Working with Endpoints.
8 Verify that the content endpoint details are correct, and then click Submit.
Prerequisites
n Generate an API refresh token. For detailed information on generating API tokens, refer to
VMware Cloud Services.
You can have any number of source control repositories and branches added to vRealize Suite
Lifecycle Manager. Adding a source control branch allows you to check in and check out the
SDDC content.
Prerequisites
n Verify that a vRealize Suite Lifecycle Manager administrator has added a system source
control server under Content Settings.
n Verify that a developer has entered the GitLab access token to the source control server so
that they can check-in and check out content.
Note Previously, primary workspaces was supported for Bitbucket Cloud. Starting from
vRealize Suite Lifecycle Manager 8.6.1, multiple workspaces is also supported for Bitbucket
Cloud.
Procedure
4 Select the configured Source Control Server (Bitbucket Server, Bitbucket cloud, GitLab, or
GitHub).
a In the Name text box, enter a unique name for the endpoint.
c Enter the Branch and Repository Name to use for the content endpoint in the
following format: For GitLab, enter group_name/repository_name, Bitbucket server, enter
project_name/repository_name and for a Bitbucket cloud, enter repository_name if
you are using primary workspace or workspace_name/repository_name if you are using
multiple workspace.
Note In bit bucket cloud, you can only create a repository and use the repository name.
The source control endpoint with a repository must be initialized with any file. GitLab and
bit bucket cloud already have a provision to add the file but the bit bucket server does not.
With Lifecycle Manager 2.1, cluster and elastic search instance for multi developer story is not
supported for bit bucket server.
7 Select the appropriate policies for this content endpoint, and click Next.
Policy Description
Enable code review Allows a manual review between developers. vRealize Suite Lifecycle
Manager content lifecycle management creates a branch with the changes
that require a code review. A code reviewer can accept or reject the merge
request into the branch.
8 Verify that the content endpoint details are correct, and click Submit.
Prerequisites
Verify that you have added at least one vCenter endpoint in the Content Settings > vSphere
Template Repository .
Procedure
a In the Name text box, enter a unique name for the endpoint.
b In the Tags text box, enter tags associated with the endpoint.
Using tags allow you to deploy a content to multiple endpoints at the same time. When
you deploy a content, you can select a tag instead of individual content endpoint names,
and the content deploys to all endpoints that have that tag. To add multiple tags, press
Enter after you enter each tag.
5 In the Server FQDN/IP text box, enter the fully qualified server name, IP address, or host
name for the content endpoint server.
8 Select the appropriate policies for the content endpoint. For more information on policies,
refer to the policy table provided in Working with Endpoints.
10 Click Next.
vCenter Server settings can be added to an LCM data center, once vCenter data collection is
competed this endpoint is seen when importing from LCM and reduces the time to fill in the
form as all the properties have been collected. Except the Virtual Machine folder path that is
provides in the format /Templates/MyTemplates/ is not imported.
Once the endpoint is created, it validates if the configuration is correct. It can connect
through API and that the configuration of the local subscriber details is setup to point to
the publisher as defined in Content Settings/vSphere Template Repository. If there is
a problem, then the endpoint is disabled and an error is displayed when you cover of the
warning.
Prerequisites
n Verify all vRealize Operations Manager instances contain the same management packs
installed and the required adapter instances configured.
n Dashboards that are configured to refer specific objects, for example, vCenter VM, Host or
Datastore are not used on the release endpoint until they are manually edited to update the
reference to a specific object.
Note Some content may not release between different versions of vRealize Operations Manager
where a content from 6.6 to 6.7, some content types may fail.
Procedure
4 Enter the information for the vRealize Operations Manager content endpoint.
b Enter a tag name so that endpoint can use them to test or capture.
f Click Test Connection and once the connection is established, click Next. For more
information on creating an SSH user on the vRealize Operations Manager instance, see
Create an SSH User in vRealize Operations Manager.
5 Under the Policy Settings, select the required options to capture, test, or mark as production.
For more information on policies, refer to the policy table provided in Working with
Endpoints.
6 Verify that the content endpoint details are correct, and click Submit.
1 When you are selecting a Root as an SSH user from the content endpoint, create a user on
the vRealize Operations Manager appliance. The user must have a SSH access and belong to
the user group root and with a valid home directory.
2 Log into the vRealize Operations Manager appliance as a root user and create user on the
vRealize Operations Manager appliance using below command. useradd sshuser.
3 Configure user groups for the created user - usermod -G root,wheel sshuser
mkdir /home/sshuser"
"chown sshuser /home/sshuser"
Note Use OPS-CLI for most of the vRealize Operations Manager contents to export or import a
content capture or release in vRealize Suite Lifecycle Manager.
Procedure
2 Under Endpoints, click the vertical ellipses to the left of the endpoint, and select Delete.
3 Click OK.
All content endpoint values can be edited apart from the name, which is used across various
logs.
Note When vRealize Suite Lifecycle Manager deploys a vRA instance or a vRA instance is
imported into vRealize Suite Lifecycle Manager, then content management services imports
Content endpoints (per tenant) automatically through a data collection process. By default, all
policies are disabled so you must edit the endpoint and assign appropriate content policies. Only
certain set of users can edit a content endpoint, for more information on roles, see Content
Actions.
Procedure
2 Under Endpoints, click the vertical ellipses to the left of the endpoint, and select Edit.
3 Edit the endpoint details you want to change, and click Next.
4 Edit the endpoint policy settings you want to change, and click Next.
5 Verify that the content endpoint details are correct, and click Submit.
Managing Content
Content is a collection of files that contains definitions that represent software defined services.
After you add a content endpoint to one or more environments, you can manage the software-
defined content that each environment contains. You can use vRealize Suite Lifecycle Manager to
perform the following operations on content:
n Check-in content
For example, a YAML file for a vRealize Automation blueprint or an XML file for a vRealize
Orchestrator workflow. Content is linked together so that when you capture a vRealize
Automation blueprint, all dependencies are also displayed in the content catalog, and they can
each have their own versions. vRealize Suite Lifecycle Manager displays dependency information
within each content version. The / Characters cannot be used in the name for Topology or Text
ResourceKind Metrics as the export fails.
vRealize Suite Lifecycle Manager does not support an Azure machine in content management for
testing and releasing content. XaaS blueprint "Azure Machine" is shipped by default with vRealize
Automation. However, transfer of XaaS blueprint between vRealize Automation environments is
not supported.
n Add Content
You can add content from an existing content endpoint.
n Content Actions
After you capture a content, you can perform and view the activity of a content.
n Searching Content
You can search an existing content based on certain defined entries within the UI.
n Test Content
You can test content to ensure it is ready for release.
n Source Control with vRealize Suite Lifecycle Manager Content Lifecycle Management
vRealize Suite Lifecycle Manager content lifecycle management integrates natively into a
defined GitLab and Bitbucket branch endpoint to provide source control for content.
Add Content
You can add content from an existing content endpoint.
Prerequisites
Procedure
If a version has already been captured, a content can be added either with the Add Content
button or with an inline capture.
3 Select test or deploy the content package in addition to capturing it, and click PROCEED.
a From the Select Capture Endpoint drop-down menu, you can either select one or
multiple content types to capture content.
b Enter a tag name and select Include all dependencies to capture any dependencies
associated with the content.
c Enter the vRO Package Name. Any spaces in the name are replaced with an _ underscore
character and a vRO package name.
The vRO Package Name is applicable only for vRealize Orchestrator or vRealize
Automation content having some vRealize Orchestrator dependencies. The field is used
for managing vRealize Orchestrator contents in an efficient way. If you provide any new
name,then all the vRealize Orchestrator contents will be merged to one package. If you
select an existing name from the drop-down menu, then a new version of the package will
be created and merges all vRealize Orchestrator contents to the version. If there exists
a package version already from that endpoint, the new version will have old contents in
the previous version with new contents. This helps you to work incrementally on vRealize
Orchestrator contents.
If the vRealize Orchestrator package is not captured prior from a given content endpoint,
then a new version is created but the content might not be the same as the previous
version. Deploy the added vRealize Orchestrator package to the vRealize Orchestrator
content endpoint first to append the content. If you do not enter any package name, then
the name of the vRealize Orchestrator package matches to the content that is captured
with an added "-vro" as part of the name. All the discovered and captured vRealize
Orchestrator content, including individual workflows in the content files, appears in the
vRealize Orchestrator package that is created.
d If the content is ready for production, select Mark this version as production ready.
f Click Next.
Note When you list the content for the first time for an endpoint, the UI retrieves the content
from the endpoint. However, once you have captured then the content is cached and an auto
refresh of content list runs in the background every 30 minutes. You can select the Get latest
content option to retrieve the content in between this time.
This option appears only if you chose to test the content package.
a Select one or more content endpoints to specify the environments to run tests on.
b Select Deploy Content to deploy the content in the endpoint before running tests.
c Select Stop test deployment on first failure to stop the test deployment when it
encounters an error.
d Select Run unit tests to run available unit tests on the content.
e Select Stop unit tests on first failure to stop testing if any unit test fails.
f Select a server to run unit tests on from the Select a Unit Test Server drop-down menu.
You must have a vRealize Orchestrator test package imported to use a unit test server.
g Click Next.
This option appears only if you chose to check-in the content package.
a Select one or more content endpoints from the Select Release Endpoints drop-down
menu to specify the production environments where the system releases the content.
7 Click SUBMIT.
If you have selected a single content capture, then you can view a single content pipeline. If
you have selected multiple content capture, then you can see the individual capture pipelines
triggered for each of the content.
Prerequisites
Verify that you have a content item already available in the content list.
Procedure
When you delete the content item, the associated content versions are also deleted. If there
is more than one content item, then you can select all and click delete. You can perform the
multi-delete operation for upto 15 content items.
Procedure
2 Under Content, click the name of the content package to capture and click CAPTURE.
3 From the Select Capture Endpoint drop-down menu, select the content endpoint to capture
from.
4 Select Include all dependencies to capture any dependencies associated with the content.
5 If the content is ready for production, select Mark this version as production ready.
6 Enter a description for this content version in the Comments field, and click CAPTURE.
Content Actions
After you capture a content, you can perform and view the activity of a content.
Deploying a Content
Content Settings Role Expected Behavior
Content version is production ready Release Manager You can view only production endpoints.
Content version is production ready Developer You can test endpoints that have the Test policy set, and
it cannot include the Production policy.
Content version is NOT marked as Release Manager You can view the test endpoints that have the Test policy
production ready Developer set.
Content version is NOT marked as Release Manager You can view the content endpoints that do not have the
SourceControlled Developer Source Control policy set on the content endpoint.
Content version is marked as Release Manager All the content endpoints are displayed based on other
SourceControlled Developer conditions in this table.
Managing Tags
Tags can be managed at a given version to navigate content within the UI. These tags can
be useful as a grouping mechanism when future capability of releasing all content by tag is
supported.
Content Types
Table 5-2. vSphere Content Endpoint
Automation-CloudTemplate (vRealize vRealize Suite Lifecycle Manager 8.1 Captures a vRealize Automation
Automation 8.2 release. For vRealize and later versions. composite blueprint to deploy virtual
Automation 8.1 and earlier releases, machines managed by vRealize
the content type was known as Automation.
Automation-CompositeBlueprint)
Automation-PolicyDefinition (vRealize vRealize Suite Lifecycle Manager 8.1 Captures a vRealize Automation
Automation 8.0 and later releases. and later versions. property definition for specifying
Prior to vRealize Automation 8.0 custom properties.
release, the content type was known
as Automation- PropertyDefinition)
Automation-XaaSBlueprint vRealize Suite Lifecycle Manager 8.1 Captures vRealize Automation XaaS
and later versions. blueprints.
Automation-CustomResource (In vRealize Suite Lifecycle Manager 8.2 Captures vRealize Automation
vRealize Suite Lifecycle Manager and later versions. Resource Type
8.2, the content type is known as
Automation-Resource Type)
Automation-ABXAction vRealize Suite Lifecycle Manager 8.3 Captures, tests, and releases vRealize
and later versions. Automation ABXActions.
Automation-XaaSBlueprint vRealize Suite Lifecycle Manager 8.3. Captures vRealize Automation XaaS
blueprints.
Automation-ABXAction vRealize Suite Lifecycle Manager 8.3. Captures, tests, and releases vRealize
Automation ABXActions.
Note The naming convention for vRealize Automation 8.x content type may change for the
vRealize Suite Lifecycle Manager 8.3 release.
Automation- Componentprofile vRealize Suite Lifecycle Manager 2.1 Captures a vRealize Automation
and later versions. component profile.
Automation- PropertyDefinition vRealize Suite Lifecycle Manager 2.1 Captures a vRealize Automation
and later versions. property definition for specifying
custom properties.
Operations Alert vRealize Operations Manager Captures vRealize Operations alerts containing
6.6.1+ symptom definitions and recommendations that
are used to evaluate conditions and generate
alerts.
Operations-SuperMetric vRealize Operations Manager Integrates vRealize Operations super metric data
6.6.1+ definition that is used to track combinations
of metrics. After releasing Super Metrics,
assigning the one or more object types
and enabling the super metric in policies
are still required. All vRealize Operations
package types also support .Super Metrics, which
means dashboards, alerts, vIews, and metric
configurations automatically point to the correct
super metric at the time of release.
Operations- vRealize Operations Manager Reads text from a Web page or text file. You
TextWidgetContent 6.6.1+ specify the URL of the Web page or the name of
the text file when you configure the Text widget.
Operations- TopoWidgetConfig vRealize Operations Manager Captures the structure of the topography around
6.6.1+ a specific resource, including parent and child
resources.
Operations-View vRealize Operations Manager Captures vRealize Operations views that help you
6.6.1+ to interpret metrics, properties, and policies of
various monitored objects.
Note Ensure that Orchestrator-RestHost is available in the target vRealize Orchestrator prior to
capturing or deploying Orchestrator-RestOperation.
Searching Content
You can search an existing content based on certain defined entries within the UI.
n Content dependencies and dependency files can be seen by clicking the version and looking
at the DEPENDENCIES tab.
n By clicking each file, you can download it from the content repository within vRealize Suite
Lifecycle Manager.
Test Content
You can test content to ensure it is ready for release.
Prerequisites
Verify that the content package has been added to vRealize Suite Lifecycle Manager.
Procedure
3 Click the three horizontal dots to the right of the version to test, and select Test.
4 Select one or more content endpoints to specify the environments to run tests on.
5 Select Deploy Content to deploy the content in the endpoint before running tests.
6 Select Stop test deployment on first failure to stop the test deployment as soon as it
encounters an error.
7 Select Run unit tests to run available unit tests on the content.
8 Select Stop unit tests on first failure to stop testing if any unit test fails.
9 Select Include all dependencies to include all dependencies associated with the content
package in the tests.
10 Select Release Latest Dependencies to release the latest versions of the dependencies
associated with the content package.
11 Select a server to run unit tests on from the Select a Unit Test Server drop-down menu, and
click PROCEED.
n Test endpoint
The server is a staging environment in which you can deploy the contents and run unit tests
against the deployed contents to the environment.
Common Tests
If you go to the unit test server (vRO), under the Content Management Tests, you can view
separate folders for all content types. For each content type folder, there is a common folder
present where you see all the common workflows that are run for a given content type.
Specific tests can be run per content name as well. For example, if an Automation-
XaaSBlueprint content called "Add AD User" requests a unit test called "Add AD User - Test
1" can be created, which can connect to a given Content endpoint, and run the XaaS Blueprint
and wait to see if it was successful. The format of tests is:
Whenever you select the unit server while testing content, the new unit tests is also run
based on the content type against the deployed content in a test endpoint.
n Common unit tests workflows can be written under common folder per content type
n Unit test workflow for a given content can be written under <Content Type> and name the
workflow as <Content name> - <Tests name>.
n If there is a test failure, then the test displays an error from a workflow.
Sample Workflows
You can refer to the existing unit workflows available in their vRealize Orchestrator (policy set to
test). Navigate to a common folder in vRealize Orchestrator, Workflows > Content Management
Tests > Content Type > Common.
Input properties available for a unit test workflow that is provided by the platform.
You can store content in both the vRealize Suite Lifecycle Manager version-controlled repository
and a GitLab or Bitbucket branch. This allows developers to work together to check in and check
out content, and to code review changes prior to deploying to test or production environments.
vRealize Suite Lifecycle Manager stores all source control commit hashes for the purpose of
check in, so the correct state of content is known. This enables multi-developer support, which
reduces the risk of overwriting content and reduces the number of merge conflicts that can
occur.
To use source control in vRealize Suite Lifecycle Manager, you must meet the following
prerequisites:
n Verify that you have a GitLab or Bitbucket server. If you do not have an existing GitLab
server, you can use the Gitlab-CE free docker container.
n Verify that at least one vRealize Suite Lifecycle Manager user has access to GitLab or
Bitbucket.
n Create a branch in GitLab and apply the necessary permissions in GitLab for other developers
to check in and check out content to the branch.
n The GitLab user must create an access token in GitLab and store the token against the GitLab
instance under vRealize Suite Lifecycle Manager Content Settings.
It is a best practice when each time the content is checked in to source control, and new version
should be checked out and deployed to a content endpoint. This saves the latest changes from
other developers (effective rebase of the content) and also communicates to the vRealize Suite
Lifecycle Manager content services which GIT Commit Hash is deployed to which content per
endpoint. However, when you are capturing content from GitLab server, the checkout works
if you are using the GitLab version 11.6.5 or earlier. The checkout fails if you are using GitLab
version higher than 11.6.5.
Ref:
Commit #2
Dependencies
Source Content 2 (version y)
control Content 1
branch (version x)
dependencies
Content 3 (version z)
Ref:
Commit #1
Ref:
Commit
Commit #2
Hash
Ref:
Commit #2
Commit #2 Dependencies
Content 5 (version y)
Content 4
Commit #1 (version x)
Dependencies
Content 6 (version z)
Ref:
Commit #1
Ref:
Commit #2
Prerequisites
Verify that you have added a source control endpoint to vRealize Suite Lifecycle Manager. See
Source Control with vRealize Suite Lifecycle Manager Content Lifecycle Management for source
control requirements.
Note We support a single content check-in, with a maximum of 1000 files at a time.
Procedure
4 Click the three vertical dots to the right of the version to check in, and select Checkin.
6 Select Include all dependencies to include all dependencies associated with the content
package in the check-in.
7 Add a descriptive comment in the Comment field, and click CHECK IN.
When checking in a vRO package, there is an optional capability to merge with an existing
vRO package that exists in the source control. This ensures that all files that are captured
are checked into the path of the selected package (ultimately merged). If you do not see the
package, then Select the Source Control Endpoint > Orchestrator-Package type, refresh the
cache and check- in to view the vRO package in which it needs to be merged. You have the
following new features added when you check in an Orchestrator package:
n As part of the dependency management, you can remove dependency from a content
version.
For a vRealize Automation content check-in, you can merge directly on GitLab. You can
check out without dependency or check out with dependency, where you can perform the
following:
n You can remove the package dependency from the latest version. For example, if you
have performed a vRealize Automation content check in with dependency and enabled
the option to merge the dependent Orchestrator-Package to an uber package directly
on GitLab. When you check-out the same Automation content with dependency from a
source control.
Results
If a code review is disabled on the source control branch, the content is auto merged.
What to do next
If a code review is enabled on the source control branch, you or another code reviewer must
check the content in to GitLab manually after the code review is complete. After you check the
content into GitLab, capture the latest content version from the source control server in vRealize
Suite Lifecycle Manager.
If you are continuing to develop on your content endpoint, capture the latest content version
from source control and deploy it to your development content endpoint. This updates the
content endpoint so that the content is in sync with the source control and subsequent check-ins
are valid.
Prerequisites
Verify that the content has been checked in to the source control endpoint. See Check in Content
to a Source Control Endpoint.
Procedure
3 Choose whether to test or deploy the content package in addition to capturing it, and click
PROCEED.
a From the Select Capture Endpoint drop-down menu, select the source control endpoint
to capture content from.
b Select Get the latest content to retrieve the latest content dependencies rather than the
dependencies the content was initially captured with.
d Select Include all dependencies to capture any dependencies associated with the
content.
Dependencies are stored in vRealize Suite Lifecycle Manager, not the source control
endpoint.
e If the content is ready for production, select Mark this version as production ready.
g Click Next.
This option appears only if you selected to test the content package.
a Select one or more content endpoints to specify the environments to run tests on.
b Select Deploy Content to deploy the content in the endpoint before running tests.
c Select Stop test deployment on first failure to stop the test deployment as soon as it
encounters an error.
d Select Run unit tests to run available unit tests on the content.
e Select Stop unit tests on first failure to stop testing if any unit test fails.
f Select a server to run unit tests on from the Select a Unit Test Server drop-down menu.
You must have a vRealize Orchestrator test package imported to use a unit test server.
g Click Next.
This option appears only if you chose to test the content package.
a Select one or more content endpoints from the Select Release Endpoints drop-down
menu to specify the production environments where the system releases the content.
b Select Stop release deployment on first failure to stop deployment as soon as the
system encounters a failure.
c Enter a comment that explains why the content is being released in the Release
Comment field as writing comments are mandatory.
7 Click SUBMIT.
Results
vRealize Suite Lifecycle Manager captures the content from the source control endpoint
and creates a new version of the content in the content catalog. This version is marked
SourceControl Enabled, which tells vRealize Suite Lifecycle Manager the state of the content
when deploying to a content endpoint so the content is checked in against the right point in time.
What to do next
If you are using source control and have multiple capture content endpoints, only deploy content
from the content catalog is marked SourceControl Enabled. This communicates the state of the
content when deploying to a content endpoint so the content is checked in against the right
point in time.
Prerequisites
n Verify that the production environment has been added as a content endpoint.
Procedure
2 Click Content and click the name of the content package to deploy.
4 Select one or more content endpoints from the Select Release Endpoints drop-down menu
to specify the production environments where the system releases the content.
5 Select Stop release deployment on first failure to stop a deployment as soon as the system
encounters a failure.
6 Select Include all dependencies to deploy all dependencies associated with the content
package.
7 Select Release Latest Dependencies to release the latest versions of the dependencies
associated with the content package.
8 Enter a comment that explains why the content is being released in the Release Comment
field, and click PROCEED.
Multi contents are selected as part of a multi release request. Failure to deploy one of the
selected contents, will not roll back deployed contents which are part of that request.
Procedure
4 Under the Content Filter section, you can filter by a single tag or multiple tags, Type,
Endpoint, and Policy to get to a subset of the content you want to view and deploy.
Content Types This section lists the Content category based on the content type.
Content Endpoints This section lists all the associated Content Endpoints.
5 After you select a content filter, you can add a tag and then click Apply.
A tag is associated when a content is created. A tag-based filter is useful when you want to
search. However, you can still add the tag even after creating content. You can also manage
bulk tags for all content and older versions.
Developers can only view their filters and release managers can view all other RM filters. The
saved filters can be edited or deleted.
After you set the content filters, the default content view changes to Content Version List.
When you provide a filter, you can locate a specific version of the content, for example,
Production Ready Content with a specific tag and of a specific set of content types. For
example, display only vSphere templates, vRealize Operations Manager dashboards and
vRealize Automation Blueprints.
Note With Lifecycle Manager 8.0, you can now check-in multiple content after filtering and
selecting contents. When you are performing a multi-capture, test and release, verify that
all the capture is successful because if one of the content capture fails, the entire content
pipeline is marked as failed. Based on multi-capture pipeline failure, you cannot move to the
next step of testing and releasing a pipeline.
b if you want to capture all the dependencies, select Include all Dependencies and merge
the vRO package, if required.
c Click Check-in.
Note Orchestrator endpoints are assumed by their parent automation instance. If there are
standalone Orchestrator endpoints configured, then you can also deploy them.
Prerequisites
Procedure
2 Click Content and click the name of the content package to delete.
3 Click the three horizontal dots to the right of the version and select Delete.
4 Click OK.
n When transferring a customization spec between vCenter servers the password fields cannot
be decrypted by the target. This causes deployments that depend on custom specs with
passwords to fail. You can manually enter the correct value in the Administrator password
field after customization spec is deployed by the Lifecycle Manager pipeline.
n Content release from different versions of vRealize Operations Manager may fail. For
example, content from 6.6 to 6.7 some content types may fail.
n A pipeline execution with a large number of captures or check-ins may fail, if the number of
executions is higher than that supported by the endpoint type. For example, bitbucket cloud
can support 1000 accesses per hour to its respository.
By enabling access source control, you can add an endpoint for a source control. For information
on adding a source control, see Add a Source Control Server Endpoint. Release manager can add
a source control server. But any developer logged-in to vRealize Suite Lifecycle Manager has to
associate their token to the server to access the source control server.
When you disable the file editor option then the bitbucket API (PUT/POST) does not work for
an admin or a developer. Either do not include the below property (feature.file.editor) in the
property files or if this is included then ensure that the property is set to true.
Location:
<base_directory>\Atlassian\ApplicationData\Bitbucket\shared\bitbucket.propert
ies
Properties: feature.file.editor=true
Prerequisites
n Verify that you have a Bitbucket, GitHub or a GitLab instance that is supported for this
version of vRealize Suite Lifecycle Manager. For more information on the supported versions
of Bitbucket, GitHub, or GitLab, refer to Content Lifecycle Management.
n Log in to GitHub, GitLab or Bitbucket, and generate an access token for your user with all
scopes enabled. Copy and save this one-time token from GitHub, GitLab or Bitbucket.
n Log in to GitHub, GitLab or Bitbucket and verify you have group, project and branch created
in GitHub, GitLab or Bitbucket before adding it as a source control endpoint.
Procedure
3 On the Source Control Access tab, click ADD SOURCE CONTROL SERVER.
Note With vRealize Suite Lifecycle Manager 8.0, you can now select Bitbucket Server or
Bitbucket Cloud.
5 Enter the IP address or fully qualified domain name of the server, and click SUBMIT.
vRealize Suite Lifecycle Manager uses https scheme for any Source Control APIs by
default. If you have not enabled https on the GitLab instance, then specify http://<ip
address>:<port> in the source control server under the content settings page to change
the scheme. When you create source control endpoint, the repository must be specified
in <GroupName>/<ProjectName> form. Whenever multiple developers are working on the
bit bucket repository then the performance is slow in the bit bucket enterprise version.
Therefore, you can use at least 4 vCPU machine of bit bucket.
7 Enter your GitLab or Bitbucket server access token in the ACCESS KEY text box, and click
SUBMIT.
a For a GitHub instance, you can either select to enter the credential of the Github instance
by providing the user name and password or enter the access token.
b Click SUBMIT.
An access token is a unique identity for a user to perform check-in or check-out to track the
GitLab or GitHub API. To create an access token for GitLab or GitHub, access the GitLab or
GitHub Server URL. For example, gitlab.example.com or github.com. For Bitbucket Server and
Cloud, browse to bitbucket.org and navigate to App Passwords to create a password with full
permissions.
Prerequisites
Verify that the source control server endpoint is not being used by any content endpoints.
Procedure
3 On the Source Control Access tab, click the trash icon for the source control server endpoint
to delete.
4 Click OK.
Note You can add multiple server names for a source control server endpoint and only GitLab
source control is supported for this version.
1 Create the Content Library (Publisher): The vSphere Template Repository points to a Content
Library that is set up for publishing. For more details on how to setup a publisher Content
Library, see vCenter Documentation.
2 Create Content Library Subscribers: Each vCenter server that opts for a template support
requires a Content Library to be configured which will Subscribe to the Published Library
configured in Step 1. The following settings are required:
Setting Description
Automatic You can enable this setting for automatic synchronization of the template metadata.
Synchronization
Subscription URL This URL contains details about the publishers lib.json file. This will be available when you
create a publisher in Step 1.
Setting Description
Library content n Download all library immediately - If you don't select this option then vCenter will
download ALL virtual machine templates.
n Download library content only when needed - Only the metadata is downloaded (not
the disks). vRealize Suite Lifecycle Manager instructs on demand and as requested to
download the associated disks
Developer Restrictions
Content tags are useful for a variety of reasons, to locate content within the UI, that is when
you find all content with "BugFix-Task-1" tag or can be used for custom business logic during the
release pipeline.
An example of this may be custom business logic implemented by a release manager - Don't
Deploy Content to Endpoint B unless the Content has been deployed to Endpoint B, first this
requires a custom pipeline/workflow to be implemented. If this rule is to be bypassed, for
example, for Release Mangers to push Content straight to Endpoint B then a tag could be applied
to the content. This tag should only be added by a Release Manager and not a Developer.
To associate a tag to a vRealize Orchestrator workflow, the global custom tag name of workflow
and value can either be manually edited to include vRSLCM_CUSTOM or the ‘/Library/Tagging/
Tag’ workflow can also be used for the tagging. Migration of pre and post stubs are not
supported.
Prerequisites
Ensure that all the Orchestrator endpoints whose workflows are to be used in the pre or post
stubs are added in vRealize Suite Lifecycle Manager and that the workflows which are to be used
in the stubs are tagged with vRSLCM_CUSTOM keyword.
Procedure
The Proxy Mapping tab displays the proxy status, and configuration details such as proxy server
hostname and port.
Note You can use the proxy settings for the source control endpoints only.
You can enable the proxy for an SCM instance by selecting it from the list of servers and clicking
Update. Once the proxy is enabled for any of the SCM servers the administrator cannot remove
the proxy from the vRealize Suite Lifecycle Manager setting page. To remove the proxy, disable
the proxy mapping for all SCM servers and then proceed with the removal of proxy from the
vRealize Suite Lifecycle Manager setting page. You can disable proxy mapping for an SCM server
by selecting it again and clicking Update. The administrator can confirm that the proxy is not
used by any of the servers from the status of vRealize Suite Lifecycle Manager Proxy used by
Content Management.
If you notice that the proxy is not enabled, then navigate to Locker > Proxy, and select the
Configure Proxy check box. For more information, see Configure Your Proxy Settings. Only
a Release Manager and the administrator has the privileges to access the Proxy mapping in
vRealize Suite Lifecycle Manager.
Pipeline Stubs
The pipeline stubs display the status of each action whenever a content is captured. The content
pipeline has the following status types whenever a content is run.
n Pre-Capture
n Capture
n Post- Capture
n Pre-Test
n Test
n Post-Test
n Pre-Deploy/Checkin
n Deploy/Check-in
n Post-Deploy/Check-In
In the last three stages, the term Check-in is used if the content is released to a source control
endpoint such as Git or BitBucket else the term deploy is used. By default, the pre or post
stages are disabled and should be configured before they can be used in an execution. The
configuration and various modes of execution for pre or post stages, also called pre or post
stubs, are covered under the configure pipeline stubs section. The capture pipeline will always
have a single stage, that is Capture. The corresponding details of the pre or post capture can be
viewed in the associated content pipeline, also referred as the parent pipeline.
The Executions tab lists all the content and capture pipeline executions. The list shows the status,
time taken, executed by and time of the request for each of the executions. This list can be
filtered by the type of pipeline and execution status.
Each pipeline consists up of various Stages, each stage then can have various Tasks. Tasks can
be either parallel or sequential based on your custom business logic. After selecting an action
that you want to perform on a content, a content capture can list various types of status related
to such an action. Each of the content settings is related to the view displayed on the Content
Pipeline page.
Inputs Parameters
The pre or post stubs support the mentioned list of parameters, the values of which can
be passed to the respective vRealize Orchestrator workflow as inputs. The value of these
inputs depends on the content (been captured/tested/deployed) of the pipeline execution for
which the pre or post routines are executed. Currently, all the parameters are of the type
'String'. Therefore, the input parameters configured for the corresponding workflow in vRealize
Orchestrator should be necessarily of type 'String'. A mismatch between the type of parameters
results in an execution failure for the pipeline. For more information on configuration, see
Configure Pipeline Stub.
Content Pipelines
Starting with vRealize Suite Lifecycle Manager 8.3, the Content Pipelines page is redesigned to
display the status of the content capture, test, and release of the content pipelines. You can view
all the content pipelines that are displayed in the completed, in progress, or failed state.
Note If you are unable to view the complete list of your pipelines, refresh the Content Pipelines
page as the queued request takes time to display the current data.
When you select a content pipeline from the Content Pipelines list, you can view the detailed
breakdown of the various stages of the selected execution. Each content pipeline displays the
following list:
Content Types Displays the content type selected for the pipeline
execution.
Content_pipeline You can select the capture, test, or the deploy options for
n Capture a content pipeline. Based on your selection, you can see
the detailed breakdown of the selected execution, such as
n Test
the All Stages View, the content_pipeline Stage View, and
n Deploy
the content_pipeline Stage Request.
When you want to upgrade from an older version of vRealize Suite Lifecycle Manager, you have
three steps.
When you want to upgrade your individual products after installing vRealize Suite Lifecycle
Manager 8.x or earlier versions.
Upgrade is supported from vRealize Suite Lifecycle Manager 8.0 and later versions. You can also
upgrade vRealize Suite Lifecycle Manager by using an ISO file to install the upgrade. Latencies
have been validated with 350 ms with a bandwidth of 1.5 MB for a vRealize Suite small suite
deployment and upgrade.
Prerequisites
n Verify that you meet the system requirements. See System Requirements.
n Take a snapshot of the vRealize Suite Lifecycle Manager virtual appliance. If you encounter
any problems during upgrade, you can revert to this snapshot.
n Verify that no critical tasks are currently in progress in vRealize Suite Lifecycle Manager.
The upgrade process stops and starts vRealize Suite Lifecycle Manager services and reboots
the vRealize Suite Lifecycle Manager virtual appliance, which might corrupt tasks that are in
progress.
n If you are upgrading vRealize Suite Lifecycle Manager through a repository URL or CD-
ROM, ensure that you download the vRealize Suite Lifecycle Manager upgrade binary from
MyVMware portal in advance. The file name must be -VMware-vLCM-Appliance-8.X.X.XX-
XXXXXXXX-updaterepo.iso.
Note You cannot use the easy installer iso file for an vRealize Suite Lifecycle Manager
upgrade, you must use the vRealize Suite Lifecycle Manager upgrade iso file.
Procedure
1 From the My services dashboard, click Lifecycle Operations and click Settings.
vRealize Suite Lifecycle Manager displays the name, version number, and vendor of the
current vRealize Suite Lifecycle Manager appliance.
3 Select the repository type for vRealize Suite Lifecycle Manager updates.
Option Description
Check Online You can check if the upgrades are available online. To use this option,
the vRealize Suite Lifecycle Manager virtual appliance must have access to
vapp-updates.vmware.com.
URL Enter your repository URL for updates. To use this option, extract the ISO
containing the upgrade files to a private repository. Do not use a private
repository that requires authentication for a file access.
CD-ROM You can update the vRealize Suite Lifecycle Manager Appliance from an ISO
file that the appliance reads from the virtual CD-ROM drive.
After few minutes, vRealize Suite Lifecycle Manager displays a message indicating whether
there are updates available.
a When vRealize Suite Lifecycle Manager is not connected to the internet, you can
download the "vRealize Suite Lifecycle Manager Update Repository Archive" binary from
My VMware Portal.
b The downloaded ISO should be attached to vRealize Suite Lifecycle Manager VM's
virtual CD-ROM drive. To do this, you can either upload the ISO in a content library
of the vCenter server hosting vRealize Suite Lifecycle Manager or you can upload in a
datastore that the vRealize Suite Lifecycle Manager VM can access. After uploading, you
must attach the ISO to the vRealize Suite Lifecycle Manager VM's CD-ROM device by
editing the VM's hardware configuration from the vCenter inventory. From vRealize Suite
Lifecycle Manager UI, select CD-ROM based upgrade option and proceed.
6 Select the checkbox on product snapshots under Prerequisite, and then click Next.
7 Click RUN PRECHECK. Once the precheck validation is complete, you can then download the
report to view the checks and validation status.
9 After a few minutes, login to the vRealize Suite Lifecycle Manager UI and check for the
upgrade successful message in the Settings > System Upgrade.
With the check version feature, you can check the latest available product versions even
without web connectivity. The table with the versions of the product of each vRealize Suite is
pre-populated wherein the data is fetched from the VMware source.
If the selected upgraded product version does not work, then navigate to the downloaded
product file with a file extension .pspak. Upload the file and validate the same using Chrome or
Internet Explorer.
For more information, refer to the Installing vRealize Automation with vRealize Suite Lifecycle
Manager Easy Installer for vRealize Automation and VMware Identity Manager documentation.
Note
n If the installation, upgrade, or scale out request of VMware Identity Manager is IN PROGRESS
or FAILED state in vRealize Suite Lifecycle Manager, ensure that you do not remediate the
cluster.
n If VMware Identity Manager is clustered through vRealize Suite Lifecycle Manager, then it is
recommended to use the Power ON and Power OFF option for a scenario which involves
bringing down the cluster, such as reboot and shut down.
n VMware Identity Manager version 3.3.4 is backward compatible with Windows connectors of
previous versions.
n When you deploy VMware Identity Manager with vRealize Suite Lifecycle Manager, do not
change the VMware Identity Manager hostname. For more information, refer to the VMware
Identity Manager documentation.
Prerequisites
n In a clustered environment, ensure that the Postgres Cluster Health Status is healthy by
selecting the Trigger Cluster Health for your product in the Environments page. After your
request is complete, you can view the notifications for your product and verify if your status
is healthy. If your status is unhealthy, you can use Power ON to remediate your cluster, prior
to an upgrade. For the 8.4 release, the remediate button is available in your product card in
the Environments page.
n Verify that you have taken a snapshot of VMware Identity Manager nodes.
n Verify that you have your product binaries mapped. For more information, see Configure
Product Binaries.
n For a clustered VMware Identity Manager upgrade, ensure that you disable all the stand-by
nodes in the load-balancer so that the traffic is not routed to the stand-by nodes, and then
enable the stand-by nodes after the upgrade is complete.
Procedure
4 Under the Product details section, you can select the following repository type.
Option Description
Repository URL When you select this option, you can manually add the local upgrade file
location in the Lifecycle virtual appliance.
vRealize Suite Lifecycle Repository When you select this option, you can enter the upgrade path available after
mapping the binaries through vRealize Suite Lifecycle Manager.
Note For VMware Identity Manager version 3.3.4, the only option available
is vRealize Suite Lifecycle Repository The other options, Repository URL
and VMware Repository are not available.
VMware Repository Select this option and select the version. The upgrade is performed using
the online source.
6 Click Submit.
After the external or embedded Linux connector is migrated, the Integrated Windows
Authentication (IWA) and LDAP directories on the Linux connector are migrated to Windows.
In VMware Identity Manager version 3.3.2 and earlier releases, the active directories were
supported on both external and embedded Linux connectors and external Windows connectors.
Starting with VMware Identity Manager version 3.3.3, IWA active directories are supported only
on external Windows connectors.
Prerequisites
n The supported Windows Server versions are 2012 R2, 2016, and 2019.
n A unique Windows system is required for the migration and it must be connected to a
domain server.
Procedure
5 In the Select Version tab, select the Repository Type, Product Version, and the Repository
URL.
6 To specify the connector migration, enter the Target Windows Connector details in the
Migrate Linux Connector to Windows Connection section.
Note The Source Connector details for Embedded Connector Type are populated from
VMware Identity Manager. You must enter only the Linux Connector SSH passwords for the
External Connector Type.
If the validations are not successful and you want to make changes, and then resume the
upgrade VMware Identity Manager operation, click SAVE AND EXIT.
9 In the Upgrade Summary page, you can verify the details, and then click Submit.
Prerequisites
n Ensure that you have upgraded the earlier versions of vRealize Suite Lifecycle Manager to
the latest. For more information on upgrading your vRealize Suite Lifecycle Manager, see
Upgrade vRealize Suite Lifecycle Manager 8.x .
n Ensure that you have upgraded the earlier version of VMware Identity Manager to 3.3.2 or
later. For more information on VMware Identity Manager upgrade, see Upgrade VMware
Identity Manager.
n Verify that you have already installed vRealize Automation 8.0, 8.0.1, 8.1, 8.2, or 8.3.
n Perform the binary mapping of the vRealize Automation upgrade ISO from Local, myvmware
or NFS share. For more information on binary mapping, see Configure Product Binaries.
n Increase the CPU, memory, and storage as per the system requirements of vRealize
Automation 8.4. For more information, see the Hardware Requirements of vRealize
Automation 8.4 Reference Architecture.
Procedure
Note At times, there can be a drift or a change in the environment outside of Lifecycle
Manager and for Lifecycle Manager to be aware of the current state of the system, the
inventory requires to be up-to-date.
a If the product inventory is already synced and up-to-date, then click Proceed Upgrade.
5 After the inventory is synced, select the vRealize Automation version to 8.4.
6 To select the Repository Type, you can either select vRealize Suite LCM Repository, only if
you have mapped the ISO Binary map, or you can select the Repository URL with a private
upgrade Repository URL.
7 If you selected the Repository URL, enter the unauthenticated URL, and then click Next.
8 Click Pre-Check.
n If the source vRealize Automation versions are one of 8.0.0 or 8.0.1, ensure follow the
steps given in the KB article 78325 before you upgrade to restore expired root accounts.
n SSH enabled - Verifies that SSH for the root user is enabled.
n Version check - Verifies if the target version selected for upgrade is compatible with the
current vRealize Automation version.
n Disk space on root, data, and services log partition - Verifies if the required amount of
free disk space is available in the root, data, and services log partition.
n CPU and Memory Check - Verifies if the required amount say 12 CPU and 42 GB Memory
resources available in each vRealize Automation nodes before upgrade.
n vCenter property existence check - Verifies if the vCenter details are present as part
of each node in the Lifecycle Manager inventory. Since a snapshot is taken during the
upgrade process, it is important to have the right vCenter details within the Lifecycle
Manager inventory.
n vRealize Automation VMs managed object reference ID retrieval check - Verifies if the
managed object reference ID of the VM can be retrieved from the details available in the
Lifecycle Manager inventory. This is required as you perform snapshot-related operations
on the VMs, finding the VM using the same.
You can navigate to the Request Details page to view the progress of the upgrade status.
You can enable the multi-tenancy for vRealize Automation, refer to Tenant Management in
vRealize Suite Lifecycle Manager.
Upgrade Preparation The preparation phase verifies that the system is healthy
and shuts down services to make sure that all data is
persisted.
Snapshot of all the VMs for an automatic recovery Snapshots are taken for faster recovery of failures. vRealize
Suite Lifecycle Manager then shuts down the VMs, takes a
snapshot, turns power on, and continues to the next phase.
At certain unexpected or failure scenarios, the vRealize Suite Lifecycle Manager upgrade
workflow gives user decision points to either finish the upgrade successfully or revert to the
stage before upgrade.
n The upgrade process starts with a status check task that verifies the current state of the
VA. If the system already has an upgrade request due to a previous upgrade attempt, then
vRealize Suite Lifecycle Manager provides you with an option to clean the older states and
start a new upgrade. You can see the status task failing with a retry parameter similar
to 'cancelAndStartAfresh'. Setting this retry parameter to true cleans up older states and
retriggers the upgrade again.
n If unexpected failures occur during the prepare phase, you can either cancel the whole
upgrade process and start new. If a failure cannot be corrected or if the unexpected failure
is fixed manually, you can proceed to the next phase in the upgrade workflow. The status
selects done after the prepare failure provide you with two retry parameters that help you
decide which option to select. If you set 'cancelAndStartAfresh' to 'true', the upgrade process
is cancelled and returns the system to the state before the upgrade. If you set ‘proceedNext’
to 'true', the vRealize Suite Lifecycle Manager upgrade workflow proceeds to the next state
with an assumption that you fixed the prepare issue outside.
n The upgrade workflow consists of VM level operations like reverting or deleting a snapshot
and VM Shutdown, power ON, and so on. If there was a failure, these operations include a
Skip option which can be used if the RETRY option in the vRealize Suite Lifecycle Manager
does not help and when you manually perform the same operation directly on the vCenter
Server.
n The final phase of the upgrade can be successful or success with warnings or a fatal state.
n Success with warnings indicates that the upgrade has completed successfully, but a
minor error is detected. You can check the errors and rectify them. You can set the
'succeedUpgradeRequest' retry parameter to 'true' which will succeed and complete the
vRealize Suite Lifecycle Manager upgrade workflow.
n If there is an fatal error, you can decide if you want to revert the snapshot and retry the
upgrade or cancel the whole upgrade process. You can revert and delete the snapshot,
cancel the current upgrade request, and move the system to a state before the upgrade
started.
n For a fatal error, you can see the status task after the upgrade
failure with retry parameters similar to 'revertSnapshotNRetryUpgrade' and
'cancelUpgradeNRevertBack'. If you set 'revertSnapshotNRetryUpgrade' to 'true',
then it can revert the snapshot and retry the upgrade again.
n If you set 'cancelUpgradeNRevertBack' to 'true', you can cancel the upgrade process,
which can revert and delete the snapshot and cancel the current upgrade request and
move the system to a state before the upgrade started.
Note
n The vRealize Suite Lifecycle Manager upgrade workflow does not support removing the
snapshots if there was a successful upgrade. You hold the snapshots or remove it manually
from the vCenter Server, if necessary.
n If you Cancel the upgrade process after a failure post prepare or upgrade phase, the
vRealize Suite Lifecycle Manager workflow post cleaning up the upgrade request in vRealize
Automation ends up in an canceled state. This indicates that the upgrade workflow from
vRealize Suite Lifecycle Manager stopped. In such situations, retrigger an upgrade from the
product actions under Manager Environment page.
n You can enable the multi-tenancy for vRealize Automation, refer to Tenant Management in
vRealize Suite Lifecycle Manager.
n If the vRealize Automation upgrade fails, you must cancel upgrade or revert a snapshot, and
then retry to upgrade through vRealize Suite Lifecycle Manager. If you revert the snapshot
manually in a vCenter Server, vRealize Automation goes into an inconsistent state.
n For vRealize Automation, if you cancel upgrade or revert a snapshot, and then retry to
upgrade, ensure that you create a support bundle that contains the log files for any future
analysis and reference.
When a deployment request is saved in vRealize Suite Lifecycle Manager 1.1 and the same
request is resumed after upgrading vRealize Suite Lifecycle Manager to 1.2, vRealize Automation
7.3 products details page items does not load. For more information, see KB article 56369. When
a vRealize Suite Lifecycle Manager upgrade is triggered, the screen stays at Maintenance mode
and Home page never comes up. After an upgrade, there can be some errors in the content
from the marketplace. The content might contain few request that prevents the service to start.
vRealize Suite Lifecycle Manager UI displays a maintenance mode message and the Home page
is not displayed. In this scenario, restart the xenon server. If the issue still persists, delete the
error request and restart xenon. To upgrade to vRealize Automation 8.x, see Upgrade vRealize
Automation 8.x with vRealize Suite Lifecycle Manager .
Prerequisites
Verify that the vRealize Suite product to upgrade is part of a vRealize Suite Lifecycle Manager
private cloud environment, and take a snapshot of the product that you can revert to in the event
that something goes wrong with the upgrade. See Creating and Managing a Product Snapshot.
If you are upgrading vRealize Automation 7.x, ensure that the following additional prerequisites
are met:
n The vRealize Automation management agent and all IaaS Windows nodes are running.
If you are upgrading vRealize Automation 8.x, ensure that the following additional prerequisites
are met:
Procedure
2 Click VIEW DETAILS for the environment the product to upgrade is part of.
3 Click the ellipses (...) icon next to the name of the product to upgrade and select Upgrade
from the drop-down menu.
5 If you are upgrading vRealize Automation or vRealize Business for Cloud, choose whether to
upgrade from the Default repository, the vRealize Suite Lifecycle Manager Repository, or a
manually-entered Repository URL.
6 If you are upgrading vRealize Log Insight or vRealize Operations Manager, choose whether
to upgrade from the vRealize Suite Lifecycle Manager Repository, or a manually-entered
Repository URL, and then select the Product Version.
7 Click Next.
8 Under Snapshot, you have two options. You can select Take product snapshot and Retain
product snapshot taken. If the Take product snapshot is set to true, and the snapshot is
taken prior to an upgrade which can be rolled back to its initial state during an upgrade
failure, the snapshot is taken with the prefix LCM_AUTOGENERATED. If the Retain product
snapshot taken is set to true, it is retained, and can revert back to the previous version after
a successful upgrade.
Note
n The Snapshot option is not supported for vRealize Automation version 7.x.
n When you select a snapshot, it powers off the product VMs prior to taking the snapshot,
and involves downtime for a specified time.
n If your upgrade fails, you can now roll back through the Revert Snapshot option. This is
only applicable for a failed upgrade or a scaleout request. If you have chosen to take
snapshot as an option and your upgrade fails, the Snapshot Rollback action would trigger
a new request to roll back to the initial state. Select the ellipsis (...) in the Requests page
for the Snapshot Rollback action.
9 Click RUN PRECHECK. After a successful precheck, you can view the Upgrade Summary, and
then click Upgrade.
If you have upgraded a vRealize Suite product outside of vRealize Suite Lifecycle Manager,
then vRealize Suite Lifecycle Manager will not reflect the latest product version or the latest
data of the upgraded product. At such instances you have to delete the vRealize Suite
product (the product which is already upgraded to the newer version outside vRealize Suite
Lifecycle Manager) from vRealize Suite Lifecycle Manager only, and then re-import the same
product again so that vRealize Suite Lifecycle Manager will fetch the latest state of the given
product along with its newer version.
What to do next
You can view the progress of the upgrade on the Requests tab.
For more information on upgrade vRealize Suite products, see Upgrade a vRealize Suite Product.
Prerequisites
Verify that you already have an existing vRealize Suite product in your environment.
Procedure
1 Right click the vertical ellipses of an existing vRealize Suite product and select an upgrade.
The compatibility matrix information is loaded with new, compatible and incompatible
versions with product that needs to be upgraded.
2 Under the Product details section, you can select the following repository type.
Option Description
VMware Repository When you select this option, the latest versions of the vRealize Suite
products are displayed in the Compatibility Matrix table. You can see
this option only on vRealize Automation and vRealize Business for Cloud.
Although, the compatibility matrix information is populated at the Suite
product level, there can be a possibility for that latest versions might not
be available at vRealize Suite Lifecycle Manager. However, with the Check
Available Version, you can get only the latest version number with the
associated build number.
Repository URL When you select this option, you can manually add the local upgrade file
location in vRealize Suite Lifecycle Manager virtual appliance.
vRealize Suite Lifecycle Repository When you select this option, you can select the upgrade path available after
mapping the binaries through vRealize Suite Lifecycle Manager.
Note Only vRealize Operations Manager upgrade consists of the Run Assessment feature.
The run assessment checks for the vRealize Operations Manager upgrade readiness. It is not
mandatory for the Run assessment to be passed, you can still go ahead with the upgrade.
The compatibility matrix information is populated as per the selected version of the vRealize
Operations Manager under the Product Version drop-down menu.
Once the precheck validation is completed, you can then download the report to view the
checks and validation status.
Note If you want to run the Precheck again after evaluating the discrepancies, you can
select the Re-Run Pre Check. Pre-Check can also be performed using on Submit toggle
button.
c Click Retry from vRealize Suite Lifecycle Manager and set Upgrade Iaas Using Cli to True.
d Click Submit.
Prerequisites
Verify that there is an older or an existing version of vRealize Operations Manager instance in the
Manage Environments.
Procedure
1 Right click the vertical ellipses of an existing vRealize Operations Manager product and select
an Upgrade.
The compatibility matrix information is loaded with new, compatible, and incompatible
versions with product that must be upgraded.
2 Under the Product details section, you can select the following repository type.
Option Description
Repository URL When you select this option, you can manually add the local upgrade file
location in a Lifecycle virtual appliance.
vRealize Suite Lifecycle Repository When you select this option, you can enter the upgrade path available after
mapping the binaries through LCM.
3 Click Next.
4 To run the file format and Version support from LCM, click RUN PRECHECK.
Once the precheck validation is finished, you can then download the report to view the
checks and validation status.
Note When you upgrade vRealize Operations Manager instance, you have two options.
n Run Assessment Tool: You can use this option to run a vRealize Operations Manager
APUAT tool.
The binary for vRealize Operations Manager APUAT tool is bundled with vRealize Suite
Lifecycle Manager build, and once vRealize Suite Lifecycle Manager gets deployed it is
present in vRealize Suite Lifecycle Manager VA location: /data/lcmcontents/, by default.
Note If you want to run the Precheck again after evaluating the discrepancies, you can
select the Re-Run Pre Check. Pre-Check can also be performed using on Submit toggle
button.
If the OS Admin Password for vRealize Operations Manager expires, vRealize Operations
Manager upgrade Precheck fails while check-in even if the admin account is locked or not.
You can change the admin password for the vRealize Operations Manager within vRealize
Suite Lifecycle Manager UI, and then click Precheck for vRealize Operations Manager again.
You can also change the vRealize Operations Manager admin password outside vRealize
Suite Lifecycle Manager directly in vRealize Operations Manager, then run an inventory
sync for the selected vRealize Operations Manager instance in the vRealize Suite Lifecycle
Manager UI. Click Run upgrade Precheck for vRealize Operations Manager again.
Prerequisites
Verify that there is an older or an existing version of vRealize Automation instance in the Manage
Environments.
Procedure
1 Right click the vertical ellipses of an existing vRealize Automation product and select an
Upgrade.
The compatibility matrix information is loaded with new, compatible and incompatible
versions with product that needs to be upgraded.
If an IaaS component fails after vRealize Automation then you can revert to the post upgrade
VA snapshot.
3 Under the Product details section, you can select the following repository type.
Option Description
Repository URL When you select this option, you can manually add the local upgrade file
location in Lifecycle virtual appliance.
VMware Repository When you select this option, the latest versions of the vRealize Suite
products are displayed in the Compatibility Matrix table. You can see this
option only on vRealize Automation. Although, the compatibility matrix
information is populated at the Suite product level, there can be a possibility
for that latest versions might not be available at vRealize Suite Lifecycle
Manager. However, with the Check Available Version, you can get only the
latest version number with the associated build number.
vRealize Suite Lifecycle Repository When you select this option, you can select the upgrade path available after
mapping the binaries through LCM.
Once the precheck validation is completed, you can then download the report to view the
checks and validation status.
Note If you want to run the Precheck again after evaluating the discrepancies, you can
select the Re-Run Pre Check. Pre-Check can also be performed using on Submit toggle
button.
5 Click Next and read the summary before you click Submit.
Procedure
1 Right click the vertical ellipses of an existing vRealize Network Insight product and select an
Upgrade.
The compatibility matrix information is loaded with new, compatible and incompatible
versions with product that needs to be upgraded.
2 Under the Product details section, you can select the following repository type.
Option Description
Repository URL When you select this option, you can manually add the local upgrade file
location in Lifecycle virtual appliance.
vRealize Suite Lifecycle Repository When you select this option, you can enter the upgrade path available after
mapping the binaries through LCM.
3 Click Next.
4 Click RUN PRECHECK to execute the File format and Version support from LCM.
Once the precheck validation is completed, you can then download the report to view the
checks and validation status. `
Note If you want to run the Precheck again after evaluating the discrepancies, you can
select the Re-Run Pre Check. Pre-Check can also be performed using on Submit toggle
button.
Prerequisites
Verify that there is an older or an existing version of vRealize Log Insight instance in the Manage
Environments.
Procedure
1 Right click the vertical ellipses of an existing vRealize Log Insight product and select an
Upgrade.
The compatibility matrix information is loaded with new, compatible and incompatible
versions with product that needs to be upgraded.
2 Under the Product details section, you can select the following repository type.
Option Description
Repository URL When you select this option, you can manually add the local upgrade file
location in Lifecycle virtual appliance.
vRealize Suite Lifecycle Repository When you select this option, you can select the upgrade path available after
mapping the binaries through LCM.
3 Click Next.
Once the precheck validation is completed, you can then download the report to view the
checks and validation status.
Note If you want to run the Precheck again after evaluating the discrepancies, you can
select the Re-Run Pre Check. Pre-Check can also be performed using on Submit toggle
button.
Procedure
1 Right click the vertical ellipses of an existing vRealize Business for Cloud product and select
an Upgrade.
The compatibility matrix information is loaded with new, compatible, and incompatible
versions with product that must be upgraded.
2 Under the Product details section, you can select the following repository type.
Option Description
Repository URL When you select this option, you can manually add the local upgrade file
location in Lifecycle virtual appliance.
vRealize Suite Lifecycle Repository When you select this option, you can enter the upgrade path available after
mapping the binaries through Lifecycle Manager.
3 Click Next.
4 Click RUN PRECHECK to run the file format and Version support from LCM.
Once the precheck validation is completed, you can then download the report to view the
checks and validation status.
Note If you want to run the Precheck again after evaluating the discrepancies, you can
select the Re-Run Pre Check. Pre-Check can also be performed using on Submit toggle
button.
Prerequisites
Note If you have multiple tenants, you can upgrade only one tenant at a time.
Verify that there is an older or an existing version of vRealize Automation Salt Stack Config
instance in the Manage Environments.
Procedure
1 In the Environments page, select vRealize Automation Salt Stack Config, and then click
Upgrade.
3 Under the Select Version section, you can select the following repository type.
Option Description
vRealize Suite LCM Repository When you select this option, you can select the upgrade path available after
mapping the binaries through vRealize Suite Lifecycle Manager.
Repository URL When you select this option, you can manually add the local upgrade file
location in Lifecycle virtual appliance.
4 Click Next.
5 In the Precheck page, you can view the validation status. You can click RE-RUN PRECHECK
button to evaluate the discrepancies.
7 Click Submit.
Procedure
1 Create a recovery plan for vRealize Suite Lifecycle Manager VM and configure the recovery
steps by turning off re-IP manually, and then disabling power on post recovery.
2 Edit the hardware setting of the recovered vRealize Suite Lifecycle Manager VM in the
vCenter inventory, and then assign correct network.
4 Access the vRealize Suite Lifecycle Manager VM console from vCenter inventory as a root
user.
a /opt/vmware/share/vami/vami_set_network <Network-Interface-Name>
STATICV4+NONEV6 <New-IPV4> <SUBNETMASK> <DEFAULT-GATEWAY>
b /opt/vmware/share/vami/vami_set_dns <New-DNS-IP-OR-FQDN>
c /opt/vmware/share/vami/vami_set_hostname <New-Hostname>
d Reboot.
6 Access the vRealize Suite Lifecycle Manager UI with new IPv4 or the new FQDN, and then
log in. Under Locker, select Home Certificates, and then generate a new certificate, which
includes the updated vRealize Suite Lifecycle Manager FQDN.
7 Under Lifecycle Operations Home page, select Settings, and then select Change Certificate to
update the vRealize Suite Lifecycle Manager certificate that is generated in the previous step.
8 Under Lifecycle Operations Home page, select Settings, and then select Authentication
Provider to perform SYNC and RE-REGISTER. This would updade the new FQDN of vRealize
Suite Lifecycle Manager in the VMware Identity Manager catalogue.
Note Perform this step only if the VMware Identity Manager is reachable to the network of
the recovered vRealize Suite Lifecycle Manager VM.
9 Perform an inventory sync with the managed products to ensure vRealize Suite Lifecycle
Manager is functional with the new network settings.
To know more about vRealize Cloud, you can view Creating Environments in vRealize Cloud.
When you purchase vRealize Cloud Subscription, you receive access to vRealize Cloud
Subscription Manager, which is a new complimentary utility service. With vRealize Cloud
Subscription Manager, you can add endpoints and monitor the data usage for your vRealize
Cloud Subscription services. You must create vRealize Cloud licenses at the locker level in
vRealize Suite Lifecycle Manager, and then connect these licenses to vRealize Cloud Subscription
Manager to monitor your cloud data usage. For more information on vRealize Cloud Subscription
Manager, refer to the vRealize Cloud Subscription Manager documentation.
Prerequisites
Procedure
1 If you do not have My VMware account, navigate to the Lifecycle Operations dashboard, and
then click Settings.
3 After your My VMware accounts are configured, then the corresponding license keys are
synced.
5 Click the License icon. The vRealize Cloud licenses are created under My VMware account
and are displayed in the Licenses table.
7 If you already have products deployed, then import these products in vRealize Suite Lifecycle
Manager, and then apply the vRealize Cloud Universal licenses to these products captured
in locker. If there are no existing products present, then you can use the vRealize Cloud
Universal licenses present in vRealize Suite Lifecycle Manager locker for product deployment.
For more information, view the Configure License Within Locker topic.
8 If you have already downloaded your license, you can add the license details in the Locker.
9 To connect a license to vRealize Cloud Subscription, select a license which is displayed in the
License table, and then right-click the vertical ellipses.
b Under API Token, generate an API token from your user account for vRealize Cloud
Subscription, and then click Next.
c Under Match License Key, the vRealize Cloud Subscription Manager finds a correct match
for the provided API token, and lists out the organization details.
d Under Report Frequency, you will receive a confirmation that you are connected to
vRealize Cloud Subscription Manager, and your data usage is reported to vRealize Cloud
Subscription Manager twice a day.
e Click Finish.
10 To disconnect a license in vRealize Suite Lifecycle Manager, right-click the vertical ellipses,
and then click Disconnect License.
11 To trigger the license usage for a product, select a license from the License table, and then
right-click the vertical ellipses.
b You can download the usage sync report to view the data usage for the products.
12 To view the data consumption report, select a license, and then right-click the vertical
ellipses.
b To view a graphical representation of the report, click GENERATE in the Generate Report
page.
c To download the report for a maximum period of 120 days, click DOWNLOAD.
The Usage Report enables you to download and view your license reports.
n Download Report: The General option enables you to download reports for
viewing ,analyzing, storing, documentation, or auditing purposes.
The vRealize Cloud Subscription Manager Billing option enables you to download a encrypted
usage data zipped file, that you upload in vRealize Cloud Subscription Manager, and this
generates a usage key. For more information, see VMware vRealize Cloud Subscription
Manager documentation. You can use this usage key in vRealize Suite Lifecycle Manager
to update the vRealize Subscription Manager usage key option. Once your usage key is
updated, you can generate the license usage report for a specified period.
n View Usage: This tab displays a chart of the usage details for a particular license.
Procedure
1 To activate a subscription license, navigate to the vRealize Cloud dashboard, and then click
Cloud Universal.
3 Select the check box to confirm that the vRealize Suite products are on the required patches
to proceed.
4 Select the plus (+) sign to add the license key details, and then click Validate. After the
license key is validated, click ADD. Click Next.
Note The license key must be a vRealize Cloud Subscription. When you add a new license,
you can view the license key under Locker in vRealize Suite Lifecycle Manager.
7 Based on the selected product, you can select the Admin Password or Root Password.
8 Select the check box to remove all the perpetual licenses from the selected product, if
required.
9 Click Validate & Add. When the validation is complete, click Next.
n Use vRCU subscription licenses with perpetual licenses: If you select this check box, enter
your Associated MyVMware Account details.
n If you select both the check boxes, you must enter the Network Proxy details.
11 Click Next.
12 You can validate the details in the Summary page, and then click Finish.
What to do next
You can track the request details under the Requests tab.
Delete The Delete option removes the selected entry from the
Cloud Universal page, but does not delete the product.
Update Password The Update Password option updates the vRealize Suite
Lifecycle Manager inventory.
Inventory Sync The Inventory Sync option helps to sync with the product
and retrieve the latest license details.
Disconnect License to Cloud Disconnect the license key from the vRealize Cloud
subscription.
Update License Key 1 Select the license key from the Usage Bundle
Download option.
2 Select the purpose.
3 Click Download.
n Unexpectedly Large vRealize Operations Manager Virtual Machine Fails to Power On Due to
Resource Limitations
Large vRealize Operations Manager virtual machines fails to power on due to resource
limitations.
n Environment Deployment Fails During vRealize Log Insight Clustering and VMware Identity
Manager Registration
Environment deployment fails during the Adding vIDM user as vRLI Super Admin task
while running vRLI Clustering and vIDM Registration.
n VMware Identity Manager Day 2 Operations Fail When the Root Password Expires
VMware Identity Manager Day 2 operations such as upgrade or root password update fails
when the root password of VMware Identity Manager expires.
n Enable Log Rotation for pgpool Logs on Postgres Clustered VMware Identity Manager
You can enable log rotation for pgpool logs on postgres clustered VMware Identity
Manager installed using vRealize Suite Lifecycle Manager.
n Licenses Disconnected as Day-2 Operation in Cloud Universal UI Are Not Listed for
Reconnect
If you disconnect a connected license from vRealize Cloud > Cloud Universal > License
Actions > Disconnect License to Cloud, then you may not be able to connect it from vRealize
Cloud > Cloud Universal > License Actions > Connect License to Cloud
Problem
When you deploy vRealize Operations Manager in vRealize Suite Lifecycle Manager, by selecting
node size as large and if you have budgeted resources for a different size virtual machine, the
virtual machine might fail to power on due to resource limitations.
Cause
vRealize Operations Manager deployment size set in vRealize Suite Lifecycle Manager is based
on the number of virtual machines, catalog items, concurrent provisions, and other workload
metrics for your vRealize Operations Manager environment. Virtual machine size is unrelated to
deployment size.
Solution
vRealize Operations Manager virtual machines deployed from vRealize Suite Lifecycle Manager
have a large (16 vCPU and 48 GB RAM) virtual machine size, if deployed with large size, and
require sufficient vCPU and RAM to power on successfully.
Problem
Even after you multiple deployment operation, environment deployment fails during the
Adding vIDM user as vRLI Super Admin task while running vRLI Clustering and vIDM
Registration.
Solution
1 Add the VMware Identity Manager Suite Administrator user to vRealize Log Insight by using
the vRealize Log Insight UI.
2 Remove the VMware Identity Manager Suite Administrator user from vRealize Log Insight by
using the vRealize Log Insight UI.
Cause
When a DNS server provided during deployment gets changed, then follow these steps to
update the DNS Settings of vRealize Suite Lifecycle Manager.
Solution
/opt/vmware/share/vami/vami_set_dns
vami_set_dns [-d <domain>] [ -s <searchpath>] DNS_Server_1 [DNS_Server_2]
4 Select the vRealize Suite Lifecycle Manager virtual appliance from vCenter, and then select
Configure.
vami.DNS.VMware_vRealize_Suite_Life_Cycle_Manager_Appliance
8 Verify the new DNS entry by running the resolvectl status, and then verify the DNS server.
Cause
If you have given an incorrect IP address while deploying vRealize Suite Lifecycle Manager.
Solution
Problem
When you navigate from Home > Settings > Product Binaries, the corresponding request is
marked as COMPLETED in the Requests page but the binary mappings are not populated.
Cause
The checksum for the target product binary cannot be same as the one published by VMware.
Solution
u Ensure that the binaries are not corrupted or modified and their SHA256 checksum is the
same as mentioned in MyVMware portal.
Cause
In vRealize Suite Lifecycle Manager 8.0, the secure field is captured as encrypted from the source
environment and the value cannot be decrypted when deployed.
Solution
u After you successfully deploy, login to the target vRealize Automation and manually update
the secure fields in the content.
Solution
1 For vRealize Suite Lifecycle Manager 1.1 or older version, service Layer logs are present
in the location /opt/vmware/vlcm/logs/ and the file format is xenon.*.log, the active log
file is xenon.0.log. For vRealize Suite Lifecycle Manager 1.2 or later, this log is available
at /var/log/vlcm and log file name is vrlcm-xserver.log
2 For vRealize Suite Lifecycle Manager 1.1 or earlier version, engine logs are present in the
location /var/log/vlcm/ and the current log filename is catalina.out. For vRealize Suite
Lifecycle Manager 1.2 or later, this log is available at /var/log/vlcm and log file name is
vrlcm-server.log
Note To upgrade from 1.0 or 1.1–1.3, the old LCM service layers log present at the
location /opt/vmware/vlcm/logs/ are in the name console.log, and the new service
layer logs are in the file format xenon.*.log.
Problem
When a composite blueprint of vRealize Automation have references to any properties like
Property Definition or Property Groups, and if those properties are deleted from the vRealize
Automation then the Blueprint has to be updated in the vRealize Automation or else the capture
in Lifecycle Manager fails.
Solution
3 Click the Properties tab (select custom properties tab if any properties were added
previously) and select OK.
4 Select each of the components in the blueprint and select the Properties tab. (select the
custom properties tab if any properties were added previously).
5 Click Save.
6 Click Finish.
Problem
When deploying an "Image Component Profile" the "Clone From" value of the component profile
is stripped. The "Clone From" text boxes are empty on the target system.
Solution
u You can manually edit the component profile and the respective values from the drop-down
menu.
Note When you capture and release a component profile of vRealize Automation
using vRealize Suite Lifecycle Manager, the name of component profile should start with
"ValueSet".
Cause
Solution
1 Use the Secure Shell (SSH) to access vRealize Suite Lifecycle Manager appliance using the
root user privileges.
rm/opt/vmware/etc/vami/flags/vami_setnetwork
/opt/vmware/share/vami/vami_set_hostname new-hostname
4 Update the vRealize Suite Lifecycle Manager certificate under Settings in vRealize Suite
Lifecycle Manager.
8 Select vami.hostname, set the value, and then update the value to the new hostname.
9 Power ON the virtual machine, and then change the hostname using the following command:
/opt/vmware/share/vami/vami_config_net
Problem
When you view or edit the directory in the Directory Management, the system cannot retrieve
the required information from VMware Identity Manager and displays an error message.
Cause
Solution
1 Log in to VMware Identity manager. Verify the directory configuration, and confirm if the
directory is associated with a connector. Also, validate the bind password.
2 If the directory configuration is incomplete, you can configure it in VMware Identity Manager.
You can also use vRealize Suite Lifecycle Manager to remove the directory using the delete
functionality, provide correct configuration details, and then add back the directory.
Solution
Note Any role assigned to the directory user in vRealize Lifecycle Manager must be deleted and
reassigned after the directory is added back.
This is supported in vRealize Suite Lifecycle Manager 8.2 Patch 1 and later releases.
Problem
When a term license key is applied on a vRealize Automation 7x instance having a perpetual
license key, the task fails in vRealize Automation. vRealize Suite Lifecycle Manager does not show
this failure and the corresponding request is marked as complete. This problem occurs only when
FIPS mode is enabled in vRealize Suite Lifecycle Manager.
Cause
This is a known limitation in vRealize Suite Lifecycle Manager with the FIPS mode.
Solution
Disable the FIPS mode before applying vRealize Cloud Universal licenses from vRealize Suite
Lifecycle Manager so that actual errors can be reflected in the vRealize Suite Lifecycle Manager
request UI.
Cause
When capturing, testing, or releasing vRealize Orchestrator content, the vRealize Orchestrator
elements may fail on the endpoint when creating content.
Solution
Inspect the vRealize Orchestrator logs and identify the element causing the failure. Delete the
respective element from vRealize Orchestrator and retry.
Cause
Solution
1 Disable FIPS in vRealize Suite Lifecycle Manager from Lifecycle Operations > Home > Settings
> FIPS Mode Compliance.
2 Cancel the request that is in progress from the Requests page. Alternatively, the request can
be deleted using API, if the option to cancel the request is not available.
Note The FIPS mode must be disabled in vRealize Suite Lifecycle Manager to avoid this
issue. If FIPS is enabled, then the issue occurs.
Cause
When the keyUsage does not have the digitalSignature attribute in the HTTPS certificate
of target product, the import or inventory sync of the vRealize Suite product fails with an error
message.
Solution
1 Click the padlock icon in the address bar of a browser (Chrome, Edge, or Firefox), and then
click Certificate.
Solution
1 Login to the virtual appliance console of VMware Identity Manager in vCenter Server.
2 Update the root password of the VMware Identity Manager virtual appliance.
3 Login to vRealize Suite Lifecycle Manager and run the inventory sync of VMware Identity
Manager. Update the root password of VMware Identity Manager when retrying a failed
inventory sync request.
Solution
Problem
The combined disk usage shown with du -hsc /var/log/pgService/pgService* is more than
50% of total disk capacity of /dev/sda4 as indicated in the output of the command df -h.
Solution
a touch /etc/cron.d/rotatePgserviceLogs
a touch /etc/cron.d/rotatePgserviceLogs
b touch /etc/logrotate.d/pgservicelog
c echo "/var/log/pgService/pgService.log {
copytruncate
rotate 6
compress
missingok
size 50M
Problem
VMware Identity Manager cluster health status displays as CRITICAL in vRealize Suite Lifecycle
Manager Health Notification due to network loss in the VMware Identity Manager appliance.
Cause
-U : The pgpool health check and replication delay check user is pgpool.
In the response, there needs to be a MASTER node and 2 STANDBY nodes present. If any of the
node's status is SHUTDOWN, DEAD or the command execution is struck, follow the steps to resolve
this issue.
Solution
1 Gracefully bring down the services on VMware Identity Manager nodes. Refer to KB 78815 for
the required steps.
3 Power ON the VMware Identity Manager nodes through vRealize Suite Lifecycle Manager.
Problem
If the details of VMware Identity Manager fails to match with vRealize Automation, when
importing vRealize Automation in vRealize Suite Lifecycle Manager, you may see the following
error message.
vRealize Automation Import failed due to VMware Identity Manager details in vRealize
Suite Lifecycle Manager not matching with the provided vRealize Automation. Please
retry by providing vRealize Automation which has VMware Identity Manager details same
as vRSCLM VMware Identity Manager details.
vRA vIDM details mismatch. vRA Import is supported only if vRSLCM vIDM is matched with
vRA vIDM details.
Cause
The VMware Identity Manager imported into vRealize Suite Lifecycle Manager does not match
the vRealize Automation host that was attempting to import.
Solution
1 Delete globalenvironment from vRealize Suite Lifecycle Manager. This action is supported in
the UI from vRealize Suite Lifecycle Manager version 8.4.
2 Import VMware Identity Manager which is associated with the vRealize Automation host.
Problem
When you upgrade vRealize Suite Lifecycle Manager from version x to version y, vRealize Suite
Lifecycle Manager may incorrectly display version x after a successful upgrade.
Cause
This behaviour displays when VAMI, the component that performs the upgrade, fails to update a
manifest file in vRealize Suite Lifecycle Manager with the upgraded version.
Solution
No action required from user. When VAMI fails to update the version in the manifest file, it
schedules a job that performs this operation in the next cycle in 12 hours.
Problem
If you select vRealize Cloud > Cloud Universal > License Actions > Disconnect License to Cloud,
and then disconnect a connected license, you cannot connect the same license from vRealize
Cloud > Cloud Universal > License Actions > Connect License to Cloud as the license key does not
get listed in the UI.
Solution
1 From the Lifecycle Operations dashboard, navigate to Locker, and then select Licenses.
2 Select Connect License from the actions for the license key that is not showing up in Cloud
Universal, and then follow the steps provided in the wizard to connect the license key to
Cloud.