Mounting File Systems

Users of Unix-style operating systems and Windows Server 2012 R2 and later versions can connect to a file system and write files. Mount targets serve as file system network access points for file systems. After your mount target is assigned an IP address, you can use it together with the file system export path to mount the file system. On the instance from which you want to mount the file system, you need to install an NFS client. For Unix-style operating systems, you create a mount point. When you mount the file system, the mount point effectively represents the root directory of the File Storage file system, allowing you to write files to the file system from the instance. Windows operating systems use a drive letter assignment instead of a mount point to represent root access.

Prerequisites

  • The file system must have at least one export in at least one mount target. When you create a new file system, an export for the file system is created at the same time. See Creating File Systems for more information.
  • Correctly configured security rules for the mount target. See Security Rules for information about how security rules work in Oracle Cloud Infrastructure. Use the instructions in Configuring VCN Security Rules for File Storage to set up security rules correctly for your file systems.

Obtaining Mount Command Samples

Mount command samples that include mount information for a specific mount target and file system are available in the Console. Samples are available for the following operating system images:

  • Oracle Linux
  • CentOS
  • Debian
  • Red Hat Linux
  • Ubuntu

Here's an example of the information contained in a mount command sample. The file system name is used to create directory names:

This image shows sample mount commands for an Oracle Linux instance.

If you specified a hostname for the mount target, the sample uses the FQDN in the commands. If you didn't specify a hostname, the sample uses the mount target IP address. Using a FQDN to mount your file system is optional; even if you specified a hostname, you can edit the command to use the IP address instead. If you use an FQDN to mount the file system, ensure that the the FQDN correctly resolves to the mount target's IP address. For more information, see DNS in Your Virtual Cloud Network.

Mount command samples mount the file system at the file system root directory. Mount command samples don't include subdirectory information for the file system. If you want to mount a subdirectory of the file system, you must edit the sample to append the subdirectory path to the export path. For more information on mounting subdirectories in Linux-type instances, see To mount a file system subdirectory (Linux). For more information on mounting subdirectories in Windows instances, see To mount a file system subdirectory (Windows).

Caution

When mounting file systems, the following mount option combination is not supported by the File Storage service:

  • soft when the file system is mounted with the read/write mount option (-o rw). This combination can cause corruption of your data.

The following mount options or mount option combinations are not recommended for use with the File Storage service:

  • soft when the file system is mounted with the read-only mount option (-o ro) and the timeo has been specified as less than 300 seconds. This combination can cause a profusion of I/O error responses.
  • rsize, or wsize. These options cause issues with performance.
Note

When mounting file systems, Network Lock Manager (NLM) is enabled for file locking by default. The default requires no specified mount option. Typical NFS workloads function normally using the default.

Some applications might require you to specify the nolock mount option. Refer to your application documentation for best practices regarding this mount option.

Required IAM Service Policy

To use Oracle Cloud Infrastructure, you must be granted security access in a policy  by an administrator. This access is required whether you're using the Console or the REST API with an SDK, CLI, or other tool. If you get a message that you don’t have permission or are unauthorized, verify with your administrator what type of access you have and which compartment  you should work in.

For administrators: The policy in Let users create, manage, and delete file systems allows users to obtain mount commands.

If you're new to policies, see Getting Started with Policies and Common Policies.

Using the Console

To get mount command samples
  1. Open the navigation menu. Under Core Infrastructure, click File Storage and then click File Systems.
  2. In the List Scope section, select a compartment.

    The Console displays a list of file systems that have already been created in the compartment, if any.

  3. Find the file system you want to mount, click the Actions icon (three dots), and then click View File System Details.
  4. In Resources, click Exports.
  5. Find the export in the mount target you want to use to mount the file system, click the Actions icon (three dots), and then click Mount Commands.

    Tip

    To be sure that you select the correct export, check the following:

  6. In Image, choose the image of the Compute instance you want to mount the file system to.
  7. Click the Copy link to copy the commands.

Next, mount the file system from a Unix-style or Windows instance.