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.
- 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.
Mounting File Systems From an Instance
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
- Red Hat Linux
Here's an example of the information contained in a mount command sample. The file system name is used to create directory names:
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).
When mounting file systems, the following mount option combination is not supported by the File Storage service:
softwhen 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:
softwhen the file system is mounted with the read-only mount option (
-o ro) and the
timeohas been specified as less than
300seconds. This combination can cause a profusion of I/O error responses.
wsize. These options cause issues with performance.
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 to work in.
For administrators: The policy in Let users create, manage, and delete file systems allows users to obtain mount commands.
Using the Console
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.
- Find the file system you want to mount, click the Actions menu, and then click View Details.
- In Resources, click Exports.
Find the export in the mount target you want to use to mount the file system, click the Actions menu, and then click Mount Commands.Tip
To be sure that you select the correct export, check the following:
- The export path: This path uniquely identifies the file system within the mount target. No two exports in a mount target can have the same export path, even if the exports are for the same file system.
- The mount target name: File systems can be exported through more than one mount target. Be sure that you've selected the export for the correct mount target.
- In Image, choose the image of the compute instance you want to mount the file system to.
- Click the Copy link to copy the commands.