Managing volume languages

About volumes and languages

Every volume has a language. The storage system uses a character set appropriate to the language for the following items on that volume:

File names
File access

The language of the root volume is used for the following items:

System name
CIFS share names
NFS user and group names
CIFS user account names
Domain name
Console commands and command output
Access from CIFS clients that don't support Unicode
Reading the following files:
- /etc/quotas
- /etc/usermap.cfg
- the home directory definition file
  Attention
  You are strongly advised to set all volumes to have the same language as the root volume, and to set the volume language at volume creation time. Changing the language of an existing volume can cause some files to become inaccessible.
  
  Note
  Names of the following objects must be in ASCII characters:
Qtrees
Snapshots
Volumes

Viewing the language list online

It might be useful to view the list of languages before you choose one for a volume. To view the list of languages, complete the following step.

Step	Action
1	Enter the following command: vol lang

Choosing a language for a volume

To choose a language for a volume, complete the following step.

Step	Action
1	If the volume is accessed using...	Then...
	NFS Classic (v2 or v3) only	Do nothing; the language does not matter.
	NFS Classic (v2 or v3) and CIFS	Set the language of the volume to the language of the clients.
	NFS v4, with or without CIFS	Set the language of the volume to cl_lang.UTF-8, where cl_lang is the language of the clients. Note If you use NFS v4, all NFS Classic clients must be configured to present file names using UTF-8.
	NFS v4, with or without CIFS

Displaying volume language use

You can display a list of volumes with the language each volume is configured to use. This is useful for the following kinds of decisions:

How to match the language of a volume to the language of clients
Whether to create a volume to accommodate clients that use a language for which you don't have a volume
Whether to change the language of a volume (usually from the default language)

To display which language a volume is configured to use, complete the following step.

Step	Action
1	Enter the following command: *vol status [vol_name] -l* vol_name is the name of the volume about which you want information. Leave out vol_name to get information about every volume on the storage system. Result Each row of the list displays the name of the volume, the language code, and the language, as shown in the following sample output. Volume Language vol0 ja (Japanese euc-j)

Step

Action

Enter the following command:

vol status [vol_name] -l

vol_name is the name of the volume about which you want information. Leave out vol_name to get information about every volume on the storage system.

Result

Each row of the list displays the name of the volume, the language code, and the language, as shown in the following sample output.

Volume Language

vol0   ja (Japanese euc-j)

Changing the language for a volume

Before changing the language that a volume uses, be sure you read and understand the section titled About volumes and languages.

To change the language that a volume uses to store file names, complete the following steps.

Step	Action
1	Enter the following command: vol lang vol_name language vol_name is the name of the volume about which you want information. language is the code for the language you want the volume to use.
2	Enter the following command to verify that the change has successfully taken place: *vol status vol_name* -l** vol_name is the name of the volume whose language you changed.

Step

Action

Enter the following command:

vol lang vol_name language

vol_name is the name of the volume about which you want information.

language is the code for the language you want the volume to use.

Enter the following command to verify that the change has successfully taken place:

vol status vol_name -l

vol_name is the name of the volume whose language you changed.