Oracle Cloud Infrastructure Documentation

Upgrading Storage Gateway

Upgrade Storage Gateway.

Note

If you are upgrading from Storage Gateway, underlying database and schema changes require you to recreate your Storage Gateway file systems. See Recreating Your File Systems for details.

Before You Begin

  • Plan for downtime appropriately since the upgrade takes some time to complete. The downtime varies depending on the system resources, the number of file systems, and the number of files.

  • Wait for any pending or ongoing write operations from the NFS client instances to complete, then unmount all file systems.

  • Wait for pending uploads to Oracle Cloud Infrastructure Object Storage to complete. On the Dashboard under System Status, ensure that the Pending Uploads field shows 0.

  • Disconnect all of the file systems.

  • Ensure that there is no ongoing activity in the Activity tab for each file system in the management console.

    Important

    To enable partial update capabilities in Storage Gateway, there must be no pending uploads for any associated file systems before the upgrade. The upgrade process purges the existing local cache across all Storage Gateway file systems.

Upgrading Storage Gateway

To upgrade to Storage Gateway:
  1. Log in to your Storage Gateway host.
  2. Download the latest version of the Storage Gateway tar archive.

  3. Extract the files from the downloaded ocisg-version.tar.gz file: 

    tar xvzf ocisg-x.x.tar.gz

    This command extracts the file's contents to a subdirectory named ocisg-version.

  4. Change directory to ocisg-version:

    cd ocisg-x.x

  5. Run the installation script as sudo or root user:

    sudo ./ocisg-install.sh

If you encounter any interruption during the upgrade, such as lost connectivity, rerun the installation script to resume the upgrade.

If you are upgrading from Storage Gateway 1.0, you must recreate the file systems that were created in the 1.0 version of the Storage Gateway software. Connect the file systems in the management console and claim ownership if there's a bucket ownership prompt. The Storage Gateway upgrade rebuilds the local metadata for existing buckets in Object Storage. The more objects there are in the buckets, the more time it takes to rebuild the metadata.

Recreating Your File Systems

When you created file systems in Storage Gateway 1.0, corresponding Oracle Cloud Infrastructure Object Storage buckets were created. Recreate those file systems in Storage Gateway so that you can connect to the same buckets and automatically see the files that have already been uploaded to Object Storage.

When you recreate Storage Gateway file systems, data that you already uploaded to Oracle Cloud Infrastructure Object Storage is automatically included in the newly created file system.