Upgrade to EMC ViPR 2.0

Table of Contents

Upgrade from EMC ViPR 1.x to 2.0

This article describes how to upgrade to EMC ViPR 2.0 Patch 1 (also known as version from version 1.x.

Back to Top

Supported upgrade paths

If ViPR Services (also known as ViPR Data Services, or object) are installed in the ViPR 1.x configuration, upgrade is supported only if:
  • ViPR Services are disabled
  • or
  • ViPR Services data are in non-filesystem buckets only (that is, buckets of the type Amazon S3, OpenStack Swift, or EMC Atmos with object ID).
Back to Top

Pre-upgrade planning

Some pre-upgrade steps are required and you should prepare for ViPR to be unavailable for a period of time.

Prepare for the ViPR virtual appliance to be unavailable for provisioning operations for about 5 minutes, and unavailable for system management operations for approximately 30 minutes.

Back to Top

Before upgrading from 1.x: Take virtual machine snapshots

If you are upgrading from 1.x, you should take snapshots of all ViPR Controller VMs before the upgrade.

Before you begin

This procedure does not back up data services VMs. The backups made in this procedure, if they need to be restored due to an upgrade problem, can cause data loss to data services nodes. However the backups can be used to salvage Controller VMs.

In the unlikely event that there is a need to revert to a snapshot, keep in mind that the ViPR database will be at the state it was in when the snapshot was taken. Reverting to the snapshot will require less manual cleanup if no provision was been done since snapshot was taken. Because resources on the array do not get synced up automatically, any resource created or deleted since the snapshot made will be out of sync between the ViPR database and the arrays, and may need to be cleaned up manually, or recreated.

This operation requires the System Administrator role in ViPR and root access to the ViPR Controller VMs.


  1. From the ViPR UI, shutdown all VMs (Admin > System > Dashboard > Shutdown all VMs).
  2. Use vSphere Client to take a snapshot of each Controller VM. Do not snapshot the virtual machine's memory.
  3. When the snapshots are complete, power up the ViPR Controller vApp.
  4. In the ViPR UI, look at the ViPR virtual appliance state in Admin > System > Dashboard.
    When the state is Stable, you can proceed with the upgrade.
Back to Top

Upgrade procedure

You can download and install new versions of ViPR software from the Settings > Upgrade page in Admin mode.

Before you begin


  1. In Admin mode, select Settings > Upgrade.
  2. Select an available ViPR version and Download.
    The downloaded software is stored on the VM and can be installed at anytime.
  3. In the Software Versions list, click Install next to the version that you want to upgrade to.
    A rolling upgrade is performed on the ViPR VMs.
    The System Maintenance page opens while installation is in progess, and shows you the current state of the upgrade process.
    Wait for the system state to be Stable before making provisioning or data requests.
Back to Top

Post-upgrade steps

Depending on which pre-upgrade steps were taken, there may be some required steps after upgrade.

Back to Top