- Releases Notes and Announcements
- Product Introduction
- Purchase Guide
- Getting Started
- Operation Guide
- Best Practices
- API Documentation
- Troubleshooting
- FAQs
- CFS Service Level Agreement
- Contact Us
- Glossary
- Releases Notes and Announcements
- Product Introduction
- Purchase Guide
- Getting Started
- Operation Guide
- Best Practices
- API Documentation
- Troubleshooting
- FAQs
- CFS Service Level Agreement
- Contact Us
- Glossary
What operating systems are supported by CFS?
You can use CFS over the Tencent Cloud private network (e.g., Linux, Unix, or Windows CVM, TKE, SCF, BatchCompute, and BMS instances). Customer IDCs and compute nodes of other vendors can also access CFS via VPN, Direct Connect, or CCN (click here for more information).
How is CFS billed?
CFS is billed hourly based on the peak storage usage for the hour.
Why would my CFS bill include fees for the Guangzhou region while I have never used any resource in the Guangzhou region?
As storage usage in the Chinese mainland is billed in a consolidated manner, the billing zone displayed in CFS bills is "South China (Guangzhou)". The specific regions are shown in the extended fields.
Which access protocols are supported by CFS?
NFS v3.0/v4.0 and CIFS/SMB2.0/SMB2.5/SMB3.0 are supported.
As clients on Windows and Linux 3.10 and its previous kernel version (e.g., CentOS 6.*) are incompatible with NFS v4.0, file systems cannot work normally after mount. Please use NFS v3.0 instead.
What are the common concepts used in CFS?
File system: A file system is a CFS instance. After a file system is mounted to a CVM instance, you can use it in the same way as a local storage system. It can be mounted to a subdirectory.
Mount target: A mount target is an entry for the compute node to access CFS. It defines the type of network for the node and the permission to access CFS.
How many file systems can a user create?
Up to 10 file systems can be created in a region by each user. You can submit a ticket if you need to create more.
How do I ensure data consistency if multiple applications read and write to the same file?
We recommend that you lock a file before an application reads or writes to the file to avoid errors caused by multiple applications modifying the same file simultaneously.
How fast can I copy/migrate data to CFS?
It depends on the host where the data is originally stored, the storage medium used, network conditions, and the file size. The higher performance the host delivers, the better the storage medium, and the higher the outbound bandwidth, the faster data migration will be. Assume that a host comes with 8 cores and 16 GB memory, and the bandwidth is 1.5 Gbps. For migrating a small file of 4 KB from the host's local storage to CFS using the migration tool CFS Filetruck, the speed will be about 40 KB/s, and that will be about 140 MB/s for migrating a large file of 1 TB. If you copy/migrate primarily small files, we recommend that you use NFS v3 to mount CFS to improve the speed.
What if a mount target is unavailable?
You can troubleshoot as follows:
View the error message.
Check whether
nfs-utils, nfs-common, and cifs-utils are installed.Check whether the local mount directory exists.
Check whether the mount target is in the same VPC as the client's server and whether they are in the same region.
Check whether the client's server has a security group policy prohibiting access to external ports. For more information on the specific ports, see the ports that need to be opened in a file system.
What do I do if an error is reported when I use the "vers=4.0" mount command?
As some clients support NFS v4.1 protocol, the client will first negotiate with the server to try to mount using NFS v4.1 protocol. In this case, because CFS currently only supports NFS v4.0 protocol, an NFS4ERR_MINOR_VERS_MIMATCH error may be reported, which will not affect the mount and can be ignored. Once the negotiation fails, the client and server will continue to negotiate the use of NFS v4.0 for the mount.
What do I do if I installed Windows IIS web server in the Windows Server 2016 OS, but IIS and CIFS are incompatible?
For Windows Server 2016 operating system, the possible changes of default security policies require the following configurations before IIS and CIFS Protocol can work together:
1. Modify the registry value for SMB client:
HKEY_LOCAL_MACHINE > SYSTEM > CurrentControlSet > Services > LanmanWorkstation > Parameters > AllowInsecureGuestAuth
If the registry key already exists, set it to 1. Otherwise, right-click to select New > DWORD (32-bit) Value, and set it to AllowInsecureGuestAuth with a value of 1.
2. Specify a local user for storage access:
Open the Internet Information Services (IIS) Manager, and under the current host:
2.1 Select Sites > Default Web Site, and click Basic Settings.
2.2 In the Edit Site pop-up window, click Connect as to select a specific user.
2.3 Click Set to set the username and password.
2.4 Click OK.
What if data cannot be written to CFS?
You can troubleshoot as follows:
View the error message.
Check the client's server network and run
telnet to verify whether the port of the mount target is open. For more information on the specific ports, see the ports that need to be opened in a file system.If the file system is not mounted to the mount target's root directory, check whether the corresponding mount target directory exists (in this case, the common error message is
Stale file handle. You can check whether the subdirectory exists through a device mounted to the root directory).Which ports need to be opened for the file system?
File System Protocol | Port | Check Network Connectivity |
NFS 3.0 | 111, 892, 2049 | telnet file system IP 2049 |
NFS 4.0 | 2049 | telnet file system IP 2049 |
CIFS/SMB | 445 | telnet file system IP 445 |
What if the configured access permission does not take effect?
For an NFS file system, multiple rules can be configured, which will take effect based on their priorities:
If the permission of a single IP conflicts with that of an IP within a CIDR block in the same permission group, the permission with a higher priority will apply. If their priority levels are the same, the permission of the single IP will apply.
If two overlapping CIDR blocks are configured with different permissions and the same priority levels, the permissions of the overlapping CIDR blocks will take effect randomly. Please avoid configuring overlapping CIDR blocks.
Note
Priority configuration is not supported for CIFS/SMB file systems and will not take effect.
How can I speed up copying local files to CFS?
For Linux, use the shell script below to accelerate copying local files to CFS. The "number of threads" in the code can be changed as needed.
threads=;<number of threads> src=;<source path/> dest=;<destination path/> rsync -av -f"+ */" -f"- *" $src $dest && (cd $src && find . -type f | xargs -n1 -P$threads -I% rsync -av % $dest/% )<!--例如，threads=24; src=/root/github/swift/; dest=/nfs/; rsync -av -f"+ */" -f"- *" $src $dest && (cd $src && find . -type f | xargs -n1 -P$threads -I% rsync -av % $dest/% )-->
What should I do if an exception occurs when I rename a file or directory on Windows?
Due to issues between the client and the supported protocols, renaming a file or directory may fail if a Windows client mounts the file system with NFS. In this case, we recommend you use CIFS/SMB for CFS file systems on Windows.
What if a file system has no write permission on Windows after being mounted with NFS?
Add
AnonymousUid and AnonymousGid to the Registry as described in the operation guide and try again after restarting the system.
For more information, see Using CFS File Systems on Windows Clients.What if mapped drives cannot be used with Windows IIS?
You can configure the correct NFS client program and modify the Registry (by adding users for access) as instructed in Using CFS File Systems on Windows Clients.
Restart the client, open the IIS configuration page, add a site, and click Advanced Settings.
In Advanced Settings, set Physical Path to the CFS mount target.
Mounting a CFS file system on Docker or Kubernetes sometimes succeeds and sometimes fails. How can I resolve this issue?
This issue is caused by protocol compatibility. NFS v3 is recommended for mounting CFS with clients such as Docker and Kubernetes. Using NFS v4 may lead to issues with some clients.
What if I want to use a CFS file system on Window Server 2012 R2 as IIS server directory, but the file system cannot be mounted?
IIS will convert the FSID needed for mounting with NFS v3.0 to uppercase, which prevents the file system from being mounted. We recommend using Windows Server 2016 to avoid this issue.
How can I continue using CFS in an AZ where CFS resources are sold out?
Assume that there is a CVM instance in Guangzhou Zone 1 that needs to use CFS, but file systems cannot be directly created in Guangzhou Zone 1 as the resources are sold out there.
In a VPC
If the CVM instance is in the "Guangzhou Zone 1" subnet of a VPC, you can log in to the VPC console to create a subnet whose AZ is "Guangzhou Zone 2" for the VPC.
After the subnet is successfully created, go back to the CFS console and select this VPC and the subnet you just created to create resources in Guangzhou Zone 2. The CFS file system can be directly mounted to the CVM instance in the subnet of Guangzhou Zone 1 in this VPC.
CIFS/SMB file system user guide:
In the classic network
If the CVM instance resides in the classic network, you can create a VPC and a subnet in Guangzhou Zone 2, and then create a file system in this network. With Classiclink, you can connect the classic network and the VPC for access. For more information, see Managing Basic Networks.
The file content update is out of sync. How can I fix this?
Symptom
An NFS file system is mounted on two Linux-based CVM instances.
append is used to write to a file on CVM instance A, and tail -f is used to view changes to the file on CVM instance B. After data is written to the file on CVM instance A, it takes 10 to 30 seconds for the change to be visible on CVM instance B. However, if you open the file directly on CVM instance B (e.g., using the vi command), you can view the change immediately.Cause
This issue is related to the options of the NFS mount command and the implementation of
tail -f. The following mount command is used:sudo mount -t nfs -o vers=4.0 <mount target IP>:/ <Destination mount directory>
If CVM instance B mounts the file system with the NFS mount command, the kernel will maintain a metadata cache of the file and directory attributes (e.g., permissions, size, and timestamp) by default. The purpose of caching is to reduce the number of NFSPROC_GETATTR remote procedure calls (RPCs).
tail -f observes the changes to file attributes (mainly the file size) through sleep+fstat and then reads the file and outputs the content. The result of fstat determines whether tail -f can output the file content in real time. However, due to the metadata cache of file and directory attributes, fstat cannot poll real-time file attributes. As a result, although the file on the NFS server has been updated, tail -f cannot observe the change, which causes an output delay.Solution
Add the
noac option when mounting the file system with the mount command to disable the caching of file and directory attributes. The mount command is as follows:sudo mount -t nfs -o vers=4.0,noac <mount target IP>:/ <Destination mount directory>sudo mount -t nfs -o vers=3,noac,nolock,proto=tcp <mount target IP>:/<FSID or subdirectory> <Destination mount directory>
What if error 0x800704C9 occurs when a file system is mounted with NFS to a client based on Windows 7 or Windows Server 2008 R2?
Cause
The issue occurs because Windows 7-based and Windows Server 2008 R2-based clients cache the original port numbers used to communicate with nlockmgr. For details, see the Microsoft help documentation.
Solution
Run Windows Update to upgrade the OS to the latest version to fix this issue.
Yes
No
Was this page helpful?