Difference between revisions of "Using autofs (automount) with NFS"

Marked this version for translation
m (added languages and translate tags)
(Marked this version for translation)
Line 2: Line 2:
__TOC__
__TOC__
<translate>
<translate>
=Autofs – Automount (en)=
=Autofs – Automount (en)= <!--T:1-->


<!--T:2-->
[[File:Manjaro-logo.png|left]]                       
[[File:Manjaro-logo.png|left]]                       


<!--T:3-->
<br clear="all"/>
<br clear="all"/>


=Autofs=
=Autofs= <!--T:4-->
Autofs is a program which makes it possible to mount external devices on demand. Other ways of mounting can be done with the use of a manual command for a temporary mount, or by using the /etc/fstab file if you want to mount a device permanently.
Autofs is a program which makes it possible to mount external devices on demand. Other ways of mounting can be done with the use of a manual command for a temporary mount, or by using the /etc/fstab file if you want to mount a device permanently.


<!--T:5-->
Autofs can be used to mount:
Autofs can be used to mount:
*USB-flash-disks
*USB-flash-disks
Line 17: Line 20:
*CD-ROM / DVD / BlueRay and so on.
*CD-ROM / DVD / BlueRay and so on.


<!--T:6-->
Autofs mounts these devices in local folders. When you want, or a program you use wants, to read from or write to the device, autofs will do that in those local folders.
Autofs mounts these devices in local folders. When you want, or a program you use wants, to read from or write to the device, autofs will do that in those local folders.
When you work a lot with mounted systems you will love the way this is done.
When you work a lot with mounted systems you will love the way this is done.


<!--T:7-->
Some people believe that since autofs is not maintained heavily it won’t exist much longer, but think about this: why do you need to maintain a program which already does what it is supposed to do?
Some people believe that since autofs is not maintained heavily it won’t exist much longer, but think about this: why do you need to maintain a program which already does what it is supposed to do?


