File Storage Paths

The File Storage service uses these kinds of paths:

  • Export Paths are part of the information contained in an export that makes a file system available through a mount target.

    The export path is automatically generated when you create an export, and it uniquely identifies the file system within the mount target.

    Note – When you create an export from the CLI, you must specify a --path <path> argument. The path you specify is recorded but not used for mounting file systems. The appliance auto-generates a path that is used to mount the file system.

    Export path syntax:

    /export/<file-system-OCID-unique-string>
                         

    where:

    • /export/ – Is the beginning of the export path.

    • <file-system-OCID-unique-string> – Is the unique character string portion of the file system's OCID.

    For example, a file system with this OCID . . .

    ocid1.filesystem.oc1.pca.d0v812zdp48onybubehhx1c67i4p3mjfth5avt3z2rkn50uqpbce3fhsa8nm

    . . . has an export path that looks like this:

    /export/d0v812zdp48onybubehhx1c67i4p3mjfth5avt3z2rkn50uqpbce3fhsa8nm

    The export path is used by a file system client 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.

    Example of an export path in a client's mount command:

    sudo mount -t nfs  \
     -o nfsvers=4.0 192.0.2.0:/export/d0v812zdp48onybubehhx1c67i4p3mjfth5avt3z2rkn50uqpbce3fhsa8nm /mnt/fs

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

    Export paths cannot be edited after the export is created.

    For more information about export paths and mounting file systems, refer to the File System Storage in the Oracle Private Cloud Appliance User Guide.

  • 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/fs is the path to the directory on the client instance on which the external file system is mounted.

    sudo mount -t nfs  \
     -o nfsvers=4.0 192.0.2.0:/export/d0v812zdp48onybubehhx1c67i4p3mjfth5avt3z2rkn50uqpbce3fhsa8nm /mnt/fs
  • 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.