document partially shared home

2024-11-22 15:11:43 +01:00
parent a6a524b9b2
commit 1624bc56d7
3 changed files with 88 additions and 0 deletions
@@ -0,0 +1,28 @@
+# Partially Shared Home - Automatically Link Files in Home - Admin Guide
+
+Shared homes create a set of problems depending on how much a software can handle running multiple instances of the same software, maybe with different version, on different hosts, probably at the same time.
+Still it is useful to have certain tool settings always with you.
+
+Thus we suggest to have per default a local home drive `base::local_homes: true`, but having only selectively shared software configuration.
+That configuration needs then to be on a file share, best the home drive (U:).
+To ensure the tools find their configuration at the expected place, symlinks need automatically to be created which point to the shared version.
+On the homde drive (U:) therein is also the personal configuration file of this feature (`linux_home_links.yaml` or `.linux_home_links.yaml`).
+
+
+
+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 enabled by default on workstation type systems starting RHEL9.
+It can be controlled in Hiera with:
+
+```
+user_session::automatic_links_in_home: true
+``` 
+
+To the [User Guide](../../../user-guide/partially_shared_home).
+This features depends on the ["Windows Drives in Home Directory" feature](windows_drives_in_home).
+
+Note this does not work for RHEL7.
+
+