To upgrade vCloud Director Object Storage Extension to version 1.0.1, you uninstall the earlier version of the software from the host machine, install the new RPM package, and run a data migration script. Before you install the vCloud Director Object Storage Extension 1.0.1 RPM package, upgrade your Cloudian HyperStore to version 7.1.6.

During the migration, vCloud 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 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 vCloud Director Object Storage Extension machine.
  2. To migrate existing data, run the following command:
    vose_cli migration start
    The migration script puts vCloud 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) To review the progress of data migration tasks, run the following command:
    vose_cli 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 vCloud Director Object Storage Extension 1.0.1.