All Products
Search
Document Center

Cloud Parallel File Storage:Limitations

Last Updated:Jun 12, 2026

This topic describes the limitations of CPFS for Lingjun file systems.

Mounting limitations

  • Supported clients: Lingjun resources, Platform for AI (PAI) general-purpose computing resources, PAI Lingjun resources (single-tenant), and Container Compute Service (ACS) (for high-performance network GPU-accelerated workloads).

  • Unsupported: Direct mounting from ECS instances.

  • Protocol: Only the POSIX protocol is supported.

File system limitations

Limit

Value

Description

Mount targets per file system

1

Each CPFS for Lingjun file system supports a maximum of one VPC mount target.

Subdirectory mounting

Supported

You can mount a subdirectory of a CPFS for Lingjun file system.

Maximum capacity per file system

1 PiB

The maximum capacity of a single file system is 1 PiB.

To create a file system with up to 20 PiB of capacity, submit a ticket.

Maximum number of files or directories per file system

10 billion

The number of supported files and directories increases with the file system capacity.

Maximum number of nodes per file system (mounted over VSC)

4,000

A single file system can be accessed by up to 4,000 nodes over VSC.

Maximum path length

4,096 bytes

In the Linux VFS, the maximum length of an access path, such as /a/b/c, is 4,096 bytes.

Maximum file name length

255 bytes

File names cannot exceed 255 bytes.

Maximum number of ECS instances per VPC mount target

6,000

Each 300 TiB of capacity supports 500 ECS instances accessing the file system through a VPC mount target. A single file system supports a maximum of 6,000 ECS instances. To mount more instances, submit a ticket.

Default bandwidth for VPC access to a single file system

Read: 10 GB/s

Write: 5 GB/s

The default maximum bandwidth for accessing a file system over a VPC is 10 GB/s for reads and 5 GB/s for writes.

Directory naming constraints

To ensure system stability and support for enterprise features, CPFS for Lingjun reserves specific directory names. If you attempt to create a directory with a reserved name, the system returns an EPERM error. There are two categories of reserved names:

  • Reserved only in the file system root directory: An EPERM error is returned only if you attempt to create a directory with one of these names in the file system root directory.

  • Reserved in all directories: An EPERM error is returned if you create a directory with one of these names at any level within the file system.

Scope

Reserved directory names

File system root directory only

.msgq, .audit_log, .fakesnapshots, .mmSharedTmpDir, .sys_healthchecker, .sys_efc, .sys_statemanager, and .sys_filesets

Any directory within the file system

.snapshots and .sys_recyclebin

Operating system limitations

The CPFS for Lingjun client supports only Linux operating systems, such as Alibaba Cloud Linux and Ubuntu. The following table lists the supported versions.

Operating system

Distribution

Kernel version

Alibaba Cloud Linux

Alibaba Cloud Linux 3

5.10.134-13 or later

Ubuntu

Ubuntu 24.04

6.8.0-79 or later

Scale-out limitations

  • CPFS for Lingjun file systems only support scale-out, not scale-in.

  • Scale-out increment: 10,240 GiB. You can scale out a file system to a maximum of 1 PiB.

    To create a file system with up to 20 PiB of capacity, submit a ticket.

For capacity specifications, see Product specifications.

Dataflow limitations

  • Dataflow

    • Same-account dataflows require CPFS for Lingjun 2.4.0 or later. Cross-account dataflows require 2.6.0 or later.

    • Maximum 10 dataflows per CPFS for Lingjun file system.

    • Each file system path can link to only one OSS bucket.

    • Dataflows cannot span different regions.

  • Restrictions on paths, filenames, and directory names

    • Renaming a non-empty directory in a dataflow-associated path returns a Permission Denied or directory-not-empty error.

    • Use special characters in directory and file names with caution.

      • Supported characters include uppercase and lowercase letters, numbers, exclamation points (!), hyphens (-), underscores (_), periods (.), asterisks (*), and parentheses (()).

      • The following characters are not supported and may cause task failures:

        • A subdirectory or file name cannot be "..".

        • A path cannot contain backslashes (\) or consecutive backslashes (\\).

        • A subdirectory or file name cannot contain forward slashes (/).

    • Maximum path length: 1,023 characters.

  • Dataflow task limitations

    • Streaming tasks require CPFS for Lingjun 2.6.0 or later and are API-only.

    • Maximum four concurrent batch tasks per dataflow. Concurrent streaming tasks are unlimited.

    • Import limitations

      • Importing a symbolic link converts it into a regular data file. The symbolic link information is lost.

      • If an OSS bucket has versioning enabled, only the latest version of an object is copied.

      • Filenames or subdirectory names cannot exceed 255 bytes.

    • Export limitations

      • Symbolic links are exported as regular, empty objects. The linked file is not synchronized.

      • Hard links are exported as regular files.

      • Socket, Device, and Pipe files are exported as regular, empty objects.

      • Directory paths cannot exceed 1,023 characters.

Fileset limitations

Important

The Fileset feature is available to whitelisted users only. To use this feature, submit a ticket to be added to the whitelist.

  • Filesets

    Limitation

    Description

    File system

    Filesets are supported only on CPFS for Lingjun 2.7.0 and later.

    Number of filesets per file system

    The default quota is 500.

    To request a higher quota, up to 3,000, submit a ticket.

    Number of files or directories per fileset

    10 billion

    Fileset

    • If a parent directory is already a fileset, its subdirectories cannot be.

    • Creating hard links or renaming across filesets is not supported.

    Fileset path

    • The path must start and end with a forward slash (/).

    • The path must not already exist. The fileset path cannot be modified.

    • If the fileset path contains multiple directory levels, the parent directory must already exist.

    • The maximum path depth is 8 levels. The root directory (/) is level 0. For example, the path /workspace/dir1/ has a depth of 2.

    • The maximum total path length is 990 characters.

    • Each directory name can be up to 255 characters long and can contain uppercase and lowercase letters, digits, underscores (_), periods (.), and hyphens (-).

    Fileset deletion

    You can delete a fileset only from the console or by using an API. After deletion, the system gradually releases the disk space. Deleted data is unrecoverable. Proceed with caution.

  • Fileset quotas

    Limit

    Description

    File system

    Only CPFS Compute Edition 2.7.0 and later versions support Fileset quotas.

    Quota

    Only one quota is supported for each Fileset path.

    Quota capacity

    The minimum capacity is 10 GiB, with a scale-out increment of 1 GiB.

    Quota file count

    The minimum file count is 10,000, with a scale-out increment of 1. The maximum limit is 10 billion.

    Quota write

    If the data written to a Fileset reaches the capacity quota or the number of files written reaches the file count quota, no new data can be written.

    Quota statistics

    Quota statistics have approximately a 15-minute latency. The current actual usage will take effect after approximately 15 minutes.

    Modify quota

    When you modify a directory quota, the specified quota capacity or file count must be higher than the used capacity or file count. Otherwise, an error occurs.