Oracle Cloud Infrastructure Documentation

Setting a File System's Reported Size

Learn how and why to change the reported size of a File Storage file system.

The File Storage service reports file system capacity as 8589934592 gibibytes (GiB) and 8589934592 gibiinodes (GiI) by default. Sometimes, application installers perform a space requirement check before running an installation process but can't correctly interpret the reported size or reported inodes of the file system. When this occurs, you can define the file system size reported to the OS by setting the Reported Size or Reported Inodes value in the file system's mount target. Typically, setting the size to 1024 GiB and the inodes to 1024 GiI permits successful installation.

Important

Changing the Reported Size or Reported Inodes for a mount target affects all file systems exported by the mount target. Changing these values doesn't limit the amount of data you can store.

Because users can change these two values at any time in a file system's lifecycle, it's important to keep Reported Size set to a value large enough to meet the needs of the OS and its applications. If the value is too small, the OS could report insufficient space, such as when running the df command on a Linux OS.

Note

There can be a delay of up to 1 hour when reporting file system usage, either in the Console or by using the df command. For more information, see File System Usage and Metering.
    1. Open the navigation menu and click Storage. Under File Storage, click File Systems.

    2. In the List scope section, under Compartment, select a compartment.

    3. Click the name of the file system that you're interested in.
    4. On the file system's details page, in Exports, click the mount target name.
    5. On the mount target's details page, click the NFS tab.
    6. Click the Reported size (GiB) or the Reported Inodes (Gil) edit icon.
    7. Enter the maximum free space in gibibytes or the maximum inodes in gibinodes you want the File Storage service to report.
    8. Click the Save icon.

  • Use the fs export-set update command and required parameters to change the reported size of the file systems exported by the export set:

    oci fs export-set update --export-set-id <export_set_ OCID> --max-fs-stat-bytes <number_of_bytes>
    Important

    The maximum free space setting affects each export in the export set. Setting the maximum free space does not limit the amount of data you can store.

    For a complete list of parameters and values for CLI commands, see the CLI Command Reference.

  • Run the UpdateExportSet operation to change the reported size of a file system.

    For information about using the API and signing requests, see REST API documentation and Security Credentials. For information about SDKs, see SDKs and the CLI.