<!--T:8-->
Another way of mounting on the fly is described on this wiki page: Fstab - Use SystemD automount [https://wiki.manjaro.org/index.php?title=Fstab_-_Use_SystemD_automount]
Another way of mounting on the fly is described on this wiki page: Fstab - Use SystemD automount [https://wiki.manjaro.org/index.php?title=Fstab_-_Use_SystemD_automount]


=Installation=
=Installation= <!--T:9-->
At the time of writing, the autofs version number was 5.1.3-1. It can be installed from the standard Manjaro repositories using Octopi, Pamac or Pacman.
At the time of writing, the autofs version number was 5.1.3-1. It can be installed from the standard Manjaro repositories using Octopi, Pamac or Pacman.
When you want to use autofs with nfs you need one extra package and that is nfs-utils. So, install that as well. The description calls it:
When you want to use autofs with nfs you need one extra package and that is nfs-utils. So, install that as well. The description calls it:
''support programs for the network filesystem''
''support programs for the network filesystem''


=Testing the mounts=
=Testing the mounts= <!--T:10-->
Before you will install and setup autofs it is a good thing to test if you can mount the device you want to mount.
Before you will install and setup autofs it is a good thing to test if you can mount the device you want to mount.


<!--T:11-->
Let’s find out first what you can mount. The nfs-utils package has a nice command for that: showmount:
Let’s find out first what you can mount. The nfs-utils package has a nice command for that: showmount:


<!--T:12-->
'''showmount -e 192.168.1.9'''
'''showmount -e 192.168.1.9'''


<!--T:13-->
When the device is on the output will be something like:
When the device is on the output will be something like:


<!--T:14-->
'''Export list for 192.168.1.9:'''
'''Export list for 192.168.1.9:'''
'''/HDD1 *'''
'''/HDD1 *'''


<!--T:15-->
There is a disk called HDD1 in the device on address 192.168.1.9.
There is a disk called HDD1 in the device on address 192.168.1.9.


<!--T:16-->
Remark: ''You do need to know the IP-address of the device to use showmount.''
Remark: ''You do need to know the IP-address of the device to use showmount.''


<!--T:17-->
Now let’s mount it to our local folder /mnt:
Now let’s mount it to our local folder /mnt:


<!--T:18-->
‘’’sudo mount -t nfs 192.168.1.9:/HDD1 /mnt’’’
‘’’sudo mount -t nfs 192.168.1.9:/HDD1 /mnt’’’


<!--T:19-->
Type ‘ls /mnt’ to find out what is on the disk you just mounted.
Type ‘ls /mnt’ to find out what is on the disk you just mounted.
When you see contents the mount has succeeded and we can now continue with the configuration of autofs.
When you see contents the mount has succeeded and we can now continue with the configuration of autofs.


=Terminal commands=
=Terminal commands= <!--T:20-->
Commands you can use are:
Commands you can use are:


<!--T:21-->
'''sudo systemctl enable autofs'''  ''Command to enable autofs so it can be started either manually or at next boot''
'''sudo systemctl enable autofs'''  ''Command to enable autofs so it can be started either manually or at next boot''


<!--T:22-->
'''sudo systemctl start autofs'''  ''Command to manually start autofs''
'''sudo systemctl start autofs'''  ''Command to manually start autofs''


<!--T:23-->
'''sudo systemctl restart autofs'''  ''Command to manually restart autofs''
'''sudo systemctl restart autofs'''  ''Command to manually restart autofs''


<!--T:24-->
'''sudo systemctl stop autofs'''    ''Command to manually stop autofs''
'''sudo systemctl stop autofs'''    ''Command to manually stop autofs''


<!--T:25-->
'''sudo systemctl status autofs'''  ''Command to read the status of autofs''
'''sudo systemctl status autofs'''  ''Command to read the status of autofs''


<!--T:26-->
When autofs is running this is the output of the status command:
When autofs is running this is the output of the status command:


<!--T:27-->
'''sudo systemctl status autofs'''
'''sudo systemctl status autofs'''
   ● autofs.service - Automounts filesystems on demand
   ● autofs.service - Automounts filesystems on demand
Line 80: Line 102:
   Dec 02 07:13:22 Desktop-Jan systemd[1]: Started Automounts filesystems on demand.
   Dec 02 07:13:22 Desktop-Jan systemd[1]: Started Automounts filesystems on demand.


<!--T:28-->
After a stop it looks like this:
After a stop it looks like this:


<!--T:29-->
'''sudo systemctl status autofs'''
'''sudo systemctl status autofs'''
   ● autofs.service - Automounts filesystems on demand
   ● autofs.service - Automounts filesystems on demand
Line 94: Line 118:
   Dec 02 08:27:27 Desktop-Jan systemd[1]: Stopped Automounts filesystems on demand.
   Dec 02 08:27:27 Desktop-Jan systemd[1]: Stopped Automounts filesystems on demand.


=Configuration=
=Configuration= <!--T:30-->
After installation we need to configure a few files specific to what we need and want. These files are placed in the folder: '''/etc/autofs'''.
After installation we need to configure a few files specific to what we need and want. These files are placed in the folder: '''/etc/autofs'''.
In fact there are 2 files needed: auto.master and auto.<any name you like>.
In fact there are 2 files needed: auto.master and auto.<any name you like>.
Since /etc/autofs is a folder owned by root you need root privileges to write and/or edit them.
Since /etc/autofs is a folder owned by root you need root privileges to write and/or edit them.


<!--T:31-->
In auto.master we write:
In auto.master we write:
* the base folder where mounts are connected to the local filesystem
* the base folder where mounts are connected to the local filesystem
Line 105: Line 130:
* ghost, an option which places empty folders in the base folder to make it possible, after the time-out, to mount the device again.
* ghost, an option which places empty folders in the base folder to make it possible, after the time-out, to mount the device again.


<!--T:32-->
A typical line in the auto.master file can look like this:
A typical line in the auto.master file can look like this:


<!--T:33-->
'''/mnt /etc/autofs/auto.NAS1 --timeout=10 --ghost'''
'''/mnt /etc/autofs/auto.NAS1 --timeout=10 --ghost'''


<!--T:34-->
When you have more than one external device you want to mount using autofs you can do 2 things:
When you have more than one external device you want to mount using autofs you can do 2 things:


<!--T:35-->
* write an extra line in the auto.master file for each device. For example:
* write an extra line in the auto.master file for each device. For example:


<!--T:36-->
'''/mnt /etc/autofs/auto.NAS1 --timeout=10 --ghost'''
'''/mnt /etc/autofs/auto.NAS1 --timeout=10 --ghost'''


<!--T:37-->
'''/mnt /etc/autofs/auto.NAS2 --timeout=10 --ghost'''
'''/mnt /etc/autofs/auto.NAS2 --timeout=10 --ghost'''


<!--T:38-->
and create extra config files for each device, or
and create extra config files for each device, or


<!--T:39-->
* use 1 line in the auto.master file using 1 config file for all devices and write more than 1 line in this config file. This is totally up to you.
* use 1 line in the auto.master file using 1 config file for all devices and write more than 1 line in this config file. This is totally up to you.


<!--T:40-->
I use this:
I use this:


<!--T:41-->
''/etc/autofs/auto.master:''
''/etc/autofs/auto.master:''


<!--T:42-->
'''/mnt /etc/autofs/auto.shares --time-out=5 --ghost'''
'''/mnt /etc/autofs/auto.shares --time-out=5 --ghost'''


<!--T:43-->
''/etc/autofs/auto.shares:''
''/etc/autofs/auto.shares:''


<!--T:44-->
'''NAS-Seagate       -fstype=nfs,rw,soft,retry=0 Seagate:/shares/Folder1'''
'''NAS-Seagate       -fstype=nfs,rw,soft,retry=0 Seagate:/shares/Folder1'''


<!--T:45-->
'''NAS-WD        -fstype=nfs,rw,soft,retry=0 WD:/nfs/Public'''
'''NAS-WD        -fstype=nfs,rw,soft,retry=0 WD:/nfs/Public'''


<!--T:46-->
This way I have one master file which, with one line, controls the base of the system and one file which controls all my shares. But again, this is totally up to you.
This way I have one master file which, with one line, controls the base of the system and one file which controls all my shares. But again, this is totally up to you.


=Explanation of auto.master=
=Explanation of auto.master= <!--T:47-->
This file is created when you install the autofs package. You will need to edit it to make it work for you. The complete file looks like this when created:
This file is created when you install the autofs package. You will need to edit it to make it work for you. The complete file looks like this when created:


   # key [ -mount-options-separated-by-comma ] location
   <!--T:48-->
# key [ -mount-options-separated-by-comma ] location
   # For details of the format look at autofs(5).
   # For details of the format look at autofs(5).
   #
   #
Line 160: Line 201:
   +auto.master
   +auto.master


<!--T:49-->
Add your line or lines just before the last visible line: +auto.master
Add your line or lines just before the last visible line: +auto.master


<!--T:50-->
After that line an empty line should exist or the configuration will not succeed, so place the cursor after +auto.master and click on ENTER.
After that line an empty line should exist or the configuration will not succeed, so place the cursor after +auto.master and click on ENTER.


<!--T:51-->
Format of the line you add:
Format of the line you add:


<!--T:52-->
''base-folder  name_of_share_file  options''.
''base-folder  name_of_share_file  options''.


<!--T:53-->
In my example this is:
In my example this is:


<!--T:54-->
'''/mnt /etc/autofs/auto.shares --time-out=5 --ghost'''
'''/mnt /etc/autofs/auto.shares --time-out=5 --ghost'''


<!--T:55-->
'''''NOTE: Make sure the used filename in the auto.master file should be exactly the same as the name of the file you use, including the path.'''''
'''''NOTE: Make sure the used filename in the auto.master file should be exactly the same as the name of the file you use, including the path.'''''


<!--T:56-->
The base folder can be /. In this case it is written as: /-
The base folder can be /. In this case it is written as: /-
You use direct addressing now. The address you write in the shares file (see next paragraph) becomes the complete address.
You use direct addressing now. The address you write in the shares file (see next paragraph) becomes the complete address.
Line 179: Line 228:
the complete path is now the sum of the path in the master file + the one in the shares file.
the complete path is now the sum of the path in the master file + the one in the shares file.


=Explanation of auto.shares=
=Explanation of auto.shares= <!--T:57-->
This file can have any extention name you like. Make it a descriptive one to easily find it, especially when you use more than one.
This file can have any extention name you like. Make it a descriptive one to easily find it, especially when you use more than one.
The line or lines in this file are all built according to this template:
The line or lines in this file are all built according to this template:


<!--T:58-->
''name_of_sub-folder  options  source''
''name_of_sub-folder  options  source''


<!--T:59-->
(separated with at least one space)
(separated with at least one space)


<!--T:60-->
After mounting the external device can be found in the following directory structure:
After mounting the external device can be found in the following directory structure:


<!--T:61-->
'''/base-folder/sub-folder'''
'''/base-folder/sub-folder'''


<!--T:62-->
You define the base folder in the auto.master file (first item in the line) and the sub-folder is defined in the auto.xxxx file (also first item on the line)
You define the base folder in the auto.master file (first item in the line) and the sub-folder is defined in the auto.xxxx file (also first item on the line)


<!--T:63-->
My shares are mounted at: /mnt/NAS-WD and /mnt/NAS-Seagate.
My shares are mounted at: /mnt/NAS-WD and /mnt/NAS-Seagate.


<!--T:64-->
/mnt is the base-folder (from auto.master) and both NAS folders are written in the shares file.
/mnt is the base-folder (from auto.master) and both NAS folders are written in the shares file.


<!--T:65-->
Options you can use are plenty. See the man pages for autofs, automount and nfs.
Options you can use are plenty. See the man pages for autofs, automount and nfs.
The ones I used here work for me. They take care of the following:
The ones I used here work for me. They take care of the following:


<!--T:66-->
*'''-fstype=nfs'''
*'''-fstype=nfs'''
The used filesystem is nfs (Network File System), a file-system used much in Linux environments.
The used filesystem is nfs (Network File System), a file-system used much in Linux environments.


<!--T:67-->
*'''rw'''
*'''rw'''
The mount is readable and writable. If you only need read access then use ro (read only)
The mount is readable and writable. If you only need read access then use ro (read only)


<!--T:68-->
*'''soft'''
*'''soft'''
If the server fails an I/O error is given, but the file-manager keeps running. When you use hard instead of soft, it hangs till the connection has been re-established.
If the server fails an I/O error is given, but the file-manager keeps running. When you use hard instead of soft, it hangs till the connection has been re-established.


<!--T:69-->
*'''retry=0'''
*'''retry=0'''
This makes sure that mount stops immediately when the server is not reachable. If not, mount will keep trying for 2 minutes to reach the server and block the program which wants to reach the server.
This makes sure that mount stops immediately when the server is not reachable. If not, mount will keep trying for 2 minutes to reach the server and block the program which wants to reach the server.


=Remarks=
=Remarks= <!--T:70-->


<!--T:71-->
* It is said that when you make a change in the shares file, the change will be active straight away. When changing the master file you need to restart the autofs.service like this:
* It is said that when you make a change in the shares file, the change will be active straight away. When changing the master file you need to restart the autofs.service like this:


<!--T:72-->
'''sudo systemctl restart autofs'''  ''It is advisable to also restart after changing the shares file, just to be sure.''
'''sudo systemctl restart autofs'''  ''It is advisable to also restart after changing the shares file, just to be sure.''


<!--T:73-->
* The permissions of both the master and the share file(s) should be 644. That means Read/Write permission for user, Read for group and Read for others.
* The permissions of both the master and the share file(s) should be 644. That means Read/Write permission for user, Read for group and Read for others.


<!--T:74-->
* Test if the system works. First example is the result when nothing is mounted, in the second example you see the result when the NAS-WD is mounted:
* Test if the system works. First example is the result when nothing is mounted, in the second example you see the result when the NAS-WD is mounted:


<!--T:75-->
$ /etc/autofs > '''sudo ps -A|grep "nfs\|rpc"'''
$ /etc/autofs > '''sudo ps -A|grep "nfs\|rpc"'''


     240 ?      00:00:00 rpcbind
     <!--T:76-->
240 ?      00:00:00 rpcbind
   23222 ?      00:00:00 rpciod
   23222 ?      00:00:00 rpciod
   23227 ?      00:00:00 nfsiod  
   23227 ?      00:00:00 nfsiod  
Line 230: Line 297:
$ /etc/autofs > '''cd /mnt/NAS-WD'''  ''Change directory to the mount''
$ /etc/autofs > '''cd /mnt/NAS-WD'''  ''Change directory to the mount''


<!--T:77-->
$ /mnt/NAS-WD > '''sudo ps -A|grep "nfs\|rpc"'''
$ /mnt/NAS-WD > '''sudo ps -A|grep "nfs\|rpc"'''


     240 ?      00:00:00 rpcbind
     <!--T:78-->
240 ?      00:00:00 rpcbind
   23222 ?      00:00:00 rpciod
   23222 ?      00:00:00 rpciod
   23227 ?      00:00:00 nfsiod
   23227 ?      00:00:00 nfsiod
   29106 ?      00:00:00 rpc.statd
   29106 ?      00:00:00 rpc.statd


=The End=
=The End= <!--T:79-->
Much info on this page was taken from the German Manjaro wiki-page:
Much info on this page was taken from the German Manjaro wiki-page:
[https://wiki.manjaro.org/index.php?title=Fstab_-_Use_SystemD_automount_(de)] by '''Egle'''
[https://wiki.manjaro.org/index.php?title=Fstab_-_Use_SystemD_automount_(de)] by '''Egle'''


<!--T:80-->
There are many webpages about autofs, with and without nfs. Just google it and you will find many different ways of setting it up. The way described here works for me and is pretty easy to setup.
There are many webpages about autofs, with and without nfs. Just google it and you will find many different ways of setting it up. The way described here works for me and is pretty easy to setup.
</translate>
</translate>


[[Category:Contents Page{{#translation:}}]]
[[Category:Contents Page{{#translation:}}]]