Upgrading to VMware Identity Manager 2.4. x from 2.1 or 2.1.1VMware Identity Manager 2.4This 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.EN-001892-02Upgrading to VMware Identity Manager 2.4.x from 2.1 or 2.1.12 VMware, Inc.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:docfeedbackvmware.comCopyright 2015, 2016 VMware, Inc. All rights reserved. Copyright and trademark information.VMware, Inc. 3401 Hillview Ave. Palo Alto, CA 94304 www.vmware.comContentsUpgrading to VMware Identity Manager 2.4. x from 2.1 or 2.1.151About Upgrading to VMware Identity Manager 2.4. x72Preparing to Upgrade VMware Identity Manager9 Prerequisites for Upgrade9 Check for the Availability of a VMware Identity Manager Upgrade Online10 Configure Proxy Server Settings for the VMware Identity Manager Appliance11 Upgrading a Cluster113Perform an Online Upgrade to VMware Identity Manager 2.4. x154Perform an Offline Upgrade to VMware Identity Manager 2.4. x17 Prepare a Local Web Server for Offline Upgrade17 Configure the Appliance and Perform Offline Upgrade185Post-Upgrade Configuration196Troubleshooting Upgrade Errors21 Checking the Upgrade Error Logs21 Rolling Back to Snapshots of VMware Identity Manager21 Collecting a Log File Bundle22Index23VMware, Inc. 3Upgrading to VMware Identity Manager 2.4.x from 2.1 or 2.1.14 VMware, Inc.Upgrading to VMware Identity Manager 2.4. x from 2.1 or 2.1.1Upgrading to VMware Identity Manager 2.4.x from 2.1 or 2.1.1 describes how to upgrade to VMware Identity Manager 2.4.x. Upgrade is supported from versions 2.1 or 2.1.1.If you have an earlier version, you must migrate to Workspace Portal 2.1 before you can upgrade to version 2.4.x. See the Migrating VMware Workspace Portal document for information. VMware Identity Manager was formerly named VMware Workspace Portal.If you would prefer to do a fresh installation of version 2.4.x, see VMware Identity Manager Installation and Configuration. Remember that a new installation does not preserve your existing configurations.For information about using your updated VMware Identity Manager instance, see the VMware Identity Manager Administrators Guide.Intended AudienceThis information is intended for anyone who installs, upgrades, and configures VMware Identity Manager. The information is written for experienced Windows or Linux system administrators who are familiar with virtual machine technology.VMware Technical Publications GlossaryVMware Technical Publications provides a glossary of terms that might be unfamiliar to you. For definitions of terms as they are used in VMware technical documentation, go to http:/www.vmware.com/support/pubs.VMware, Inc. 5Upgrading to VMware Identity Manager 2.4.x from 2.1 or 2.1.16 VMware, Inc.About Upgrading to VMware Identity Manager 2.4. x1The following upgrade paths and scenarios are supported.Supported Upgrade PathsThe following upgrade paths are supported:nVersion 2.1.0 to 2.4.xnVersion 2.1.1 to 2.4.xIMPORTANT If you have an earlier version, you must migrate to version 2.1 before you can upgrade to VMware Identity Manager 2.4.x. See the Migrating VMware Workspace Portal document for information.VMware Identity Manager was formerly named VMware Workspace Portal.Upgrade ScenariosnYou can only upgrade a VMware Identity Manager service virtual appliance.nUpgrade of an entire cluster is not supported.If you have deployed a cluster, you need to perform certain tasks before upgrade, upgrade the master virtual appliance, and then create a cluster again. See “Upgrading a Cluster,” on page 11 for information.nIf you deployed a connector-only virtual appliance, connected to a service virtual appliance, first upgrade the service virtual appliance, then deploy a new connector-only virtual appliance.Internet ConnectivityYou can upgrade to VMware Identity Manager 2.4.x online or offline.By default, the VMware Identity Manager appliance uses the VMware Web site for the upgrade procedure, which requires the appliance to have Internet connectivity. You must also configure proxy server settings for the appliance, if applicable.If your virtual appliance does not have Internet connectivity, you can perform the upgrade offline. For an offline upgrade, you download the upgrade package and set up a local Web server to host the upgrade file.VMware, Inc. 7Upgrading to VMware Identity Manager 2.4.x from 2.1 or 2.1.18 VMware, Inc.Preparing to Upgrade VMware Identity Manager2To prepare for the upgrade, you must perform a number of prerequisite tasks, such as checking for available upgrades and configuring the proxy server settings for the appliance, if applicable.T