mirror of
https://github.com/clearlinux/clear-linux-documentation.git
synced 2026-09-04 04:41:36 +00:00
Merge pull request #389 from mvincerx/mv-bare-metal-install-beta-03
bare-metal-install-beta: Adds `Recommended options` & revises `enable-user-space`
This commit is contained in:
michael vincerra
+63
-18
@@ -5,8 +5,11 @@ Install |CL-ATTR| from the live desktop beta image
|
||||
|
||||
The live desktop beta image allows you to boot |CL-ATTR| into a GNOME
|
||||
desktop without modifying the host system. Using the live image, you can
|
||||
explore the possibilities of developing with |CL|. You can also launch the
|
||||
new installer and install |CL| on your target system.
|
||||
explore the possibilities of developing with |CL|.
|
||||
|
||||
You can also launch the installer to install |CL| on your target system.
|
||||
If you proceed with installation, this document assumes you follow the
|
||||
`Recommended options`_.
|
||||
|
||||
.. contents:: :local:
|
||||
:depth: 1
|
||||
@@ -32,9 +35,7 @@ Preliminary steps
|
||||
|
||||
#. Follow your OS instructions to create a bootable USB drive.
|
||||
|
||||
* :ref:`bootable-usb-linux-all`
|
||||
* :ref:`bootable-usb-mac-all`
|
||||
* :ref:`bootable-usb-windows-all`
|
||||
* :ref:`bootable-usb-beta-all`
|
||||
|
||||
Install from live image
|
||||
***********************
|
||||
@@ -86,18 +87,18 @@ Minimum installation requirements
|
||||
*********************************
|
||||
|
||||
To fulfill minimum installation requirements, complete the
|
||||
`Required options`_. `Advanced options`_ are optional.
|
||||
`Required options`_. We also encourage you to install `Recommended options`_ for a full desktop experience. `Advanced options`_ are optional.
|
||||
|
||||
.. note::
|
||||
|
||||
* The :kbd:`Install` button is only highlighted **after** you complete the
|
||||
`Required options`_, and after you enter required values in submenus.
|
||||
* The :kbd:`Install` button is **only highlighted after** you complete
|
||||
`Required options`_.
|
||||
|
||||
* You must choose whether or not to participate in :ref:`telemetrics`
|
||||
before you can finish installation.
|
||||
|
||||
* You may wish to `Test Network Settings`_ before you
|
||||
`Configure Network Interfaces`_. Assure that a ``Success`` message is received before installation.
|
||||
* You may `Test Network Settings`_ before you
|
||||
`Configure Network Interfaces`_. Assure a *Success* message appears before installation.
|
||||
|
||||
Main Menu
|
||||
*********
|
||||
@@ -242,7 +243,7 @@ Configure Media
|
||||
|
||||
#. Select :kbd:`Enter` to :kbd:`Confirm`.
|
||||
|
||||
#. Choose one partitioning method and continue below:
|
||||
#. Select one partitioning method and continue:
|
||||
|
||||
* `Auto Partition`_
|
||||
* `Add Partition`_
|
||||
@@ -455,6 +456,22 @@ For more detailed information, visit our :ref:`telemetry-about` page.
|
||||
|
||||
Figure 14: Enable Telemetry
|
||||
|
||||
Recommended options
|
||||
*******************
|
||||
|
||||
After you complete the `Required options`_, we highly recommend completing
|
||||
a few `Advanced options`_ at minimum:
|
||||
|
||||
* `Bundle Selection`_ Add basic utlities and tools:
|
||||
|
||||
* :file:`desktop-autostart`
|
||||
* :file:`user-basic`
|
||||
|
||||
* `User Manager`_ Assign a new user with administrative rights
|
||||
* `Assign Hostname`_ Simplify your development environment
|
||||
|
||||
This document assumes you follow these additional steps.
|
||||
|
||||
Skip to finish installation
|
||||
===========================
|
||||
|
||||
@@ -462,10 +479,9 @@ After selecting values for all :guilabel:`Required options`, you may skip
|
||||
to `Finish installation`_.
|
||||
|
||||
Otherwise, continue below. In the Main Menu, select
|
||||
:guilabel:`Advanced options` to configure network interfaces or proxy
|
||||
settings, add bundles, add/manage users, add kernel arguments, and more.
|
||||
:guilabel:`Advanced options` for additional configuration.
|
||||
|
||||
Advanced Options
|
||||
Advanced options
|
||||
****************
|
||||
|
||||
Configure Network Interfaces
|
||||
@@ -588,6 +604,8 @@ Bundle Selection
|
||||
|
||||
#. Select :kbd:`Spacebar` to select the checkbox for each desired bundle.
|
||||
|
||||
#. We recommend adding :file:`desktop-autostart` and :file:`user-basic`.
|
||||
|
||||
.. figure:: figures/bare-metal-install-beta-19.png
|
||||
:scale: 100%
|
||||
:alt: Bundle Selection
|
||||
@@ -815,17 +833,44 @@ Finish installation
|
||||
#. When you are satisfied with your installation configuration, navigate to
|
||||
:guilabel:`Install` and select :kbd:`Enter`.
|
||||
|
||||
#. Select :guilabel:`reboot`.
|
||||
|
||||
.. note::
|
||||
|
||||
When installation is finished, a ``reboot`` button appears.
|
||||
|
||||
#. Select ``reboot``.
|
||||
If you do not perform `Recommended options`_, upon rebooting, a
|
||||
:file:`login:` prompt will appear. At the prompt, enter `root` and change your password immediately.
|
||||
|
||||
#. When the system reboots, remove any installation media present.
|
||||
|
||||
.. note::
|
||||
|
||||
Allow time for the graphical login to appear. This shows the administrative user assigned in `Recommended options`_.
|
||||
|
||||
#. Log in as the adminstrative user.
|
||||
|
||||
#. Upon launch of the GUI, open a Terminal.
|
||||
|
||||
#. In the Terminal, log into *root* for the first time.
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
sudo -i
|
||||
|
||||
#. Enter password of administrative user to switch to root.
|
||||
|
||||
#. Enter the command to change the root password:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
passwd root
|
||||
|
||||
#. Follow onscreen instructions to create a password for root.
|
||||
|
||||
#. Enter :command:`exit` to return to the administative user.
|
||||
|
||||
**Congratulations!**
|
||||
|
||||
You have successfully installed |CL| on bare metal using the new installer.
|
||||
You have successfully installed |CL| on bare metal using the installer.
|
||||
|
||||
Next steps
|
||||
**********
|
||||
|
||||
BIN
Binary file not shown.
|
Before Width: | Height: | Size: 96 KiB After Width: | Height: | Size: 96 KiB |
@@ -6,22 +6,15 @@ Create and enable a new user space
|
||||
This section provides steps to complete the following basic setup tasks for
|
||||
a newly installed |CL-ATTR| 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.
|
||||
* Set up a new user and add the new user to the `wheel` group.
|
||||
* Install a GUI to test `sudo` privileges.
|
||||
|
||||
.. note::
|
||||
Log in as the root user to complete the tasks in this
|
||||
section.
|
||||
.. contents::
|
||||
:local:
|
||||
:depth: 1
|
||||
|
||||
Create a new user
|
||||
******************
|
||||
*****************
|
||||
|
||||
To create a new user and set a password for that user, enter the following
|
||||
commands as a root user:
|
||||
commands as a `root` user:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
@@ -33,29 +26,8 @@ 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 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
|
||||
:command:`swupd`. Software applications are installed as bundles using the
|
||||
sub-command :command:`bundle-add`.
|
||||
|
||||
The `sysadmin-basic` bundle installs the vast majority of
|
||||
applications useful to a system administrator.
|
||||
Install the `sysadmin-basic` bundle:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
swupd bundle-add sysadmin-basic
|
||||
|
||||
We provide the full list of bundles and packages installed with the
|
||||
`sysadmin-basic`_ bundle. Additionally, we have listed
|
||||
`all bundles`_ for |CL|, 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
|
||||
***********************************************************
|
||||
Add the new user to the `wheel` group
|
||||
*************************************
|
||||
|
||||
Before logging off as root and logging into your new user account,
|
||||
enable the :command:`sudo` command for your new `<userid>`.
|
||||
@@ -73,65 +45,50 @@ To be able to execute all applications with root privileges, add the
|
||||
|
||||
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 created earlier.
|
||||
|
||||
You will now be in the home directory of `<userid>`. The bundle
|
||||
`sysadmin-basic`_ contains the majority of applications that a 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.
|
||||
You will now be in the home directory of `<userid>`.
|
||||
|
||||
Install a GUI to test `sudo` privileges
|
||||
========================================
|
||||
.. note::
|
||||
Install and update the OS software to its current version
|
||||
*********************************************************
|
||||
|
||||
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.
|
||||
The |CL| software utility :ref:`swupd <swupd-guide>` allows you to perform system updates while reaping the benefits of upstream development.
|
||||
|
||||
To test the :command:`sudo` command and ensure it is set up correctly,
|
||||
install the GNOME Display Manager (gdm) and start it.
|
||||
To update your newly installed OS, run:
|
||||
|
||||
#. To install the the GNOME Display Manager using :command:`swupd`, enter
|
||||
the following command:
|
||||
.. code-block:: bash
|
||||
|
||||
.. code-block:: bash
|
||||
swupd update
|
||||
|
||||
sudo swupd bundle-add desktop
|
||||
Add a bundle
|
||||
************
|
||||
|
||||
#. To start the GNOME Display Manager, enter the following command:
|
||||
Software applications are installed as bundles using the command
|
||||
:command:`swupd bundle-add`. Experienced Linux* users might compare `swupd`
|
||||
to running :command:`apt-get` or :command:`yum install` for package
|
||||
management. Yet |CL| manages packages at the level of bundles, which
|
||||
are integrated stacks of packages.
|
||||
|
||||
.. code-block:: bash
|
||||
For example, the `sysadmin-basic` bundle installs the majority of applications useful to a system administrator. To install it, enter:
|
||||
|
||||
systemctl start gdm
|
||||
.. code-block:: bash
|
||||
|
||||
#. The system prompts you to authenticate the user. Enter the password for
|
||||
`<userid>`, and the GNOME Display Manager starts as shown in Figure
|
||||
1:
|
||||
swupd bundle-add sysadmin-basic
|
||||
|
||||
.. figure:: figures/gnomedt.png
|
||||
:scale: 50 %
|
||||
:alt: Gnome Desktop
|
||||
View a full list of bundles and packages installed with the `sysadmin-basic`_ bundle. You can also view `all bundles`_ for |CL|, active or deprecated.
|
||||
|
||||
Figure 1: :guilabel:`Gnome Desktop`
|
||||
Expand your knowledge of :command:`swupd` and check out our developer resources:
|
||||
|
||||
#. To start the GNOME Display Manager each time you start your system, enter
|
||||
the following command:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
systemctl enable gdm
|
||||
* :ref:`swupd-guide`
|
||||
* :ref:`developer-workstation`
|
||||
|
||||
Next steps
|
||||
***********
|
||||
**********
|
||||
|
||||
With your system now running |CL|, many opportunities exist.
|
||||
Check out our guides and tutorials.
|
||||
|
||||
Visit the :ref:`tutorials <tutorials>` page for examples on using your |CL|
|
||||
system.
|
||||
* :ref:`guides`
|
||||
* :ref:`tutorials`
|
||||
|
||||
.. _`sysadmin-basic`:
|
||||
https://github.com/clearlinux/clr-bundles/blob/master/bundles/sysadmin-basic
|
||||
|
||||
Reference in New Issue
Block a user