Oracle Cloud Infrastructure Documentation

Managing File Systems

A Storage Gateway file system connects a directory on a local host to an Object Storage bucket in Oracle Cloud Infrastructure. This topic describes how to manage Storage Gateway file systems.

Adding a File System

You can add file systems in Storage Gateway and connect each file system to an Object Storage bucket in your tenancy.

To add a file system

Connecting a File System

After you create a file system, you must connect the file system to an Oracle Cloud Infrastructure Object Storage bucket before you can store and retrieve data through the file system.


If network connectivity with Oracle Cloud Infrastructure is lost, your file system is disconnected.

To connect a file system

Mounting File Systems on Clients

Each Storage Gateway file system maps a directory to an Oracle Cloud Infrastructure Object Storage bucket. To establish the connection between Storage Gateway and an NFS client, you must mount the Storage Gateway file system on the NFS client.

Any Linux/UNIX NFS client certified to work with NFSv4 server running on Oracle Linux 7.x is compatible with Storage Gateway.


Storage Gateway does not currently support NFS clients running on Windows or Mac OS.

To mount a Storage Gateway file system

Viewing the Details of a File System

You can view the configuration details of a file system and monitor the upload activity through the management console of Storage Gateway.

To view the details of a file system

Changing the Properties of a File System

You can change the properties of a file system using the Storage Gateway management console.

To change the properties of a file system

Refreshing a File System

The auto-refresh feature triggers file system refreshes based on a time interval you specify. The system schedules the next refresh after any in-progress refresh completes. That means the elapsed time between the beginning of any two successive refreshes is equal to the specified auto-refresh interval plus the time required to run a file system refresh.

Use the following command to configure the auto-refresh feature:

ocisg set <file_system_name> dataset.refreshInterval=<interval_in_minutes>

The configuration command works on created and connected file systems. The configuration does not take effect until the file system is disconnected and reconnected or the Storage Gateway application restarts. To apply the changes, run:

ocisg down
ocisg up

Attribute caching can cause NFS clients to be unaware of files, corresponding to new objects in the bucket, that are created in a Storage Gateway file system during a refresh. You can use the noac mount option to turn off attribute caching. Turning off attribute caching can affect system performance.

When you run a refresh, the system reads attributes and fetches information about all objects in the corresponding bucket. Use a larger refresh interval for buckets with many objects.


After you refresh a file system, or create one for a bucket that already contains objects, Oracle recommends that you check for any files that might have been missed due to network connectivity issues.

To check for missing files, run the following command:

zgrep -ni "failed to get the object for" <path_to_gateway_logs>/<file_system_name>.*

For example, if the path to the gateway logging directory is /ocisg/log and the file system name is my-fs-1, the command is:

zgrep -ni "failed to get the object for" /ocisg/log/my-fs-1.*

Files listed in the output of this command were not successfully registered with the gateway. If any file names appear in the list, refresh the file system again.

Disconnecting a File System

When a file system is disconnected, no one can access or modify that file system.

We recommend disconnecting file systems that are not in use. Disconnecting a file system frees up the resources associated with that file system, making those resources available to file systems that are active (connected).

To disconnect a file system

You can resume storing and retrieving data by connecting the file system again. You can delete the disconnected file system when you no longer need it. For more information, see Deleting a File System.

Importing an Existing File System

Before you import an existing file system from another Storage Gateway, ensure that any pending file uploads to Oracle Cloud Infrastructure Object Storage are complete.

To import an existing file system

Deleting a File System

You can delete a file system from Storage Gateway when you no longer need it.

To delete a file system: