Executing commands and setting options for a vFiler unit

Methods for executing commands for a vFiler unit

You can enter commands for a vFiler unit in the following ways:

From the context of the vFiler unit, you can enter commands directly.
When a command is run in the context of a vFiler unit, it is executed as if it is being run on the vFiler unit's console. The command is subject to the constraints of that vFiler unit.

See Entering commands from the vFiler unit.
From the hosting storage system, you can use the vfiler run command to execute commands for the specified vFiler unit.
See Entering commands for a vFiler unit from the hosting storage system.
From the client of a vFiler unit, you can establish an rsh connection with the vFiler unit and then enter the commands.
See Entering a command for a vFiler unit through rsh.

Note
Not all Data ONTAP commands can be executed for a vFiler unit, and special considerations or restrictions apply to some of those that can be executed. To see what commands are supported, enter ? from the context of a vFiler unit (see Entering commands from the vFiler unit) or enter the following command:
vfiler runvfilertemplate?
Special considerations and restrictions are described in the "vFiler considerations" section of each command's man pages.

Entering commands from the vFiler unit

To enter commands for a vFiler unit from the vFiler unit, complete the following steps:

Step	Action
1	To run in the context of the vFiler (as if the command is run on the vFiler unit's console), enter the following command: vfiler context vfiler_name Example vfiler context vfiler1
2	Enter the command you want to run: Example `?` This shows all the commands available to you from the context of the vFiler unit.
3	To return to the context of the hosting storage system, enter the following command: vfiler context vfiler0

Step

Action

To run in the context of the vFiler (as if the command is run on the vFiler unit's console), enter the following command:

vfiler context vfiler_name

Example

vfiler context vfiler1

Enter the command you want to run:

Example

?

This shows all the commands available to you from the context of the vFiler unit.

To return to the context of the hosting storage system, enter the following command:

vfiler context vfiler0

Entering commands for a vFiler unit from the hosting storage system

To enter commands for a vFiler unit from the hosting storage system, complete the following step.

Step	Action
1	Enter the following command: vfiler run vfilertemplate command Example vfiler run vfiler1 useradmin

Step

Action

Enter the following command:

vfiler run vfilertemplate command

Example

vfiler run vfiler1 useradmin

Note
Not all Data ONTAP commands can be executed for a vFiler unit. To see what commands are supported, enter ? from the context of a vFiler unit (see Entering commands from the vFiler unit) or enter the following command:

vfiler run vfilertemplate ?

Prerequisites for entering commands through rsh from a vFiler unit client

You must meet the following prerequisites if you want to enter commands for a vFiler unit through rsh:

The rsh protocol must be allowed for the vFiler unit. By default, rsh is allowed.
The rsh protocol must be enabled for the vFiler unit; that is, the rsh.enable option for the vFiler unit must be set to On. By default, rsh is enabled.
You must enter the command on a client that is permitted to have rsh access to the vFiler unit. In other words, the client must be one of the hosts specified by the rsh.access option for the vFiler unit.

Commands that you can enter through rsh

You can enter the commands listed in the following table through an rsh connection to a vFiler unit.

?	help	qtree	passwd
exportfs	quota	options	hostname
lun	igroup	iscsi

Note
The hostname command is only for displaying, not changing, the name of the vFiler unit.

Entering a command for a vFiler unit through rsh

To enter a command for a vFiler unit through an rsh connection, complete the following step.

Step	Action
1	Enter the following command: rsh vfiler_IP_address command Example The following command displays all options on the vFiler unit whose IP address is 123.123.123.1: rsh 123.123.123.1 options

Options that can be set for a vFiler unit

Not all Data ONTAP options are supported on a vFiler unit. You can use the options command for the following options:

all cifs options
all dns options
all nfs options
all nis options
rsh.access
all pcnfsd options
wafl.default_nt_user
wafl.default_unix_user
wafl.nt_admin_priv_map_to_root
all wafl.wcc_ options

Exception

You can display the cifs.wins_servers option only from the hosting storage system.

Path names specified by options

Path names specified by options are complete path names. For example, the path name specified by the cifs.home_dir option should begin with the /vol/vol_name prefix.