Rehost CIFS volumes

Contributors

You can rehost volumes that serve data over SMB protocol. After rehosting the CIFS volume, to continue accessing data over SMB protocol, you must manually configure policies and the associated rules.

What you’ll need
  • Volume must be online.

  • Volume management operations, such as volume move or LUN move, must not be running.

  • Data access to the volume that is being rehosted must be stopped.

  • The ns-switch and name services configuration of the target SVM must be configured to support data access of the rehosting volume.

  • The source SVM and destination SVM must have the same Active Directory and realmDNS domain.

  • The user ID and group ID of the volume must be either available in the target SVM or changed on the hosting volume.

    Note

    If local users and groups are configured, and if there are files and directories on that volume with permissions set for those users or groups, these permissions are no longer effective.

About this task
  • Rehosting is a disruptive operation.

  • If the rehosting operation fails, you might need to reconfigure the volume policies and the associated rules on the source volume.

  • If the source SVM and destination SVM Active Directory domains differ, you might lose access to the objects on the volume.

  • When the source SVM has local users and groups, the permissions for the files and directories (ACLs) that are set are no longer effective after volume rehost operation.

    The same is true for audit ACLs (SACLs)

  • After the rehost operation, the following volume policies, policy rules, and configurations are lost from the source volume, and must be manually reconfigured on the rehosted volume:

    • Volume and qtree export policies

    • Antivirus policies

    • Volume efficiency policy

    • Quality of service (QoS) policies

    • Snapshot policies

    • Quota rules

    • ns-switch and name services configuration export policy and rules

    • User and group IDs

Steps
  1. Record information about the CIFS shares to avoid losing information on CIFS shares in case volume rehost operation fails.

  2. Unmount the volume from the parent volume:

    volume unmount

  3. Switch to the advanced privilege level:

    set -privilege advanced

  4. Rehost the volume on the destination SVM:

    volume rehost -vserver source_svm -volume vol_name -destination-vserver destination_svm

  5. Mount the volume under the appropriate junction path in the destination SVM:

    volume mount

  6. Create CIFS shares for the rehosted volume:

    vserver cifs share create

  7. If the DNS domains differ between the source SVM and destination SVM, create new users and groups.

  8. Update the CIFS client with the new destination SVM LIFs and junction path to the rehosted volume.

After you finish

You must manually reconfigure the policies and the associated rules on the rehosted volume.