Changing resources for vFilers

What you can change

You can add, move, or remove resources for vFilers. The resources can be network resources (that is, IP addresses) or storage resources (that is, volumes or qtrees).

Effects of changing resources

Adding, removing, and moving vFiler resources has the following effects:

After you add storage resources to a vFiler, the resources are moved from the hosting filer to a vFiler.
After you remove storage resources from a vFiler, the resources are moved from the vFiler to the hosting filer.
After you add an IP address to a vFiler, you can assign the address as an IP alias of an interface or assign the address to a network interface that has not been configured.
After you remove an IP address from a vFiler, the IP address becomes an unassigned IP address.
After you move resources from one vFiler to another, the resources are removed from the source vFiler and added to the destination vFiler.
Note
Adding, removing, or moving vFiler resources only affects the association between the vFilers and the resources. It does not have any effect on user data in the vFilers involved.

Requirements for moving and removing resources

Remember the following requirements when you move or remove vFiler resources:

The storage unit to be moved or removed cannot be the one containing the vFiler's /etc directory.
If a storage unit that is to be moved or removed contains LUNs, you must unmap the LUNs first. See the Block Access Management Guide for iSCSI for instructions.
If a storage unit that is to be moved or removed contains any CIFS shares, homedirs, or open files and directories, you must remove the CIFS shares, remove the homedirs from the list of homedirs, or close open files and directories.
The following requirements are for moving an IP address between vFilers or removing an IP address from a vFiler:
- Both the source vFiler and destination vFilers must be in the same IPspace.
- If the address is an IP alias, the alias must be removed. If the address is not an IP alias, the network interface associated with the address must not be configured.

Considerations for moving resources between vFilers

Remember the following considerations when you move resources between vFilers:

If a storage unit that is to be moved from one vFiler to another contains LUNs, you must unmap the LUNs first. See the Block Access Management Guide for iSCSI for instructions.
After you move a storage unit from one vFiler to another, the security information associated with the files in the storage unit is retained. This might cause users to be unable to access files properly. For example, before the move, a particular user ID (UID) was allowed access to a file; after the move, the UID corresponds to a different user on the destination vFiler, and the user previously represented by this UID can no longer gain access the file.
If you reassign a volume from one vFiler to another, Data ONTAP turns off quotas for the volume. After the volume is moved, you can turn quotas on again for the volume from the destination vFiler.
If you reassign a qtree from one vFiler to another, Data ONTAP turns off quotas for the volume containing the qtree on both the source vFiler and the destination vFiler. After the qtree is moved, you can turn quotas on again for the volume.
All network connections to the vFilers are terminated when resources are being moved.

Adding resources to a vFiler

To add resources to a vFiler, complete the following step.

Step	Action
1	Enter the following command: *vfiler add vfiler_name* [ -f ] [ -i ip_address [ -i ip_address ] ...] [ path [ path ... ] ]** Use the `-f` option to skip warning messages. Example The following example adds an IP address and a volume to an existing vFiler: vfiler add vfiler1 -i 123.123.123.125 /vol/vol3

Step

Action

Enter the following command:

vfiler add vfiler_name [ -f ] [ -i ip_address [ -i 
ip_address ] ...] [ path [ path ... ] ]

Use the -f option to skip warning messages.

Example

The following example adds an IP address and a volume to an existing vFiler:

vfiler add vfiler1 -i 123.123.123.125 /vol/vol3

Removing resources from a vFiler

To remove resources from a vFiler, complete the following step.

Step	Action
1	Enter the following command: *vfiler remove vfiler_name* [ -f ] [ -i ip_address [ -i ip_address ] ...] [ path [ path ... ] ]** Use the `-f` option to skip warning messages. Example The following example removes an IP address and a volume from an existing vFiler: vfiler remove vfiler1 -i 123.123.123.125 /vol/vol3

Step

Action

Enter the following command:

vfiler remove vfiler_name [ -f ] [ -i ip_address [ -i 
ip_address ] ...] [ path [ path ... ] ]

Use the -f option to skip warning messages.

Example

The following example removes an IP address and a volume from an existing vFiler:

vfiler remove vfiler1 -i 123.123.123.125 /vol/vol3

Moving resources between vFilers

To move resources between vFilers, complete the following step.

Step	Action
1	Enter the following command: *vfiler move source_vfiler* destination_vfiler [ -f ] [ -i ip_address [ -i ip_address ] ...] [ path [ path ... ] ]** Use the `-f` option to skip warning messages. Example The following example moves an IP address and a volume from one vFiler to another: vfiler move vfiler1 vfiler2 -i 123.123.123.125 /vol/vol3

Step

Action

Enter the following command:

vfiler move source_vfiler destination_vfiler [ -f ] [ -i 
ip_address [ -i ip_address ] ...] [ path [ path ... ] ]

Use the -f option to skip warning messages.

Example

The following example moves an IP address and a volume from one vFiler to another:

vfiler move vfiler1 vfiler2 -i 123.123.123.125 /vol/vol3