From 786d7f3c25677484855d54451c30af0c4b225b62 Mon Sep 17 00:00:00 2001 From: Mahoney Date: Tue, 1 May 2018 09:36:47 -0700 Subject: [PATCH 1/3] Copy edits for enable a new user space Signed-off-by: Mahoney --- .../guides/maintenance/enable-user-space.rst | 91 +++++++++---------- 1 file changed, 43 insertions(+), 48 deletions(-) diff --git a/source/clear-linux/guides/maintenance/enable-user-space.rst b/source/clear-linux/guides/maintenance/enable-user-space.rst index 8f8e23d1..18ef954b 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 -* 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. +* Create a new user. +* Install and update the OS software to its current version. +* 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 @@ -56,23 +53,23 @@ utility: .. note:: - The image we installed may not be the latest version of |CL| available on + The image 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`_. + available version. The 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 +A full list of bundles and packages installed with the +`os-clr-on-clr`_ bundle is provided. Additionally, +`all Clear Linux bundles`_ is listed, 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 +78,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`: From d8cf6db3d82cd82dd4bfd51f9515f3516f3ba475 Mon Sep 17 00:00:00 2001 From: Mahoney Date: Thu, 3 May 2018 08:47:57 -0700 Subject: [PATCH 2/3] Completed review feedback and incoporated changes. Signed-off-by: Mahoney --- .../guides/maintenance/enable-user-space.rst | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/source/clear-linux/guides/maintenance/enable-user-space.rst b/source/clear-linux/guides/maintenance/enable-user-space.rst index 18ef954b..fb469811 100644 --- a/source/clear-linux/guides/maintenance/enable-user-space.rst +++ b/source/clear-linux/guides/maintenance/enable-user-space.rst @@ -7,10 +7,10 @@ This section provides steps to complete the following basic setup tasks for a newly installed |CLOSIA| system: * Create a new user. -* Install and update the OS software to its current version. +* Update the OS to its most current version using `swupd`. +* 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. +* Install a GUI to test `sudo` privileges. .. note:: Log in as the root user to complete the tasks in this @@ -31,7 +31,7 @@ Replace the with the name of the user account you want to create includ to enter a new password. Retype the new password for the new user account just created. -Install and update the OS software to its current version +Install and update software ********************************************************* |CL| has a unique application and architecture to add and update applications @@ -53,14 +53,14 @@ utility: .. note:: - The image installed may not be the latest version of |CL| available on + 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. The website provides more `information about swupd`_. + available version. Our website provides more `information about swupd`_. -A full list of bundles and packages installed with the -`os-clr-on-clr`_ bundle is provided. Additionally, -`all Clear Linux bundles`_ is listed, active or deprecated. Click any bundle on the +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. Set up a new user and add the new user to the `wheel` group From d0de27112fbf8b44792e2aca2d1d67f9bc18f4ca Mon Sep 17 00:00:00 2001 From: Mahoney Date: Thu, 3 May 2018 11:16:42 -0700 Subject: [PATCH 3/3] Signed-off-by: Mahoney --- .../clear-linux/guides/maintenance/enable-user-space.rst | 9 +-------- 1 file changed, 1 insertion(+), 8 deletions(-) diff --git a/source/clear-linux/guides/maintenance/enable-user-space.rst b/source/clear-linux/guides/maintenance/enable-user-space.rst index fb469811..a814a531 100644 --- a/source/clear-linux/guides/maintenance/enable-user-space.rst +++ b/source/clear-linux/guides/maintenance/enable-user-space.rst @@ -31,7 +31,7 @@ Replace the with the name of the user account you want to create includ 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 @@ -51,13 +51,6 @@ 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