document automatic mounts

This commit is contained in:
2024-11-07 13:35:21 +01:00
committed by ebner
parent aa94f9eee1
commit eaf6ebc81e
8 changed files with 152 additions and 57 deletions
+8 -56
View File
@@ -1,28 +1,12 @@
# Mounting Volumes
Managing mount points of local or network volumes can also be managed in Hiera.
Managing mount points of local or network volumes can also be done in Hiera.
First we show more generic features which mount a given set of network drives.
More below is documented how individual mounts can be created or removed.
## Access same Network Drives as Windows
Linux can be made to mount a users usual network drives the same way as Windows.
The mountpoints can be found in `~/network-drives`.
The `U:`-drive is there named `home`, while the rest keeps their original share name.
This feature is controlled in Hiera with
```
user_session::mount_cifs_shares: true
```
These mounts are created on the first user session created and will end with the last session closed.
If for some reason they are not created (e.g. due to offline login), you might execute `/opt/pli/bin/create-network-drive-links` to bring them back in again.
Note this does not work for RHEL7.
For more automatic network data setups please look at
- [Windows Drives in Home Directory](windows_drives_in_home)
- [Central Storage Mount](central_storage_mount)
- [autofs](autofs)
- [AFS](afs)
## Managing Mountpoints in Hiera
@@ -154,41 +138,9 @@ username and password allowed to mount it.
On the other hand, a mount `emf` with type `cifs` is defined. You should specify in options the location of `credentials` as well as optional parameters.
## AFS
AFS is depending on role already configured by default. Additionally it can be enabled or disabled in Hiera with `base::enable_afs`:
```
base::enable_afs: true
```
respectively to disable:
```
base::enable_afs: false
```
Following details can be modified, but are usually not required:
- `afs_client::mountpoint`
- `afs_client::root_volume`
- `afs_client::enable_dynroot`
- `afs_client::min_cache_size` (e.g. `8G`)
- `afs_client::files`
- `afs_client::dcache`
When disabling AFS the daemon is not automatically switched off. There is additional manual effort required on the host:
```
systemctl disable yfs-client.service
reboot
```
If you want to do it without reboot, first stop all processes using AFS. You might figure them out e.g. with `lsof | grep /afs`.
Then do
```
umount /afs
systemctl stop yfs-client.service
systemctl disable yfs-client.service
afsd -shutdown
```
## Systemd Automount
Adding the options `noauto,x-systemd.automount` will make the mount not happen on startup, but will be automounted on the first use of the mountpoint.
## Bind Mounts
Bind mounts can be defined as follows: