Product Specifications

UTF-8 support and filename restrictions, plus key platform limits for tasks, containers, and NAS/S3/tape backends.

Character Set Support

UTF-8 Encoding Overview

UTF-8 encodes all character data, providing consistent representation across various storage systems. Defined by RFC 3629, UTF-8 is a variable-length encoding capable of representing all 1,112,064 valid Unicode code points using one to four 8-bit bytes.

• ASCII Range (U+0000 to U+007F): Encoded using a single byte, maintaining binary compatibility with ASCII.

• Higher Ranges: Encoded using two to four bytes, optimized to minimize size and maximize compatibility for frequently used characters.

This strategy ensures comprehensive Unicode support, efficient storage, and reliable interoperability with modern file systems and network protocols.

UTF-8 Restrictions

Avoid using certain UTF-8 characters in file or folder names:

• / and | are reserved by the filesystem and shell.

• % and : should not be the sole characters in a name.

When a file or folder is encoded with a non-UTF-8 character set, it will automatically be re-encoded using the format %MNGA182 followed by the hexadecimal representation of the original name. This process maintains compatibility and helps track files with unsupported or legacy encodings.

These limits apply to tasks, naming, containers, and supported backends. Some values reflect underlying OS or protocol constraints.

Limitations

These limits apply to tasks, naming, containers, and supported backends. Some values reflect underlying OS or protocol constraints.

Tasks Limitations

Tasks	Value
Maximum number of tasks	18,446,744,073,709,551,615
Maximum task name length	255 characters

Files And Directories	Value	Notes
Maximum number of files and directories	18,446,744,073,709,551,615	Includes active, archived, exchange, and deleted entries.

Names and paths	Value	Notes
Maximum filename length	255 characters	If a non-UTF-8 character is detected, the name is re-encoded. This reduces the effective max length.
Maximum path + filename length	4096 bytes	Matches OS PATH_MAX. Unicode can use multiple bytes. Practical limit is also capped at 21,845 characters.

For files or folders with non-UTF-8 characters, Nodeum re-encodes them as: %MNGA182 followed by the hexadecimal representation of the original name.

Metadata Limitations

Metadata fields	Value
Metadata name length	256 characters
Metadata value length	256 characters
Custom field name length	256 characters
Custom field value length	256 characters

Reserved Extended Attribute Metadata

The following attribute names are reserved by Nodeum for extended metadata:

• user.mtcsize

• user.mtcid

• user.mtcincache

• user.mtclastgetdate

• user.mtclastupdate

Container	Value	Notes
Maximum number of containers	100
Container name length	4–25 characters
First character	Must be lower case	Required if the container must be accessible through S3.
Unsupported patterns	_, trailing -, ;;, --, IP address (e.g. 10.10.10.2)

File System Commands

This system supports all standard file operations such as mkdir, rmdir, ls, and cd, but it does not support symbolic links.

Storage Limitations

Nas Storage	Value
Hostname length	55 characters
Target name length	255 characters
Mount options length	255 characters
Username length	255 characters
Password length	255 characters

S3 - Object Storage	Value
Cloud connector name length	25 characters
Bucket name length	64 characters
Location/region length	15 characters
Buckets	No limit
Objects per bucket	No limit
Multipart uploads returned per list request	1,000
Objects returned per list request	1,000
Parts per upload	10,000
Parts returned per list parts request	1,000
Max object size	5 TB
Max object size per PUT operation	5 TB
Min object size	0 B
Part size	5 MB to 5 GB (last part: 0 B to 5 GB)

Tape Library	Value
Tape library name length	250 characters
Tape pool name length	255 characters
Barcode length	8 characters
Maximum number of tape libraries	16
Maximum number of drives	256
Maximum number of tapes	15,000