Migrating vRealize Automation 6.2 to 7.2 vRealize Automation 7.2 This document supports the version of each product listed and supports all subsequent versions until the document is replaced by a new edition. To check for more recent editions of this document, see http://www.vmware.com/support/pubs.
Migrating vRealize Automation 6.2 to 7.2 You can find the most up-to-date technical documentation on the VMware Web site at: http://www.vmware.com/support/ The VMware Web site also provides the latest product updates. If you have comments about this documentation, submit your feedback to: docfeedback@vmware.com Copyright © 2008–2017 VMware, Inc. All rights reserved. Copyright and trademark information. VMware, Inc. 3401 Hillview Ave. Palo Alto, CA 94304 www.vmware.com 2 VMware, Inc.
Contents Updated Information 5 1 Migration Prerequisites 7 2 Migrate Identity Stores to the VMware Identity Manager 11 Create a Local User Account for Your Tenants Before Migration 11 Synchronize Users and Groups for an Active Directory Link Before Migration 12 3 Migrate a vRealize Automation Environment 15 4 Post-Migration Tasks for vRealize Automation 19 Update the License Key After Migration 19 Migrate Multiple Tenant and IaaS Administrators After Migration Reinstall the vRealize Orchestrator Plug-I
Migrating vRealize Automation 6.2 to 7.2 4 VMware, Inc.
Updated Information This Migrating vRealize Automation 6.2 to 7.2 guide is updated with each release of the product or when necessary. This table provides the update history of the Migrating vRealize Automation 6.2 to 7.2 guide.
Migrating vRealize Automation 6.2 to 7.2 6 VMware, Inc.
Migration Prerequisites 1 Review these prerequisites to ensure a successful migration. Prerequisites n Verify that you have a new target installation of VMware vRealize ™ Automation 7.2 whose components reflect the source 6.2.x environment. n Verify that endpoint names configured for agents, such as vSphere agents, running on the target system match the endpoint names used by the source installation.
Migrating vRealize Automation 6.2 to 7.2 n Create a full backup of the source vRealize Automation 6.2.x IaaS Microsoft SQL database and use the backup to restore the SQL database in the target environment. For information, find articles on the Microsoft Developer Network about creating a full SQL Server database backup and restoring an SQL Server database to a new location. n Take a snapshot of each vRealize Automation target 7.2 virtual machine.
Chapter 1 Migration Prerequisites Table 1‑3. Target IaaS Database (Continued) VMware, Inc. Item Description Original encryption key Source IaaS Microsoft SQL database encryption key that you retrieve from the source environment at the beginning of the migration procedure. New passphrase A series of words used to generate a new encryption key. You use this passphrase each time you install a new IaaS component in the target vRealize Automation 7.2 deployment.
Migrating vRealize Automation 6.2 to 7.2 10 VMware, Inc.
Migrate Identity Stores to the VMware Identity Manager 2 When you migrate from VMware vRealize ™ Automation 6.2.x to the current version of vRealize Automation, you must migrate the 6.2.x identity stores to the VMware Identity Manager (vIDM). You complete three tasks to migrate vRealize Automation 6.x identity stores. 1 Create a local user account for your tenants before migration. 2 Synchronize users and groups for an Active Directory link before migration.
Migrating vRealize Automation 6.2 to 7.2 7 Click the Administrators tab. 8 Enter the local user name in the Tenant administrators search box and press Enter. 9 Click Finish. 10 Log out of the console.
Chapter 2 Migrate Identity Stores to the VMware Identity Manager Option Sample Input Bind User UPN Use the email address format to enter the name of the user who can authenticate the domain. Bind DN Password Enter the Active Directory bind account password for the account that can search for users. 5 Click Test Connection to test the connection to the configured directory. 6 Click Save & Next. The Select the Domains page appears, and displays the list of domains.
Migrating vRealize Automation 6.2 to 7.2 14 VMware, Inc.
Migrate a vRealize Automation Environment 3 You can migrate your VMware vRealize ™ Automation 6.2.x environment to a new installation of vRealize Automation 7.2. Prerequisites n Chapter 2, “Migrate Identity Stores to the VMware Identity Manager,” on page 11. Do not migrate tenant administrators when you migrate tenants and stores. Perform the Migrate Multiple Tenant Administrators procedure when you complete migration.
Migrating vRealize Automation 6.2 to 7.2 5 6 7 Enter the information for the source vRealize Automation appliance. Option Description Host name The host name for the source vRealize Automation 6.2.x appliance. Root username root Root password The root password that you entered when you deployed the vRealize Automation 6.2 appliance. Enter the information for the target vRealize Automation appliance.
Chapter 3 Migrate a vRealize Automation Environment n 9 If an item fails to validate, inspect the error message and the validation log file on the Model Manager Data IaaS node at C:\\Program Files(x86)\VMware\VCAC\Server\InstallLogs_latest_timestamp\validate.log. Click Edit Settings and edit the problem item. Go to step 8. Click Migrate. The page displays the migration progress. What to do next Chapter 4, “Post-Migration Tasks for vRealize Automation,” on page 19 VMware, Inc.
Migrating vRealize Automation 6.2 to 7.2 18 VMware, Inc.
Post-Migration Tasks for vRealize Automation 4 After you migrate VMware vRealize ™ Automation, perform the post-migration tasks that pertain to your situation.
Migrating vRealize Automation 6.2 to 7.2 6 Click Submit Key. Migrate Multiple Tenant and IaaS Administrators After Migration You can use the Identity Stores Migration Tool to migrate multiple vRealize Automation 6.2.x tenants and IaaS administrators to your newly synchronized vsphere.local tenant. Alternatively, you can add IaaS administrators manually to the respective tenants. In a Linux environment, run the Identity Stores Migration Tool as administrator.
Chapter 4 Post-Migration Tasks for vRealize Automation Even if you see your tenant users assigned in your tenant before running this command, you must run this command to register your users in Horizon to obtain full tenant administrator privileges. WIndows a Double-click Identity Stores Migration Tool to download the tool to your Downloads directory. b Log in to the Windows machine where SSO is running. c Copy the vra-sso-migration.
Migrating vRealize Automation 6.2 to 7.2 Procedure u Reconfigure the load balancers for the vRealize Automation appliance, the IaaS Web Server that hosts the Model Manager, and the Manager Service to restore the original health check settings and enable replica nodes to accept incoming traffic. Validate the vRealize Automation Migrated Environment You can verify that all data is migrated successfully to the target VMware vRealize ™ Automation 7.2 environment.
Chapter 4 Post-Migration Tasks for vRealize Automation Procedure 1 Select Infrastructure > Endpoints > Endpoints. 2 On the Endpoints page, point to the vRealize Orchestrator endpoint, and select Edit from the context menu. 3 In the Address text box, edit the vRealize Orchestrator endpoint URL to remove :8281. 4 Click OK. 5 Manually start data collection on the vRealize Orchestrator, and verify that the collection is successful. VMware, Inc.
Migrating vRealize Automation 6.2 to 7.2 24 VMware, Inc.
Troubleshooting Migration 5 Migration troubleshooting topics provide solutions to problems you might experience when you migrate vRealize Automation. PostgreSQL Version Causes Error A source vRealize Automation 6.2.x environment containing an updated PostgreSQL database blocks administrator access. Problem If an upgraded PostgreSQL database is used by vRealize Automation 6.2.x, an administrator must add an entry to the pg_hba.conf file that provides access to this database from vRealize Automation.
Migrating vRealize Automation 6.2 to 7.2 26 VMware, Inc.
Index C connecting, Native Active Directory 12 I identity stores, migrating 11 L local user account, creating 11 M migrate, vRealize Automation 15 migrating identity stores 11 migration post-migration tasks 19 prerequisites 7 N Native Active Directory store, migrating 11 P post-migration task clustered environment 21 reinstall plug-ins 21 update license key 19 validate migration 22 T tenant and IaaS administrators, migrating 20 troubleshooting, external PostgreSQL database 25 U updated information 5
Migrating vRealize Automation 6.2 to 7.2 28 VMware, Inc.
