To upgrade VMware Cloud Director Object Storage Extension to version 1.5, uninstall the earlier version of the software from the host machine and install the new RPM package. If you are upgrading from VMware Cloud Director Object Storage Extension version 1.0, you must also run a data migration script.

During the migration, VMware Cloud Director users are mapped to new identities in the underlying storage system. The migration script grants the same access permissions for buckets and objects that the users had before the migration. After the migration, users cannot change the access permissions for the migrated buckets and objects. For migrated vApps and catalogs, updating the share status is not possible.

Prerequisites

Procedure

  1. Open an SSH connection to the VMware Cloud Director Object Storage Extension machine.
  2. Migrate the existing data.
    ose migration start

    The migration script puts VMware Cloud Director Object Storage Extension services into maintenance mode and restarts the services upon a successful completion.

    If necessary, you can restart the data migration operation. Rerun the same command and append the --force argument. Rerunning the script with the --force argument deletes the existing migration tasks and creates new ones.

    Once the data migration starts, the system returns the following message: Successfully started migrate tasks. Upon a successful completion, the system returns the following message:
    [Migration Task]
    ID : task-ID
    Status : COMPLETED
    Progress : 100
    StartDate : 2019-10-10T08:14:18.041+0000
    EndDate : 2019-10-10T08:17:07.006+0000
    Type Migration : success
    Path Migration : success
    Permission Migration : success
  3. (Optional) Review the progress of data migration tasks.
    ose migration show
    The system returns the following:
    [Migration Task]
    ID : task-ID
    Status : RUNNING
    Progress : 66
    StartDate : 2019-10-10T08:14:18.041+0000
    EndDate : 2019-10-10T08:17:07.006+0000
    Type Migration : success
    Path Migration : success
    Permission Migration :
    + 0838
    ...
    + bucket-name1
    + bucket-name2
    - filename1.jpeg
    - filename2.log
    - filename3.cer

Results

Once data migration is complete, you can start using the new version of VMware Cloud Director Object Storage Extension.