diff --git a/CHANGELOG.md b/CHANGELOG.md index ed8469a3e9c..2b011825ef9 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,5 @@ +- Documented onboarding SSH connected Ubuntu clients with install-created + user in Client Configuration Guide (bsc#1213437) - Added Saline documentation to Salt Guide - Replaced mgradm with mrgctl in Installation and Upgrade Guide - Corrected metadata signing section in Administration Guide diff --git a/modules/client-configuration/pages/clients-ubuntu.adoc b/modules/client-configuration/pages/clients-ubuntu.adoc index 1000574a21d..0cf83270cc6 100644 --- a/modules/client-configuration/pages/clients-ubuntu.adoc +++ b/modules/client-configuration/pages/clients-ubuntu.adoc @@ -232,6 +232,10 @@ If the default user has been granted administrative privileges during installati With cloud instances this does not happen because [command]``cloud-init`` automatically creates a file under [path]``/etc/sudoers.d`` and grants privilege escalation through [command]``sudo`` without the need for a password. ==== + + +=== Grant Root User Access + .Procedure: Granting Root User Access . On the client, edit the [filename]``sudoers`` file: @@ -256,6 +260,36 @@ We recommend that you remove the line from the [path]``sudoers`` file after the +=== Bootstrap as Install-created User via SSH + +To bootstrap an Ubuntu client via SSH you must add the install-created user to the sudo group. +Then run the bootstrap script from the client. + +.Procedure: Adding Install-created User to sudo Group and Bootstrapping via SSH + +. On the client, as root, run from the command line (replace [literal]```` with the name of the install-created user): ++ + +---- +sudo usermod -aG sudo +---- + +. Bootstrap the client system from its command line (replace [literal]```` with the fully qualified domain name of the {productname} Server): ++ + +---- +sudo su - +curl -Sks https:///pub/bootstrap/bootstrap-script.sh | /bin/bash +---- + +[IMPORTANT] +==== +{ubuntu} can only be bootstrapped using the corresponding {ubuntu} bootstrap script run from the client system's command line after issuing [command]``sudo su -`` as above. +It cannot be bootstrapped via the {productname} {webui} due to the fact that the root user is disabled on {ubuntu} by default, and that the {webui} does not permit for privilege escalation of the {ubuntu} install-created user. +==== + + + == Register Clients include::snippets/create_bootstrap_repo_register.adoc[]