Skip to main content

Add a home directory search path

Contributors netapp-aherbin netapp-thomi

If you want to use ONTAP SMB home directories, you must add at least one home directory search path.

About this task

You can add a home directory search path by using the vserver cifs home-directory search-path add command.

The vserver cifs home-directory search-path add command checks the path specified in the -path option during command execution. If the specified path does not exist, the command generates a message prompting for whether you want to continue. You choose y or n. If you choose y to continue, ONTAP creates the search path. However, you must create the directory structure before you can use the search path in the home directory configuration. If you choose not to continue, the command fails; the search path is not created. You can then create the path directory structure and rerun the vserver cifs home-directory search-path add command.

Steps
  1. Add a home directory search path: vserver cifs home-directory search-path add -vserver vserver -path path

  2. Verify that you successfully added the search path using the vserver cifs home-directory search-path show command.

Example

The following example adds the path /home1 to the home directory configuration on SVM vs1.

cluster::> vserver cifs home-directory search-path add -vserver vs1 -path /home1

vs1::> vserver cifs home-directory search-path show
Vserver     Position Path
----------- -------- -----------------
vs1         1        /home1

The following example attempts to add the path /home2 to the home directory configuration on SVM vs1. The path does not exist. The choice is made to not continue.

cluster::> vserver cifs home-directory search-path add -vserver vs1 -path /home2
Warning: The specified path "/home2" does not exist in the namespace
         belonging to Vserver "vs1".
Do you want to continue? {y|n}: n
Related information

Adding a home directory share