Oracle Cloud Infrastructure Documentation

Upgrading Storage Gateway

Storage Gateway notifies you when there is a new version available for you to download and install:

  • A pop-up notification appears in the management console after you log in.
  • A small banner notification appears at the top of the Dashboard.
  • If you have configured email notifications, the system sends an email notification. See Configuring Email Notification for details.

Important

If you are upgrading from Storage Gateway 1.0, 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.

Upgrading Storage Gateway

To upgrade to Storage Gateway 1.2.1

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. Storage Gateway version 1.2.1 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.

To recreate your file systems