diff --git a/source/clear-linux/guides/maintenance/enable-user-space.rst b/source/clear-linux/guides/maintenance/enable-user-space.rst index 8f8e23d1..a814a531 100644 --- a/source/clear-linux/guides/maintenance/enable-user-space.rst +++ b/source/clear-linux/guides/maintenance/enable-user-space.rst @@ -4,38 +4,35 @@ Create and enable a new user space ################################## This section provides steps to complete the following basic setup tasks for -a newly installed |CL| system: +a newly installed |CLOSIA| system: -* Create a new user +* Create a new user. * Update the OS to its most current version using `swupd`. -* Install the most common applications for system administrators and - developers using bundles. -* Setup a new user. -* Add the new user to the `wheel` group. -* Install a GUI using those `sudo` privileges. +* Install the most common applications for system administrators and developers using bundles. +* Set up a new user and add the new user to the `wheel` group. +* Install a GUI to test `sudo` privileges. .. note:: - You must be logged in as the root user to complete the tasks in this + Log in as the root user to complete the tasks in this section. Create a new user -================= +****************** To create a new user and set a password for that user, enter the following commands as a root user: -.. code-block:: console +.. code-block:: bash useradd passwd -Replace with the name of the user account you want to create and -with the password for said user. The :command:`passwd` command prompts you -to enter a new password and then retype the new password for the new user -account you just created. +Replace the with the name of the user account you want to create including the password for that user. The :command:`passwd` command prompts you +to enter a new password. Retype the new password for the new user +account just created. -Install and update software -=========================== +Install and update the OS software to its current version +********************************************************* |CL| has a unique application and architecture to add and update applications and to perform system updates called software update utility or @@ -54,25 +51,18 @@ utility: swupd bundle-add os-clr-on-clr -.. note:: - - The image we installed may not be the latest version of |CL| available on - the server. However, whenever the command - :command:`swupd bundle-add ` runs, the OS is updated to the latest - available version. Our website provides more `information about swupd`_. - We provide the full list of bundles and packages installed with the `os-clr-on-clr`_ bundle. Additionally, we have listed `all Clear Linux bundles`_, active or deprecated. Click any bundle on the list to view the manifest of the bundle. -Finish setting up your new user -=============================== +Set up a new user and add the new user to the `wheel` group +*********************************************************** -Before logging off as root and logging into your new user account, we must +Before logging off as root and logging into your new user account, enable the :command:`sudo` command for your new ``. -To be able to execute all applications with root privileges, we must add the +To be able to execute all applications with root privileges, add the `` to the `wheel group`_. #. Add `` to the `wheel` group: @@ -81,64 +71,62 @@ To be able to execute all applications with root privileges, we must add the usermod -G wheel -a -#. Now, we can log out of root and into our new ``. +#. Log out of root and into the new ``. To log off as root, enter :command:`exit`. The command will bring you back to the `login:` prompt. -#. Enter the new `` and the password you created earlier. +#. Enter the new `` and the password created earlier. You will now be in the home directory of ``. The bundle `os-clr-on-clr`_ contains the majority of applications that a developer or - system administrator would want but it does not include a graphical user - interface. The `desktop` bundle includes the Gnome Desktop Manager and + system administrator would want, but it does not include a graphical user + interface. The `desktop` bundle includes the GNOME\* Display Manager and additional supporting applications. -Install a GUI to test sudo --------------------------- +Install a GUI to test `sudo` privileges +======================================== .. note:: -If you are following this sequence after just setting up the pre-configured VMware virtual machine from -the repo, you must :ref:`increase virtual disk size` or the following step -will fail. +If you are following this sequence after just setting up the pre-configured VMware\* virtual machine from the repo, you must :ref:`increase virtual disk size` or the following step will fail. To test the :command:`sudo` command and ensure it is set up correctly, -install the Gnome Desktop Manager (gdm) and start it. +install the GNOME Display Manager (gdm) and start it. -#. To install Gnome using :command:`swupd`, enter the following command: +#. To install the the GNOME Display Manager using :command:`swupd`, enter the following command: - .. code-block:: console + .. code-block:: bash sudo swupd bundle-add desktop -#. To start the Gnome Desktop Manager, enter the following command: +#. To start the GNOME Display Manager, enter the following command: - .. code-block:: console + .. code-block:: bash systemctl start gdm -#. The system prompts you to authenticate the user. Enter the password for - `` and the Gnome Desktop should start as shown in figure 13: +#. The system prompts to authenticate the user. Enter the password for + ``, and the GNOME Display Manager should start as shown in Figure 1: .. figure:: figures/gnomedt.png :scale: 50 % :alt: Gnome Desktop - Figure 13: :guilabel:`Gnome Desktop` + Figure 1: :guilabel:`Gnome Desktop` -#. To start the Gnome Desktop each time you start your system, enter +#. To start the GNOME Display Manager each time you start your system, enter the following command: - .. code-block:: console + .. code-block:: bash systemctl enable gdm Next steps -========== +*********** -With your system now running |CL| many paths are open for you. +With your system now running |CL|, many opportunities exist. -Visit our :ref:`tutorials ` page for examples on using your |CL| +Visit the :ref:`tutorials ` page for examples on using your |CL| system. .. _`information about swupd`: