Export translations

Settings

Group

Language

Format

Export for off-line translation

Export in native format

<languages/>
__TOC__
<div lang="en" dir="ltr" class="mw-content-ltr">
=Autofs – Automount (en)=
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
[[File:Manjaro-logo.png|left]]
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=Autofs=
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Autofs can be used to mount:
*USB-flash-disks
*external hard disks
*network attached storage devices
*CD-ROM / DVD / BlueRay and so on.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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?
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Another way of mounting on the fly is described on this wiki page: [[Fstab_-_Use_SystemD_automount|Fstab - Use SystemD automount]]
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=Installation=
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:
''support programs for the network filesystem''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=Testing the mounts=
Before you will install and setup autofs it is a good thing to test if you can mount the device you want to mount.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Let’s find out first what you can mount. The nfs-utils package has a nice command for that: showmount:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
'''showmount -e 192.168.1.9'''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
When the device is on the output will be something like:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
'''Export list for 192.168.1.9:'''
'''/HDD1 *'''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
There is a disk called HDD1 in the device on address 192.168.1.9.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Remark: ''You do need to know the IP-address of the device to use showmount.''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Now let’s mount it to our local folder /mnt:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
‘’’sudo mount -t nfs 192.168.1.9:/HDD1 /mnt’’’
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=Terminal commands=
Commands you can use are:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
'''sudo systemctl enable autofs'''  ''Command to enable autofs so it can be started either manually or at next boot''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
'''sudo systemctl start autofs'''   ''Command to manually start autofs''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
'''sudo systemctl restart autofs'''   ''Command to manually restart autofs''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
'''sudo systemctl stop autofs'''    ''Command to manually stop autofs''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
'''sudo systemctl status autofs'''  ''Command to read the status of autofs''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
When autofs is running this is the output of the status command:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
'''sudo systemctl status autofs'''
  ● autofs.service - Automounts filesystems on demand
     Loaded: loaded (/usr/lib/systemd/system/autofs.service; enabled; vendor preset: disabled)
     Active: active (running) since Sat 2017-12-02 07:13:22 CET; 1h 9min ago
    Process: 1069 ExecStart=/usr/bin/automount $OPTIONS --pid-file /run/autofs.pid (code=exited, status=0/SUCCESS)
   Main PID: 1089 (automount)
      Tasks: 5 (limit: 4915)
     CGroup: /system.slice/autofs.service
             └─1089 /usr/bin/automount --pid-file /run/autofs.pid
  Dec 02 07:13:22 Desktop-Jan systemd[1]: Starting Automounts filesystems on demand...
  Dec 02 07:13:22 Desktop-Jan automount[1089]: -
  Dec 02 07:13:22 Desktop-Jan systemd[1]: Started Automounts filesystems on demand.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
After a stop it looks like this:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
'''sudo systemctl status autofs'''
  ● autofs.service - Automounts filesystems on demand
     Loaded: loaded (/usr/lib/systemd/system/autofs.service; enabled; vendor preset: disabled)
     Active: inactive (dead) since Sat 2017-12-02 08:27:27 CET; 1s ago
    Process: 1069 ExecStart=/usr/bin/automount $OPTIONS --pid-file /run/autofs.pid (code=exited, status=0/SUCCESS)
   Main PID: 1089 (code=exited, status=0/SUCCESS)
  Dec 02 07:13:22 Desktop-Jan systemd[1]: Starting Automounts filesystems on demand...
  Dec 02 07:13:22 Desktop-Jan automount[1089]: -
  Dec 02 07:13:22 Desktop-Jan systemd[1]: Started Automounts filesystems on demand.
  Dec 02 08:27:26 Desktop-Jan systemd[1]: Stopping Automounts filesystems on demand...
  Dec 02 08:27:27 Desktop-Jan systemd[1]: Stopped Automounts filesystems on demand.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=Configuration=
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>.
Since /etc/autofs is a folder owned by root you need root privileges to write and/or edit them.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
In auto.master we write:
* the base folder where mounts are connected to the local filesystem
* the name of the file in which the mount can be configured
* a timeout value (time after which the mount is automatically unmounted when not needed anymore)
* ghost, an option which places empty folders in the base folder to make it possible, after the time-out, to mount the device again.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
A typical line in the auto.master file can look like this:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
'''/mnt /etc/autofs/auto.NAS1 --timeout=10 --ghost'''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
When you have more than one external device you want to mount using autofs you can do 2 things:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* write an extra line in the auto.master file for each device. For example:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
'''/mnt /etc/autofs/auto.NAS1 --timeout=10 --ghost'''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
'''/mnt /etc/autofs/auto.NAS2 --timeout=10 --ghost'''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
and create extra config files for each device, or
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* 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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
''/etc/autofs/auto.master:''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
'''/mnt /etc/autofs/auto.shares --time-out=5 --ghost'''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
''/etc/autofs/auto.shares:''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
'''NAS-Seagate	       -fstype=nfs,rw,soft,retry=0 Seagate:/shares/Folder1'''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
'''NAS-WD  	       -fstype=nfs,rw,soft,retry=0 WD:/nfs/Public'''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=Explanation of auto.master=
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:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
# key [ -mount-options-separated-by-comma ] location
  # For details of the format look at autofs(5).
  #
  #/misc	/etc/auto.misc
  #
  # NOTE: mounts done from a hosts map will be mounted with the
  #	"nosuid" and "nodev" options unless the "suid" and "dev"
  #	options are explicitly given.
  #
  #/net	-hosts
  #
  # Include central master map if it can be found using
  # nsswitch sources.
  #
  # Note that if there are entries for /net or /misc (as
  # above) in the included master map any keys that are the
  # same will not be seen as the first read key seen takes
  # precedence.
  #
  #/net        -hosts           -nosuid
  +auto.master
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Add your line or lines just before the last visible line: +auto.master
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Format of the line you add:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
''base-folder  name_of_share_file  options''.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
In my example this is:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
'''/mnt /etc/autofs/auto.shares --time-out=5 --ghost'''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
'''''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.'''''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
When you write the name of a folder in the master file you use indirect addressing:
the complete path is now the sum of the path in the master file + the one in the shares file.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=Explanation of auto.shares=
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:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
''name_of_sub-folder   options   source''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
(separated with at least one space)
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
After mounting the external device can be found in the following directory structure:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
'''/base-folder/sub-folder'''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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)
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
My shares are mounted at: /mnt/NAS-WD and /mnt/NAS-Seagate.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
/mnt is the base-folder (from auto.master) and both NAS folders are written in the shares file.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*'''-fstype=nfs'''
The used filesystem is nfs (Network File System), a file-system used much in Linux environments.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*'''rw'''
The mount is readable and writable. If you only need read access then use ro (read only)
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*'''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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*'''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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=Remarks=
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* 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:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
'''sudo systemctl restart autofs'''  ''It is advisable to also restart after changing the shares file, just to be sure.''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* 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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* 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:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
$ /etc/autofs > '''sudo ps -A|grep "nfs\|rpc"'''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
240 ?       00:00:00 rpcbind
  23222 ?       00:00:00 rpciod
  23227 ?       00:00:00 nfsiod 
 
$ /etc/autofs > '''cd /mnt/NAS-WD'''  ''Change directory to the mount''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
240 ?       00:00:00 rpcbind
  23222 ?       00:00:00 rpciod
  23227 ?       00:00:00 nfsiod
  29106 ?       00:00:00 rpc.statd
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

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