Oracle Cloud Infrastructure Documentation

Paths in File Systems

There are three kinds of paths that are used in the File Storage service:

  1. Export Paths are specified when a file system is associated with a mount target. It uniquely identifies the file system within the mount target, letting you associate up to 100 file systems behind a single mount target. The export path is appended to the mount target IP address, and used to mount (logically attach) to the file system. This path is unrelated to any path within the file system or the client instance. It exists solely as a way to distinguish one file system from another within a single mount target.

    In this mount command example, 10.0.0.6 is the mount target IP address./example/path is the unique export path that was specified when the file system was associated with a mount target during creation.

    sudo mount 10.0.0.6:/example/path /mnt/mountpointA

    Important

    The path must start with a slash (/) followed by a sequence of zero or more slash-separated elements. For multiple file systems associated with a single mount target, the path sequence for the first file system cannot contain the complete path element sequence of the second file system path sequence. Paths cannot end in a slash. No path element can be a period (.) or two periods in sequence (..). Lastly, no path can exceed 255 bytes.

    Examples:

    Acceptable:

    /example and /path

    /example and /example2

    Not Acceptable:

    /example and /example/path

    / and /example

    /example/

    /example/path/../example1

  2. Mount Point Paths are paths within a client instance to a locally accessible directory to which the remote file system is mounted.

    In this mount command example, /mnt/mountpointA is the path to the directory on the client instance on which the external file system is mounted.

    sudo mount 10.0.0.6:/example/path /mnt/mountpointA

  3. File System Paths are paths to directories within the file system, and contain the contents of the file system. When the file system is mounted, you can create any directory structure within it you like. Snapshots of the file system can be accessed using the file system path, under the file system's root directory at .snapshot/name.

    The following example shows the path to a snapshot called 'January 1' when navigating from the instance:

    /mountpointA/.snapshot/January1