Home > Storage > PowerScale (Isilon) > Product Documentation > Storage (general) > PowerScale OneFS: Long Filename Support > Configuring long filename support
You can configure and manage OneFS long filename support from the OneFS CLI using the isi namelength command set. The subcommands and syntax for this utility are as follows:
# isi namelength -h
Description:
Manage file name length configurations.
Required Privileges:
ISI_PRIV_CLUSTER
Usage:
isi namelength <action>
[--timeout <integer>]
[{--help | -h}]
Actions:
create Create a file name length configuration domain.
delete Delete a file name length configuration or all configurations.
modify Modify a file name length configuration domain.
list View a list of file name length configuration domains.
view View detailed properties of a file name length configuration
domain.
Options:
Display Options:
--timeout <integer>
Number of seconds for a command timeout (specified as 'isi --timeout NNN
<command>').
--help | -h
Display help for this command.
See 'isi namelength <subcommand> --help' for more information on a specific subcommand.
Configure a PowerScale cluster for long filename support as follows:
Step 1: Verify OneFS version and upgrade cluster
The uname CLI command output displays a cluster’s current OneFS version.
For example:
# uname -sr
Isilon OneFS v9.7.0.0
The current OneFS version information is also displayed at the upper right of any of the OneFS WebUI pages.
Step 2: Upgrade cluster OneFS version, if required
If the output from step 1 shows the cluster running an earlier release than OneFS 9.3, an upgrade to OneFS 9.3 or later is required. You can perform the upgrade from the CLI with the isi upgrade cluster command or in the OneFS WebUI at Cluster Management > Upgrade.
Once the upgrade has completed, it must be committed, either through the WebUI prompts or the isi upgrade cluster commit CLI command.
Step 3. View cluster’s long filename support status
The isi namelength list CLI command output shows a cluster’s long filename support status. For example, the following cluster already has long filename support enabled on the /ifs/tst path:
# isi namelength list
Path Policy Max Bytes Max Chars
-----------------------------------------
/ifs/tst restricted 255 255
-----------------------------------------
Total: 1
Step 4. Configure long filename support
To enable long filename support, run the isi namelength create <path> CLI command on the cluster:
# mkdir /ifs/lfn
# isi namelength create --max-bytes 1024 --max-chars 1024 /ifs/lfn
By default, name length support is created with default maximum values of 255 bytes in length and 255 characters.
Step 5: Confirm that the long filename support is configured
Run the isi namelength list CLI command to confirm that the cluster’s /ifs/lfn directory path is now configured to support long filenames:
# isi namelength list
Path Policy Max Bytes Max Chars
-----------------------------------------
/ifs/lfn custom 1024 1024
/ifs/tst restricted 255 255
-----------------------------------------
Total: 2