Merge branch 'los1030' into 'master'

[LOS-1030] Add almalinux documentation - locmap

See merge request !94

docs/almalinux/alma8/index.md

+# AlmaLinux 8 Documentation
+  
+* [Documentation pages](/almalinux/alma8)
+    * [Installation instructions](/almalinux/alma8/install)
+    * [Locmap installation](/almalinux/alma8/locmap)
+
+Please check <a href="../../docs/">Documentation</a> for additional documentation.
\ No newline at end of file

docs/almalinux/alma8/install.md

+# AlmaLinux 8 - Install instructions
+
+The following methods are currently available to install AlmaLinux 8
+
+* AIMS interactive - select the menu item `Install AlmaLinux 8 (ALMA8) x86_64` or `Install AlmaLinux 8 (ALMA8) aarch64`
+* AIMS host registration - define your host to use the `ALMA8_X86_64` or `ALMA8_AARCH64`
+* OpenStack VM - boot from the image `ALMA8 - x86_64`
+* ai-bs puppet managed VM - use `ai-bs --alma8`
+* docker image - use `docker pull gitlab-registry.cern.ch/linuxsupport/alma8-base:latest`
+* Boot ISO: https://linuxsoft.cern.ch/cern/alma/8/BaseOS/x86_64/os/images/boot.iso
+
+

docs/almalinux/alma8/locmap.md

+# AlmaLinux 8 - Locmap
+
+Locmap is typically installed by default when installing a new AlmaLinux 8 system and selecting 'Software Development Workstation (CERN Recommended Setup)' during the installation.
+
+In the event that locmap is not available, you may follow these instructions to install it.
+
+```bash
+$ sudo dnf -y install locmap-release
+$ sudo dnf -y install locmap
+$ sudo locmap --enable all
+$ sudo locmap --configure all
+```
+
+### Usage
+
+You can access the documentation by typing (as root):
+
+```bash
+# man locmap
+```
+
+You can list enabled modules:
+
+```bash
+# locmap --list
+[Available Modules]
+afs            [disabled]
+cernbox        [disabled]
+chrony         [disabled]
+cvmfs          [disabled]
+eosclient      [disabled]
+kerberos       [disabled]
+lpadmin        [disabled]
+postfix        [disabled]
+ssh            [disabled]
+sudo           [disabled]
+zoom           [disabled]
+```
+
+You can configure all enabled module with the following command:
+
+```bash
+# locmap --configure all
+```
+
+You can configure a new module:
+
+```bash
+# locmap --enable modulename
+# locmap --configure modulename
+```
+
+You can disable a module:
+
+```bash
+# locmap --disable modulename
+```
+
+### Locmap and Openstack
+It easy to run locmap during an openstack installation. Create a script with the above commands say `install.sh`. Pass this as user data to `openstack create`.
+
+```
+openstack server create --image 'ALMA8 - x86_64' --key-name <mykey> --user-data ~/tmp/install.sh  --flavor m2.small mynode
+```
+
+alternatively the script can be uploaded via the configuration tab of the "Launch Instance" panel of OpenStack.

docs/almalinux/alma9/index.md

+# AlmaLinux 9 Documentation
+  
+* [Documentation pages](/almalinux/alma9)
+    * [Installation instructions](/almalinux/alma9/install)
+    * [Locmap installation](/almalinux/alma9/locmap)
+
+Please check <a href="../../docs/">Documentation</a> for additional documentation.
\ No newline at end of file

docs/almalinux/alma9/install.md

+# AlmaLinux 9 - Install instructions
+
+The following methods are currently available to install AlmaLinux 9
+
+* AIMS interactive - select the menu item `Install AlmaLinux 9 (ALMA9) x86_64` or `Install AlmaLinux 9 (ALMA9) aarch64`
+* AIMS host registration - define your host to use the `ALMA9_X86_64` or `ALMA9_AARCH64`
+* OpenStack VM - boot from the image `ALMA9 - x86_64`
+* ai-bs puppet managed VM - use `ai-bs --alma9`
+* docker image - use `docker pull gitlab-registry.cern.ch/linuxsupport/alma9-base:latest`
+* Boot ISO: https://linuxsoft.cern.ch/cern/alma/9/BaseOS/x86_64/os/images/boot.iso
\ No newline at end of file

docs/almalinux/alma9/locmap.md

+# AlmaLinux 9 - Locmap
+
+Locmap is typically installed by default when installing a new AlmaLinux 8 system and selecting 'Software Development Workstation (CERN Recommended Setup)' during the installation.
+
+In the event that locmap is not available, you may follow these instructions to install it.
+
+```bash
+$ sudo dnf -y install locmap-release
+$ sudo dnf -y install locmap
+$ sudo locmap --enable all
+$ sudo locmap --configure all
+```
+
+### Usage
+
+You can access the documentation by typing (as root):
+
+```bash
+# man locmap
+```
+
+You can list enabled modules:
+
+```bash
+# locmap --list
+[Available Modules]
+afs            [disabled]
+cernbox        [disabled]
+chrony         [disabled]
+cvmfs          [disabled]
+eosclient      [disabled]
+kerberos       [disabled]
+lpadmin        [disabled]
+postfix        [disabled]
+ssh            [disabled]
+sudo           [disabled]
+zoom           [disabled]
+```
+
+You can configure all enabled module with the following command:
+
+```bash
+# locmap --configure all
+```
+
+You can configure a new module:
+
+```bash
+# locmap --enable modulename
+# locmap --configure modulename
+```
+
+You can disable a module:
+
+```bash
+# locmap --disable modulename
+```
+
+### Locmap and Openstack
+It easy to run locmap during an openstack installation. Create a script with the above commands say `install.sh`. Pass this as user data to `openstack create`.
+
+```
+openstack server create --image 'ALMA9 - x86_64' --key-name <mykey> --user-data ~/tmp/install.sh  --flavor m2.small mynode
+```
+
+alternatively the script can be uploaded via the configuration tab of the "Launch Instance" panel of OpenStack.

docs/centos8/docs/index.md

@@ -5,6 +5,5 @@
     * [Step by step installation guide](/centos8/docs/stepbystep)
     * [Locmap installation](/centos8/docs/locmap)
     * [Booting into single user mode](/centos8/docs/singleuser)
-    * [CentOS Linux 8 to CentOS Stream 8 migration](/centos8/docs/migration).
 
 Please check <a href="../../docs/">Documentation</a> for additional documentation.

mkdocs.yml

@@ -129,8 +129,14 @@ nav:
     - 'Which distribution should I use?': which.md
     - 'AlmaLinux':
         - 'AlmaLinux': almalinux/index.md
-        - 'AlmaLinux 9 (ALMA9)': almalinux/alma9.md
-        - 'AlmaLinux 8 (ALMA8)': almalinux/alma8.md
+        - 'AlmaLinux 9 (ALMA9)':
+            - 'AlmaLinux 9': almalinux/alma9intro.md
+            - 'Documentation': almalinux/alma9/index.md
+            - 'Installation': almalinux/alma9/install.md
+        - 'AlmaLinux 8 (ALMA8)':
+            - 'AlmaLinux 8': almalinux/alma8intro.md
+            - 'Documentation': almalinux/alma8/index.md
+            - 'Installation': almalinux/alma8/install.md
     - 'Red Hat Enterprise Linux (RHEL)':
         - 'Red Hat Enterprise Linux (RHEL)': rhel/index.md
         - 'Red Hat Enterprise Linux 9 (RHEL9)': rhel/rhel9.md