clearlinux/clear-linux-documentation
2
0
Fork 0
mirror of https://github.com/clearlinux/clear-linux-documentation.git synced 2026-07-11 07:07:08 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #124 from gkmahon/enable-new-user-space-edits

Browse Source 
Copy edits for enable a new user space
This commit is contained in:
mltullis
2018-05-03 11:26:16 -07:00
committed by GitHub
parent 7e09fc02e6 d0de27112f
commit c472a0b7c8
1 changed files with 37 additions and 49 deletions
Download Patch File Download Diff File Expand all files Collapse all files
source/clear-linux/guides/maintenance/enable-user-space.rst
+37 -49
View File
@@ -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 <userid>
passwd <userid>
Replace <userid> 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 <userid> 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 <bundle>` 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 `<userid>`.
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
`<userid>` to the `wheel group`_.
#. Add `<userid>` 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 <userid>
#. Now, we can log out of root and into our new `<userid>`.
#. Log out of root and into the new `<userid>`.
To log off as root, enter :command:`exit`.
The command will bring you back to the `login:` prompt.
#. Enter the new `<userid>` and the password you created earlier.
#. Enter the new `<userid>` and the password created earlier.
You will now be in the home directory of `<userid>`. 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<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<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
`<userid>` and the Gnome Desktop should start as shown in figure 13:
#. The system prompts to authenticate the user. Enter the password for
`<userid>`, 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 <tutorials>` page for examples on using your |CL|
Visit the :ref:`tutorials <tutorials>` page for examples on using your |CL|
system.
.. _`information about swupd`: