Oracle Cloud Infrastructure Documentation

Upgrading Storage Gateway

You are notified when there is a new version of Storage Gateway 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.
  • An email notification is sent if you have configured email notifications (see Configuring Email Notification for details).


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, as 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 Pending Uploads show 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 (for example, you lose 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. Then 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 Oracle Cloud Infrastructure Object Storage. The more objects there are in the buckets, the longer the 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. You must recreate those same 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