From c021c2ead2970ba474eba9f68a7bc230e3c29b93 Mon Sep 17 00:00:00 2001 From: Jose Lamego Date: Fri, 8 Jun 2018 13:47:25 -0500 Subject: [PATCH 01/76] kata-containers: add tutorial This tutorial describes how to install, configure and run Kata Containers on Clear Linux. Signed-off-by: Jose Lamego --- source/clear-linux/tutorials/kata.rst | 81 ++++++++++++++++++++++ source/clear-linux/tutorials/tutorials.rst | 1 + 2 files changed, 82 insertions(+) create mode 100644 source/clear-linux/tutorials/kata.rst diff --git a/source/clear-linux/tutorials/kata.rst b/source/clear-linux/tutorials/kata.rst new file mode 100644 index 00000000..7f886e58 --- /dev/null +++ b/source/clear-linux/tutorials/kata.rst @@ -0,0 +1,81 @@ + .. _kata: + +Install Kata Containers +####################### + +This tutorial describes how to install, configure and run Kata Containers on +|CLOSIA|. Kata Containers is an open source project and community working to +build a standard implementation of lightweight Virtual Machines (VMs) that feel +and perform like containers, but provide the workload isolation and security +advantages of VMs. Kata Containers is available in Clear Linux versions above 22860. + +Prerequisites +************* + +This tutorial assumes you have installed |CL| on your host system. +For detailed instructions on installing |CL| on a bare metal system, visit +the :ref:`bare metal installation tutorial`. + +Before you install any new packages, update |CL| with the following command: + +.. code-block:: bash + + sudo swupd update + +Install Kata Containers +*********************** + +Kata Containers is included in the :file:`containers-virt` bundle. To install the +framework, enter: + +.. code-block:: bash + + sudo swupd bundle-add containers-virt + +Configure Docker to use Kata Containers by default + +.. code-block:: bash + + sudo mkdir -p /etc/systemd/system/docker.service.d/ + cat < Date: Mon, 11 Jun 2018 13:48:00 -0500 Subject: [PATCH 02/76] Update kata.rst --- source/clear-linux/tutorials/kata.rst | 34 +++++++++++++-------------- 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/source/clear-linux/tutorials/kata.rst b/source/clear-linux/tutorials/kata.rst index 7f886e58..841dc083 100644 --- a/source/clear-linux/tutorials/kata.rst +++ b/source/clear-linux/tutorials/kata.rst @@ -1,13 +1,13 @@ .. _kata: -Install Kata Containers +Install Kata Containers\* ####################### -This tutorial describes how to install, configure and run Kata Containers on -|CLOSIA|. Kata Containers is an open source project and community working to +This tutorial describes how to install, configure and run Kata Containers\* on +|CLOSIA|. Kata Containers\* is an open source project and community working to build a standard implementation of lightweight Virtual Machines (VMs) that feel and perform like containers, but provide the workload isolation and security -advantages of VMs. Kata Containers is available in Clear Linux versions above 22860. +advantages of VMs. Kata Containers\* is available in Clear Linux versions above 22860. Prerequisites ************* @@ -22,17 +22,17 @@ Before you install any new packages, update |CL| with the following command: sudo swupd update -Install Kata Containers +Install Kata Containers\* *********************** -Kata Containers is included in the :file:`containers-virt` bundle. To install the +Kata Containers\* is included in the :file:`containers-virt` bundle. To install the framework, enter: .. code-block:: bash sudo swupd bundle-add containers-virt -Configure Docker to use Kata Containers by default +Configure Docker to use Kata Containers\* by default .. code-block:: bash @@ -43,14 +43,14 @@ Configure Docker to use Kata Containers by default ExecStart=/usr/bin/dockerd -D --add-runtime kata-runtime=/usr/bin/kata-runtime --default-runtime=kata-runtime EOF -Restart the Docker\* and Kata Containers systemd services +Restart the Docker\* and Kata Containers\* systemd services .. code-block:: bash sudo systemctl daemon-reload sudo systemctl restart docker -Run Kata Containers +Run Kata Containers\* ******************* .. code-block:: bash @@ -59,19 +59,19 @@ Run Kata Containers **Congratulations!** -You successfully installed and set up Kata Containers on |CLOSIA|. +You successfully installed and set up Kata Containers\* on |CLOSIA|. -More information about Docker in |CLOSIA|. +More information about Docker\* in |CLOSIA|. ############################################# -Docker on |CLOSIA| provides a docker.service service file to start the docker +Docker\* on |CLOSIA| provides a docker.service service file to start the Docker\* daemon. The daemon will use runc or cc-runtime depending on the environment: -If you are running Clear Linux on baremetal or on a VM with Nested -Virtualization activated, docker will use cc-runtime as the default runtime. -If you are running Clear Linux on a VM without Nested Virtualization, docker -will use runc as the default runtime. It is not necessary to configure Docker -to use cc-runtime manually since Docker itself will automatically use this +If you are running |CL| on baremetal or on a VM with Nested +Virtualization activated, Docker\* will use cc-runtime as the default runtime. +If you are running |CL| on a VM without Nested Virtualization, Docker\* +will use runc as the default runtime. It is not necessary to configure Docker\* +to use cc-runtime manually since Docker\* itself will automatically use this runtime on systems that support it. To check which runtime your system is using, run: From 1d570b86220340efbbb41faac00994709b4cd070 Mon Sep 17 00:00:00 2001 From: MCamp859 Date: Tue, 12 Jun 2018 20:16:33 -0400 Subject: [PATCH 03/76] Edits for branding and format. Removed $ prompts. Moved links to end of file. Updated tutorial.rst. Signed-off-by: MCamp859 --- .../clear-linux/tutorials/kata_migration.rst | 100 ++++++++++++++++++ source/clear-linux/tutorials/tutorials.rst | 1 + 2 files changed, 101 insertions(+) create mode 100644 source/clear-linux/tutorials/kata_migration.rst diff --git a/source/clear-linux/tutorials/kata_migration.rst b/source/clear-linux/tutorials/kata_migration.rst new file mode 100644 index 00000000..6d41252a --- /dev/null +++ b/source/clear-linux/tutorials/kata_migration.rst @@ -0,0 +1,100 @@ +.. _kata_migration: + +Migrate Clear Containers to Kata Containers\* +############################################# + +`Clear Containers`_ and `Kata Containers`_ can co-exist in the same system. +Both can be installed through the :file:`containers-virt bundle`. However, we +recommend that you migrate to Kata Containers because Clear Containers is no +longer maintained_ and will soon be deprecated on |CLOSIA|. + +This guide describes how to migrate to Kata Containers and assumes that: + +* Clear Containers is on a Docker\* system. +* Kata Containers is installed. See :ref:`kata`. + + +Stop Clear Containers instances +******************************* + +As an unprivileged user, stop all running instances of Clear Containers: + +.. code-block:: bash + + for container in $(sudo docker ps -q); do sudo docker stop $container; done + + +Manually migrate customized configuration files +*********************************************** + +If you have made changes to your `Clear Containers configuration`_, review +those changes and decide whether to manually apply those changes to your +`Kata Containers configuration`_. + +Make any required changes before continuing this process. + +.. note:: + + You do not need to manually remove any Clear Containers packages. + +Disable Clear Containers manager configuration +********************************************** + +Remove the Clear Containers configuration file: + +.. code-block:: bash + + sudo rm /etc/systemd/system/docker.service.d/clear-containers.conf + +Enable Kata Containers as default +********************************* + +#. Configure Docker to use the Kata Containers runtime by default. + + .. code-block:: bash + + sudo mkdir -p /etc/systemd/system/docker.service.d/ + cat < Date: Fri, 15 Jun 2018 19:46:15 -0700 Subject: [PATCH 04/76] Create autospec guide and autospec-about to fulfill JIRAs: - CLEAR 3076: Autospec concept draft - CLEAR 3077: Autospec guide Signed-off-by: Michael Vincerra --- .../clear-linux/concepts/autospec-about.rst | 107 ++++++ source/clear-linux/concepts/concepts.rst | 1 + .../guides/maintenance/autospec.rst | 316 ++++++++++++++++++ .../guides/maintenance/maintenance.rst | 1 + 4 files changed, 425 insertions(+) create mode 100644 source/clear-linux/concepts/autospec-about.rst create mode 100644 source/clear-linux/guides/maintenance/autospec.rst diff --git a/source/clear-linux/concepts/autospec-about.rst b/source/clear-linux/concepts/autospec-about.rst new file mode 100644 index 00000000..05752595 --- /dev/null +++ b/source/clear-linux/concepts/autospec-about.rst @@ -0,0 +1,107 @@ +.. _autospec-about: + +.. _autospec-overview: + +Autospec overview +################# + +Whereas a standard RPM build process using ``rpmbuild`` requires a tarball +and ``spec`` file to start, ``autospec`` only requires a tarball. +``autospec`` analyzes the source code and :file:`Makefile` information in +order to generate a ``spec`` file for you. Although not required, you can +influence ``autospec`` by providing control files. + +.. code-block:: console + + buildreq_add + buildreq__ban + pkgconfig_add + pkgconfig_ban + requires_add + requires_ban + options.conf + build_pattern + +These files should be located in same directory as the resulting ``spec`` +file. + +.. note:: + + For a comprehensive list of control files, view the `autospec readme`_. + +Control files are explained in Table 1. + +.. list-table:: **Table 1. Control Files** + :widths: 20 80 + :header-rows: 1 + + * - Filename + - Description + * - buildreq_add + - Each line in the file provides the name of a package to add as a + build dependency to the ``spec``. + * - buildreq_ban + - Each line in the file is a build dependency that under no + circumstance should be automatically added to the build dependencies. + This is useful to block automatic configuration routines adding + undesired functionality, or to omit any automatically discovered + dependencies during tarball scanning. + * - pkgconfig_add + - Each line in the file is assumed to be a pkgconfig() build + dependency. Add the pkg-config names here, as ``autospec`` will + automatically transform the names into their ``pkgconfig($name)`` + style when generating the ``spec``. + * - pkgconfig_ban + - Each line in this file is a pkgconfig() build dependency that should + not be added automatically to the build, much the same as + `` buildreq_ban``. As with ``pkgconfig_add``, these names are + automatically transformed by ``autospec`` into their correct + ``pkgconfig($name))`` style. + * - requires_add + - Each line in the file provides the name of a package to add as a + runtime dependency to the ``spec``. + * - requires_ban + - Each line in the file is a runtime dependency that under no + circumstance should be automatically added to the runtime + dependencies. This is useful to block automatic configuration + routines adding undesired functionality, or to omit any automatically + discovered dependencies during tarball scanning. + * - build_pattern + - In certain situations, the automatically detected build pattern may + not work for the given package. This one line file allows you to + override the build pattern that ``autospec`` will use. + * - options.conf + - Further control of the build can be achieved through the use of the + ``options.conf`` file. If this file does not exist it is created by + autospec with default values. If certain deprecated configuration + files exists autospec will use the value indicated by those files and + remove them. + +How autospec works +****************** + +Autospec attempts to infer the requirements of the ``spec`` file. If +autospec infers correctly, the control files (Table 1) will automatically +correct the build requirements. These control files are used to influence +the ``spec`` file generation. + +#. The :command:`make autospec` command generates a ``spec`` file from the + control files. + +#. ``autospec`` creates a ``chroot`` with ``mock`` config. + +#. ``autospec`` attempts to build an RPM from the generated ``spec`` file. + +#. ``autospec`` detects any missed definitions in the ``spec`` file. + +.. note:: + + * If there are missed definitions, ``autospec`` creates another ``mock`` + ``chroot`` and starts building again at Step 1. + * If a build error occurs, ``autospec`` stops for user inspection. + * If no build errors occur, RPM packages are successfully built. + +``autospec`` continuously runs updated builds, based on new information +discovered from build failures until it has a valid ``spec`` file. + +.. _autospec readme: https://github.com/clearlinux/autospec diff --git a/source/clear-linux/concepts/concepts.rst b/source/clear-linux/concepts/concepts.rst index 476b5c8f..dbb4b680 100644 --- a/source/clear-linux/concepts/concepts.rst +++ b/source/clear-linux/concepts/concepts.rst @@ -13,4 +13,5 @@ details relevant to the |CL| features. swupd-about mixer-about bundles-about + autospec-about restart diff --git a/source/clear-linux/guides/maintenance/autospec.rst b/source/clear-linux/guides/maintenance/autospec.rst new file mode 100644 index 00000000..317e0520 --- /dev/null +++ b/source/clear-linux/guides/maintenance/autospec.rst @@ -0,0 +1,316 @@ +.. _autospec: + +Build RPMs with autospec +######################## + +This guide shows you how to create RPMs with :ref:`autospec ` +, a tool that assists in automated creation and maintenance of RPM packaging +on |CLOSIA|. Additionally, you will use the RPMs to create bundles using +:ref:`mixer `. + +Prerequisites +************* +This guide assumes that you have: + +* Created :ref:`a custom mix ` of |CL| and deployed it to a + to a target device + +* |CL| running on a host machine or virtual environment + + .. note:: + + To install |CL|, see: + + * :ref:`bare-metal-install` + * :ref:`virtual-machine-install` + +Install Clear Linux tooling framework +===================================== + +Our GitHub\* repository provides you with the resources you need +to create and maintain packages. + +#. On your host system, install this developer bundle. + + .. code-block:: bash + + sudo swupd bundle-add os-clr-on-clr + +#. Run this command to download the :file:`user-setup.sh` script. + + .. code-block:: bash + + curl -O https://raw.githubusercontent.com/clearlinux/common/master/user-setup.sh + +#. Make :file:`user-setup.sh` executable. + + .. code-block:: bash + + chmod +x user-setup.sh + +#. Run the script as an unprivileged user. + + .. code-block:: bash + + ./user-setup.sh + +#. After the script completes, log out and log in again to complete + the setup process. + + The `user-setup script`_ creates a folder called :file:`clearlinux`, which + contains the :file:`Makefile`, :file:`packages`, and :file:`projects` + subfolders. + + The :file:`projects` folder contains the main tools, `autospec` + and `common`, used for making packages in |CL|. + +Create a RPM with autospec +************************** + +.. include:: ../../concepts/autospec-about.rst + :Start-after: autospec-overview + :end-before: For a comprehensive list of control files + +For a detailed explanation of how ``autospec`` works on |CL|, visit our +:ref:`autospec-about`. For a general understanding of how RPMs work, we +recommend visiting the `rpm website`_ or the `RPM Packaging Guide`_ . + +Building RPMs +============= + +Choose one of the following options to build RPMs and manage source +code: + +* :ref:`build-a-new-rpm` and spec file using ``make autospecnew``. + +* :ref:`build-source-code-with-existing-spec-file` (without changing the + spec file) using ``make build``. + +* :ref:`generate-a-new-spec-file` based on changes in the control files with + ``make autospec``. + +.. _build-a-new-rpm: + +Build a new RPM +=============== + +#. Navigate to the autospec workspace. + + .. code-block:: bash + + cd ~/clearlinux + +#. Enter the command: + + .. code-block:: bash + + make autospecnew URL="https://github.com/bktan/helloclear/archive/helloclear-4.tar.gz" NAME="helloclear" + + .. note:: + + For a local tarball, use for the *URL*: + file:// + +#. If build failures or dependency issues occur, continue below. + Otherwise, skip directly to `copy-rpm-packages-to-mixer`_. + + #. Navigate to the specific package. + + .. code-block:: bash + + cd ~/clearlinux/packages/[package-name] + + #. Respond to the build process output by editing control files to resolve + issues, which may include dependencies or exclusions. + See `autospec readme`_ + + #. Run this command: + + .. code-block:: bash + + make autospec + + Repeat the last two steps above until all errors are resolved and you + complete a successful build. + + Skip to `copy-rpm-packages-to-mixer`_ to add the new RPM to your mix. + +.. _build-source-code-with-existing-spec-file: + +Build source code with an existing spec file +============================================ + +If you only want to build the RPM using the spec file, use this method. This +method assumes that a spec file already exists. In this example, we run a +``make build`` on the ``dmidecode`` package. + +#. Navigate to the ``dmidecode`` package in clearlinux: + + .. code-block:: + + cd ~/clearlinux/packages/dmidecode/ + +#. To download the tarball and build, run the command: + + .. code-block:: + + make build + + Skip to `copy-rpm-packages-to-mixer`_ to add the new RPM to your mix. + +.. _generate-a-new-spec-file: + +Generate a new spec file with a pre-defined package +=================================================== + +In this method, you will modify an existing |CL| package called ``dmidecode`` +to create a custom RPM. You will make a simple change to this package, +change the revision to a new number that is higher than the |CL| OS version, +and rebuild the package. + +#. Navigate to clearlinux: + + .. code-block:: bash + + cd ~/clearlinux + +#. Copy the ``dmidecode`` package. + + .. code-block:: bash + + make clone_dmidecode + +#. Navigate into the *dmidecode* directory: + + .. code-block:: bash + + cd packages/dmidecode + +#. With an editor, open the :file:`excludes` file and add these lines: + + .. code-block:: bash + + /usr/bin/biosdecode + /usr/bin/ownership + /usr/bin/vpddecode + /usr/share/man/man8/biosdecode.8 + /usr/share/man/man8/ownership.8 + /usr/share/man/man8/vpddecode.8 + + .. note:: + + These files aren't needed by dmidecode, so we can remove them without + any issues. + +#. Save the file and exit. + +#. At :file:`~/clearlinux/packages/dmidecode`, build the modified + ``dmidecode`` package: + + .. code-block:: bash + + make autospec + + When the process completes, you will see new RPM packages in the + :file:`results/` folder. + +#. To view the new RPM packages, enter: + + .. code-block:: bash + + ls /clearlinux/packages/dmidecode/results/ + +Add a custom RPM to a mix and deploy to target +********************************************** + +We need a RPM repository to store our custom RPMs. This repository also +includes some metadata that allows programs such as ``yum`` and ``dnf`` to +follow and include any specified dependencies. This architecture enables us +to test custom RPMs before we integrate them in a mix. + +.. note:: + + Assure that you followed the :ref:`mixer` instruction and created + a location for **local RPM packages** using the *--local-rpms* flag + with the command: :command:`mixer init --local-rpms`. If you skipped + this step, return and complete it in :ref:`mixer` before proceeding. + +.. _copy-rpm-packages-to-mixer: + +Copy RPM packages to mixer and build bundle +============================================ + +Transfer the newly generated RPM packages to the ``mixer`` folder so +that it can include them as needed. + +.. note:: + + This guide assumes that you have a web server that hosts ``swupd`` update + content. + +#. Change directory into the mix workspace: + + .. code-block:: bash + + cd ~/mix + +#. Copy the contents from the results folder in the RPM packages to the + :file:`local-rpms` folder in the :file:`mix` folder: + + .. code-block:: bash + + cp ~/clearlinux/packages/dmidecode/results/*x86_64*rpm ~/mix/local-rpms/ + +#. Remove the debuginfo: + + .. code-block:: bash + + rm ~/mix/local-rpms/*debuginfo*x86_64* + +#. Generate the yum repo: + + .. code-block:: bash + + sudo mixer add-rpms + +#. Create a local bundle definition file to include the newly generated RPM + package in your mix. In our example, the ``[bundle-name]`` is + either ``dmidecode`` or ``helloclear``. + + .. code-block:: bash + + mixer bundle edit [bundle-name] + +#. Then add the new bundle to the mix. + + .. code-block:: bash + + mixer bundle add [bundle-name] + +#. Build the bundle and update content. + + .. code-block:: bash + + sudo mixer build all + +#. Log into the target device. + +#. On the target device, update and install the new bundle. + + .. code-block:: bash + + sudo swupd update + + sudo swupd bundle-add [bundle-name] + +**Congratulations!** + +You successfully built a RPM and created a mix with it. + +.. _rpm website: http://rpm.org + +.. _RPM Packaging Guide: https://rpm-packaging-guide.github.io/ + +.. _user-setup script: https://github.com/clearlinux/common/blob/master/user-setup.sh + +.. _autospec readme: https://github.com/clearlinux/autospec diff --git a/source/clear-linux/guides/maintenance/maintenance.rst b/source/clear-linux/guides/maintenance/maintenance.rst index 8775a909..61ae7920 100644 --- a/source/clear-linux/guides/maintenance/maintenance.rst +++ b/source/clear-linux/guides/maintenance/maintenance.rst @@ -22,3 +22,4 @@ maintaining |CLOSIA| after :ref:`installation ` is completed. download-verify-uncompress-mac download-verify-uncompress-windows image-types + autospec From 848cd6b56cc3d80b5ed996f3d9c3aa0c28945636 Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Mon, 18 Jun 2018 12:40:54 -0700 Subject: [PATCH 05/76] Applies feedback from phmccarty re terminology and fixes typo. Signed-off-by: Michael Vincerra --- source/clear-linux/concepts/autospec-about.rst | 18 +++++++++--------- .../guides/maintenance/autospec.rst | 7 ++++--- 2 files changed, 13 insertions(+), 12 deletions(-) diff --git a/source/clear-linux/concepts/autospec-about.rst b/source/clear-linux/concepts/autospec-about.rst index 05752595..7930c545 100644 --- a/source/clear-linux/concepts/autospec-about.rst +++ b/source/clear-linux/concepts/autospec-about.rst @@ -2,13 +2,13 @@ .. _autospec-overview: -Autospec overview -################# +Autospec +######## Whereas a standard RPM build process using ``rpmbuild`` requires a tarball -and ``spec`` file to start, ``autospec`` only requires a tarball. -``autospec`` analyzes the source code and :file:`Makefile` information in -order to generate a ``spec`` file for you. Although not required, you can +and ``spec`` file to start, ``autospec`` only requires a tarball and package +name. ``autospec`` analyzes the source code and :file:`Makefile` information +in order to generate a ``spec`` file for you. Although not required, you can influence ``autospec`` by providing control files. .. code-block:: console @@ -88,20 +88,20 @@ the ``spec`` file generation. #. The :command:`make autospec` command generates a ``spec`` file from the control files. -#. ``autospec`` creates a ``chroot`` with ``mock`` config. +#. ``autospec`` creates a ``build root`` with ``mock`` config. #. ``autospec`` attempts to build an RPM from the generated ``spec`` file. -#. ``autospec`` detects any missed definitions in the ``spec`` file. +#. ``autospec`` detects any missed declarations in the ``spec`` file. .. note:: - * If there are missed definitions, ``autospec`` creates another ``mock`` + * If there are missed declarations, ``autospec`` creates another ``mock`` ``chroot`` and starts building again at Step 1. * If a build error occurs, ``autospec`` stops for user inspection. * If no build errors occur, RPM packages are successfully built. -``autospec`` continuously runs updated builds, based on new information +``autospec`` continues to rebuild the package, based on new information discovered from build failures until it has a valid ``spec`` file. .. _autospec readme: https://github.com/clearlinux/autospec diff --git a/source/clear-linux/guides/maintenance/autospec.rst b/source/clear-linux/guides/maintenance/autospec.rst index 317e0520..c2370254 100644 --- a/source/clear-linux/guides/maintenance/autospec.rst +++ b/source/clear-linux/guides/maintenance/autospec.rst @@ -72,8 +72,9 @@ Create a RPM with autospec :end-before: For a comprehensive list of control files For a detailed explanation of how ``autospec`` works on |CL|, visit our -:ref:`autospec-about`. For a general understanding of how RPMs work, we -recommend visiting the `rpm website`_ or the `RPM Packaging Guide`_ . +:ref:`autospec-about` about page. For a general understanding of how RPMs +work, we recommend visiting the `rpm website`_ or the +`RPM Packaging Guide`_ . Building RPMs ============= @@ -104,7 +105,7 @@ Build a new RPM .. code-block:: bash - make autospecnew URL="https://github.com/bktan/helloclear/archive/helloclear-4.tar.gz" NAME="helloclear" + make autospecnew URL="https://github.com/bktan8/helloclear/archive/helloclear-4.tar.gz" NAME="helloclear" .. note:: From 1e3cab5c97c6cc2c0c0389503ca5104f73322bcb Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Wed, 20 Jun 2018 11:23:24 -0700 Subject: [PATCH 06/76] Applies grammatical and trademark edits: - Linux kernels are updated per clr/bundles active status - Fulfills JIRA CLEAR 3107 Signed-off-by: Michael Vincerra --- .../reference/compatible-kernels.rst | 19 +++++++++---------- 1 file changed, 9 insertions(+), 10 deletions(-) diff --git a/source/clear-linux/reference/compatible-kernels.rst b/source/clear-linux/reference/compatible-kernels.rst index caa5fe28..0524c57d 100644 --- a/source/clear-linux/reference/compatible-kernels.rst +++ b/source/clear-linux/reference/compatible-kernels.rst @@ -1,6 +1,6 @@ .. _compatible-kernels: -Compatible Clear Linux kernels +Compatible Clear Linux\* kernels ############################## The |CLOSIA| provides the following Linux kernels with a respective bundle. @@ -44,11 +44,10 @@ The *kernel-kvm* bundle focuses on the Linux :abbr:`KVM (Kernel-based Virtual Machine)`. It is optimized for fast booting and performs best on Virtual Machines running on the Intel® architectures described on the :ref:`supported hardware list`. -Use this kernel when running |CL| as the guest OS -on top of *qemu/kvm*. Use this kernel with **cloud orchestrators** using -*qemu/kvm* internally as their **hypervisor**. -This kernel can be used as a stand alone Linux VM, see our -:ref:`instructions on using KVM` for more information. The +Use this kernel when running |CL| as the guest OS on top of *qemu/kvm*. Use +this kernel with **cloud orchestrators** using *qemu/kvm* internally as +their **hypervisor**. This kernel can be used as a standalone |CL| VM, see +our :ref:`instructions on using KVM` for more information. The optimization patches are found in our `Linux-KVM`_ GitHub repo. Kernel Hyper-V\* @@ -59,8 +58,8 @@ Hyper-V. It is optimized for fast booting and performs best on Virtual Machines running on the Intel® architectures described on the :ref:`supported hardware list`. Use this kernel when running |CL| as the guest OS of **Cloud Instances** in -projects such as Microsoft `Azure`_\*. This kernel can be used as a stand -alone Linux VM, see our :ref:`instructions on using Hyper-V` for +projects such as Microsoft `Azure`_\*. This kernel can be used in a +standalone |CL| VM, see our :ref:`instructions on using Hyper-V` for more information. The optimization patches are found in our `Linux-HyperV`_ GitHub repo. @@ -73,8 +72,8 @@ is optimized for fast booting and performs best on Virtual Machines running on the Intel® architectures described on the :ref:`supported hardware list`. Use this kernel when running |CL| as the guest OS of **Cloud Instances** in -projects such as Microsoft `Azure`_. This kernel can be used as a stand -alone Linux VM, see our :ref:`instructions on using Hyper-V` for +projects such as Microsoft `Azure`_. This kernel can be used in a standalone +|CL| VM, see our :ref:`instructions on using Hyper-V` for more information. The optimization patches are found in our `Linux-HyperV-LTS`_ GitHub repo. From 078ee76f1d6f3ae3dc3d5311404f14d3345dcd23 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Thu, 21 Jun 2018 13:12:53 -0700 Subject: [PATCH 07/76] Reorder methods to find partition size The lsblk approach is more likely to be used on an already deployed system, while the config.json is more of a reference point. --- .../increase-virtual-disk-size.rst | 40 ++++++++++--------- 1 file changed, 22 insertions(+), 18 deletions(-) diff --git a/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst b/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst index 7b991faa..5c87482c 100644 --- a/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst +++ b/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst @@ -13,7 +13,28 @@ Determine the prebuilt image size There are two methods to find the virtual disk size of your prebuilt |CL| image. -The first method is to check the config.JSON file of the image, located in the +The first method is to boot up your :abbr:`VM (Virtual Machine)` and +execute the :command:`lsblk` command as shown below: + +.. code-block:: bash + + sudo lsblk + +An example output of the :command:`lsblk` command: + +.. code-block:: console + + NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT + sda 8:0 0 8.5G 0 disk + ├─sdd1 8:1 0 512M 0 part + ├─sdd2 8:2 0 32M 0 part [SWAP] + └─sdd3 8:3 0 8G 0 part / + +In this example, both methods show the prebuilt Hyper-V image is about 8.5 GB. + + + +The second method is to check the config.JSON file of the image, located in the `releases`_ repository. For example, to find the size of the Hyper-V\* image version number 20450, follow these steps: @@ -39,24 +60,7 @@ version number 20450, follow these steps: "size" : "8G", "type" : "linux" } ], -The second method is to boot up your :abbr:`VM (Virtual Machine)` and -execute the :command:`lsblk` command as shown below: -.. code-block:: bash - - sudo lsblk - -An example output: - -.. code-block:: console - - NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT - sda 8:0 0 8.5G 0 disk - ├─sdd1 8:1 0 512M 0 part - ├─sdd2 8:2 0 32M 0 part [SWAP] - └─sdd3 8:3 0 8G 0 part / - -In this example, both methods show the prebuilt Hyper-V image is about 8.5 GB. Increase virtual disk size ************************** From 746bef2d0d332b2c16bc056ca29103b31d3f0ef1 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Thu, 21 Jun 2018 13:53:20 -0700 Subject: [PATCH 08/76] Add second level headers --- .../increase-virtual-disk-size.rst | 53 +++++++++++++------ 1 file changed, 38 insertions(+), 15 deletions(-) diff --git a/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst b/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst index 5c87482c..005d436b 100644 --- a/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst +++ b/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst @@ -1,40 +1,51 @@ .. _increase-virtual-disk-size: -Increase Clear Linux image virtual disk size -############################################ +Increase virtual disk size of a Clear Linux image +################################################# Prebuilt |CLOSIA| images come in different sizes, ranging from 300 MB to 20 GB. This guide describes how to increase the size of your prebuilt |CL| image if you need more capacity. -Determine the prebuilt image size -********************************* +.. contents:: This guide will cover: + + +Determine the partition sizes of the prebuilt image +*************************************************** There are two methods to find the virtual disk size of your prebuilt |CL| image. +In both examples, the prebuilt Hyper-V image used starting off at about 8.5 GB +with /dev/sdd3 being the partition + + +Checking :command:`lsblk` on the VM +----------------------------------- + The first method is to boot up your :abbr:`VM (Virtual Machine)` and execute the :command:`lsblk` command as shown below: -.. code-block:: bash + .. code-block:: bash - sudo lsblk + sudo lsblk An example output of the :command:`lsblk` command: -.. code-block:: console + .. code-block:: console - NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT - sda 8:0 0 8.5G 0 disk - ├─sdd1 8:1 0 512M 0 part - ├─sdd2 8:2 0 32M 0 part [SWAP] - └─sdd3 8:3 0 8G 0 part / - -In this example, both methods show the prebuilt Hyper-V image is about 8.5 GB. + NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT + sda 8:0 0 8.5G 0 disk + ├─sdd1 8:1 0 512M 0 part + ├─sdd2 8:2 0 32M 0 part [SWAP] + └─sdd3 8:3 0 8G 0 part / -The second method is to check the config.JSON file of the image, located in the + +Checking :file:`config.json` used to build the image +---------------------------------------------------- +The second method is to check the :file:`config.json` file used to create prebuilt image, located in the `releases`_ repository. For example, to find the size of the Hyper-V\* image version number 20450, follow these steps: @@ -65,12 +76,20 @@ version number 20450, follow these steps: Increase virtual disk size ************************** +Power off VM and increase virtual disk size: +-------------------------------------------- + To increase the virtual disk size for a prebuilt image, perform the steps below: #. Shut down your VM if it is running. #. Use an appropriate hypervisor tool to increase the virtual disk size of your VM. #. Power up the VM. + + +Resize the partition of the virtual disk: +----------------------------------------- + #. Log in to an account with root privileges. #. Open a terminal emulator. #. Add the |CL| `storage-utils` bundle to install the `parted` and @@ -114,6 +133,10 @@ To increase the virtual disk size for a prebuilt image, perform the steps below: #. Enter :command:`q` to exit `parted` when you are finished resizing the image. + +Resize the filesytem +-------------------- + #. Enter :command:`sudo resize2fs -p /dev/[modified partition name]` where *[modified partition name]* is the partition that was changed in `parted`. From b8af0eb051a5c1c5d5c72d7d7287a51409d211e5 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Fri, 22 Jun 2018 10:36:26 -0700 Subject: [PATCH 09/76] Split figure into two and minor clarifications --- .../figures/increase-virtual-disk-size-1.png | Bin 32439 -> 22657 bytes .../figures/increase-virtual-disk-size-2.png | Bin 0 -> 11026 bytes .../increase-virtual-disk-size.rst | 155 ++++++++++-------- 3 files changed, 87 insertions(+), 68 deletions(-) create mode 100644 source/clear-linux/guides/maintenance/figures/increase-virtual-disk-size-2.png diff --git a/source/clear-linux/guides/maintenance/figures/increase-virtual-disk-size-1.png b/source/clear-linux/guides/maintenance/figures/increase-virtual-disk-size-1.png index db5a2f3f413ead2268e9a55c7c053d6e3831f4e4..a4692c9affcf3f1040252b177910d34bd7aba681 100755 GIT binary patch literal 22657 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 W?YdTw_!{!-?|1EeNA~s~|Mb6RM4_1g literal 0 HcmV?d00001 diff --git a/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst b/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst index 005d436b..755a327f 100644 --- a/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst +++ b/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst @@ -10,14 +10,15 @@ if you need more capacity. .. contents:: This guide will cover: -Determine the partition sizes of the prebuilt image +Determine the partition order and sizes of the prebuilt image *************************************************** -There are two methods to find the virtual disk size of your prebuilt |CL| +There are two methods to find the order and sizes of partitions virtual disk of your prebuilt |CL| image. -In both examples, the prebuilt Hyper-V image used starting off at about 8.5 GB -with /dev/sdd3 being the partition +In both examples, the prebuilt Hyper-V image +has a disk size of 8.5 GB with /dev/sdd3 being the partition +for the root filesystem (/) Checking :command:`lsblk` on the VM @@ -26,26 +27,28 @@ Checking :command:`lsblk` on the VM The first method is to boot up your :abbr:`VM (Virtual Machine)` and execute the :command:`lsblk` command as shown below: - .. code-block:: bash + .. code-block:: bash - sudo lsblk + sudo lsblk An example output of the :command:`lsblk` command: - .. code-block:: console - - NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT - sda 8:0 0 8.5G 0 disk - ├─sdd1 8:1 0 512M 0 part - ├─sdd2 8:2 0 32M 0 part [SWAP] - └─sdd3 8:3 0 8G 0 part / + .. code-block:: console + NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT + sda 8:0 0 8.5G 0 disk + ├─sdd1 8:1 0 512M 0 part + ├─sdd2 8:2 0 32M 0 part [SWAP] + └─sdd3 8:3 0 8G 0 part / +An example of this can also be seen in Figure 1. Checking :file:`config.json` used to build the image ---------------------------------------------------- -The second method is to check the :file:`config.json` file used to create prebuilt image, located in the + +The second method to determine partition to check the :file:`config.json` +file used to create prebuilt image, located in the `releases`_ repository. For example, to find the size of the Hyper-V\* image version number 20450, follow these steps: @@ -53,101 +56,117 @@ version number 20450, follow these steps: #. Drill down into the `20450 > clear > config > image` directory. #. Open the :file:`hyperv-config.json` file. #. Locate the `PartitionLayout` key. - The example shows 512 MB for the EFI partition, 32 MB for the swap - partition, and 8 GB for the root partition. - .. code-block:: console + The example shows 512 MB for the EFI partition, 32 MB for the swap + partition, and 8 GB for the root partition. - "PartitionLayout" : [ { "disk" : "hyperv.img", - "partition" : 1, - "size" : "512M", - "type" : "EFI" }, - { "disk" : "hyperv.img", - "partition" : 2, - "size" : "32M", - "type" : "swap" }, - { "disk" : "hyperv.img", - "partition" : 3, - "size" : "8G", - "type" : "linux" } ], + + .. code-block:: console + + "PartitionLayout" : [ { "disk" : "hyperv.img", + "partition" : 1, + "size" : "512M", + "type" : "EFI" }, + { "disk" : "hyperv.img", + "partition" : 2, + "size" : "32M", + "type" : "swap" }, + { "disk" : "hyperv.img", + "partition" : 3, + "size" : "8G", + "type" : "linux" } ], Increase virtual disk size ************************** +Once you have determined the disk and partition to be increased, you are ready to perform the actual increase. + Power off VM and increase virtual disk size: -------------------------------------------- To increase the virtual disk size for a prebuilt image, perform the steps below: -#. Shut down your VM if it is running. -#. Use an appropriate hypervisor tool to increase the virtual disk size of - your VM. -#. Power up the VM. +#. Shut down your VM if it is running. +#. Use the process defined by your hypervisor to + increase the virtual disk size of your |CL| VM. +#. Power up the VM. Resize the partition of the virtual disk: ----------------------------------------- -#. Log in to an account with root privileges. -#. Open a terminal emulator. -#. Add the |CL| `storage-utils` bundle to install the `parted` and - `resize2fs` tools. +#. Log in to an account with root privileges. +#. Open a terminal emulator. +#. Add the |CL| `storage-utils` bundle to install the :command:`parted` and :command:`resize2fs` tools. - .. code-block:: bash + .. code-block:: bash - sudo swupd bundle-add storage-utils + sudo swupd bundle-add storage-utils #. Launch the `parted` tool. - .. code-block:: bash + .. code-block:: bash - sudo parted + sudo parted #. In the `parted` tool, perform these steps: - #. Press :command:`p` to print the partitions table. - #. If the warning message below is displayed, enter :command:`Fix`. + #. Press :command:`p` to print the partitions table. + #. If the warning message below is displayed, enter :command:`Fix`. - .. code-block:: console + .. code-block:: console - Warning: Not all of the space available to /dev/sda appears to be - used, you can fix the GPT to use all of the space (an extra ... - blocks) or continue with the current setting? + Warning: Not all of the space available to /dev/sda appears to be + used, you can fix the GPT to use all of the space (an extra ... + blocks) or continue with the current setting? - Fix/Ignore? + Fix/Ignore? - #. Enter :command:`resizepart [partition number]` where - *[partition number]* is the partition number to modify. - #. Enter :command:`yes` when prompted. - #. Enter the new `End` size. + #. Enter :command:`resizepart [partition number]` where + *[partition number]* is the partition number of the partition to modify. + #. Enter :command:`yes` when prompted. + #. Enter the new `End` size. - .. note:: + .. note:: - If you want a partition to take up the remaining disk space, then - enter the total size of the disk. When you print the partitions - table with the :command:`p` command, the total disk size is shown - after the `Disk` label. + If you want a partition to take up the remaining disk space, then + enter the total size of the disk. When you print the partitions + table with the :command:`p` command, the total disk size is shown + after the `Disk` label. - #. Enter :command:`q` to exit `parted` when you are finished resizing the - image. + An example of this can be seen in Figure 1. + + + + #. Enter :command:`q` to exit `parted` when you are finished resizing the + image. + + +Figure 1 depicts the described steps to resize the partition of the virtual disk from 8.5GB to 20GB. + +.. figure:: figures/increase-virtual-disk-size-1.png + :scale: 100 % + :alt: Increase root partition size + + Figure 1: Increase root partition size. Resize the filesytem -------------------- -#. Enter :command:`sudo resize2fs -p /dev/[modified partition name]` where - *[modified partition name]* is the partition that was changed in `parted`. +#. Enter :command:`sudo resize2fs -p /dev/[modified partition name]` where + *[modified partition name]* is the partition that was changed in `parted`. -Figure 1 shows how to increase the size of a |CL| Hyper-V image from 8.5 -GB to 20 GB. Before the steps shown in Figure 1, we used the Hyper-V Manager -to increase the VM virtual disk size from 8.5 GB to 20 GB. +#. Run the :command:`df -h` to verify that the filesystem size has increased. -.. figure:: figures/increase-virtual-disk-size-1.png - :scale: 100 % - :alt: Increase root partition size example +Figure 2 depicts the described steps to resize the partition of the virtual disk from 8.5GB to 20GB. - Figure 1: Increase root partition size example. +.. figure:: figures/increase-virtual-disk-size-2.png + :scale: 100 % + :alt: Increase root filesystem with resize2fs + + Figure 2: Increase root filesystem size after partition has been expanded. .. _releases: https://download.clearlinux.org/releases/ From 63a862b615f73e9060dccec1f46f654a73e1f357 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Mon, 25 Jun 2018 10:33:42 -0700 Subject: [PATCH 10/76] Minor formatting and clarifications. --- .../increase-virtual-disk-size.rst | 42 ++++++++++--------- 1 file changed, 23 insertions(+), 19 deletions(-) diff --git a/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst b/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst index 755a327f..76765100 100644 --- a/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst +++ b/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst @@ -3,7 +3,7 @@ Increase virtual disk size of a Clear Linux image ################################################# -Prebuilt |CLOSIA| images come in different sizes, ranging from 300 MB to 20 +|CLOSIA| prebuilt images come in different sizes, ranging from 300 MB to 20 GB. This guide describes how to increase the size of your prebuilt |CL| image if you need more capacity. @@ -47,7 +47,7 @@ An example of this can also be seen in Figure 1. Checking :file:`config.json` used to build the image ---------------------------------------------------- -The second method to determine partition to check the :file:`config.json` +The second method to determine partition to check the :file:`config.json` file used to create prebuilt image, located in the `releases`_ repository. For example, to find the size of the Hyper-V\* image version number 20450, follow these steps: @@ -80,7 +80,7 @@ version number 20450, follow these steps: Increase virtual disk size ************************** -Once you have determined the disk and partition to be increased, you are ready to perform the actual increase. +Once you have determined the disk and partition to be increased, you are ready to perform the actual increase of the disk, partition, and filesystem. Power off VM and increase virtual disk size: @@ -89,8 +89,9 @@ Power off VM and increase virtual disk size: To increase the virtual disk size for a prebuilt image, perform the steps below: #. Shut down your VM if it is running. -#. Use the process defined by your hypervisor to - increase the virtual disk size of your |CL| VM. +#. Use the process defined by your hypervisor + or cloud provider to increase + the virtual disk size of your |CL| VM. #. Power up the VM. @@ -144,29 +145,32 @@ Resize the partition of the virtual disk: image. -Figure 1 depicts the described steps to resize the partition of the virtual disk from 8.5GB to 20GB. + Figure 1 depicts the described steps to resize the partition of the virtual disk from 8.5GB to 20GB. -.. figure:: figures/increase-virtual-disk-size-1.png - :scale: 100 % - :alt: Increase root partition size + .. figure:: figures/increase-virtual-disk-size-1.png + :scale: 100 % + :alt: Increase root partition size - Figure 1: Increase root partition size. + Figure 1: Increase root partition size. Resize the filesytem -------------------- -#. Enter :command:`sudo resize2fs -p /dev/[modified partition name]` where - *[modified partition name]* is the partition that was changed in `parted`. + #. Enter :command:`sudo resize2fs -p /dev/[modified partition name]` where + *[modified partition name]* is the partition that was changed in `parted`. -#. Run the :command:`df -h` to verify that the filesystem size has increased. + #. Run the :command:`df -h` to verify that the filesystem size has increased. -Figure 2 depicts the described steps to resize the partition of the virtual disk from 8.5GB to 20GB. + Figure 2 depicts the described steps to resize the partition of the virtual disk from 8.5GB to 20GB. -.. figure:: figures/increase-virtual-disk-size-2.png - :scale: 100 % - :alt: Increase root filesystem with resize2fs + .. figure:: figures/increase-virtual-disk-size-2.png + :scale: 100 % + :alt: Increase root filesystem with resize2fs - Figure 2: Increase root filesystem size after partition has been expanded. + Figure 2: Increase root filesystem size after partition has been expanded. -.. _releases: https://download.clearlinux.org/releases/ + .. _releases: https://download.clearlinux.org/releases/ + + +Congratulations! You have resized the disk, partition, and filesystem. At this point, the increase in disk capacity is usable. \ No newline at end of file From be55e1bcf569beae0a3bb85edb0ed0a70712e1b0 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Mon, 25 Jun 2018 11:32:44 -0700 Subject: [PATCH 11/76] Add reference back to VMware player install. --- .../vmware-esxi-preconfigured-cl-image.rst | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst index 92dcf185..75b67d8f 100644 --- a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst +++ b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst @@ -5,7 +5,7 @@ Run preconfigured Clear Linux image as a VMware\* ESXi guest OS `VMware ESXi`_ is a type 1 bare-metal hypervisor which runs directly on top of server hardware. With VMware ESXi, you can create, configure, manage, -and run |CLOSIA| virtual machines in the cloud. +and run |CLOSIA| virtual machines at scale. This section shows you how to deploy a preconfigured |CL| VMware image on VMware ESXi 6.5 Update 1 using these steps: @@ -18,14 +18,18 @@ VMware ESXi 6.5 Update 1 using these steps: #. Create and configure a new VM. #. Power on the VM and boot |CL|. -If you would prefer to perform a fresh installation of |CL| into a new VMware +If you would prefer to perform a manual installation of |CL| into a new VMware ESXi :abbr:`VM (Virtual Machine)` instead, see :ref:`vmware-esxi-install-cl`. +Visit :ref:`image-types` to learn more about the available images. + + .. note:: VMware also offers a type 2 hypervisor called `VMware Workstation Player`_ which is designed for the desktop environment. + See :ref:`vmw-player-preconf` or see :ref:`vmw-player`. + -Visit :ref:`image-types` to learn more about the available images. Download the latest Clear Linux VMware image ******************************************** From f014bc5c0112102e6290d74a54738bd7ac45c1b3 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Mon, 25 Jun 2018 11:47:22 -0700 Subject: [PATCH 12/76] Change to ToC directive with page anchors --- .../vmware-esxi-preconfigured-cl-image.rst | 16 +++++----------- 1 file changed, 5 insertions(+), 11 deletions(-) diff --git a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst index 75b67d8f..b149e4fd 100644 --- a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst +++ b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst @@ -8,19 +8,10 @@ of server hardware. With VMware ESXi, you can create, configure, manage, and run |CLOSIA| virtual machines at scale. This section shows you how to deploy a preconfigured |CL| VMware image on -VMware ESXi 6.5 Update 1 using these steps: - -#. Download the latest Clear Linux VMware image. -#. Verify the integrity of the |CL| image. -#. Uncompress the |CL| image. -#. Upload the Clear Linux image to the VMware server. -#. Convert the Clear Linux image to an ESXi-supported format. -#. Create and configure a new VM. -#. Power on the VM and boot |CL|. +VMware ESXi 6.5. If you would prefer to perform a manual installation of |CL| into a new VMware ESXi :abbr:`VM (Virtual Machine)` instead, see :ref:`vmware-esxi-install-cl`. - Visit :ref:`image-types` to learn more about the available images. @@ -30,6 +21,9 @@ Visit :ref:`image-types` to learn more about the available images. See :ref:`vmw-player-preconf` or see :ref:`vmw-player`. +.. contents:: + :depth: 2 + Download the latest Clear Linux VMware image ******************************************** @@ -243,7 +237,7 @@ After configuring the settings above, power on the VM. Figure 13: VMware ESXi - Navigator > Virtual Machines > Power on VM Also see: -********* +--------- * :ref:`vmware-esxi-install-cl` From 371b823e2ebb1c4856e582252e524a69daa93996 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Mon, 25 Jun 2018 14:06:52 -0700 Subject: [PATCH 13/76] Recommend using vMA and add VMware doc references vMA is the official recommendation from VMware for running vmkfstools. --- .../vmware-esxi-preconfigured-cl-image.rst | 42 +++++++++++++++---- 1 file changed, 35 insertions(+), 7 deletions(-) diff --git a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst index b149e4fd..5e8fcbf0 100644 --- a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst +++ b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst @@ -28,7 +28,7 @@ Visit :ref:`image-types` to learn more about the available images. Download the latest Clear Linux VMware image ******************************************** -Get the latest |CL| VMware image from the `image`_ repository. +Get the latest |CL| VMware prebuilt image from the `image`_ repository. Look for :file:`clear-[version number]-vmware.vmdk.xz`. You can also use this command: @@ -48,10 +48,17 @@ For alternative instructions on other operating systems, see: Upload the Clear Linux image to the VMware server ************************************************* -#. Connect to the VMware server and login to an account with sufficient +Once the |CL| VMware prebuilt image has been downloaded and uncompressed on your local system, +it must be uploaded to a datastore on the VMware ESXi server. + +The steps in this section can also be referenced from the `VMware documentation on Using the Datastore File Browser`_ + +#. Connect to the VMware ESXi server and login to an account with sufficient permission to create and manage VMs. -#. Under the :guilabel:`Navigator` window, select :guilabel:`Storage`. - See Figure 1. + +#. Under the :guilabel:`Navigator` window on the left side, select :guilabel:`Storage`. + See Figure 1 + #. Under the :guilabel:`Datastores` tab, click the :guilabel:`Datastore browser` button. @@ -85,14 +92,28 @@ Upload the Clear Linux image to the VMware server Convert the Clear Linux image to an ESXi-supported format ********************************************************* -#. SSH into the VMware server and login to an account with root privileges. -#. Locate the uploaded image, which is typically found in `/vmfs/volumes/datastore1`. +Once the |CL| VMware prebuilt image has been uploaded to the VMware ESXi datastore, +it must be converted to a format for usable with VMware's ESXi hypervisor. + +The steps in this section can also be referenced from the `VMware documentation on Cloning and converting virtual machine disks with vmkfstools`_ + +#. SSH into the `vSphere Management Assistant`_ appliance that is managing the ESXi host. + + .. note:: + If there is no :abbr:`vMA (vSphere Management Assistant)` appliance configured and available, you can temporarily enable SSH directly on the ESXi host by referencing + the `VMware documentation on Enable the Secure Shell (SSH)`_ . + + As a security best practice, remember to disable SSH access after following the steps in this section. + + +#. Locate the uploaded image, which is typically found in :file:`/vmfs/volumes/datastore1`. + #. Use the :command:`vmkfstools` command to perform the conversion, as shown below: .. code-block:: console - # vmkfstools -i clear-[version number]-vmware.vmdk -d zeroedthick clear-[version number]-esxi.vmdk + vmkfstools -i clear-[version number]-vmware.vmdk -d zeroedthick clear-[version number]-esxi.vmdk Two files should result from this: @@ -102,6 +123,8 @@ Convert the Clear Linux image to an ESXi-supported format The :file:`clear-[version number]-esxi.vmdk` file will be used in the next section when you create a new VM. + + Create and configure a new VM ***************************** @@ -242,5 +265,10 @@ Also see: * :ref:`vmware-esxi-install-cl` .. _VMware ESXi: https://www.vmware.com/products/esxi-and-esx.html +.. _`VMware documentation on Using the Datastore File Browser`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-7533A767-8396-4844-A3F2-206047D254EA.html +.. _`vSphere Management Assistant appliance`: https://www.vmware.com/support/developer/vima/ +.. _`VMware documentation on Cloning and converting virtual machine disks with vmkfstools`: https://kb.vmware.com/kb/1028042 +.. _`VMware documentation on Enable the Secure Shell (SSH)`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-B649CB74-832F-467B-B6A4-8BA67AD5C1F0.html +.. _`VMware documentation on General ESXi Security Recommendations`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.security.doc/GUID-B39474AF-6778-499A-B8AB-E973BE6D4899.html .. _VMware Workstation Player: https://www.vmware.com/products/workstation-player.html .. _image: https://download.clearlinux.org/image From fcc3d3095cc2b26583245189d8950016b3c9a690 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Mon, 25 Jun 2018 14:08:51 -0700 Subject: [PATCH 14/76] Fix broken link reference --- .../vmware-esxi-preconfigured-cl-image.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst index 5e8fcbf0..82c4edf4 100644 --- a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst +++ b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst @@ -266,7 +266,7 @@ Also see: .. _VMware ESXi: https://www.vmware.com/products/esxi-and-esx.html .. _`VMware documentation on Using the Datastore File Browser`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-7533A767-8396-4844-A3F2-206047D254EA.html -.. _`vSphere Management Assistant appliance`: https://www.vmware.com/support/developer/vima/ +.. _`vSphere Management Assistant`: https://www.vmware.com/support/developer/vima/ .. _`VMware documentation on Cloning and converting virtual machine disks with vmkfstools`: https://kb.vmware.com/kb/1028042 .. _`VMware documentation on Enable the Secure Shell (SSH)`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-B649CB74-832F-467B-B6A4-8BA67AD5C1F0.html .. _`VMware documentation on General ESXi Security Recommendations`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.security.doc/GUID-B39474AF-6778-499A-B8AB-E973BE6D4899.html From 79511445b03513c42ed218dd3314831c62d1374f Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Mon, 25 Jun 2018 20:00:14 -0700 Subject: [PATCH 15/76] Fix minor syntax error blocking substitution No space after period was causing |CL| substitution not to expand --- source/clear-linux/tutorials/docker/docker.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/clear-linux/tutorials/docker/docker.rst b/source/clear-linux/tutorials/docker/docker.rst index 75c00e35..4b1200ed 100644 --- a/source/clear-linux/tutorials/docker/docker.rst +++ b/source/clear-linux/tutorials/docker/docker.rst @@ -4,7 +4,7 @@ Run Docker\* on Clear Linux\* ############################# |CLOSIA| supports multiple containerization platforms, including a Docker\* -solution.|CL| has many `unique features`_ including a minimal default +solution. |CL| has many `unique features`_ including a minimal default installation which makes it compelling to use as a host for container workloads, management, and orchestration. From 5d3058169266c8ed018a15b3f8c3ce6381a87b36 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Tue, 26 Jun 2018 11:47:00 -0700 Subject: [PATCH 16/76] Add vCLI option to connect vMA is being deprecated --- .../vmware-esxi-preconfigured-cl-image.rst | 20 ++++++++++++------- 1 file changed, 13 insertions(+), 7 deletions(-) diff --git a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst index 82c4edf4..5f60534e 100644 --- a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst +++ b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst @@ -48,15 +48,17 @@ For alternative instructions on other operating systems, see: Upload the Clear Linux image to the VMware server ************************************************* -Once the |CL| VMware prebuilt image has been downloaded and uncompressed on your local system, -it must be uploaded to a datastore on the VMware ESXi server. +Once the |CL| VMware prebuilt image has been downloaded and +uncompressed on your local system, it must be uploaded to a datastore +on the VMware ESXi server. The steps in this section can also be referenced from the `VMware documentation on Using the Datastore File Browser`_ #. Connect to the VMware ESXi server and login to an account with sufficient permission to create and manage VMs. -#. Under the :guilabel:`Navigator` window on the left side, select :guilabel:`Storage`. +#. Under the :guilabel:`Navigator` window on the left side, + select :guilabel:`Storage`. See Figure 1 #. Under the :guilabel:`Datastores` tab, click @@ -97,16 +99,18 @@ it must be converted to a format for usable with VMware's ESXi hypervisor. The steps in this section can also be referenced from the `VMware documentation on Cloning and converting virtual machine disks with vmkfstools`_ -#. SSH into the `vSphere Management Assistant`_ appliance that is managing the ESXi host. +#. SSH into the `vSphere Management Assistant`_ appliance that is managing the ESXi host or connect to the vSphere hosting using the `vSphere CLI`_. .. note:: - If there is no :abbr:`vMA (vSphere Management Assistant)` appliance configured and available, you can temporarily enable SSH directly on the ESXi host by referencing + If there is no :abbr:`vMA (vSphere Management Assistant)` appliance or :abbr:`vCLI (vSphere CLI)` configured and available, + you can temporarily enable SSH directly on the ESXi host by referencing the `VMware documentation on Enable the Secure Shell (SSH)`_ . As a security best practice, remember to disable SSH access after following the steps in this section. -#. Locate the uploaded image, which is typically found in :file:`/vmfs/volumes/datastore1`. +#. Locate the uploaded image, which is typically found in + :file:`/vmfs/volumes/datastore1`. #. Use the :command:`vmkfstools` command to perform the conversion, as shown below: @@ -132,7 +136,8 @@ In this section, you will create a new VM, configure its basic parameters such as number of CPUs, memory size, and then attach the converted |CL| VMware image. Also, in order to boot |CL|, you must enable UEFI support. -#. Under the :guilabel:`Navigator` window, select :guilabel:`Virtual Machines`. See Figure 4. +#. Under the :guilabel:`Navigator` window, select + :guilabel:`Virtual Machines`. See Figure 4. #. In the right window, click the :guilabel:`Create / Register VM` button. @@ -267,6 +272,7 @@ Also see: .. _VMware ESXi: https://www.vmware.com/products/esxi-and-esx.html .. _`VMware documentation on Using the Datastore File Browser`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-7533A767-8396-4844-A3F2-206047D254EA.html .. _`vSphere Management Assistant`: https://www.vmware.com/support/developer/vima/ +.. _`vSphere CLI`: https://www.vmware.com/support/developer/vcli/ .. _`VMware documentation on Cloning and converting virtual machine disks with vmkfstools`: https://kb.vmware.com/kb/1028042 .. _`VMware documentation on Enable the Secure Shell (SSH)`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-B649CB74-832F-467B-B6A4-8BA67AD5C1F0.html .. _`VMware documentation on General ESXi Security Recommendations`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.security.doc/GUID-B39474AF-6778-499A-B8AB-E973BE6D4899.html From b16660a9f051b0557bcaf1e2c8cc261a64403a14 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Tue, 26 Jun 2018 12:21:29 -0700 Subject: [PATCH 17/76] added a reference to validate-signatures.rst to download-verify-uncompress-linux.rst for uniformity (issue 163). made a couple wording changes to validate-signatures.rst and added a label to help with navigation --- .../maintenance/download-verify-uncompress-linux.rst | 3 +++ .../guides/maintenance/validate-signatures.rst | 8 +++++--- 2 files changed, 8 insertions(+), 3 deletions(-) diff --git a/source/clear-linux/guides/maintenance/download-verify-uncompress-linux.rst b/source/clear-linux/guides/maintenance/download-verify-uncompress-linux.rst index f497148c..95cb27bd 100644 --- a/source/clear-linux/guides/maintenance/download-verify-uncompress-linux.rst +++ b/source/clear-linux/guides/maintenance/download-verify-uncompress-linux.rst @@ -42,6 +42,9 @@ checksum, a warning is displayed with a message indicating the computed checksum does **not** match. Otherwise, the name of the image is printed on the screen followed by `OK`. +For a more in-depth discussion of image verification including checking the +certificate see :ref:`image-content-validation`. + Uncompress the Clear Linux image ******************************** diff --git a/source/clear-linux/guides/maintenance/validate-signatures.rst b/source/clear-linux/guides/maintenance/validate-signatures.rst index 190e4f59..94a7763e 100644 --- a/source/clear-linux/guides/maintenance/validate-signatures.rst +++ b/source/clear-linux/guides/maintenance/validate-signatures.rst @@ -1,7 +1,7 @@ .. _validate-signatures: -Validate signatures -################### +Validating signatures +##################### |CLOSIA| offers a way to validate the content of an image or an update. All validation of content works by creating and signing a hash. A valid signature @@ -9,9 +9,11 @@ creates a chain of trust. A broken chain of trust, seen as an invalid signature, means the content is not valid. This guide covers how to validate the contents of an image, which is a manual -process, and describes the automatic process ``swupd`` performs internally to +process and is the same process ``swupd`` performs internally to validate an update. +.. _image-content-validation: + Image content validation ======================== From a19a19e48d5916ff307d794ab9ec411c8c018905 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Tue, 26 Jun 2018 15:43:23 -0700 Subject: [PATCH 18/76] Fix lsblk output --- .../guides/maintenance/increase-virtual-disk-size.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst b/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst index 76765100..a700a7d9 100644 --- a/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst +++ b/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst @@ -17,7 +17,7 @@ There are two methods to find the order and sizes of partitions virtual disk of image. In both examples, the prebuilt Hyper-V image -has a disk size of 8.5 GB with /dev/sdd3 being the partition +has a disk size of 8.5 GB with /dev/sda3 being the partition for the root filesystem (/) @@ -37,9 +37,9 @@ An example output of the :command:`lsblk` command: NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT sda 8:0 0 8.5G 0 disk - ├─sdd1 8:1 0 512M 0 part - ├─sdd2 8:2 0 32M 0 part [SWAP] - └─sdd3 8:3 0 8G 0 part / + ├─sda1 8:1 0 512M 0 part + ├─sda2 8:2 0 32M 0 part [SWAP] + └─sda3 8:3 0 8G 0 part / An example of this can also be seen in Figure 1. From 5b6c781c69e88640f63aefb3bc50ad87ca2d32b0 Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Tue, 26 Jun 2018 16:26:00 -0700 Subject: [PATCH 19/76] Fixes syntax on figures and code blocks for proper rendering. Signed-off-by: Michael Vincerra --- .../increase-virtual-disk-size.rst | 173 +++++++++--------- 1 file changed, 83 insertions(+), 90 deletions(-) diff --git a/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst b/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst index a700a7d9..0436d965 100644 --- a/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst +++ b/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst @@ -1,6 +1,6 @@ .. _increase-virtual-disk-size: -Increase virtual disk size of a Clear Linux image +Increase virtual disk size of a Clear Linux\* image ################################################# |CLOSIA| prebuilt images come in different sizes, ranging from 300 MB to 20 @@ -9,17 +9,14 @@ if you need more capacity. .. contents:: This guide will cover: - Determine the partition order and sizes of the prebuilt image *************************************************** -There are two methods to find the order and sizes of partitions virtual disk of your prebuilt |CL| -image. - -In both examples, the prebuilt Hyper-V image -has a disk size of 8.5 GB with /dev/sda3 being the partition -for the root filesystem (/) +There are two methods to find the order and sizes of partitions virtual disk +of your prebuilt |CL| image. +In both examples, the prebuilt Hyper-V image has a disk size of 8.5 GB with / +dev/sda3 being the partition for the root filesystem (/) Checking :command:`lsblk` on the VM ----------------------------------- @@ -27,66 +24,64 @@ Checking :command:`lsblk` on the VM The first method is to boot up your :abbr:`VM (Virtual Machine)` and execute the :command:`lsblk` command as shown below: - .. code-block:: bash +.. code-block:: bash - sudo lsblk + sudo lsblk An example output of the :command:`lsblk` command: - .. code-block:: console +.. code-block:: console - NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT - sda 8:0 0 8.5G 0 disk - ├─sda1 8:1 0 512M 0 part - ├─sda2 8:2 0 32M 0 part [SWAP] - └─sda3 8:3 0 8G 0 part / + NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT + sda 8:0 0 8.5G 0 disk + ├─sda1 8:1 0 512M 0 part + ├─sda2 8:2 0 32M 0 part [SWAP] + └─sda3 8:3 0 8G 0 part / An example of this can also be seen in Figure 1. - Checking :file:`config.json` used to build the image ---------------------------------------------------- The second method to determine partition to check the :file:`config.json` -file used to create prebuilt image, located in the -`releases`_ repository. For example, to find the size of the Hyper-V\* image -version number 20450, follow these steps: +file used to create prebuilt image, located in the `releases`_ repository. +For example, to find the size of the Hyper-V\* image version number 20450, +follow these steps: -#. Go to the `releases`_ repository. -#. Drill down into the `20450 > clear > config > image` directory. -#. Open the :file:`hyperv-config.json` file. -#. Locate the `PartitionLayout` key. +#. Go to the `releases`_ repository. +#. Drill down into the `20450 > clear > config > image` directory. +#. Open the :file:`hyperv-config.json` file. +#. Locate the `PartitionLayout` key. - The example shows 512 MB for the EFI partition, 32 MB for the swap - partition, and 8 GB for the root partition. + The example shows 512 MB for the EFI partition, 32 MB for the swap + partition, and 8 GB for the root partition. - .. code-block:: console - - "PartitionLayout" : [ { "disk" : "hyperv.img", - "partition" : 1, - "size" : "512M", - "type" : "EFI" }, - { "disk" : "hyperv.img", - "partition" : 2, - "size" : "32M", - "type" : "swap" }, - { "disk" : "hyperv.img", - "partition" : 3, - "size" : "8G", - "type" : "linux" } ], - + .. code-block:: console + "PartitionLayout" : [ { "disk" : "hyperv.img", + "partition" : 1, + "size" : "512M", + "type" : "EFI" }, + { "disk" : "hyperv.img", + "partition" : 2, + "size" : "32M", + "type" : "swap" }, + { "disk" : "hyperv.img", + "partition" : 3, + "size" : "8G", + "type" : "linux" } ], Increase virtual disk size ************************** -Once you have determined the disk and partition to be increased, you are ready to perform the actual increase of the disk, partition, and filesystem. - +Once you have determined the disk and partition to be increased, you are +ready to perform the actual increase of the disk, partition, and filesystem. Power off VM and increase virtual disk size: -------------------------------------------- -To increase the virtual disk size for a prebuilt image, perform the steps below: +To increase the virtual disk size for a prebuilt image, perform the steps +below: #. Shut down your VM if it is running. #. Use the process defined by your hypervisor @@ -100,77 +95,75 @@ Resize the partition of the virtual disk: #. Log in to an account with root privileges. #. Open a terminal emulator. -#. Add the |CL| `storage-utils` bundle to install the :command:`parted` and :command:`resize2fs` tools. +#. Add the |CL| `storage-utils` bundle to install the + :command:`parted` and :command:`resize2fs` tools. - .. code-block:: bash + .. code-block:: bash - sudo swupd bundle-add storage-utils + sudo swupd bundle-add storage-utils -#. Launch the `parted` tool. +#. Launch the `parted` tool. - .. code-block:: bash + .. code-block:: bash - sudo parted + sudo parted -#. In the `parted` tool, perform these steps: +#. In the `parted` tool, perform these steps: - #. Press :command:`p` to print the partitions table. - #. If the warning message below is displayed, enter :command:`Fix`. + #. Press :command:`p` to print the partitions table. + #. If the warning message below is displayed, enter :command:`Fix`. - .. code-block:: console + .. code-block:: console - Warning: Not all of the space available to /dev/sda appears to be - used, you can fix the GPT to use all of the space (an extra ... - blocks) or continue with the current setting? + Warning: Not all of the space available to /dev/sda appears to be + used, you can fix the GPT to use all of the space (an extra ... + blocks) or continue with the current setting? - Fix/Ignore? + Fix/Ignore? - #. Enter :command:`resizepart [partition number]` where - *[partition number]* is the partition number of the partition to modify. - #. Enter :command:`yes` when prompted. - #. Enter the new `End` size. + #. Enter :command:`resizepart [partition number]` where + *[partition number]* is the partition number of the partition to modify. + #. Enter :command:`yes` when prompted. + #. Enter the new `End` size. - .. note:: + .. note:: - If you want a partition to take up the remaining disk space, then - enter the total size of the disk. When you print the partitions - table with the :command:`p` command, the total disk size is shown - after the `Disk` label. + If you want a partition to take up the remaining disk space, then + enter the total size of the disk. When you print the partitions + table with the :command:`p` command, the total disk size is shown + after the `Disk` label. - An example of this can be seen in Figure 1. + An example of this can be seen in Figure 1. + #. Enter :command:`q` to exit `parted` when you are finished resizing the + image. + Figure 1 depicts the described steps to resize the partition of the virtual disk from 8.5GB to 20GB. - #. Enter :command:`q` to exit `parted` when you are finished resizing the - image. - - - Figure 1 depicts the described steps to resize the partition of the virtual disk from 8.5GB to 20GB. - - .. figure:: figures/increase-virtual-disk-size-1.png - :scale: 100 % - :alt: Increase root partition size - - Figure 1: Increase root partition size. + .. figure:: figures/increase-virtual-disk-size-1.png + :scale: 100 % + :alt: Increase root partition size + Figure 1: Increase root partition size. Resize the filesytem -------------------- - #. Enter :command:`sudo resize2fs -p /dev/[modified partition name]` where - *[modified partition name]* is the partition that was changed in `parted`. +#. Enter :command:`sudo resize2fs -p /dev/[modified partition name]` where + *[modified partition name]* is the partition that was changed in `parted`. - #. Run the :command:`df -h` to verify that the filesystem size has increased. +#. Run the :command:`df -h` to verify that the filesystem size has + increased. - Figure 2 depicts the described steps to resize the partition of the virtual disk from 8.5GB to 20GB. + Figure 2 depicts the described steps to resize the partition of the virtual disk from 8.5GB to 20GB. - .. figure:: figures/increase-virtual-disk-size-2.png - :scale: 100 % - :alt: Increase root filesystem with resize2fs + .. figure:: figures/increase-virtual-disk-size-2.png + :scale: 100 % + :alt: Increase root filesystem with resize2fs - Figure 2: Increase root filesystem size after partition has been expanded. + Figure 2: Increase root filesystem size after partition has been expanded. - .. _releases: https://download.clearlinux.org/releases/ +Congratulations! You have resized the disk, partition, and filesystem. At +this point, the increase in disk capacity is usable. - -Congratulations! You have resized the disk, partition, and filesystem. At this point, the increase in disk capacity is usable. \ No newline at end of file +.. _releases: https://download.clearlinux.org/releases/ \ No newline at end of file From d1542099f307753a8a2b1223cc79460c94ff0efb Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Tue, 26 Jun 2018 17:25:33 -0700 Subject: [PATCH 20/76] Corrects syntax for: - Figures and labels - Internal TOC - External references to URLs - Relative paths to files Signed-off-by: Michael Vincerra --- .../vmware-esxi-preconfigured-cl-image.rst | 268 +++++++++--------- 1 file changed, 138 insertions(+), 130 deletions(-) diff --git a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst index 5f60534e..23751b7d 100644 --- a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst +++ b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst @@ -1,6 +1,6 @@ .. _vmware-esxi-preconfigured-cl-image: -Run preconfigured Clear Linux image as a VMware\* ESXi guest OS +Run preconfigured Clear Linux\* image as a VMware\* ESXi guest OS ############################################################### `VMware ESXi`_ is a type 1 bare-metal hypervisor which runs directly on top @@ -10,21 +10,20 @@ and run |CLOSIA| virtual machines at scale. This section shows you how to deploy a preconfigured |CL| VMware image on VMware ESXi 6.5. -If you would prefer to perform a manual installation of |CL| into a new VMware -ESXi :abbr:`VM (Virtual Machine)` instead, see :ref:`vmware-esxi-install-cl`. -Visit :ref:`image-types` to learn more about the available images. - +If you would prefer to perform a manual installation of |CL| into a new +VMware ESXi :abbr:`VM (Virtual Machine)` instead, see +:ref:`vmware-esxi-install-cl`. Visit :ref:`image-types` to learn more about +the available images. .. note:: - VMware also offers a type 2 hypervisor called `VMware Workstation Player`_ which is designed for the desktop environment. + VMware also offers a type 2 hypervisor called `VMware Workstation Player` + which is designed for the desktop environment. See :ref:`vmw-player-preconf` or see :ref:`vmw-player`. - -.. contents:: +.. contents:: :local: :depth: 2 - Download the latest Clear Linux VMware image ******************************************** @@ -54,80 +53,81 @@ on the VMware ESXi server. The steps in this section can also be referenced from the `VMware documentation on Using the Datastore File Browser`_ -#. Connect to the VMware ESXi server and login to an account with sufficient - permission to create and manage VMs. +#. Connect to the VMware ESXi server and login to an account with sufficient + permission to create and manage VMs. -#. Under the :guilabel:`Navigator` window on the left side, - select :guilabel:`Storage`. - See Figure 1 +#. Under the :guilabel:`Navigator` window on the left side, + select :guilabel:`Storage`. + See Figure 1 -#. Under the :guilabel:`Datastores` tab, click - the :guilabel:`Datastore browser` button. +#. Under the :guilabel:`Datastores` tab, click + the :guilabel:`Datastore browser` button. - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-1.png + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-1.png :scale: 100 % :alt: VMware ESXi - Navigator > Storage Figure 1: VMware ESXi - Navigator > Storage -#. Click the :guilabel:`Create directory` button and name the directory - `Clear Linux VM`. See Figure 2. +#. Click the :guilabel:`Create directory` button and name the directory + `Clear Linux VM`. See Figure 2. - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-2.png + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-2.png :scale: 100 % :alt: VMware ESXi - Datastore > Create directory Figure 2: VMware ESXi - Datastore > Create directory -#. Select the newly-created directory and click the :guilabel:`Upload` - button. See Figure 3. +#. Select the newly-created directory and click the :guilabel:`Upload` + button. See Figure 3. - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-3.png + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-3.png :scale: 100 % :alt: VMware ESXi - Datastore > Upload VMware image Figure 3: VMware ESXi - Datastore > Upload VMware image -#. Select the uncompressed |CL| VMware image file - :file:`clear-[version number]-vmware.vmdk` and upload it. +#. Select the uncompressed |CL| VMware image file + :file:`clear-[version number]-vmware.vmdk` and upload it. Convert the Clear Linux image to an ESXi-supported format ********************************************************* -Once the |CL| VMware prebuilt image has been uploaded to the VMware ESXi datastore, -it must be converted to a format for usable with VMware's ESXi hypervisor. +Once the |CL| VMware prebuilt image has been uploaded to the VMware ESXi +datastore, it must be converted to a format for usable with VMware's ESXi +hypervisor. The steps in this section can also be referenced from the `VMware documentation on Cloning and converting virtual machine disks with vmkfstools`_ -#. SSH into the `vSphere Management Assistant`_ appliance that is managing the ESXi host or connect to the vSphere hosting using the `vSphere CLI`_. +#. SSH into the `vSphere Management Assistant`_ appliance that is managing + the ESXi host or connect to the vSphere hosting using the `vSphere CLI`_. - .. note:: - If there is no :abbr:`vMA (vSphere Management Assistant)` appliance or :abbr:`vCLI (vSphere CLI)` configured and available, - you can temporarily enable SSH directly on the ESXi host by referencing - the `VMware documentation on Enable the Secure Shell (SSH)`_ . + .. note:: + + If there is no :abbr:`vMA (vSphere Management Assistant)` appliance or :abbr:`vCLI (vSphere CLI)` configured and available, + you can temporarily enable SSH directly on the ESXi host by referencing + the `VMware documentation on Enable the Secure Shell (SSH)`_ . - As a security best practice, remember to disable SSH access after following the steps in this section. + As a security best practice, remember to disable SSH access after following the steps in this section. -#. Locate the uploaded image, which is typically found in - :file:`/vmfs/volumes/datastore1`. +#. Locate the uploaded image, which is typically found in + :file:`/vmfs/volumes/datastore1`. -#. Use the :command:`vmkfstools` command to perform the conversion, as - shown below: +#. Use the :command:`vmkfstools` command to perform the conversion, as + shown below: - .. code-block:: console + .. code-block:: console - vmkfstools -i clear-[version number]-vmware.vmdk -d zeroedthick clear-[version number]-esxi.vmdk + vmkfstools -i clear-[version number]-vmware.vmdk -d zeroedthick clear-[version number]-esxi.vmdk - Two files should result from this: - - * :file:`clear-[version number]-esxi-flat.vmdk` - * :file:`clear-[version number]-esxi.vmdk` - - The :file:`clear-[version number]-esxi.vmdk` file will be used in the - next section when you create a new VM. + Two files should result from this: + * :file:`clear-[version number]-esxi-flat.vmdk` + * :file:`clear-[version number]-esxi.vmdk` + The :file:`clear-[version number]-esxi.vmdk` file will be used in the + next section when you create a new VM. Create and configure a new VM ***************************** @@ -136,145 +136,153 @@ In this section, you will create a new VM, configure its basic parameters such as number of CPUs, memory size, and then attach the converted |CL| VMware image. Also, in order to boot |CL|, you must enable UEFI support. -#. Under the :guilabel:`Navigator` window, select - :guilabel:`Virtual Machines`. See Figure 4. +#. Under the :guilabel:`Navigator` window, select + :guilabel:`Virtual Machines`. See Figure 4. -#. In the right window, click the :guilabel:`Create / Register VM` button. +#. In the right window, click the :guilabel:`Create / Register VM` button. - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-4.png + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-4.png :scale: 100 % :alt: VMware ESXi - Navigator > Virtual Machines Figure 4: VMware ESXi - Navigator > Virtual Machines -#. On the :guilabel:`Select creation type` step: +#. On the :guilabel:`Select creation type` step: - #. Select the :guilabel:`Create a new virtual machine` option. See - Figure 5. + #. Select the :guilabel:`Create a new virtual machine` option. See + Figure 5. - #. Click the :guilabel:`Next` button. + #. Click the :guilabel:`Next` button. - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-5.png - :scale: 100 % - :alt: VMware ESXi - Create a new virtual machine + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-5.png + :scale: 100 % + :alt: VMware ESXi - Create a new virtual machine - Figure 5: VMware ESXi - Create a new virtual machine + Figure 5: VMware ESXi - Create a new virtual machine -#. On the :guilabel:`Select a name and guest OS` step: +#. On the :guilabel:`Select a name and guest OS` step: - #. Give the new VM a name in the :guilabel:`Name` field. See Figure 6. - #. Set the :guilabel:`Compatability` option to :guilabel:`ESXi 6.5 virtual machine`. - #. Set the :guilabel:`Guest OS family` option to :guilabel:`Linux`. - #. Set the :guilabel:`Guest OS version` option to :guilabel:`Other 3.x or later Linux (64-bit)`. - #. Click the :guilabel:`Next` button. +#. Give the new VM a name in the :guilabel:`Name` field. See Figure 6. - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-6.png - :scale: 100 % - :alt: VMware ESXi - Give a name and select guest OS type +#. Set the :guilabel:`Compatability` option to + :guilabel:`ESXi 6.5 virtual machine`. +#. Set the :guilabel:`Guest OS family` option to :guilabel:`Linux`. +#. Set the :guilabel:`Guest OS version` option to + :guilabel:`Other 3.x or later Linux (64-bit)`. +#. Click the :guilabel:`Next` button. - Figure 6: VMware ESXi - Give a name and select guest OS type + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-6.png + :scale: 100 % + :alt: VMware ESXi - Give a name and select guest OS type -#. On the :guilabel:`Select storage` step: + Figure 6: VMware ESXi - Give a name and select guest OS type - #. Accept the default option. - #. Click the :guilabel:`Next` button. +#. On the :guilabel:`Select storage` step: -#. On the :guilabel:`Customize settings` step: + #. Accept the default option. + #. Click the :guilabel:`Next` button. - #. Click the :guilabel:`Virtual Hardware` button. See Figure 7. - #. Expand the :guilabel:`CPU` setting and enable :guilabel:`Hardware virtualization` by - checking :guilabel:`Expose hardware assisted virtualization to the guest OS`. +#. On the :guilabel:`Customize settings` step: - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-7.png - :scale: 100 % - :alt: VMware ESXi - Enable hardware virtualization + #. Click the :guilabel:`Virtual Hardware` button. See Figure 7. + #. Expand the :guilabel:`CPU` setting and enable + :guilabel:`Hardware virtualization` by checking + :guilabel:`Expose hardware assisted virtualization to the guest OS`. - Figure 7: VMware ESXi - Enable hardware virtualization + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-7.png + :scale: 100 % + :alt: VMware ESXi - Enable hardware virtualization - #. Remove the default :guilabel:`Hard drive 1` setting by clicking - the `X` icon on the right side. See Figure 8. + Figure 7: VMware ESXi - Enable hardware virtualization - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-8.png - :scale: 100 % - :alt: VMware ESXi - Remove hard drive + #. Remove the default :guilabel:`Hard drive 1` setting by clicking + the `X` icon on the right side. See Figure 8. - Figure 8: VMware ESXi - Remove hard drive + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-8.png + :scale: 100 % + :alt: VMware ESXi - Remove hard drive - #. Since a preconfigured image will be used, - the :guilabel:`CD/DVD Drive 1` setting will not be needed. Disable it by unchecking the :guilabel:`Connect` checkbox. See Figure 9. + Figure 8: VMware ESXi - Remove hard drive - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-9.png - :scale: 100 % - :alt: VMware ESXi - Disconnect the CD/DVD drive + #. Since a preconfigured image will be used, + the :guilabel:`CD/DVD Drive 1` setting will not be needed. Disable it + by unchecking the :guilabel:`Connect` checkbox. See Figure 9. - Figure 9: VMware ESXi - Disconnect the CD/DVD drive + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-9.png + :scale: 100 % + :alt: VMware ESXi - Disconnect the CD/DVD drive - #. Attach the :file:`clear-[version number]-esxi.vmdk` file that was - converted from the preconfigured |CL| VMware image. + Figure 9: VMware ESXi - Disconnect the CD/DVD drive - #. Click the :guilabel:`Add hard disk` button and select the - :guilabel:`Existing hard drive` option. See Figure 10. + #. Attach the :file:`clear-[version number]-esxi.vmdk` file that was + converted from the preconfigured |CL| VMware image. - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-10.png - :scale: 100 % - :alt: VMware ESXi - Add an existing hard drive + #. Click the :guilabel:`Add hard disk` button and select the + :guilabel:`Existing hard drive` option. See Figure 10. - Figure 10: VMware ESXi - Add an existing hard drive + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-10.png + :scale: 100 % + :alt: VMware ESXi - Add an existing hard drive - #. Select the converted :file:`clear-[version number]-esxi.vmdk` - file. Do not use the original unconverted :file:`clear-[version number]-vmware.vmdk` file. See Figure 11. + Figure 10: VMware ESXi - Add an existing hard drive - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-11.png - :scale: 100 % - :alt: VMware ESXi - Select the converted `vmdk` file + #. Select the converted :file:`clear-[version number]-esxi.vmdk` + file. Do not use the original unconverted + :file:`clear-[version number]-vmware.vmdk` file. See Figure 11. - Figure 11: VMware ESXi - Select the converted :file:`clear-[version number]-esxi.vmdk` file + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-11.png + :scale: 100 % + :alt: VMware ESXi - Select the converted `vmdk` file -#. |CL| needs UEFI support in order to boot. Enable UEFI boot support. + Figure 11: VMware ESXi - Select the converted + :file:`clear-[version number]-esxi.vmdk` file - #. Click the :guilabel:`VM Options` button. See Figure 12. - #. Expand the :guilabel:`Boot Options` setting. - #. For the :guilabel:`Firmware` setting, click the drop-down list to - the right of it and select the :guilabel:`EFI` option. +#. |CL| needs UEFI support in order to boot. Enable UEFI boot support. - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-12.png - :scale: 100 % - :alt: VMware ESXi - Set boot firmware to EFI + #. Click the :guilabel:`VM Options` button. See Figure 12. + #. Expand the :guilabel:`Boot Options` setting. + #. For the :guilabel:`Firmware` setting, click the drop-down list to + the right of it and select the :guilabel:`EFI` option. - Figure 12: VMware ESXi - Set boot firmware to EFI + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-12.png + :scale: 100 % + :alt: VMware ESXi - Set boot firmware to EFI -#. Click the :guilabel:`Save` button. -#. Click the :guilabel:`Next` button. -#. Click the :guilabel:`Finish` button. + Figure 12: VMware ESXi - Set boot firmware to EFI + +#. Click the :guilabel:`Save` button. +#. Click the :guilabel:`Next` button. +#. Click the :guilabel:`Finish` button. Power on the VM and boot Clear Linux ************************************ After configuring the settings above, power on the VM. -#. Under the :guilabel:`Navigator` window, select :guilabel:`Virtual Machines`. See Figure 13. -#. In the right window, select the newly-created VM. -#. Click the :guilabel:`Power on` button. -#. Click on the icon representing the VM to bring it into view and maximize - its window. +#. Under the :guilabel:`Navigator` window, select + :guilabel:`Virtual Machines`. See Figure 13. +#. In the right window, select the newly-created VM. +#. Click the :guilabel:`Power on` button. +#. Click on the icon representing the VM to bring it into view and maximize + its window. - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-13.png + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-13.png :scale: 100 % :alt: VMware ESXi - Navigator > Virtual Machines > Power on VM Figure 13: VMware ESXi - Navigator > Virtual Machines > Power on VM Also see: ---------- +========= * :ref:`vmware-esxi-install-cl` .. _VMware ESXi: https://www.vmware.com/products/esxi-and-esx.html -.. _`VMware documentation on Using the Datastore File Browser`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-7533A767-8396-4844-A3F2-206047D254EA.html -.. _`vSphere Management Assistant`: https://www.vmware.com/support/developer/vima/ -.. _`vSphere CLI`: https://www.vmware.com/support/developer/vcli/ -.. _`VMware documentation on Cloning and converting virtual machine disks with vmkfstools`: https://kb.vmware.com/kb/1028042 -.. _`VMware documentation on Enable the Secure Shell (SSH)`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-B649CB74-832F-467B-B6A4-8BA67AD5C1F0.html -.. _`VMware documentation on General ESXi Security Recommendations`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.security.doc/GUID-B39474AF-6778-499A-B8AB-E973BE6D4899.html +.. _VMware documentation on Using the Datastore File Browser: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-7533A767-8396-4844-A3F2-206047D254EA.html +.. _vSphere Management Assistant: https://www.vmware.com/support/developer/vima/ +.. _vSphere CLI: https://www.vmware.com/support/developer/vcli/ +.. _VMware documentation on Cloning and converting virtual machine disks with vmkfstools: https://kb.vmware.com/kb/1028042 +.. _VMware documentation on Enable the Secure Shell (SSH): https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-B649CB74-832F-467B-B6A4-8BA67AD5C1F0.html +.. _VMware documentation on General ESXi Security Recommendations: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.security.doc/GUID-B39474AF-6778-499A-B8AB-E973BE6D4899.html .. _VMware Workstation Player: https://www.vmware.com/products/workstation-player.html .. _image: https://download.clearlinux.org/image From 23364b05a3d31a240a144467aa9ffa34eaf4a0df Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Wed, 27 Jun 2018 13:40:57 -0700 Subject: [PATCH 21/76] Removes external hyperlink from Intel Clear Containers: - Reason: Previous page to which it was linked was removed. Signed-off-by: Michael Vincerra --- source/clear-linux/reference/compatible-kernels.rst | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/source/clear-linux/reference/compatible-kernels.rst b/source/clear-linux/reference/compatible-kernels.rst index 0524c57d..ab1303fb 100644 --- a/source/clear-linux/reference/compatible-kernels.rst +++ b/source/clear-linux/reference/compatible-kernels.rst @@ -19,7 +19,7 @@ Kernel Container ================ The *kernel-container* bundle contains the kernel used by the -`Intel® Clear Containers`_ project. This kernel is optimized for +Intel® Clear Containers project. This kernel is optimized for fast booting and performs best on |CC| running on the Intel® architectures described on the :ref:`supported hardware list`. The optimization patches are found in our `Linux-Container`_ GitHub repo. @@ -88,5 +88,4 @@ more information. The optimization patches are found in our .. _CIAO: https://github.com/01org/ciao .. _Azure: https://azuremarketplace.microsoft.com/en-us/marketplace/apps/clear-linux-project.clear-linux-os -.. _Intel® Clear Containers: - https://clearlinux.org/features/intel®-clear-containers + From aa9baaad2a109eab84c9e5265dc3ed0f63c82036 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Wed, 27 Jun 2018 15:17:16 -0700 Subject: [PATCH 22/76] fixed title to align with project standards --- source/clear-linux/guides/maintenance/validate-signatures.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/clear-linux/guides/maintenance/validate-signatures.rst b/source/clear-linux/guides/maintenance/validate-signatures.rst index 94a7763e..73b131e0 100644 --- a/source/clear-linux/guides/maintenance/validate-signatures.rst +++ b/source/clear-linux/guides/maintenance/validate-signatures.rst @@ -1,6 +1,6 @@ .. _validate-signatures: -Validating signatures +Validate signatures ##################### |CLOSIA| offers a way to validate the content of an image or an update. All From 48fda098504b35c60df56c35c00fbb8348980bcc Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Wed, 27 Jun 2018 15:26:23 -0700 Subject: [PATCH 23/76] trimmed header underline to match header --- source/clear-linux/guides/maintenance/validate-signatures.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/clear-linux/guides/maintenance/validate-signatures.rst b/source/clear-linux/guides/maintenance/validate-signatures.rst index 73b131e0..1001369a 100644 --- a/source/clear-linux/guides/maintenance/validate-signatures.rst +++ b/source/clear-linux/guides/maintenance/validate-signatures.rst @@ -1,7 +1,7 @@ .. _validate-signatures: Validate signatures -##################### +################### |CLOSIA| offers a way to validate the content of an image or an update. All validation of content works by creating and signing a hash. A valid signature From 1e9b5ce1070a98bc4d48b59cd4d280457acff691 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Thu, 28 Jun 2018 10:51:48 -0700 Subject: [PATCH 24/76] Remove hyperv-mini image hyperv-mini image is being deprecated --- source/clear-linux/guides/maintenance/image-types.rst | 2 -- 1 file changed, 2 deletions(-) diff --git a/source/clear-linux/guides/maintenance/image-types.rst b/source/clear-linux/guides/maintenance/image-types.rst index e3a119f5..c0d6c1e6 100644 --- a/source/clear-linux/guides/maintenance/image-types.rst +++ b/source/clear-linux/guides/maintenance/image-types.rst @@ -42,8 +42,6 @@ Table 1 lists the currently available images. - Optimized image used by Clear Containers runtime * - hyperv.vhdx - Image for Microsoft Hyper-V\* - * - hyperv-mini.vhdx - - Minimal image with fewer bundles for Microsoft Hyper-V * - installer.img - Interactive installer image * - installer.iso From 85e87d3b16af7b9c03907a76bad168fd3fd61c16 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Thu, 28 Jun 2018 11:24:29 -0700 Subject: [PATCH 25/76] Add preference to use IMG over ISO --- source/clear-linux/guides/maintenance/image-types.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/clear-linux/guides/maintenance/image-types.rst b/source/clear-linux/guides/maintenance/image-types.rst index c0d6c1e6..85b1d96a 100644 --- a/source/clear-linux/guides/maintenance/image-types.rst +++ b/source/clear-linux/guides/maintenance/image-types.rst @@ -42,10 +42,10 @@ Table 1 lists the currently available images. - Optimized image used by Clear Containers runtime * - hyperv.vhdx - Image for Microsoft Hyper-V\* - * - installer.img - - Interactive installer image + * - installer.img + - Preferred interactive installer image * - installer.iso - - ISO of the interactive installer image + - ISO of the interactive installer image. Only on special cases where ISO image format is required (not for use with a USB key) * - kvm.img - Image for booting in a simple VM with start_qemu.sh * - live.img From 353f967c3d675fe6f3afafb8680fac6d39cfced0 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Thu, 28 Jun 2018 12:20:33 -0700 Subject: [PATCH 26/76] More descriptive description and file readability Add some consistency to dscriptions, references to images with optimized kernels. --- .../guides/maintenance/image-types.rst | 36 ++++++++++++------- 1 file changed, 24 insertions(+), 12 deletions(-) diff --git a/source/clear-linux/guides/maintenance/image-types.rst b/source/clear-linux/guides/maintenance/image-types.rst index 85b1d96a..5653e763 100644 --- a/source/clear-linux/guides/maintenance/image-types.rst +++ b/source/clear-linux/guides/maintenance/image-types.rst @@ -29,28 +29,40 @@ Table 1 lists the currently available images. * - Image Type - Description + * - azure.vhd - - Image for Microsoft\* Azure\* + - Virtual Hard Disk for use on Microsoft\* Azure\* cloud platform + * - azure-docker.vhd - - Image with Docker\* installed for Microsoft Azure + - Virtual Hard Disk for use on Microsoft\* Azure\* cloud platform with Docker\* pre-installed + * - azure-machine-learning.vhd - - Image with the `machine-learning-basic` bundle installed for Microsoft - Azure + - Virtual Hard Disk for use on Microsoft\* Azure\* cloud platform with the `machine-learning-basic` bundle installed + * - cloud.img - - Image for cloud deployment such as OpenStack\* + - Image for use by cloud deployments such as OpenStack\* + * - containers.img - - Optimized image used by Clear Containers runtime + - Image for use by Clear Containers runtime. Includes `optimized kernel`_ for Clear Containers. + * - hyperv.vhdx - - Image for Microsoft Hyper-V\* + - Virtual Hard Disk for use with Microsoft Hyper-V\* hypervisor. Includes `optimized kernel`_ for Hyper-V. + * - installer.img - - Preferred interactive installer image + - Preferred image of Clear Linux with interactive installer. + * - installer.iso - - ISO of the interactive installer image. Only on special cases where ISO image format is required (not for use with a USB key) + - ISO of Clear Linux with interactive installer. Only for special cases where ISO image format is required (not for use with a USB key) + * - kvm.img - - Image for booting in a simple VM with start_qemu.sh + - Image for booting in a simple VM with start_qemu.sh. Includes `optimized kernel`_ for KVM. + * - live.img - - Live boot image + - image for live booting into memory, without requiring installaton. + * - vmware.vmdk - - Image for VMware\* + - Virtual Machine Disk for VMware\* platforms inclduing Player, Workstation, and ESXi. .. _images: https://download.clearlinux.org/image +.. _`optimized kernel`: https://clearlinux.org/documentation/clear-linux/reference/compatible-kernels + From 27273f7aeabf2272112a34cea8f91548ad05f2ba Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Thu, 28 Jun 2018 12:32:24 -0700 Subject: [PATCH 27/76] Split table into 2 This helps understand the difference between images by catagorizingthem and highlights what users are most likely looking for. --- .../guides/maintenance/image-types.rst | 34 ++++++++++++------- 1 file changed, 22 insertions(+), 12 deletions(-) diff --git a/source/clear-linux/guides/maintenance/image-types.rst b/source/clear-linux/guides/maintenance/image-types.rst index 5653e763..d1cfcdab 100644 --- a/source/clear-linux/guides/maintenance/image-types.rst +++ b/source/clear-linux/guides/maintenance/image-types.rst @@ -21,10 +21,29 @@ file format. The *[compression type]* field specifies the compression type. Two types of compressions are used: GNU\* zip (*.gz*) and XZ (*.xz*). -Table 1 lists the currently available images. +Table 1 lists the currently available images which are platform independant. +Table 2 lists the currently available images which are platform specific. -.. list-table:: Table 1: Types of Clear Linux images - :widths: 20, 60 +.. list-table:: Table 1: Types of platform independant Clear Linux images + :widths: 15, 85 + :header-rows: 1 + + * - Image Type + - Description + + * - installer.img + - Preferred image of Clear Linux with interactive installer. + + * - installer.iso + - ISO of Clear Linux with interactive installer. Only for special cases where ISO image format is required (not for use with a USB key) + + * - live.img + - image for live booting into memory, without requiring installaton. + + + +.. list-table:: Table 2: Types of platform specific Clear Linux images + :widths: 15, 85 :header-rows: 1 * - Image Type @@ -48,18 +67,9 @@ Table 1 lists the currently available images. * - hyperv.vhdx - Virtual Hard Disk for use with Microsoft Hyper-V\* hypervisor. Includes `optimized kernel`_ for Hyper-V. - * - installer.img - - Preferred image of Clear Linux with interactive installer. - - * - installer.iso - - ISO of Clear Linux with interactive installer. Only for special cases where ISO image format is required (not for use with a USB key) - * - kvm.img - Image for booting in a simple VM with start_qemu.sh. Includes `optimized kernel`_ for KVM. - * - live.img - - image for live booting into memory, without requiring installaton. - * - vmware.vmdk - Virtual Machine Disk for VMware\* platforms inclduing Player, Workstation, and ESXi. From 053d57c682798b1b4c01f2769a5cc692b747af51 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Thu, 28 Jun 2018 12:35:44 -0700 Subject: [PATCH 28/76] Move image types document from guide to reference --- .../clear-linux/{guides/maintenance => reference}/image-types.rst | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename source/clear-linux/{guides/maintenance => reference}/image-types.rst (100%) diff --git a/source/clear-linux/guides/maintenance/image-types.rst b/source/clear-linux/reference/image-types.rst similarity index 100% rename from source/clear-linux/guides/maintenance/image-types.rst rename to source/clear-linux/reference/image-types.rst From daa1a459971f45b2b44c13135c55457ab21eb8c9 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Thu, 28 Jun 2018 13:28:43 -0700 Subject: [PATCH 29/76] first commit of swupd-guide.rst --- .../guides/maintenance/swupd_guide.rst | 81 +++++++++++++++++++ 1 file changed, 81 insertions(+) create mode 100644 source/clear-linux/guides/maintenance/swupd_guide.rst diff --git a/source/clear-linux/guides/maintenance/swupd_guide.rst b/source/clear-linux/guides/maintenance/swupd_guide.rst new file mode 100644 index 00000000..398ea209 --- /dev/null +++ b/source/clear-linux/guides/maintenance/swupd_guide.rst @@ -0,0 +1,81 @@ +.. _swupd_guide: + +swupd guide +########### + +*swupd* manages the software update capability of |CLOSIA|. It can check for +valid system updates and, if found, download and install them. It can also +perform verification of the system software. + +|CL| uses :ref:`bundles-about` as the base abstraction for +installing functionality on top of the core operating system. Use the `swupd` +tool to install and remove bundles. + +.. contents:: + :local: + :depth: 2 + +For a full listing of commands and options please see the man page in |CL| + +.. code-block:: bash + + man swupd + +OS Update and Verification +************************** + +|CL| is designed to promote a regular update cadence. `swupd` helps to +make sure that process is simple and secure. + +Automatic Updates +================= + +|CL| updates can be toggled to happen automatically or on demand. Enable +automatic updates like this: + +.. code-block:: bash + + sudo swupd autoupdate --enable + +To disable use the `--disable` flag instead. + +System Software Verification +============================ + +`swupd` can determine whether the system software has been overwritten, removed, or modified in any way. + +.. code-block:: bash + + sudo swupd verify + +Bundles +******* + +Listing installed bundles +========================= + +You can list all of the bundles currently installed on the system + +.. code-block:: bash + + sudo swupd bundle-list --all + +Adding a bundle +=============== + +Start by selecting a bundle from the list of :ref:`available-bundles`. In +this example we're adding dev-utils-dev, which is useful for development. + +.. code-block:: bash + + sudo swupd bundle-add dev-utils-dev + +Removing a bundle +================= + +Dependencies common to other bundles will not be removed + +.. code-block:: bash + + sudo swupd bundle-remove dev-utils-dev + From 5379715cf971e2a1e7b1fc68f57262119b98668e Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Fri, 29 Jun 2018 13:40:53 -0700 Subject: [PATCH 30/76] Corrects Sphinx syntax, spelling, and document formatting. Signed-off-by: Michael Vincerra --- source/clear-linux/reference/image-types.rst | 33 ++++++++++---------- 1 file changed, 16 insertions(+), 17 deletions(-) diff --git a/source/clear-linux/reference/image-types.rst b/source/clear-linux/reference/image-types.rst index d1cfcdab..25d375ef 100644 --- a/source/clear-linux/reference/image-types.rst +++ b/source/clear-linux/reference/image-types.rst @@ -1,6 +1,6 @@ .. _image-types: -Clear Linux image types +Clear Linux\* image types ####################### .. _image-types-content: @@ -9,22 +9,22 @@ Clear Linux image types The naming convention of a |CL| image filename is: - .. code-block:: console +.. code-block:: console - clear-[version number]-[image type].[compression type] + clear-[version number]-[image type].[compression type] -The *[version number]* field specifies the version number. +* The *[version number]* field specifies the version number. -The *[image type]* field specifies the type of image and its corresponding -file format. +* The *[image type]* field specifies the type of image and its corresponding + file format. -The *[compression type]* field specifies the compression type. Two types of -compressions are used: GNU\* zip (*.gz*) and XZ (*.xz*). +* The *[compression type]* field specifies the compression type. Two types of + compressions are used: GNU\* zip (*.gz*) and XZ (*.xz*). -Table 1 lists the currently available images which are platform independant. -Table 2 lists the currently available images which are platform specific. +Table 1 lists the currently available images that are platform independent. +Table 2 lists the currently available images that are platform specific. -.. list-table:: Table 1: Types of platform independant Clear Linux images +.. list-table:: Table 1: Types of platform-independent Clear Linux images :widths: 15, 85 :header-rows: 1 @@ -40,9 +40,7 @@ Table 2 lists the currently available images which are platform specific. * - live.img - image for live booting into memory, without requiring installaton. - - -.. list-table:: Table 2: Types of platform specific Clear Linux images +.. list-table:: Table 2: Types of platform-specific Clear Linux images :widths: 15, 85 :header-rows: 1 @@ -53,10 +51,10 @@ Table 2 lists the currently available images which are platform specific. - Virtual Hard Disk for use on Microsoft\* Azure\* cloud platform * - azure-docker.vhd - - Virtual Hard Disk for use on Microsoft\* Azure\* cloud platform with Docker\* pre-installed + - Virtual Hard Disk for use on Microsoft Azure cloud platform with Docker\* pre-installed * - azure-machine-learning.vhd - - Virtual Hard Disk for use on Microsoft\* Azure\* cloud platform with the `machine-learning-basic` bundle installed + - Virtual Hard Disk for use on Microsoft Azure cloud platform with the `machine-learning-basic` bundle installed * - cloud.img - Image for use by cloud deployments such as OpenStack\* @@ -68,7 +66,8 @@ Table 2 lists the currently available images which are platform specific. - Virtual Hard Disk for use with Microsoft Hyper-V\* hypervisor. Includes `optimized kernel`_ for Hyper-V. * - kvm.img - - Image for booting in a simple VM with start_qemu.sh. Includes `optimized kernel`_ for KVM. + - Image for booting in a simple VM with start_qemu.sh. Includes + `optimized kernel`_ for KVM. * - vmware.vmdk - Virtual Machine Disk for VMware\* platforms inclduing Player, Workstation, and ESXi. From dea47748b551341e814aceca49d6067effb99208 Mon Sep 17 00:00:00 2001 From: Jose Lamego Date: Mon, 2 Jul 2018 11:08:03 -0500 Subject: [PATCH 31/76] Update kata.rst --- source/clear-linux/tutorials/kata.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/clear-linux/tutorials/kata.rst b/source/clear-linux/tutorials/kata.rst index 841dc083..615f9e1e 100644 --- a/source/clear-linux/tutorials/kata.rst +++ b/source/clear-linux/tutorials/kata.rst @@ -7,7 +7,7 @@ This tutorial describes how to install, configure and run Kata Containers\* on |CLOSIA|. Kata Containers\* is an open source project and community working to build a standard implementation of lightweight Virtual Machines (VMs) that feel and perform like containers, but provide the workload isolation and security -advantages of VMs. Kata Containers\* is available in Clear Linux versions above 22860. +advantages of VMs. Kata Containers\* is available in Clear Linux versions above 23380. Prerequisites ************* From 7386f26245e964fd274a1610a58795f7f372afba Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Mon, 2 Jul 2018 12:21:18 -0700 Subject: [PATCH 32/76] added more material --- .../guides/maintenance/swupd_guide.rst | 102 ++++++++++++++++-- 1 file changed, 95 insertions(+), 7 deletions(-) diff --git a/source/clear-linux/guides/maintenance/swupd_guide.rst b/source/clear-linux/guides/maintenance/swupd_guide.rst index 398ea209..dad8f797 100644 --- a/source/clear-linux/guides/maintenance/swupd_guide.rst +++ b/source/clear-linux/guides/maintenance/swupd_guide.rst @@ -15,6 +15,8 @@ tool to install and remove bundles. :local: :depth: 2 +.. _man_swupd: + For a full listing of commands and options please see the man page in |CL| .. code-block:: bash @@ -27,27 +29,103 @@ OS Update and Verification |CL| is designed to promote a regular update cadence. `swupd` helps to make sure that process is simple and secure. -Automatic Updates -================= +OS Info +======= -|CL| updates can be toggled to happen automatically or on demand. Enable -automatic updates like this: +Current OS version and update server info: .. code-block:: bash - sudo swupd autoupdate --enable + swupd info -To disable use the `--disable` flag instead. +.. code-block:: console + Installed version: 23330 + Version URL: https://download.clearlinux.org/update/ + Content URL: https://cdn.download.clearlinux.org/update/ + +Disable Automatic Updates +========================= + +|CL| updates are automatic by default but can be toggled to occur only +on demand. Disable automatic updates: + +.. code-block:: bash + + sudo swupd autoupdate --disable + +To re-enable automatic updates use the `--enable` flag. + +Check for Updates +================= + +.. code-block:: bash + + sudo swupd check-update + +Perform a Manual Update +======================= + +You can update to a specific verion or accept the +latest as the default with no arguments. + +Initiate a manual update: + +.. code-block:: bash + + sudo swupd update -m 23330 + +Output from a successful update: + +.. code-block:: console + + Update started. + Version on server (23330) is not newer than system version (23330) + Update complete. System already up-to-date at version 23330 System Software Verification ============================ -`swupd` can determine whether the system software has been overwritten, removed, or modified in any way. +`swupd` can determine whether system directories and files have been added +to, overwritten, removed, or modified (eg., permissions). .. code-block:: bash sudo swupd verify +All directories that are watched by `swupd` are verified according to +the manifest data and hash mismatches are flagged as follows: + +.. code-block:: console + + Verifying version 23300 + Verifying files + ...0% + Hash mismatch for file: /usr/bin/chardetect + ... + ... + Hash mismatch for file: /usr/lib/python3.6/site-packages/urllib3/util/wait.py + ...100% + Inspected 237180 files + 423 files did not match + Verify successful + +In this case, python packages that were installed on top of the default +install were flagged as mismatched. `swupd` can be directed to ignore +or fix issues based on :ref:`command line options `. + +Fixing Hash Mixmatches +====================== + +`swupd` can correct any issues it detects. Additional directives can be +added including a white list of directories that will be ignored, if +desired. + +The following command will repair issues, remove unknown items, and ignore files or directories matching `/usr/lib/python`: + +.. code-block:: bash + + sudo swupd verify --fix --picky --picky-whitelist=/usr/lib/python + Bundles ******* @@ -60,6 +138,16 @@ You can list all of the bundles currently installed on the system sudo swupd bundle-list --all +Finding a bundle containing a binary +==================================== + +Run the following to display a list of bundles that contain a particular +binary. Note that it may be present in multiple bundles: + +.. code-block:: bash + + swupd search -b + Adding a bundle =============== From 598d4fda9a8c5adc7bbe952c9a28664f062155b7 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Mon, 2 Jul 2018 12:22:55 -0700 Subject: [PATCH 33/76] added swupd-guide to toc --- source/clear-linux/guides/maintenance/maintenance.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/source/clear-linux/guides/maintenance/maintenance.rst b/source/clear-linux/guides/maintenance/maintenance.rst index 8775a909..b5cbc720 100644 --- a/source/clear-linux/guides/maintenance/maintenance.rst +++ b/source/clear-linux/guides/maintenance/maintenance.rst @@ -14,6 +14,7 @@ maintaining |CLOSIA| after :ref:`installation ` is completed. bulk-provision mixer mixin + swupd validate-signatures telemetry-enable time From b9dbe660769576280eb688021af4499aba29468c Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Mon, 2 Jul 2018 12:33:07 -0700 Subject: [PATCH 34/76] corrected some linking problems and renamed the swupd guide file --- .../guides/maintenance/maintenance.rst | 2 +- .../guides/maintenance/swupd_guide.rst | 169 ------------------ 2 files changed, 1 insertion(+), 170 deletions(-) delete mode 100644 source/clear-linux/guides/maintenance/swupd_guide.rst diff --git a/source/clear-linux/guides/maintenance/maintenance.rst b/source/clear-linux/guides/maintenance/maintenance.rst index b5cbc720..6cbf1034 100644 --- a/source/clear-linux/guides/maintenance/maintenance.rst +++ b/source/clear-linux/guides/maintenance/maintenance.rst @@ -14,7 +14,7 @@ maintaining |CLOSIA| after :ref:`installation ` is completed. bulk-provision mixer mixin - swupd + swupd-guide validate-signatures telemetry-enable time diff --git a/source/clear-linux/guides/maintenance/swupd_guide.rst b/source/clear-linux/guides/maintenance/swupd_guide.rst deleted file mode 100644 index dad8f797..00000000 --- a/source/clear-linux/guides/maintenance/swupd_guide.rst +++ /dev/null @@ -1,169 +0,0 @@ -.. _swupd_guide: - -swupd guide -########### - -*swupd* manages the software update capability of |CLOSIA|. It can check for -valid system updates and, if found, download and install them. It can also -perform verification of the system software. - -|CL| uses :ref:`bundles-about` as the base abstraction for -installing functionality on top of the core operating system. Use the `swupd` -tool to install and remove bundles. - -.. contents:: - :local: - :depth: 2 - -.. _man_swupd: - -For a full listing of commands and options please see the man page in |CL| - -.. code-block:: bash - - man swupd - -OS Update and Verification -************************** - -|CL| is designed to promote a regular update cadence. `swupd` helps to -make sure that process is simple and secure. - -OS Info -======= - -Current OS version and update server info: - -.. code-block:: bash - - swupd info - -.. code-block:: console - Installed version: 23330 - Version URL: https://download.clearlinux.org/update/ - Content URL: https://cdn.download.clearlinux.org/update/ - -Disable Automatic Updates -========================= - -|CL| updates are automatic by default but can be toggled to occur only -on demand. Disable automatic updates: - -.. code-block:: bash - - sudo swupd autoupdate --disable - -To re-enable automatic updates use the `--enable` flag. - -Check for Updates -================= - -.. code-block:: bash - - sudo swupd check-update - -Perform a Manual Update -======================= - -You can update to a specific verion or accept the -latest as the default with no arguments. - -Initiate a manual update: - -.. code-block:: bash - - sudo swupd update -m 23330 - -Output from a successful update: - -.. code-block:: console - - Update started. - Version on server (23330) is not newer than system version (23330) - Update complete. System already up-to-date at version 23330 - -System Software Verification -============================ - -`swupd` can determine whether system directories and files have been added -to, overwritten, removed, or modified (eg., permissions). - -.. code-block:: bash - - sudo swupd verify - -All directories that are watched by `swupd` are verified according to -the manifest data and hash mismatches are flagged as follows: - -.. code-block:: console - - Verifying version 23300 - Verifying files - ...0% - Hash mismatch for file: /usr/bin/chardetect - ... - ... - Hash mismatch for file: /usr/lib/python3.6/site-packages/urllib3/util/wait.py - ...100% - Inspected 237180 files - 423 files did not match - Verify successful - -In this case, python packages that were installed on top of the default -install were flagged as mismatched. `swupd` can be directed to ignore -or fix issues based on :ref:`command line options `. - -Fixing Hash Mixmatches -====================== - -`swupd` can correct any issues it detects. Additional directives can be -added including a white list of directories that will be ignored, if -desired. - -The following command will repair issues, remove unknown items, and ignore files or directories matching `/usr/lib/python`: - -.. code-block:: bash - - sudo swupd verify --fix --picky --picky-whitelist=/usr/lib/python - -Bundles -******* - -Listing installed bundles -========================= - -You can list all of the bundles currently installed on the system - -.. code-block:: bash - - sudo swupd bundle-list --all - -Finding a bundle containing a binary -==================================== - -Run the following to display a list of bundles that contain a particular -binary. Note that it may be present in multiple bundles: - -.. code-block:: bash - - swupd search -b - -Adding a bundle -=============== - -Start by selecting a bundle from the list of :ref:`available-bundles`. In -this example we're adding dev-utils-dev, which is useful for development. - -.. code-block:: bash - - sudo swupd bundle-add dev-utils-dev - -Removing a bundle -================= - -Dependencies common to other bundles will not be removed - -.. code-block:: bash - - sudo swupd bundle-remove dev-utils-dev - From 93a1f5621d7cbb3dbd6d1ab4c724dd67991a737b Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Mon, 2 Jul 2018 12:33:39 -0700 Subject: [PATCH 35/76] added the changes swupd guide file --- .../guides/maintenance/swupd-guide.rst | 169 ++++++++++++++++++ 1 file changed, 169 insertions(+) create mode 100644 source/clear-linux/guides/maintenance/swupd-guide.rst diff --git a/source/clear-linux/guides/maintenance/swupd-guide.rst b/source/clear-linux/guides/maintenance/swupd-guide.rst new file mode 100644 index 00000000..2a25fc6d --- /dev/null +++ b/source/clear-linux/guides/maintenance/swupd-guide.rst @@ -0,0 +1,169 @@ +.. _swupd-guide: + +swupd guide +########### + +*swupd* manages the software update capability of |CLOSIA|. It can check for +valid system updates and, if found, download and install them. It can also +perform verification of the system software. + +|CL| uses :ref:`bundles-about` as the base abstraction for +installing functionality on top of the core operating system. Use the `swupd` +tool to install and remove bundles. + +.. contents:: + :local: + :depth: 2 + +.. _man_swupd: + +For a full listing of commands and options please see the man page in |CL| + +.. code-block:: bash + + man swupd + +OS Update and Verification +************************** + +|CL| is designed to promote a regular update cadence. `swupd` helps to +make sure that process is simple and secure. + +OS Info +======= + +Current OS version and update server info: + +.. code-block:: bash + + swupd info + +.. code-block:: console + Installed version: 23330 + Version URL: https://download.clearlinux.org/update/ + Content URL: https://cdn.download.clearlinux.org/update/ + +Disable Automatic Updates +========================= + +|CL| updates are automatic by default but can be toggled to occur only +on demand. Disable automatic updates: + +.. code-block:: bash + + sudo swupd autoupdate --disable + +To re-enable automatic updates use the `--enable` flag. + +Check for Updates +================= + +.. code-block:: bash + + sudo swupd check-update + +Perform a Manual Update +======================= + +You can update to a specific verion or accept the +latest as the default with no arguments. + +Initiate a manual update: + +.. code-block:: bash + + sudo swupd update -m 23330 + +Output from a successful update: + +.. code-block:: console + + Update started. + Version on server (23330) is not newer than system version (23330) + Update complete. System already up-to-date at version 23330 + +System Software Verification +============================ + +`swupd` can determine whether system directories and files have been added +to, overwritten, removed, or modified (eg., permissions). + +.. code-block:: bash + + sudo swupd verify + +All directories that are watched by `swupd` are verified according to +the manifest data and hash mismatches are flagged as follows: + +.. code-block:: console + + Verifying version 23300 + Verifying files + ...0% + Hash mismatch for file: /usr/bin/chardetect + ... + ... + Hash mismatch for file: /usr/lib/python3.6/site-packages/urllib3/util/wait.py + ...100% + Inspected 237180 files + 423 files did not match + Verify successful + +In this case, python packages that were installed on top of the default +install were flagged as mismatched. `swupd` can be directed to ignore +or fix issues based on :ref:`command line options `. + +Fixing Hash Mixmatches +====================== + +`swupd` can correct any issues it detects. Additional directives can be +added including a white list of directories that will be ignored, if +desired. + +The following command will repair issues, remove unknown items, and ignore files or directories matching `/usr/lib/python`: + +.. code-block:: bash + + sudo swupd verify --fix --picky --picky-whitelist=/usr/lib/python + +Bundles +******* + +Listing installed bundles +========================= + +You can list all of the bundles currently installed on the system + +.. code-block:: bash + + sudo swupd bundle-list --all + +Finding a bundle containing a binary +==================================== + +Run the following to display a list of bundles that contain a particular +binary. Note that it may be present in multiple bundles: + +.. code-block:: bash + + swupd search -b + +Adding a bundle +=============== + +Start by selecting a bundle from the list of :ref:`available-bundles`. In +this example we're adding dev-utils-dev, which is useful for development. + +.. code-block:: bash + + sudo swupd bundle-add dev-utils-dev + +Removing a bundle +================= + +Dependencies common to other bundles will not be removed + +.. code-block:: bash + + sudo swupd bundle-remove dev-utils-dev + From 70d8c38987a165f4dbcf59a6322b6fc9779d9e3f Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Mon, 2 Jul 2018 14:12:44 -0700 Subject: [PATCH 36/76] fixed some wording and typos --- .../guides/maintenance/swupd-guide.rst | 17 ++++++++--------- 1 file changed, 8 insertions(+), 9 deletions(-) diff --git a/source/clear-linux/guides/maintenance/swupd-guide.rst b/source/clear-linux/guides/maintenance/swupd-guide.rst index 2a25fc6d..b70e811d 100644 --- a/source/clear-linux/guides/maintenance/swupd-guide.rst +++ b/source/clear-linux/guides/maintenance/swupd-guide.rst @@ -1,7 +1,7 @@ .. _swupd-guide: -swupd guide -########### +Use swupd +######### *swupd* manages the software update capability of |CLOSIA|. It can check for valid system updates and, if found, download and install them. It can also @@ -65,10 +65,8 @@ Check for Updates Perform a Manual Update ======================= -You can update to a specific verion or accept the -latest as the default with no arguments. - -Initiate a manual update: +You can update to a specific version or accept the latest as the default with +no arguments. Initiate a manual update: .. code-block:: bash @@ -86,7 +84,7 @@ System Software Verification ============================ `swupd` can determine whether system directories and files have been added -to, overwritten, removed, or modified (eg., permissions). +to, overwritten, removed, or modified (e.g., permissions). .. code-block:: bash @@ -113,14 +111,15 @@ In this case, python packages that were installed on top of the default install were flagged as mismatched. `swupd` can be directed to ignore or fix issues based on :ref:`command line options `. -Fixing Hash Mixmatches +Fixing Hash Mismatches ====================== `swupd` can correct any issues it detects. Additional directives can be added including a white list of directories that will be ignored, if desired. -The following command will repair issues, remove unknown items, and ignore files or directories matching `/usr/lib/python`: +The following command will repair issues, remove unknown items, and +ignore files or directories matching `/usr/lib/python`: .. code-block:: bash From 979abaa9f694f757911bc75e224f51133684ee6e Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Mon, 2 Jul 2018 14:45:43 -0700 Subject: [PATCH 37/76] removed reference to successful manual update --- source/clear-linux/guides/maintenance/swupd-guide.rst | 8 -------- 1 file changed, 8 deletions(-) diff --git a/source/clear-linux/guides/maintenance/swupd-guide.rst b/source/clear-linux/guides/maintenance/swupd-guide.rst index b70e811d..a254ea9a 100644 --- a/source/clear-linux/guides/maintenance/swupd-guide.rst +++ b/source/clear-linux/guides/maintenance/swupd-guide.rst @@ -72,14 +72,6 @@ no arguments. Initiate a manual update: sudo swupd update -m 23330 -Output from a successful update: - -.. code-block:: console - - Update started. - Version on server (23330) is not newer than system version (23330) - Update complete. System already up-to-date at version 23330 - System Software Verification ============================ From 2135cccc98e0d0a49ad54f1144b373d57cdf6745 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Tue, 3 Jul 2018 10:28:10 -0700 Subject: [PATCH 38/76] removed update.rst as material is duplicate of swupd-guide.rst, updated swupd-guide, and updated maintenance.rst to reflect removal update.rst --- .../guides/maintenance/maintenance.rst | 3 +- .../guides/maintenance/swupd-guide.rst | 46 ++++++++---- .../clear-linux/guides/maintenance/update.rst | 70 ------------------- 3 files changed, 35 insertions(+), 84 deletions(-) delete mode 100644 source/clear-linux/guides/maintenance/update.rst diff --git a/source/clear-linux/guides/maintenance/maintenance.rst b/source/clear-linux/guides/maintenance/maintenance.rst index 6cbf1034..76713380 100644 --- a/source/clear-linux/guides/maintenance/maintenance.rst +++ b/source/clear-linux/guides/maintenance/maintenance.rst @@ -10,11 +10,10 @@ maintaining |CLOSIA| after :ref:`installation ` is completed. :maxdepth: 2 enable-user-space - update + swupd-guide bulk-provision mixer mixin - swupd-guide validate-signatures telemetry-enable time diff --git a/source/clear-linux/guides/maintenance/swupd-guide.rst b/source/clear-linux/guides/maintenance/swupd-guide.rst index b70e811d..0c9ef8a0 100644 --- a/source/clear-linux/guides/maintenance/swupd-guide.rst +++ b/source/clear-linux/guides/maintenance/swupd-guide.rst @@ -11,6 +11,13 @@ perform verification of the system software. installing functionality on top of the core operating system. Use the `swupd` tool to install and remove bundles. +This guide assumes: + +* The device is on a well-connected network. + +* The device is able to connect to the release infrastructure + http://update.clearlinux.org + .. contents:: :local: :depth: 2 @@ -23,14 +30,14 @@ For a full listing of commands and options please see the man page in |CL| man swupd -OS Update and Verification +OS update and verification ************************** |CL| is designed to promote a regular update cadence. `swupd` helps to make sure that process is simple and secure. -OS Info -======= +View OS info +============ Current OS version and update server info: @@ -43,26 +50,36 @@ Current OS version and update server info: Version URL: https://download.clearlinux.org/update/ Content URL: https://cdn.download.clearlinux.org/update/ -Disable Automatic Updates -========================= +Enable or disable automatic updates +=================================== -|CL| updates are automatic by default but can be toggled to occur only -on demand. Disable automatic updates: +|CL| updates are automatic by default but can be set to occur only +on demand. To verify your current auto-update setting: + +.. code-block:: bash + + sudo swupd autoupdate + +Disable automatic updates: .. code-block:: bash sudo swupd autoupdate --disable -To re-enable automatic updates use the `--enable` flag. +To re-enable automatic: -Check for Updates +.. code-block:: bash + + sudo swupd autoupdate --enable + +Check for updates ================= .. code-block:: bash sudo swupd check-update -Perform a Manual Update +Perform a manual update ======================= You can update to a specific version or accept the latest as the default with @@ -80,7 +97,12 @@ Output from a successful update: Version on server (23330) is not newer than system version (23330) Update complete. System already up-to-date at version 23330 -System Software Verification +.. note:: + + After a kernel update, reboot immediately for the enhancements to + take effect. + +System software verification ============================ `swupd` can determine whether system directories and files have been added @@ -111,7 +133,7 @@ In this case, python packages that were installed on top of the default install were flagged as mismatched. `swupd` can be directed to ignore or fix issues based on :ref:`command line options `. -Fixing Hash Mismatches +Fixing hash mismatches ====================== `swupd` can correct any issues it detects. Additional directives can be diff --git a/source/clear-linux/guides/maintenance/update.rst b/source/clear-linux/guides/maintenance/update.rst deleted file mode 100644 index 5705fda3..00000000 --- a/source/clear-linux/guides/maintenance/update.rst +++ /dev/null @@ -1,70 +0,0 @@ -.. _update: - -Update Clear Linux -################## - -This section describes how to update |CLOSIA|. - -Prerequisites -============= - -* The system is up and running the Clear Linux 15400 release or later. - -* The device is on a well-connected network. - -* The device is able to connect to the release infrastructure - http://update.clearlinux.org - -To verify the current release running on the system, enter: - -.. code-block:: console - - $ sudo swupd update -s - -How to update the system -======================== - -Starting with version 15400, Clear Linux supports auto-update. By default, it -is turned on. - -To verify the current auto-update setting: - - .. code-block:: console - - $ swupd autoupdate - -To enable auto-update: - - .. code-block:: console - - $ sudo swupd autoupdate --enable - -To disable auto-update: - - .. code-block:: console - - $ sudo swupd autoupdate --disable - -To force a manual update: - - .. code-block:: console - - $ sudo swupd update - -.. note:: - - When the swupd console output indicates a kernel update, reboot - immediately for the enhancements to take effect. - - -Additional information -====================== - -To see the man page listing additional swupd options, install the -`sysadmin-basic` bundle to access the `man` command and later access -the man page: - - .. code-block:: console - - $ sudo swupd bundle-add sysadmin-basic - $ man swupd From 9242b467b8ac91736a5045238f401b63591f4345 Mon Sep 17 00:00:00 2001 From: Mike Tullis Date: Tue, 3 Jul 2018 11:29:34 -0700 Subject: [PATCH 39/76] Simplified sentence (test PR) --- .../get-started/bare-metal-install/bare-metal-install.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/clear-linux/get-started/bare-metal-install/bare-metal-install.rst b/source/clear-linux/get-started/bare-metal-install/bare-metal-install.rst index 46a492f6..30e0967d 100644 --- a/source/clear-linux/get-started/bare-metal-install/bare-metal-install.rst +++ b/source/clear-linux/get-started/bare-metal-install/bare-metal-install.rst @@ -44,7 +44,7 @@ Follow these steps to install |CL| on the target system: #. Power on the system. -#. Open the system BIOS setup menu, normally by pressing the :kbd:`F2` key. +#. Open the system BIOS setup menu by pressing the :kbd:`F2` key. Your BIOS setup menu entry point may vary. #. In the setup menu, enable the UEFI boot and set the USB drive as the first From 9b0ff80def16d92b9d9ed4660bfd85ba534475ea Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Mon, 2 Jul 2018 16:57:19 -0700 Subject: [PATCH 40/76] Adds nginx web-server to show how to host mixer updates. - Simplifies and combines two mix workflows at start - Fixes Sphinx syntax - Replaces incorrect link to web server in section CONTENTURL, VERSIONURL Signed-off-by: Michael Vincerra --- .../clear-linux/guides/maintenance/mixer.rst | 188 ++++++++++++++---- 1 file changed, 146 insertions(+), 42 deletions(-) diff --git a/source/clear-linux/guides/maintenance/mixer.rst b/source/clear-linux/guides/maintenance/mixer.rst index 90e54dec..1d5b831d 100644 --- a/source/clear-linux/guides/maintenance/mixer.rst +++ b/source/clear-linux/guides/maintenance/mixer.rst @@ -16,35 +16,26 @@ To start working with the mixer tools, you need a recent image of |CL| with the `mixer` bundle installed. If the bundle is not yet installed, you can add it with the :command:`swupd bundle-add` command as follows: - .. code-block:: bash +.. code-block:: bash - sudo swupd bundle-add mixer + sudo swupd bundle-add mixer Current mixing workflow *********************** There are two different workflows to create your own mix. +First, if your mix only uses |CL| content, *skip step 5* below. +Second, if your mix includes your own +:abbr:`RPMs (RPM Package Manager files)`, follow all these steps. -The following workflow applies if the mix includes your own -:abbr:`RPMs (RPM Package Manager files)`: - -#. `Create a workspace`_ -#. `Generate the starting point for your mix`_ -#. `Edit builder.conf`_ -#. `Create or locate RPMs for the mix`_ -#. `Import RPMs into workspace`_ -#. `Create a local RPM repo`_ -#. `List, edit, create, add, remove, or validate bundles`_ -#. `Build the bundle chroots`_ -#. `Create an update`_ -#. `Create an image`_ - -Alternatively, the following workflow applies if the mix only uses |CL| -content. - +#. `Create ngninx web server to host mixer updates`_ #. `Create a workspace`_ #. `Generate the starting point for your mix`_ #. `Edit builder.conf`_ +#. `Create custom RPMs`_ + #. `Create or locate RPMs for the mix`_ + #. `Import RPMs into workspace`_ + #. `Create a local RPM repo`_ #. `List, edit, create, add, remove, or validate bundles`_ #. `Build the bundle chroots`_ #. `Create an update`_ @@ -53,6 +44,114 @@ content. The following sections contain detailed information on every step of these workflows. +.. _create-nginx-web-server: + +Create ngninx web server to host mixer updates +********************************************** + +Follow these steps to set up a HTTP service with ``nginx`` web +server, where you can host custom |CL| mixes. + +#. Install ``web-server-basic``: + + .. code-block:: bash + + sudo swupd bundle-add web-server-basic + +#. Make the directory where mixer updates will reside. + + .. code-block:: bash + + sudo mkdir -p /var/www + +#. Create a symbolic link. + + .. code-block:: bash + + sudo ln -sf $HOME/mixer/update/www /var/www/mixer + +#. To assure ``nginx`` starts by default, add and configure it. + + .. code-block:: bash + + sudo mkdir -p /etc/nginx/conf.d + +#. Copy the default example configuration file to `/etc` to load on boot. + + .. code-block:: bash + + sudo cp -f /usr/share/nginx/conf/nginx.conf.example /etc/nginx/nginx.conf + +#. Open ``mixer.conf`` with an editor. + + .. code-block:: bash + + sudo nano /etc/nginx/conf.d/mixer.conf + +#. Add the server configuration content below to ``mixer.conf``. + + .. code-block:: console + + server { + server_name localhost; + location / { + root /var/www/mixer; + autoindex on; + } + } + +#. Restart the daemon, enable nginx on boot, and start the service. + + .. code-block:: bash + + sudo systemctl daemon-reload + + sudo systemctl enable nginx + + sudo systemctl start nginx + +#. To verify the web server is running, enter in an Internet browser: + + .. code-block:: bash + + http://localhost + +#. Alternatively, verify the server is running by entering: + + .. code-block:: bash + + ps aux | grep nginx + + .. note:: + + If `nginx` is active, a list should appear showing one master process + and a few worker processes. + +Connect the URL to mixer +======================== + +Add the URL of the `nginx` server to builder.conf. Your |CL| clients connect +to this URL to find the update content. + +#. Get the IP address of your nginx server: + + .. code-block:: bash + + networkctl status + +#. In the mixer workspace, edit `builder.conf` to set the value for + CONTENTURL and VERSIONURL to the IP `Address` of your `nginx` server. + + .. code-block:: bash + + nano builder.conf + + .. note:: + + For example: + CONTNENTURL=http://192.168.25.52 + VERSIONURL=http://192.168.25.52 + Create a workspace ****************** @@ -103,9 +202,8 @@ directories in your mix workspace and adds their paths to the generated the paths manually. For more information on using these directories or setting them up manually, see `Create or locate RPMs for the mix`_. -If all upstream |CL| bundles will be part of the mix, you can easily add them all -during initialization with the optional :option:`--all-upstream` flag. For -example: +If all upstream |CL| bundles will be part of the mix, you can easily add +them all during initialization with the optional :option:`--all-upstream` flag. For example: .. code-block:: bash @@ -197,8 +295,8 @@ The following variables require further explanation: the folder at all. * The `YUM_CONF` variable sets the path where mixer automatically generates - the :file:`.yum-mix.conf` yum configuration file. The yum configuration file - points the chroot-builder to the path where the RPMs are stored. + the :file:`.yum-mix.conf` yum configuration file. The yum configuration + file points the chroot-builder to the path where the RPMs are stored. * The `CERT` variable sets the path where mixer stores the :file:`Swupd_Root.pem` certificate file. The chroot-builder needs the @@ -206,9 +304,9 @@ The following variables require further explanation: security for content verification. The value of the `CERT` variable can point to a different certificate. The chroot-builder inserts the certificate specified in this value into the - :file:`/os-core-update/usr/share/clear/update-ca/` path. The software update - client uses this certificate to verify the :file:`Manifest.MoM` file's - signature. For now, we **strongly** recommend that you do not modify + :file:`/os-core-update/usr/share/clear/update-ca/` path. The software + update client uses this certificate to verify the :file:`Manifest.MoM` + file's signature. For now, we **strongly** recommend that you do not modify this line, as the certificate that :abbr:`swupd (Software Updater)` expects needs to have a very specific configuration to sign and verify properly. Mixer automatically generates the certificate, if you do not @@ -216,14 +314,14 @@ The following variables require further explanation: file to provide security for the updated content you create. * The `CONTENTURL` and `VERSIONURL` variables set the domain or IP address - where swupd looks for your update content and the corresponding version. You - must set these variables to the domain or IP-address of the server hosting the - update content. You can use any web server to host your update content. To learn - how to install and configure web server using |CL|, visit - :ref:`web-server-install`. For our example, the web update content within - the `SERVER_STATE_DIR` directory is located here: - :file:`/home/clr/mix/update/www`. If the web server is on the same machine as - this directory, you can create a symlink to the directory in your web + where swupd looks for your update content and the corresponding version. + You must set these variables to the domain or IP-address of the server + hosting the update content. You can use any web server to host your update + content. To learn how to install and configure web server using |CL|, see + :ref:`create-nginx-web-server`. For our example, the web update content + within the `SERVER_STATE_DIR` directory is located here: + :file:`/home/clr/mix/update/www`. If the web server is on the same machine + as this directory, you can create a symlink to the directory in your web server's document root to easily host the content. These URLs are embedded in images created for your mix. The `swupd-client` looks at these URLs to determine if a new version is available and the location @@ -242,8 +340,12 @@ The following variables require further explanation: .. note:: If you are working only with |CL| bundles, then skip to `List, edit, create, add, remove, or validate bundles`_. + +Create custom RPMs +****************** + Create or locate RPMs for the mix -********************************* +================================= If you create RPMs from scratch, you can use `autospec`, `mock`, `rpmbuild`, or similar tools to build them. If the RPMs are not built on |CL|, ensure @@ -252,7 +354,7 @@ there is no guarantee they will be compatible. For more information on building the RPMs properly, refer to our `build RPMs instructions`_. Import RPMs into workspace -************************** +========================== #. Create a :file:`local-rpms` directory in your workspace, for example, :file:`/home/clr/mix/local-rpms`. @@ -269,7 +371,7 @@ Mixer uses this directory to find the RPMs to build a local RPM repo for yum to use. Create a local RPM repo -*********************** +======================= #. Create an empty directory in your workspace named :file:`local-yum`. #. Add the path to your :file:`builder.conf` file: @@ -416,7 +518,8 @@ as part of the bundle. .. note:: The :command:`mixer bundle edit` command accepts multiple bundles at once. - Thus, you can create multiple new bundles in a single command, for example: + Thus, you can create multiple new bundles in a single command, for + example: .. code-block:: bash @@ -486,8 +589,8 @@ Validate the bundles in the mix Mixer performs basic validation on all bundles when used throughout the system. -Mixer checks the validity of the bundle's syntax and name. Optionally, you can -run this validation manually on `bundle1` with the following command: +Mixer checks the validity of the bundle's syntax and name. Optionally, you +can run this validation manually on `bundle1` with the following command: .. code-block:: bash @@ -746,7 +849,8 @@ modifications as needed, for example: .. code-block:: bash - sudo mixer-pack-maker.sh --to --from -S /home/clr/mix/update + sudo mixer-pack-maker.sh --to --from -S / + home/clr/mix/update .. _mixer-format: From 963039ec224aaaa0647a2988ef9c93e025646f47 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Tue, 3 Jul 2018 16:59:34 -0700 Subject: [PATCH 41/76] added autoupdate version to swupd-guide.rst --- source/clear-linux/guides/maintenance/swupd-guide.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/clear-linux/guides/maintenance/swupd-guide.rst b/source/clear-linux/guides/maintenance/swupd-guide.rst index 23726f4d..1c5123f0 100644 --- a/source/clear-linux/guides/maintenance/swupd-guide.rst +++ b/source/clear-linux/guides/maintenance/swupd-guide.rst @@ -53,7 +53,7 @@ Current OS version and update server info: Enable or disable automatic updates =================================== -|CL| updates are automatic by default but can be set to occur only +|CL| updates are automatic by default starting with version 15400 but can be set to occur only on demand. To verify your current auto-update setting: .. code-block:: bash From cc080b83bc27e1eec3689f36d75dc67835a8f3f1 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Tue, 10 Jul 2018 12:14:00 -0700 Subject: [PATCH 42/76] removed version number reference --- source/clear-linux/guides/maintenance/swupd-guide.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/clear-linux/guides/maintenance/swupd-guide.rst b/source/clear-linux/guides/maintenance/swupd-guide.rst index 1c5123f0..23726f4d 100644 --- a/source/clear-linux/guides/maintenance/swupd-guide.rst +++ b/source/clear-linux/guides/maintenance/swupd-guide.rst @@ -53,7 +53,7 @@ Current OS version and update server info: Enable or disable automatic updates =================================== -|CL| updates are automatic by default starting with version 15400 but can be set to occur only +|CL| updates are automatic by default but can be set to occur only on demand. To verify your current auto-update setting: .. code-block:: bash From dd716f19bb401407307cb1556ac2a28185ddded1 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Tue, 10 Jul 2018 16:20:01 -0700 Subject: [PATCH 43/76] added note for proxy config for docker, improved wording throughout, and removed asterisks where they weren't needed. --- source/clear-linux/tutorials/kata.rst | 51 ++++++++++++++++++--------- 1 file changed, 35 insertions(+), 16 deletions(-) diff --git a/source/clear-linux/tutorials/kata.rst b/source/clear-linux/tutorials/kata.rst index 615f9e1e..a21a8542 100644 --- a/source/clear-linux/tutorials/kata.rst +++ b/source/clear-linux/tutorials/kata.rst @@ -4,10 +4,9 @@ Install Kata Containers\* ####################### This tutorial describes how to install, configure and run Kata Containers\* on -|CLOSIA|. Kata Containers\* is an open source project and community working to -build a standard implementation of lightweight Virtual Machines (VMs) that feel -and perform like containers, but provide the workload isolation and security -advantages of VMs. Kata Containers\* is available in Clear Linux versions above 23380. +|CLOSIA|. Kata Containers is an open source project dedicated to the +development of a lightweight implementation of Virtual Machines (VMs) +offering the speed of containers and the security of VMs. Prerequisites ************* @@ -22,17 +21,17 @@ Before you install any new packages, update |CL| with the following command: sudo swupd update -Install Kata Containers\* +Install Kata Containers *********************** -Kata Containers\* is included in the :file:`containers-virt` bundle. To install the +Kata Containers is included in the :file:`containers-virt` bundle. To install the framework, enter: .. code-block:: bash sudo swupd bundle-add containers-virt -Configure Docker to use Kata Containers\* by default +Configure Docker\* to use Kata Containers by default .. code-block:: bash @@ -43,35 +42,55 @@ Configure Docker to use Kata Containers\* by default ExecStart=/usr/bin/dockerd -D --add-runtime kata-runtime=/usr/bin/kata-runtime --default-runtime=kata-runtime EOF -Restart the Docker\* and Kata Containers\* systemd services +Restart the Docker and Kata Containers systemd services .. code-block:: bash sudo systemctl daemon-reload sudo systemctl restart docker -Run Kata Containers\* +Run Kata Containers ******************* .. code-block:: bash sudo docker run -ti busybox sh +.. note:: + + In cases where it is necessary to use a proxy server and your proxy + environment variables are already set, run the following commands as + a shell script to configure Docker: + + .. code-block:: bash + + docker_service_dir="/etc/systemd/system/docker.service.d/" + sudo mkdir -p "$docker_service_dir" + cat < Date: Tue, 10 Jul 2018 17:14:56 -0700 Subject: [PATCH 44/76] fixed issue 162 --- source/clear-linux/concepts/swupd-about.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/clear-linux/concepts/swupd-about.rst b/source/clear-linux/concepts/swupd-about.rst index 3f4b8452..c3162de0 100644 --- a/source/clear-linux/concepts/swupd-about.rst +++ b/source/clear-linux/concepts/swupd-about.rst @@ -123,7 +123,7 @@ and core update take merely seconds. While we realize our definition of bundles makes sense to us, data center operators may have special needs and ideas. Therefore, we provide a -:ref:`mixer`. This tool allows users to customize and add bundles +:ref:`mixer tool `. This tool allows users to customize and add bundles or even add their own software, while keeping the operating system and its updates as the basis. Using this tool, system administrators can focus on the custom pieces their deployments require while staying on From 276db4610529fab10eccf8535da8b3643ff031fb Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Wed, 11 Jul 2018 13:20:07 -0700 Subject: [PATCH 45/76] Applies line edits to clarify nginx default configuration. Signed-off-by: Michael Vincerra --- source/clear-linux/guides/maintenance/mixer.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/clear-linux/guides/maintenance/mixer.rst b/source/clear-linux/guides/maintenance/mixer.rst index 1d5b831d..a2eaa0e4 100644 --- a/source/clear-linux/guides/maintenance/mixer.rst +++ b/source/clear-linux/guides/maintenance/mixer.rst @@ -70,13 +70,13 @@ server, where you can host custom |CL| mixes. sudo ln -sf $HOME/mixer/update/www /var/www/mixer -#. To assure ``nginx`` starts by default, add and configure it. +#. Set up ``nginx`` configuration. .. code-block:: bash sudo mkdir -p /etc/nginx/conf.d -#. Copy the default example configuration file to `/etc` to load on boot. +#. Copy the default example configuration file. .. code-block:: bash From 9b3013b2d7ba6d76fddfb68216eed204a883c02f Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Wed, 11 Jul 2018 13:56:22 -0700 Subject: [PATCH 46/76] Adds new URL for helloclear https://github.com/clearlinux/helloclear/archive/ Signed-off-by: Michael Vincerra --- source/clear-linux/guides/maintenance/autospec.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/clear-linux/guides/maintenance/autospec.rst b/source/clear-linux/guides/maintenance/autospec.rst index c2370254..a15b6ba9 100644 --- a/source/clear-linux/guides/maintenance/autospec.rst +++ b/source/clear-linux/guides/maintenance/autospec.rst @@ -105,7 +105,8 @@ Build a new RPM .. code-block:: bash - make autospecnew URL="https://github.com/bktan8/helloclear/archive/helloclear-4.tar.gz" NAME="helloclear" + make autospecnew URL="https://github.com/clearlinux/helloclear/archive/helloclear-v1.0.tar.gz" + NAME="helloclear" .. note:: From bf70fb60fd117dbf4d71f93213d998957babaed3 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Wed, 11 Jul 2018 14:09:53 -0700 Subject: [PATCH 47/76] corrected runtime references --- source/clear-linux/tutorials/kata.rst | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/source/clear-linux/tutorials/kata.rst b/source/clear-linux/tutorials/kata.rst index a21a8542..b13b2fee 100644 --- a/source/clear-linux/tutorials/kata.rst +++ b/source/clear-linux/tutorials/kata.rst @@ -84,14 +84,15 @@ More information about Docker in |CLOSIA|. ############################################# Docker on |CLOSIA| provides a docker.service service file to start the Docker -daemon. The daemon will use runc or cc-runtime depending on the environment: +daemon. The daemon will use runc or s/cc-runtime/kata-runtime depending on +the environment: -If you are running |CL| on baremetal or on a VM with Nested -Virtualization activated, Docker will use cc-runtime as the default runtime. -If you are running |CL| on a VM without Nested Virtualization, Docker -will use runc as the default runtime. It is not necessary to configure Docker -to use cc-runtime manually since Docker itself will automatically use this -runtime on systems that support it. +If you are running |CL| on bare metal or on a VM with Nested +Virtualization activated, Docker will use s/cc-runtime/kata-runtime as the +default runtime. If you are running |CL| on a VM without Nested +Virtualization, Docker will use runc as the default runtime. It is not +necessary to manually configure the runtime for Docker, since Docker itself +will automatically use the one supported by the system. To check which runtime your system is using, run: From 0eaa2542c79eb63996bcd12431034caf142a95f0 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Wed, 11 Jul 2018 14:40:42 -0700 Subject: [PATCH 48/76] added link to clear container migration --- source/clear-linux/tutorials/kata.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/source/clear-linux/tutorials/kata.rst b/source/clear-linux/tutorials/kata.rst index b13b2fee..ff4d7a4c 100644 --- a/source/clear-linux/tutorials/kata.rst +++ b/source/clear-linux/tutorials/kata.rst @@ -15,6 +15,9 @@ This tutorial assumes you have installed |CL| on your host system. For detailed instructions on installing |CL| on a bare metal system, visit the :ref:`bare metal installation tutorial`. +If you have Clear Containers installed on your |CL| system, then follow the +:ref:`migrate Clear Containers to Kata Containers tutorial`. + Before you install any new packages, update |CL| with the following command: .. code-block:: bash From bdfa11846eb98ba9bfcaa627f385f557cd4757ea Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Wed, 11 Jul 2018 17:09:18 -0700 Subject: [PATCH 49/76] Adds :contents: directive to Clear Linux collaboration guide. Signed-off-by: Michael Vincerra --- .../collaboration/documentation/contents.rst | 40 +++++++++++++++++++ .../collaboration/documentation/rest.rst | 1 + 2 files changed, 41 insertions(+) create mode 100644 source/clear-linux/reference/collaboration/documentation/contents.rst diff --git a/source/clear-linux/reference/collaboration/documentation/contents.rst b/source/clear-linux/reference/collaboration/documentation/contents.rst new file mode 100644 index 00000000..554fe4b2 --- /dev/null +++ b/source/clear-linux/reference/collaboration/documentation/contents.rst @@ -0,0 +1,40 @@ +.. _contents: + + +Contents directive +################## + +For |CL| documentation that has three or more sections, use the `contents:` +directive as shown in the example below. This directive automatically captures the headings (and +subheadings if used) as specified in the value given after `:depth:`. Adding this directive to +longer documents allows users to quickly navigate to the desired section. + + .. contents: :local: + :depth: 2 + +.. code-block:: bash + + .. contents: :local: + :depth: 2 + +.. note:: + + Assure that you add `:local:` as the value. For more resources on this directive, + visit the `reStruturedText Directives`_ + +EXAMPLE: + +Clear Linux Guide Example +************************* + +Introduction +========= + +Step-by-Step +============ + +Launch +====== + + +.. _reStruturedText Directives: http://docutils.sourceforge.net/0.4/docs/ref/rst/directives.html#table-of-contents diff --git a/source/clear-linux/reference/collaboration/documentation/rest.rst b/source/clear-linux/reference/collaboration/documentation/rest.rst index a11522bc..3b1a81f6 100644 --- a/source/clear-linux/reference/collaboration/documentation/rest.rst +++ b/source/clear-linux/reference/collaboration/documentation/rest.rst @@ -36,6 +36,7 @@ templates supplied. cross images code + contents .. _Sphinx documentation: From e23dcbbe9cf347aae9880b421b7b6d13d2ea16e7 Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Thu, 12 Jul 2018 10:06:35 -0700 Subject: [PATCH 50/76] Removes instances of s/cc-runtime for kata per @devimc Signed-off-by: Michael Vincerra --- source/clear-linux/tutorials/kata.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/clear-linux/tutorials/kata.rst b/source/clear-linux/tutorials/kata.rst index ff4d7a4c..0bb6d589 100644 --- a/source/clear-linux/tutorials/kata.rst +++ b/source/clear-linux/tutorials/kata.rst @@ -87,11 +87,11 @@ More information about Docker in |CLOSIA|. ############################################# Docker on |CLOSIA| provides a docker.service service file to start the Docker -daemon. The daemon will use runc or s/cc-runtime/kata-runtime depending on +daemon. The daemon will use runc or kata-runtime depending on the environment: If you are running |CL| on bare metal or on a VM with Nested -Virtualization activated, Docker will use s/cc-runtime/kata-runtime as the +Virtualization activated, Docker will use kata-runtime as the default runtime. If you are running |CL| on a VM without Nested Virtualization, Docker will use runc as the default runtime. It is not necessary to manually configure the runtime for Docker, since Docker itself From 8cce36d61fd80cba696bfa40b43d962c79dde797 Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Thu, 12 Jul 2018 10:41:51 -0700 Subject: [PATCH 51/76] Fixes format for contents: directive Signed-off-by: Michael Vincerra --- .../reference/collaboration/documentation/contents.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/clear-linux/reference/collaboration/documentation/contents.rst b/source/clear-linux/reference/collaboration/documentation/contents.rst index 554fe4b2..9de87d64 100644 --- a/source/clear-linux/reference/collaboration/documentation/contents.rst +++ b/source/clear-linux/reference/collaboration/documentation/contents.rst @@ -9,8 +9,8 @@ directive as shown in the example below. This directive automatically captures t subheadings if used) as specified in the value given after `:depth:`. Adding this directive to longer documents allows users to quickly navigate to the desired section. - .. contents: :local: - :depth: 2 +.. contents: :local: + :depth: 2 .. code-block:: bash From a16acb908419c395a3911d98fad56abc6c9b6847 Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Thu, 12 Jul 2018 10:49:17 -0700 Subject: [PATCH 52/76] Corrects formatting. Signed-off-by: Michael Vincerra --- .../reference/collaboration/documentation/contents.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/clear-linux/reference/collaboration/documentation/contents.rst b/source/clear-linux/reference/collaboration/documentation/contents.rst index 9de87d64..e722c7dc 100644 --- a/source/clear-linux/reference/collaboration/documentation/contents.rst +++ b/source/clear-linux/reference/collaboration/documentation/contents.rst @@ -9,12 +9,12 @@ directive as shown in the example below. This directive automatically captures t subheadings if used) as specified in the value given after `:depth:`. Adding this directive to longer documents allows users to quickly navigate to the desired section. -.. contents: :local: +.. contents:: :local: :depth: 2 .. code-block:: bash - .. contents: :local: + .. contents:: :local: :depth: 2 .. note:: From 18ca599fe19f677173db4a1f07a3905ed30babb9 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Thu, 12 Jul 2018 12:20:26 -0700 Subject: [PATCH 53/76] Remove Clear Containers reference. Add Kata Clear Containers runtime integration was removed. Updating documentation to reflect that. --- .../clear-linux/tutorials/docker/docker.rst | 45 +++---------------- 1 file changed, 7 insertions(+), 38 deletions(-) diff --git a/source/clear-linux/tutorials/docker/docker.rst b/source/clear-linux/tutorials/docker/docker.rst index 75c00e35..60f6dc02 100644 --- a/source/clear-linux/tutorials/docker/docker.rst +++ b/source/clear-linux/tutorials/docker/docker.rst @@ -68,48 +68,17 @@ packages to run Docker images as containers. Congratulations! At this point, you have a working installation of Docker on |CL|. You are ready to start using container images on your system. -Integration with Clear Containers (optional) +Integration with Kata Containers (optional) ******************************************** -`Clear Containers`_, is an open source project aiming to increase security +`Kata Containers`_, is an open source project aiming to increase security of containers by using a hardware-backed virtual machine container runtime, -instead of software namespace containers that are provided by the standard +rather than software namespace containers which are provided by the standard Docker *runc* runtime. -The Docker package from |CL| will automatically use the *cc-runtime* -required for Clear Containers if it is available on your Clear Linux system. +Clear Linux provides easy integration of the *kata-runtime* with Docker. +More information on installing and using the *kata-runtime* can be found at :ref:`kata` -#. To take advantage of Clear Containers in |CL|, install the - *containers-virt* bundle by running this command: - - .. code-block:: bash - - sudo swupd bundle-add containers-virt - -#. Restart the Docker daemon through systemd manager by running this command: - - .. code-block:: bash - - sudo systemctl restart docker - -#. After restarting, the Docker daemon will seamlessly use Clear Containers - to launch containers. You can see the runtime has changed to - :command:`cc-runtime` by running this command: - - .. code-block:: bash - - sudo docker info | grep Runtime - -#. You should see the following output indicating the *cc-runtime* is the - Default Runtime: - - .. code-block:: console - - Runtimes: cc-runtime runc - Default Runtime: cc-runtime - -Congratulations! At this point, you have successfully replaced the default -container runtime with Clear Containers. .. note:: @@ -216,7 +185,7 @@ Also see: * `Docker Home`_ * `Docker Documentation`_ * `Docker Hub`_ -* `Clear Containers`_ +* `Kata Containers`_ .. _`unique features`: https://clearlinux.org/features .. _`Clear Linux image on Docker Hub`: https://hub.docker.com/_/clearlinux/ @@ -225,7 +194,7 @@ Also see: .. _`bundles`: https://clearlinux.org/documentation/clear-linux/concepts/bundles-about#related-concepts .. _`stateless system`: https://clearlinux.org/features/stateless .. _`Docker documentation on daemon configuration`: https://docs.docker.com/engine/reference/commandline/dockerd/#daemon-configuration-file -.. _`Clear Containers`: https://github.com/clearcontainers +.. _`Kata Containers`: https://katacontainers.io/ .. _`Docker Home`: https://www.docker.com/ .. _`Docker Documentation`: https://docs.docker.com/ .. _`Docker Hub`: https://hub.docker.com/ From 4c818be239c10157e8174a2f15369c67b7de18d1 Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Thu, 12 Jul 2018 15:09:34 -0700 Subject: [PATCH 54/76] Fixes typo. Signed-off-by: Michael Vincerra --- .../reference/collaboration/documentation/contents.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/clear-linux/reference/collaboration/documentation/contents.rst b/source/clear-linux/reference/collaboration/documentation/contents.rst index e722c7dc..6b4f043f 100644 --- a/source/clear-linux/reference/collaboration/documentation/contents.rst +++ b/source/clear-linux/reference/collaboration/documentation/contents.rst @@ -4,7 +4,7 @@ Contents directive ################## -For |CL| documentation that has three or more sections, use the `contents:` +For |CL| documentation that has three or more sections, use the `contents::` directive as shown in the example below. This directive automatically captures the headings (and subheadings if used) as specified in the value given after `:depth:`. Adding this directive to longer documents allows users to quickly navigate to the desired section. From 9b686070946c91d6bc2c153f563621c1126da561 Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Fri, 13 Jul 2018 10:43:47 -0700 Subject: [PATCH 55/76] Removes unnecessary hidden comment. Signed-off-by: Michael Vincerra --- source/clear-linux/concepts/autospec-about.rst | 2 -- 1 file changed, 2 deletions(-) diff --git a/source/clear-linux/concepts/autospec-about.rst b/source/clear-linux/concepts/autospec-about.rst index 7930c545..b8d397ba 100644 --- a/source/clear-linux/concepts/autospec-about.rst +++ b/source/clear-linux/concepts/autospec-about.rst @@ -1,7 +1,5 @@ .. _autospec-about: -.. _autospec-overview: - Autospec ######## From ff01559f283adc2d6f492084b08be01dd4c989b6 Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Mon, 16 Jul 2018 14:16:44 -0700 Subject: [PATCH 56/76] Grammatical change foil to isolate sphinx build errors Signed-off-by: Michael Vincerra --- source/clear-linux/concepts/autospec-about.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/clear-linux/concepts/autospec-about.rst b/source/clear-linux/concepts/autospec-about.rst index b8d397ba..64eaafcf 100644 --- a/source/clear-linux/concepts/autospec-about.rst +++ b/source/clear-linux/concepts/autospec-about.rst @@ -80,7 +80,7 @@ How autospec works Autospec attempts to infer the requirements of the ``spec`` file. If autospec infers correctly, the control files (Table 1) will automatically -correct the build requirements. These control files are used to influence +correct the build requirements. The control files are used to influence the ``spec`` file generation. #. The :command:`make autospec` command generates a ``spec`` file from the From 85dd899c83966c0d2b383b61b4fef7a01157c6d3 Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Mon, 16 Jul 2018 15:10:37 -0700 Subject: [PATCH 57/76] Adds two missing values to code-blocks; revises intro paragraph. Signed-off-by: Michael Vincerra --- source/clear-linux/guides/maintenance/autospec.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/source/clear-linux/guides/maintenance/autospec.rst b/source/clear-linux/guides/maintenance/autospec.rst index a15b6ba9..8c065fd4 100644 --- a/source/clear-linux/guides/maintenance/autospec.rst +++ b/source/clear-linux/guides/maintenance/autospec.rst @@ -5,8 +5,8 @@ Build RPMs with autospec This guide shows you how to create RPMs with :ref:`autospec ` , a tool that assists in automated creation and maintenance of RPM packaging -on |CLOSIA|. Additionally, you will use the RPMs to create bundles using -:ref:`mixer `. +on |CLOSIA|. Additionally, you learn how to use these RPMs to create bundles +with :ref:`mixer `. Prerequisites ************* @@ -148,13 +148,13 @@ method assumes that a spec file already exists. In this example, we run a #. Navigate to the ``dmidecode`` package in clearlinux: - .. code-block:: + .. code-block:: bash cd ~/clearlinux/packages/dmidecode/ #. To download the tarball and build, run the command: - .. code-block:: + .. code-block:: bash make build From b7a99447dfa9243c113273e8363cf588b4cb17f1 Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Mon, 16 Jul 2018 15:52:00 -0700 Subject: [PATCH 58/76] Corrects grammatical errors. Corrects Sphinx syntax for URLs. Signed-off-by: Michael Vincerra --- .../clear-linux/tutorials/docker/docker.rst | 54 +++++++++++-------- 1 file changed, 33 insertions(+), 21 deletions(-) diff --git a/source/clear-linux/tutorials/docker/docker.rst b/source/clear-linux/tutorials/docker/docker.rst index 60f6dc02..6c6cae2a 100644 --- a/source/clear-linux/tutorials/docker/docker.rst +++ b/source/clear-linux/tutorials/docker/docker.rst @@ -4,8 +4,8 @@ Run Docker\* on Clear Linux\* ############################# |CLOSIA| supports multiple containerization platforms, including a Docker\* -solution.|CL| has many `unique features`_ including a minimal default -installation which makes it compelling to use as a host for container +solution. |CL| has many `unique features`_ including a minimal default +installation, which makes it compelling to use as a host for container workloads, management, and orchestration. This tutorial covers: @@ -72,12 +72,12 @@ Integration with Kata Containers (optional) ******************************************** `Kata Containers`_, is an open source project aiming to increase security -of containers by using a hardware-backed virtual machine container runtime, -rather than software namespace containers which are provided by the standard +of containers by using a hardware-backed virtual machine container runtime +rather than software namespace containers that are provided by the standard Docker *runc* runtime. Clear Linux provides easy integration of the *kata-runtime* with Docker. -More information on installing and using the *kata-runtime* can be found at :ref:`kata` +More information on installing and using the *kata-runtime* may be found at :ref:`kata`. .. note:: @@ -137,7 +137,7 @@ an the official Docker image for nginx, an open source reverse proxy server. .. note:: - Below is an explaination of switches used in the command above. For + Below is an explanation of switches used in the command above. For detailed :command:`docker run` switches and syntax, refer to the `Docker Documentation`_ . @@ -166,12 +166,12 @@ an the official Docker image for nginx, an open source reverse proxy server. sudo docker rm test-nginx Congratulations! At this point, you have successfully pulled a nginx -container image from `Docker Hub`_ and ran an example container. +container image from `Docker Hub`_ and have run an example container. Creating a Docker swarm cluster ******************************* -Clusters of Docker hosts are referred to as swarms. +Clusters of Docker hosts are referred to as *swarms*. The process in this tutorial can be repeated to install Docker on multiple Clear Linux hosts with the intent to form a Docker swarm cluster. @@ -187,16 +187,28 @@ Also see: * `Docker Hub`_ * `Kata Containers`_ -.. _`unique features`: https://clearlinux.org/features -.. _`Clear Linux image on Docker Hub`: https://hub.docker.com/_/clearlinux/ -.. _`building a custom Clear Linux docker image`: https://clearlinux.org/documentation/clear-linux/guides/network/custom-clear-container -.. _`Docker proxy instructions`: https://docs.docker.com/config/daemon/systemd/#httphttps-proxy -.. _`bundles`: https://clearlinux.org/documentation/clear-linux/concepts/bundles-about#related-concepts -.. _`stateless system`: https://clearlinux.org/features/stateless -.. _`Docker documentation on daemon configuration`: https://docs.docker.com/engine/reference/commandline/dockerd/#daemon-configuration-file -.. _`Kata Containers`: https://katacontainers.io/ -.. _`Docker Home`: https://www.docker.com/ -.. _`Docker Documentation`: https://docs.docker.com/ -.. _`Docker Hub`: https://hub.docker.com/ -.. _`Docker documentation on swarm key concepts`: https://docs.docker.com/engine/swarm/key-concepts/ -.. _`Docker documentation on creating a swarm`: https://docs.docker.com/engine/swarm/swarm-tutorial/create-swarm/ +.. _unique features: https://clearlinux.org/features + +.. _Clear Linux image on Docker Hub: https://hub.docker.com/_/clearlinux/ + +.. _building a custom Clear Linux docker image: https://clearlinux.org/documentation/clear-linux/guides/network/custom-clear-container + +.. _Docker proxy instructions: https://docs.docker.com/config/daemon/systemd/#httphttps-proxy + +.. _bundles: https://clearlinux.org/documentation/clear-linux/concepts/bundles-about#related-concepts + +.. _stateless system: https://clearlinux.org/features/stateless + +.. _Docker documentation on daemon configuration: https://docs.docker.com/engine/reference/commandline/dockerd/#daemon-configuration-file + +.. _Kata Containers: https://katacontainers.io/ + +.. _Docker Home: https://www.docker.com/ + +.. _Docker Documentation: https://docs.docker.com/ + +.. _Docker Hub: https://hub.docker.com/ + +.. _Docker documentation on swarm key concepts: https://docs.docker.com/engine/swarm/key-concepts/ + +.. _Docker documentation on creating a swarm: https://docs.docker.com/engine/swarm/swarm-tutorial/create-swarm/ From 3e8a8889a7d3fa02fb145ce034010ad0c7d60ace Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Tue, 17 Jul 2018 12:11:18 -0700 Subject: [PATCH 59/76] fix to make sure ms azure changes are visible in final rendered site --- source/clear-linux/tutorials/{azure => }/azure.rst | 0 source/clear-linux/tutorials/tutorials.rst | 2 +- 2 files changed, 1 insertion(+), 1 deletion(-) rename source/clear-linux/tutorials/{azure => }/azure.rst (100%) diff --git a/source/clear-linux/tutorials/azure/azure.rst b/source/clear-linux/tutorials/azure.rst similarity index 100% rename from source/clear-linux/tutorials/azure/azure.rst rename to source/clear-linux/tutorials/azure.rst diff --git a/source/clear-linux/tutorials/tutorials.rst b/source/clear-linux/tutorials/tutorials.rst index ad9a89fe..9bc120ad 100644 --- a/source/clear-linux/tutorials/tutorials.rst +++ b/source/clear-linux/tutorials/tutorials.rst @@ -13,7 +13,7 @@ specific |CLOSIA| use cases. flatpak/flatpak machine-learning/machine-learning docker/docker - azure/azure + azure multi-boot/multi-boot hadoop fmv From e056361c6efc777277421efd6b5245b46c58fa9b Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Tue, 17 Jul 2018 12:15:34 -0700 Subject: [PATCH 60/76] fixed figure links --- source/clear-linux/tutorials/azure.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/clear-linux/tutorials/azure.rst b/source/clear-linux/tutorials/azure.rst index be19af9c..168fbcfd 100644 --- a/source/clear-linux/tutorials/azure.rst +++ b/source/clear-linux/tutorials/azure.rst @@ -269,7 +269,7 @@ Log into your Microsoft Azure account #. Open your browser and enter the page `https://aka.ms/devicelogin` as shown in figure 1: - .. figure:: figures/azure-1.png + .. figure:: azure/figures/azure-1.png :scale: 50 % :alt: Microsoft Device Login @@ -280,7 +280,7 @@ Log into your Microsoft Azure account session login and will be different each time you log into MS Azure using the :command:`az login` command. - .. figure:: figures/azure-2.png + .. figure:: azure/figures/azure-2.png :scale: 50 % :alt: Microsoft Device Login - Azure CLI @@ -294,7 +294,7 @@ Log into your Microsoft Azure account have signed into the Microsoft Cross-platform Command Line Interface application on your device and you can close the window. - .. figure:: figures/azure-3.png + .. figure:: azure/figures/azure-3.png :scale: 50 % :alt: Microsoft Azure Cross-platform CLI From 32d44093f783aad39979675109f9cd3d10efb1f5 Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Tue, 17 Jul 2018 17:40:35 -0700 Subject: [PATCH 61/76] Replaces hash with asterisk below 'More information about Docker in |CLOSIA|' - If hash is used, there are two 'titles' rendered in webpage left menu Signed-off-by: Michael Vincerra --- source/clear-linux/tutorials/kata.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/clear-linux/tutorials/kata.rst b/source/clear-linux/tutorials/kata.rst index 0bb6d589..24b782e1 100644 --- a/source/clear-linux/tutorials/kata.rst +++ b/source/clear-linux/tutorials/kata.rst @@ -83,8 +83,8 @@ Run Kata Containers You have successfully installed and set up Kata Containers on |CLOSIA|. -More information about Docker in |CLOSIA|. -############################################# +More information about Docker in |CLOSIA| +***************************************** Docker on |CLOSIA| provides a docker.service service file to start the Docker daemon. The daemon will use runc or kata-runtime depending on From 1b55b0d487a0684484d65ebe29117c3a6d4276e6 Mon Sep 17 00:00:00 2001 From: MCamp859 Date: Thu, 19 Jul 2018 15:31:14 -0400 Subject: [PATCH 62/76] Add telemetry concept to CL docs. Update related telemetry rst files to add links. Signed-off-by: MCamp859 --- source/clear-linux/concepts/concepts.rst | 1 + .../telemetry-about/telemetry-about-1.png | Bin 0 -> 60310 bytes .../clear-linux/concepts/telemetry-about.rst | 76 ++++++++++++++++++ .../guides/maintenance/telemetry-enable.rst | 14 ++-- .../telemetry-backend/telemetry-backend.rst | 13 +-- 5 files changed, 94 insertions(+), 10 deletions(-) create mode 100644 source/clear-linux/concepts/figures/telemetry-about/telemetry-about-1.png create mode 100644 source/clear-linux/concepts/telemetry-about.rst diff --git a/source/clear-linux/concepts/concepts.rst b/source/clear-linux/concepts/concepts.rst index dbb4b680..496e31e5 100644 --- a/source/clear-linux/concepts/concepts.rst +++ b/source/clear-linux/concepts/concepts.rst @@ -15,3 +15,4 @@ details relevant to the |CL| features. bundles-about autospec-about restart + telemetry-about diff --git a/source/clear-linux/concepts/figures/telemetry-about/telemetry-about-1.png b/source/clear-linux/concepts/figures/telemetry-about/telemetry-about-1.png new file mode 100644 index 0000000000000000000000000000000000000000..37463254b8f349da18c6d67f2c7f5ee72fecb1cd GIT binary patch literal 60310 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 literal 0 HcmV?d00001 diff --git a/source/clear-linux/concepts/telemetry-about.rst b/source/clear-linux/concepts/telemetry-about.rst new file mode 100644 index 00000000..261cf216 --- /dev/null +++ b/source/clear-linux/concepts/telemetry-about.rst @@ -0,0 +1,76 @@ +.. _telemetry-about: + +Telemetrics +########### + +Telemetry is one of the key features of |CLOSIA|. The |CL| team is focused on +the quality of the telemetry data, and is moving from issues that are detected +and reported by users to issues detected and repaired by providers. Ideally, +these issues will be undetected by users. + +On the |CL| team, we refer to *telemetrics*, which is a combination word made from: + +* Telemetry which is sensing and reporting data. +* Analytics which is using visualization and statistical inferencing to make + sense of the reported data. + +|CL| telemetry reports system-level debug/crash information using specialized probes. The +probes monitor system tasks such as :abbr:`swupd (software updater)`, kernel +oops, machine error checks, and BIOS error report table for unhandled hardware +failures. Telemetry enables real-time issue reporting to allow system +developers to quickly focus on an issue and monitor corrective actions. + +|CL| telemetry is fully customizable and can be used during software development +for debugging purposes. You can use libtelemetry in your code to create custom +telemetry records. You can also use telem-record-gen in script files or call +it from another program. + +Architecture +************ + +|CL| telemetry has two fundamental components, which are shown in figure 1: + +* Client: generates and delivers records to the backend server via the network. +* Backend: captures records sent from the client and displays the cumulative + content through a specialized interface. + +Note: To capture records for analysis, you must set up your own backend server. + +.. figure:: figures/telemetry-about-1.png + :scale: 75% + :alt: Clear Linux Telemetry Architecture. + + Figure 1: Clear Linux Telemetry Architecture. + +The telemetry client provides the front end of a complete telemetrics solution +and includes the following components: + +* telemd, a daemon that prepares the records to send to a telemetrics server or + spools the records on disk in case it cannot successfully deliver them. +* Probes that collect specific types of data from the operating system. +* libtelemetry, that telemetrics probes use to create telemetrics records and + send them to the telemd daemon for further processing. + +The telemetry backend provides the server-side component of a complete telemetrics solution and +consists of: + +* Nginx web server. +* Two Flask apps: + + * Collector, an ingestion web app for records received from telemetrics-client probes. + * TelemetryUI, a web app that exposes several views to visualize the telemetry data + and also provides a REST API to perform queries. + +* PostgreSQL as the underlying database server. + +Next steps +********** + +To put this concept into practice, see the following resources: + +* :ref:`Enable and disable telemetry in Clear Linux` +* :ref:`Create a telemetry backend server in Clear Linux` +* `Telemetry feature description`_ + +.. _`Telemetry feature description: + `https://clearlinux.org/features/telemetry diff --git a/source/clear-linux/guides/maintenance/telemetry-enable.rst b/source/clear-linux/guides/maintenance/telemetry-enable.rst index 3f6ed348..1505b2b0 100644 --- a/source/clear-linux/guides/maintenance/telemetry-enable.rst +++ b/source/clear-linux/guides/maintenance/telemetry-enable.rst @@ -9,7 +9,7 @@ daemon, :command:`telemd`. This functionality is maintained in the ``telemetrics`` software bundle. .. note:: - The telemetry functionality adheres to `Intel's privacy policies`_ + The telemetry functionality adheres to `Intel privacy policies`_ regarding the collection and use of :abbr:`PII (Personally Identifiable Information)` and is open source. Specifically, no intentionally identifiable information about the user or system owner is collected. @@ -104,9 +104,13 @@ To completely remove telemetrics from your system, use the command Additional resources ******************** -https://clearlinux.org/features/telemetry +* `Telemetry feature description`_ +* :ref:`Telemetry architecture` +* :ref:`Create a telemetry backend server in Clear Linux` +* https://github.com/clearlinux/telemetrics-client -https://github.com/clearlinux/telemetrics-client - -.. _`Intel's privacy policies`: +.. _`Intel privacy policies`: https://www.intel.com/content/www/us/en/privacy/intel-privacy-notice.html + +.. _`Telemetry feature description: + `https://clearlinux.org/features/telemetry diff --git a/source/clear-linux/tutorials/telemetry-backend/telemetry-backend.rst b/source/clear-linux/tutorials/telemetry-backend/telemetry-backend.rst index b932f444..9d1ac866 100644 --- a/source/clear-linux/tutorials/telemetry-backend/telemetry-backend.rst +++ b/source/clear-linux/tutorials/telemetry-backend/telemetry-backend.rst @@ -462,14 +462,17 @@ it. Additional resources ******************** -https://clearlinux.org/features/telemetry - -https://github.com/clearlinux/telemetrics-client - -https://github.com/clearlinux/telemetrics-backend +* `Telemetry feature description`_ +* :ref:`Telemetry architecture` +* :ref:`Enable and disable telemetry in Clear Linux` +* https://github.com/clearlinux/telemetrics-client +* https://github.com/clearlinux/telemetrics-backend .. _`Clear Linux telemetry backend server overview`: https://github.com/clearlinux/telemetrics-backend .. _`Intel privacy policies`: https://www.intel.com/content/www/us/en/privacy/intel-privacy-notice.html + +.. _`Telemetry feature description: + `https://clearlinux.org/features/telemetry From 1384891b3e9f6bff40b856e526a7892f988ddd4f Mon Sep 17 00:00:00 2001 From: mvincerx <37549381+mvincerx@users.noreply.github.com> Date: Mon, 23 Jul 2018 16:02:15 -0700 Subject: [PATCH 63/76] Create guides_feedback Submitted to organize new requests into 3 categories as result of recommended changes from Gap Analysis for Clear Linux Documentation 'Guides'. --- guides_feedback | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 guides_feedback diff --git a/guides_feedback b/guides_feedback new file mode 100644 index 00000000..08ef7692 --- /dev/null +++ b/guides_feedback @@ -0,0 +1,12 @@ +1. Review existing 'guides' page: https://clearlinux.org/documentation/clear-linux/guides + +2. If you wish to add new content, use one of the following categories. Fill in the phrase after the colon, +based on the role to which the task applies. + +I am a Clear Linux Beginner, and I want to learn how to: + +I am a Clear Linux Developer, and I want to learn how to: + +I am a Clear Linux Administrator, and I want to learn how to: + + From a1b765beddb31193a32e78609291770ddc18170e Mon Sep 17 00:00:00 2001 From: mvincerx <37549381+mvincerx@users.noreply.github.com> Date: Mon, 23 Jul 2018 16:18:16 -0700 Subject: [PATCH 64/76] Add issue workflow to categorize new guides into 3 categories - Basics; Developer; and Administrator. - Result of Gap Analysis - Github user: mvincerx --- .../identify--guides--option-by-user-role.md | 20 +++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 .github/ISSUE_TEMPLATE/identify--guides--option-by-user-role.md diff --git a/.github/ISSUE_TEMPLATE/identify--guides--option-by-user-role.md b/.github/ISSUE_TEMPLATE/identify--guides--option-by-user-role.md new file mode 100644 index 00000000..55e6d2ab --- /dev/null +++ b/.github/ISSUE_TEMPLATE/identify--guides--option-by-user-role.md @@ -0,0 +1,20 @@ +--- +name: Identify 'Guides' Option by User Role +about: For new content proposed to 'Guides', select the category to which it belongs + based on 3 options. + +--- + +New pages will appear here: https://clearlinux.org/documentation/clear-linux/guides + +[ ] Basics +[ ] Developer +[ ] Administrator + +Complete the field below, after the colon, that matches the option selected above: + +I am a Clear Linux Beginner (Basics). I want to learn how to: + +I am a Clear Linux Developer. I want to learn how to: + +I am a Clear Linux Administrator. I want to learn how to: From 0b08cf0cb0d32e8113533332609bad69ce35cf14 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Mon, 23 Jul 2018 16:25:15 -0700 Subject: [PATCH 65/76] first 23 fixes to remove warnings from build - down to 75 warnings --- .../cgdisk-manual-install.rst | 4 ++-- .../bootable-usb/bootable-usb-linux.rst | 4 ++-- .../bootable-usb/bootable-usb-mac.rst | 4 ++-- .../bootable-usb/bootable-usb-windows.rst | 4 ++-- ...download-verify-uncompress-windows-fig-1.png | Bin 0 -> 44787 bytes .../vmw-player-preconf.rst | 2 +- .../virtual-machine-install/vmw-player.rst | 2 +- .../vmware-esxi-preconfigured-cl-image.rst | 2 +- .../download-verify-uncompress-linux.rst | 2 +- .../download-verify-uncompress-mac.rst | 2 +- .../download-verify-uncompress-windows.rst | 2 +- .../maintenance/increase-virtual-disk-size.rst | 4 ++-- .../guides/maintenance/maintenance.rst | 1 - .../guides/maintenance/swupd-guide.rst | 1 + source/clear-linux/guides/network/vnc.rst | 4 ++-- .../collaboration/documentation/contents.rst | 2 +- .../collaboration/documentation/tables.rst | 2 +- .../reference/compatible-kernels.rst | 2 +- source/clear-linux/reference/image-types.rst | 2 +- .../clear-linux/tutorials/aws-web/aws-web.rst | 4 +++- source/clear-linux/tutorials/kata.rst | 2 +- 21 files changed, 27 insertions(+), 25 deletions(-) create mode 100644 source/clear-linux/get-started/virtual-machine-install/figures/download-verify-uncompress-windows-fig-1.png diff --git a/source/clear-linux/get-started/bare-metal-install/cgdisk-manual-install.rst b/source/clear-linux/get-started/bare-metal-install/cgdisk-manual-install.rst index f646defa..0c5eb624 100755 --- a/source/clear-linux/get-started/bare-metal-install/cgdisk-manual-install.rst +++ b/source/clear-linux/get-started/bare-metal-install/cgdisk-manual-install.rst @@ -1,7 +1,7 @@ .. _cgdisk-manual-install: Create partitions for Clear Linux\* using CGDISK -############################################### +################################################ As part of the |CL| manual installation processThese instructions guide you through the initial setup of your hard drive partitions using the :command:`cgdisk` utility . If you do not wish to continue creating your own @@ -291,4 +291,4 @@ partitions and select to format them. https://clearlinux.org/features/software-update .. _`Linux partitioning scheme`: - https://wiki.archlinux.org/index.php/partitioning#Partition_scheme \ No newline at end of file + https://wiki.archlinux.org/index.php/partitioning#Partition_scheme diff --git a/source/clear-linux/get-started/bootable-usb/bootable-usb-linux.rst b/source/clear-linux/get-started/bootable-usb/bootable-usb-linux.rst index 76a551c5..392f2427 100644 --- a/source/clear-linux/get-started/bootable-usb/bootable-usb-linux.rst +++ b/source/clear-linux/get-started/bootable-usb/bootable-usb-linux.rst @@ -13,9 +13,9 @@ Instructions are also available for other operating systems: * :ref:`bootable-usb-mac` * :ref:`bootable-usb-windows` -.. include:: ../../guides/maintenance/image-types.rst +.. include:: ../../reference/image-types.rst :start-after: for different platforms and environments. - :end-before: Table 1 lists the currently available images. + :end-before: Table 1 lists the currently available images .. include:: ../../guides/maintenance/download-verify-uncompress-linux.rst :Start-after: verify-linux: diff --git a/source/clear-linux/get-started/bootable-usb/bootable-usb-mac.rst b/source/clear-linux/get-started/bootable-usb/bootable-usb-mac.rst index 29ebe375..fd56c0e3 100644 --- a/source/clear-linux/get-started/bootable-usb/bootable-usb-mac.rst +++ b/source/clear-linux/get-started/bootable-usb/bootable-usb-mac.rst @@ -13,9 +13,9 @@ Instructions are also available for other operating systems: * :ref:`bootable-usb-linux` * :ref:`bootable-usb-windows` -.. include:: ../../guides/maintenance/image-types.rst +.. include:: ../../reference/image-types.rst :start-after: for different platforms and environments. - :end-before: Table 1 lists the currently available images. + :end-before: Table 1 lists the currently available images .. include:: ../../guides/maintenance/download-verify-uncompress-mac.rst :start-after: verify-mac: diff --git a/source/clear-linux/get-started/bootable-usb/bootable-usb-windows.rst b/source/clear-linux/get-started/bootable-usb/bootable-usb-windows.rst index 424c7ebb..6d99d405 100644 --- a/source/clear-linux/get-started/bootable-usb/bootable-usb-windows.rst +++ b/source/clear-linux/get-started/bootable-usb/bootable-usb-windows.rst @@ -13,9 +13,9 @@ Instructions are also available for other operating systems: * :ref:`bootable-usb-mac` * :ref:`bootable-usb-linux` -.. include:: ../../guides/maintenance/image-types.rst +.. include:: ../../reference/image-types.rst :start-after: for different platforms and environments. - :end-before: Table 1 lists the currently available images. + :end-before: Table 1 lists the currently available images .. include:: ../../guides/maintenance/download-verify-uncompress-windows.rst :Start-after: verify-windows: diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/download-verify-uncompress-windows-fig-1.png b/source/clear-linux/get-started/virtual-machine-install/figures/download-verify-uncompress-windows-fig-1.png new file mode 100644 index 0000000000000000000000000000000000000000..0b0ee7f60ec620754f16d3f38b9c582203ac3bca GIT binary patch literal 44787 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 literal 0 HcmV?d00001 diff --git a/source/clear-linux/get-started/virtual-machine-install/vmw-player-preconf.rst b/source/clear-linux/get-started/virtual-machine-install/vmw-player-preconf.rst index 96819b32..d090222b 100644 --- a/source/clear-linux/get-started/virtual-machine-install/vmw-player-preconf.rst +++ b/source/clear-linux/get-started/virtual-machine-install/vmw-player-preconf.rst @@ -64,7 +64,7 @@ For additional help, see the `VMware Workstation Player guide`_. Clear Linux image types *********************** -.. include:: ../../guides/maintenance/image-types.rst +.. include:: ../../reference/image-types.rst :Start-after: image-types-content: Download the latest Clear Linux VMware image diff --git a/source/clear-linux/get-started/virtual-machine-install/vmw-player.rst b/source/clear-linux/get-started/virtual-machine-install/vmw-player.rst index 5bd5afcd..06dc38ee 100644 --- a/source/clear-linux/get-started/virtual-machine-install/vmw-player.rst +++ b/source/clear-linux/get-started/virtual-machine-install/vmw-player.rst @@ -74,7 +74,7 @@ For additional help, see the `VMware Workstation Player guide`_. Clear Linux image types *********************** -.. include:: ../../guides/maintenance/image-types.rst +.. include:: ../../reference/image-types.rst :Start-after: image-types-content: diff --git a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst index 23751b7d..e9f35d57 100644 --- a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst +++ b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst @@ -1,7 +1,7 @@ .. _vmware-esxi-preconfigured-cl-image: Run preconfigured Clear Linux\* image as a VMware\* ESXi guest OS -############################################################### +################################################################# `VMware ESXi`_ is a type 1 bare-metal hypervisor which runs directly on top of server hardware. With VMware ESXi, you can create, configure, manage, diff --git a/source/clear-linux/guides/maintenance/download-verify-uncompress-linux.rst b/source/clear-linux/guides/maintenance/download-verify-uncompress-linux.rst index 95cb27bd..e90c0170 100644 --- a/source/clear-linux/guides/maintenance/download-verify-uncompress-linux.rst +++ b/source/clear-linux/guides/maintenance/download-verify-uncompress-linux.rst @@ -14,7 +14,7 @@ Instructions for other operating systems are available: Image types *********** -.. include:: image-types.rst +.. include:: ../../reference/image-types.rst :start-after: image-types-content: .. _verify-linux: diff --git a/source/clear-linux/guides/maintenance/download-verify-uncompress-mac.rst b/source/clear-linux/guides/maintenance/download-verify-uncompress-mac.rst index d37346ef..d94be7b6 100644 --- a/source/clear-linux/guides/maintenance/download-verify-uncompress-mac.rst +++ b/source/clear-linux/guides/maintenance/download-verify-uncompress-mac.rst @@ -14,7 +14,7 @@ Instructions for other operating systems are available: Image types *********** -.. include:: image-types.rst +.. include:: ../../reference/image-types.rst :start-after: image-types-content: .. _verify-mac: diff --git a/source/clear-linux/guides/maintenance/download-verify-uncompress-windows.rst b/source/clear-linux/guides/maintenance/download-verify-uncompress-windows.rst index 24d7c7fa..03b892fb 100644 --- a/source/clear-linux/guides/maintenance/download-verify-uncompress-windows.rst +++ b/source/clear-linux/guides/maintenance/download-verify-uncompress-windows.rst @@ -14,7 +14,7 @@ Instructions for other operating systems are available: Image types *********** -.. include:: image-types.rst +.. include:: ../../reference/image-types.rst :start-after: image-types-content: .. _verify-windows: diff --git a/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst b/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst index 0436d965..a676e615 100644 --- a/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst +++ b/source/clear-linux/guides/maintenance/increase-virtual-disk-size.rst @@ -1,7 +1,7 @@ .. _increase-virtual-disk-size: Increase virtual disk size of a Clear Linux\* image -################################################# +################################################### |CLOSIA| prebuilt images come in different sizes, ranging from 300 MB to 20 GB. This guide describes how to increase the size of your prebuilt |CL| image @@ -10,7 +10,7 @@ if you need more capacity. .. contents:: This guide will cover: Determine the partition order and sizes of the prebuilt image -*************************************************** +************************************************************* There are two methods to find the order and sizes of partitions virtual disk of your prebuilt |CL| image. diff --git a/source/clear-linux/guides/maintenance/maintenance.rst b/source/clear-linux/guides/maintenance/maintenance.rst index 1f6209c1..b65cadbe 100644 --- a/source/clear-linux/guides/maintenance/maintenance.rst +++ b/source/clear-linux/guides/maintenance/maintenance.rst @@ -21,5 +21,4 @@ maintaining |CLOSIA| after :ref:`installation ` is completed. download-verify-uncompress-linux download-verify-uncompress-mac download-verify-uncompress-windows - image-types autospec diff --git a/source/clear-linux/guides/maintenance/swupd-guide.rst b/source/clear-linux/guides/maintenance/swupd-guide.rst index 23726f4d..db385152 100644 --- a/source/clear-linux/guides/maintenance/swupd-guide.rst +++ b/source/clear-linux/guides/maintenance/swupd-guide.rst @@ -46,6 +46,7 @@ Current OS version and update server info: swupd info .. code-block:: console + Installed version: 23330 Version URL: https://download.clearlinux.org/update/ Content URL: https://cdn.download.clearlinux.org/update/ diff --git a/source/clear-linux/guides/network/vnc.rst b/source/clear-linux/guides/network/vnc.rst index e2f1e21d..8de6f3ef 100644 --- a/source/clear-linux/guides/network/vnc.rst +++ b/source/clear-linux/guides/network/vnc.rst @@ -674,12 +674,12 @@ For `Method 3`: Figure 7 shows two VNC sessions (5901 and 5905) accepting connections from any host as specified by the `0.0.0.0`'s. This is before the `-localhost` option was used. - + .. figure:: figures/vnc/vnc-7.png :scale: 100 % :alt: VNC session accepting connection from any host - Figure 7: VNC sessions (5901 and 5905) accepting connections from any host + Figure 7: VNC sessions (5901 and 5905) accepting connections from any host Figure 8 shows two VNC sessions (5901 and 5905) only accepting connections from localhost as specified by `127.0.0.1`'s. This is after the `-localhost` option was used. diff --git a/source/clear-linux/reference/collaboration/documentation/contents.rst b/source/clear-linux/reference/collaboration/documentation/contents.rst index 6b4f043f..e88c4d7c 100644 --- a/source/clear-linux/reference/collaboration/documentation/contents.rst +++ b/source/clear-linux/reference/collaboration/documentation/contents.rst @@ -28,7 +28,7 @@ Clear Linux Guide Example ************************* Introduction -========= +============ Step-by-Step ============ diff --git a/source/clear-linux/reference/collaboration/documentation/tables.rst b/source/clear-linux/reference/collaboration/documentation/tables.rst index 3ad59298..29d0b2c2 100644 --- a/source/clear-linux/reference/collaboration/documentation/tables.rst +++ b/source/clear-linux/reference/collaboration/documentation/tables.rst @@ -18,7 +18,7 @@ Follow these general guidelines: it is not rendered. * Only create a table if the body of the table contains six or more cells, -which is a minimum table size of at least 2x3 or 3x2. + which is a minimum table size of at least 2x3 or 3x2. ReST supports several types of tables. |CL| uses grid and :abbr:`CSV-tables (Comma Separated Values tables)`. Grid tables are only diff --git a/source/clear-linux/reference/compatible-kernels.rst b/source/clear-linux/reference/compatible-kernels.rst index ab1303fb..72c6072e 100644 --- a/source/clear-linux/reference/compatible-kernels.rst +++ b/source/clear-linux/reference/compatible-kernels.rst @@ -1,7 +1,7 @@ .. _compatible-kernels: Compatible Clear Linux\* kernels -############################## +################################ The |CLOSIA| provides the following Linux kernels with a respective bundle. This document describes the specific use cases these `bundles`_ serve diff --git a/source/clear-linux/reference/image-types.rst b/source/clear-linux/reference/image-types.rst index 25d375ef..691b01a1 100644 --- a/source/clear-linux/reference/image-types.rst +++ b/source/clear-linux/reference/image-types.rst @@ -1,7 +1,7 @@ .. _image-types: Clear Linux\* image types -####################### +######################### .. _image-types-content: diff --git a/source/clear-linux/tutorials/aws-web/aws-web.rst b/source/clear-linux/tutorials/aws-web/aws-web.rst index 8c433212..25b9b1af 100644 --- a/source/clear-linux/tutorials/aws-web/aws-web.rst +++ b/source/clear-linux/tutorials/aws-web/aws-web.rst @@ -18,9 +18,11 @@ Prerequisites ************* This tutorial assumes the following statements are true: + * You are using a linux-based system to access AWS and can run :command:`SSH` to access the remote |CL| AWS image. -* Your browser puts downloaded files in the :file:`$HOME/Downloads` directory. +* Your browser puts downloaded files in the :file:`$HOME/Downloads` + directory. * You have already set up an AWS user account and logged into the AWS console. diff --git a/source/clear-linux/tutorials/kata.rst b/source/clear-linux/tutorials/kata.rst index 24b782e1..1c6ef20b 100644 --- a/source/clear-linux/tutorials/kata.rst +++ b/source/clear-linux/tutorials/kata.rst @@ -1,7 +1,7 @@ .. _kata: Install Kata Containers\* -####################### +######################### This tutorial describes how to install, configure and run Kata Containers\* on |CLOSIA|. Kata Containers is an open source project dedicated to the From e06981e4cfd21b00ac589390a24e7210f652cf6f Mon Sep 17 00:00:00 2001 From: mvincerx <37549381+mvincerx@users.noreply.github.com> Date: Mon, 23 Jul 2018 16:26:42 -0700 Subject: [PATCH 66/76] Update issue templates --- .../identify--guides--option-by-user-role.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/identify--guides--option-by-user-role.md b/.github/ISSUE_TEMPLATE/identify--guides--option-by-user-role.md index 55e6d2ab..4e366d66 100644 --- a/.github/ISSUE_TEMPLATE/identify--guides--option-by-user-role.md +++ b/.github/ISSUE_TEMPLATE/identify--guides--option-by-user-role.md @@ -7,11 +7,12 @@ about: For new content proposed to 'Guides', select the category to which it bel New pages will appear here: https://clearlinux.org/documentation/clear-linux/guides -[ ] Basics -[ ] Developer -[ ] Administrator +1. Enter an 'x' in the category for the new "guide": +* [ ] Basics +* [ ] Developer +* [ ] Administrator -Complete the field below, after the colon, that matches the option selected above: +Complete the field below, following the colon, that matches option selected above: I am a Clear Linux Beginner (Basics). I want to learn how to: From 00b6ca1c4fe1b7810cf9bcbb036394a907f0d0f0 Mon Sep 17 00:00:00 2001 From: mvincerx <37549381+mvincerx@users.noreply.github.com> Date: Mon, 23 Jul 2018 16:29:06 -0700 Subject: [PATCH 67/76] Update issue templates --- ...uides--type-by-role----for-guides-only-.md | 20 +++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 .github/ISSUE_TEMPLATE/identify--guides--type-by-role----for-guides-only-.md diff --git a/.github/ISSUE_TEMPLATE/identify--guides--type-by-role----for-guides-only-.md b/.github/ISSUE_TEMPLATE/identify--guides--type-by-role----for-guides-only-.md new file mode 100644 index 00000000..21b9c68a --- /dev/null +++ b/.github/ISSUE_TEMPLATE/identify--guides--type-by-role----for-guides-only-.md @@ -0,0 +1,20 @@ +--- +name: Identify 'Guides' Type by Role -- For Guides only. +about: For new content in 'Guides', select 1 category to which it belongs. + +--- + +New pages will appear here: https://clearlinux.org/documentation/clear-linux/guides + +1. Enter an 'x' in the category for the new "guide": +* [ ] Basics +* [ ] Developer +* [ ] Administrator + +Complete the field below, following the colon, that matches option selected above: + +I am a Clear Linux Beginner (Basics). I want to learn how to: + +I am a Clear Linux Developer. I want to learn how to: + +I am a Clear Linux Administrator. I want to learn how to: From 8ecd89265a53ce046bbd826dad2ca54b2f1e0b20 Mon Sep 17 00:00:00 2001 From: mvincerx <37549381+mvincerx@users.noreply.github.com> Date: Mon, 23 Jul 2018 16:32:34 -0700 Subject: [PATCH 68/76] Update issue templates --- .../identify--guides--option-by-user-role.md | 21 ------------------- 1 file changed, 21 deletions(-) delete mode 100644 .github/ISSUE_TEMPLATE/identify--guides--option-by-user-role.md diff --git a/.github/ISSUE_TEMPLATE/identify--guides--option-by-user-role.md b/.github/ISSUE_TEMPLATE/identify--guides--option-by-user-role.md deleted file mode 100644 index 4e366d66..00000000 --- a/.github/ISSUE_TEMPLATE/identify--guides--option-by-user-role.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -name: Identify 'Guides' Option by User Role -about: For new content proposed to 'Guides', select the category to which it belongs - based on 3 options. - ---- - -New pages will appear here: https://clearlinux.org/documentation/clear-linux/guides - -1. Enter an 'x' in the category for the new "guide": -* [ ] Basics -* [ ] Developer -* [ ] Administrator - -Complete the field below, following the colon, that matches option selected above: - -I am a Clear Linux Beginner (Basics). I want to learn how to: - -I am a Clear Linux Developer. I want to learn how to: - -I am a Clear Linux Administrator. I want to learn how to: From 217ac48b47a4ecfe39f9e59500af279fcd561c05 Mon Sep 17 00:00:00 2001 From: mvincerx <37549381+mvincerx@users.noreply.github.com> Date: Mon, 23 Jul 2018 16:34:00 -0700 Subject: [PATCH 69/76] Update issue templates --- .../identify--guides--type-by-role----for-guides-only-.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/identify--guides--type-by-role----for-guides-only-.md b/.github/ISSUE_TEMPLATE/identify--guides--type-by-role----for-guides-only-.md index 21b9c68a..fb6e16a1 100644 --- a/.github/ISSUE_TEMPLATE/identify--guides--type-by-role----for-guides-only-.md +++ b/.github/ISSUE_TEMPLATE/identify--guides--type-by-role----for-guides-only-.md @@ -1,6 +1,6 @@ --- name: Identify 'Guides' Type by Role -- For Guides only. -about: For new content in 'Guides', select 1 category to which it belongs. +about: For new content in 'Guides', select 1 of 3 categories to which it belongs. --- From cbea9d3f4da98d488199d3c94da1450c1f9151fb Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Mon, 23 Jul 2018 16:52:02 -0700 Subject: [PATCH 70/76] up to 27 fixes and down to 68 warnings --- source/clear-linux/tutorials/multi-boot/multi-boot.rst | 6 +++--- source/clear-linux/tutorials/spark.rst | 8 ++++---- .../tutorials/telemetry-backend/telemetry-backend.rst | 8 +++++--- .../tutorials/web-server-install/web-server-install.rst | 2 +- source/clear-linux/tutorials/wp-install/wp-install.rst | 2 +- 5 files changed, 14 insertions(+), 12 deletions(-) diff --git a/source/clear-linux/tutorials/multi-boot/multi-boot.rst b/source/clear-linux/tutorials/multi-boot/multi-boot.rst index 4b71762e..7c0e49d1 100644 --- a/source/clear-linux/tutorials/multi-boot/multi-boot.rst +++ b/source/clear-linux/tutorials/multi-boot/multi-boot.rst @@ -73,9 +73,9 @@ Table notes: .. [#] The EFI partition holds the kernel and boot information for |CL| and - other operating systems. The partition size is dependent on the number - of operating systems to be installed. In general, allocate about 100 MB per - operating system. For this tutorial, we used 1 GB. + other operating systems. The partition size is dependent on the number + of operating systems to be installed. In general, allocate about 100 MB + per operating system. For this tutorial, we used 1 GB. diff --git a/source/clear-linux/tutorials/spark.rst b/source/clear-linux/tutorials/spark.rst index 7941de1d..5b02cb9a 100644 --- a/source/clear-linux/tutorials/spark.rst +++ b/source/clear-linux/tutorials/spark.rst @@ -72,7 +72,7 @@ Configure Apache Spark with your localhost IP address. View your IP address using the :command:`hostname -I` command. - .. code-block:: + .. code-block:: bash SPARK_MASTER_HOST="10.300.200.100" @@ -82,7 +82,7 @@ Configure Apache Spark #. Edit the :file:`/etc/spark/spark-defaults.conf` file and update the `spark.master` variable with the `SPARK_MASTER_HOST` address and port `7077`. - .. code-block:: + .. code-block:: bash spark.master spark://10.300.200.100:7077 @@ -105,7 +105,7 @@ Start the master server and a worker daemon #. Open an internet browser and view the worker daemon information using the master's IP address and port `8080`: - .. code-block:: + .. code-block:: bash http://10.300.200.100:8080 @@ -122,7 +122,7 @@ Run the Spark wordcount example #. Open an internet browser and view the application information using the master's IP address and port `8080`: - .. code-block:: + .. code-block:: bash http://10.300.200.100:8080 diff --git a/source/clear-linux/tutorials/telemetry-backend/telemetry-backend.rst b/source/clear-linux/tutorials/telemetry-backend/telemetry-backend.rst index b932f444..a11c2474 100644 --- a/source/clear-linux/tutorials/telemetry-backend/telemetry-backend.rst +++ b/source/clear-linux/tutorials/telemetry-backend/telemetry-backend.rst @@ -67,6 +67,7 @@ to clone the :guilabel:`telemetrics-backend` repository into the git clone https://github.com/clearlinux/telemetrics-backend .. note:: + You may need to set up the :envvar:`https_proxy` environment variable if you have issues reaching github.com. @@ -109,10 +110,11 @@ following actions: * :option:`restart` - restart the nginx and uWSGI services. * :option:`uninstall` - uninstall all packages. - ..note:: + .. note:: - The :option:`uninstall` option does not perform any actions if the distro is - set to |CL| and will only uninstall packages if the distro is Ubuntu + The :option:`uninstall` option does not perform any actions if the + distro is set to |CL| and will only uninstall packages if the distro is + Ubuntu Next, we install the telemetrics backend server with the following options: diff --git a/source/clear-linux/tutorials/web-server-install/web-server-install.rst b/source/clear-linux/tutorials/web-server-install/web-server-install.rst index 3a2e814f..3c526468 100644 --- a/source/clear-linux/tutorials/web-server-install/web-server-install.rst +++ b/source/clear-linux/tutorials/web-server-install/web-server-install.rst @@ -1,7 +1,7 @@ .. _web-server-install: Create a Clear Linux\* based web server -##################################### +####################################### This tutorial shows you how to create a LAMP server using |CLOSIA| and how to use phpMyAdmin\* to manage an associated database. diff --git a/source/clear-linux/tutorials/wp-install/wp-install.rst b/source/clear-linux/tutorials/wp-install/wp-install.rst index a30d81f5..b5eda738 100644 --- a/source/clear-linux/tutorials/wp-install/wp-install.rst +++ b/source/clear-linux/tutorials/wp-install/wp-install.rst @@ -153,7 +153,7 @@ Once the installation is complete, you can name your blog and create a Wordpress `Figure 6: The WordPress login screen.` #. Enter your WordPress username and password. -#. Check :guilabel:`Remember me`to save your credentials. +#. Check :guilabel:`Remember me` to save your credentials. #. Click :guilabel:`Log in`. Figure 7 shows the WordPress dashboard after a successful login: From 9b0e141aa197c530f702c40b1d99eefd8b6d22e0 Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Tue, 24 Jul 2018 12:54:54 -0700 Subject: [PATCH 71/76] Adds target-anchors to cross reference with new method. --- source/clear-linux/concepts/autospec-about.rst | 7 +++++++ source/clear-linux/guides/maintenance/autospec.rst | 4 ++-- 2 files changed, 9 insertions(+), 2 deletions(-) diff --git a/source/clear-linux/concepts/autospec-about.rst b/source/clear-linux/concepts/autospec-about.rst index 64eaafcf..b7f9fce0 100644 --- a/source/clear-linux/concepts/autospec-about.rst +++ b/source/clear-linux/concepts/autospec-about.rst @@ -3,6 +3,11 @@ Autospec ######## +.. _incl-autospec-overview + +Overview +-------- + Whereas a standard RPM build process using ``rpmbuild`` requires a tarball and ``spec`` file to start, ``autospec`` only requires a tarball and package name. ``autospec`` analyzes the source code and :file:`Makefile` information @@ -27,6 +32,8 @@ file. For a comprehensive list of control files, view the `autospec readme`_. +.. _incl-autospec-overview-end + Control files are explained in Table 1. .. list-table:: **Table 1. Control Files** diff --git a/source/clear-linux/guides/maintenance/autospec.rst b/source/clear-linux/guides/maintenance/autospec.rst index 8c065fd4..ce4b953b 100644 --- a/source/clear-linux/guides/maintenance/autospec.rst +++ b/source/clear-linux/guides/maintenance/autospec.rst @@ -68,8 +68,8 @@ Create a RPM with autospec ************************** .. include:: ../../concepts/autospec-about.rst - :Start-after: autospec-overview - :end-before: For a comprehensive list of control files + :Start-after: incl-autospec-overview + :end-before: incl-autospec-overview-end For a detailed explanation of how ``autospec`` works on |CL|, visit our :ref:`autospec-about` about page. For a general understanding of how RPMs From 5eab2ea6bf0d88c34f53dc274332c6eeb4af9076 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Wed, 25 Jul 2018 16:37:57 -0700 Subject: [PATCH 72/76] updated includes to new code standard --- .../get-started/bootable-usb/bootable-usb-linux.rst | 4 ++-- .../clear-linux/get-started/bootable-usb/bootable-usb-mac.rst | 4 ++-- .../get-started/bootable-usb/bootable-usb-windows.rst | 4 ++-- source/clear-linux/reference/image-types.rst | 4 ++++ 4 files changed, 10 insertions(+), 6 deletions(-) diff --git a/source/clear-linux/get-started/bootable-usb/bootable-usb-linux.rst b/source/clear-linux/get-started/bootable-usb/bootable-usb-linux.rst index 392f2427..4767c26a 100644 --- a/source/clear-linux/get-started/bootable-usb/bootable-usb-linux.rst +++ b/source/clear-linux/get-started/bootable-usb/bootable-usb-linux.rst @@ -14,8 +14,8 @@ Instructions are also available for other operating systems: * :ref:`bootable-usb-windows` .. include:: ../../reference/image-types.rst - :start-after: for different platforms and environments. - :end-before: Table 1 lists the currently available images + :start-after: incl-image-filename: + :end-before: incl-image-filename-end: .. include:: ../../guides/maintenance/download-verify-uncompress-linux.rst :Start-after: verify-linux: diff --git a/source/clear-linux/get-started/bootable-usb/bootable-usb-mac.rst b/source/clear-linux/get-started/bootable-usb/bootable-usb-mac.rst index fd56c0e3..2aab17b2 100644 --- a/source/clear-linux/get-started/bootable-usb/bootable-usb-mac.rst +++ b/source/clear-linux/get-started/bootable-usb/bootable-usb-mac.rst @@ -14,8 +14,8 @@ Instructions are also available for other operating systems: * :ref:`bootable-usb-windows` .. include:: ../../reference/image-types.rst - :start-after: for different platforms and environments. - :end-before: Table 1 lists the currently available images + :start-after: incl-image-filename: + :end-before: incl-image-filename-end: .. include:: ../../guides/maintenance/download-verify-uncompress-mac.rst :start-after: verify-mac: diff --git a/source/clear-linux/get-started/bootable-usb/bootable-usb-windows.rst b/source/clear-linux/get-started/bootable-usb/bootable-usb-windows.rst index 6d99d405..d4dbd75e 100644 --- a/source/clear-linux/get-started/bootable-usb/bootable-usb-windows.rst +++ b/source/clear-linux/get-started/bootable-usb/bootable-usb-windows.rst @@ -14,8 +14,8 @@ Instructions are also available for other operating systems: * :ref:`bootable-usb-linux` .. include:: ../../reference/image-types.rst - :start-after: for different platforms and environments. - :end-before: Table 1 lists the currently available images + :start-after: incl-image-filename: + :end-before: incl-image-filename-end: .. include:: ../../guides/maintenance/download-verify-uncompress-windows.rst :Start-after: verify-windows: diff --git a/source/clear-linux/reference/image-types.rst b/source/clear-linux/reference/image-types.rst index 691b01a1..50f81dfc 100644 --- a/source/clear-linux/reference/image-types.rst +++ b/source/clear-linux/reference/image-types.rst @@ -7,6 +7,8 @@ Clear Linux\* image types |CLOSIA| offers many types of `images`_ for different platforms and environments. +.. _incl-image-filename: + The naming convention of a |CL| image filename is: .. code-block:: console @@ -21,6 +23,8 @@ The naming convention of a |CL| image filename is: * The *[compression type]* field specifies the compression type. Two types of compressions are used: GNU\* zip (*.gz*) and XZ (*.xz*). +.. _incl-image-filename-end: + Table 1 lists the currently available images that are platform independent. Table 2 lists the currently available images that are platform specific. From a4875df4fbb6d1e10c4efd02574aa22b1b1b7844 Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Wed, 25 Jul 2018 16:57:31 -0700 Subject: [PATCH 73/76] Appends ':' to the end of the target-label - where it appears in autospec-about - where it is used in the "include" Signed-off-by: Michael Vincerra --- source/clear-linux/concepts/autospec-about.rst | 2 +- source/clear-linux/guides/maintenance/autospec.rst | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/source/clear-linux/concepts/autospec-about.rst b/source/clear-linux/concepts/autospec-about.rst index b7f9fce0..a314514c 100644 --- a/source/clear-linux/concepts/autospec-about.rst +++ b/source/clear-linux/concepts/autospec-about.rst @@ -3,7 +3,7 @@ Autospec ######## -.. _incl-autospec-overview +.. _incl-autospec-overview: Overview -------- diff --git a/source/clear-linux/guides/maintenance/autospec.rst b/source/clear-linux/guides/maintenance/autospec.rst index ce4b953b..29ed5da7 100644 --- a/source/clear-linux/guides/maintenance/autospec.rst +++ b/source/clear-linux/guides/maintenance/autospec.rst @@ -68,8 +68,8 @@ Create a RPM with autospec ************************** .. include:: ../../concepts/autospec-about.rst - :Start-after: incl-autospec-overview - :end-before: incl-autospec-overview-end + :Start-after: incl-autospec-overview: + :end-before: incl-autospec-overview-end: For a detailed explanation of how ``autospec`` works on |CL|, visit our :ref:`autospec-about` about page. For a general understanding of how RPMs From e8f6a074b99ae9f73b66e789e773e19d3afa179b Mon Sep 17 00:00:00 2001 From: MCamp859 Date: Wed, 25 Jul 2018 21:55:58 -0400 Subject: [PATCH 74/76] Updated kata and kata_migration tutorials. Updated info for selecting runtime and edits for text flow and clarity. Signed-off-by: MCamp859 --- source/clear-linux/tutorials/kata.rst | 58 ++++++++++--------- .../clear-linux/tutorials/kata_migration.rst | 13 +---- 2 files changed, 32 insertions(+), 39 deletions(-) diff --git a/source/clear-linux/tutorials/kata.rst b/source/clear-linux/tutorials/kata.rst index 1c6ef20b..aee38778 100644 --- a/source/clear-linux/tutorials/kata.rst +++ b/source/clear-linux/tutorials/kata.rst @@ -3,16 +3,16 @@ Install Kata Containers\* ######################### -This tutorial describes how to install, configure and run Kata Containers\* on -|CLOSIA|. Kata Containers is an open source project dedicated to the -development of a lightweight implementation of Virtual Machines (VMs) -offering the speed of containers and the security of VMs. +This tutorial describes how to install, configure, and run `Kata Containers`_ +on |CLOSIA|. Kata Containers is an open source project developing a +lightweight implementation of :abbr:`VMs (Virtual Machines)` that offer the +speed of containers and the security of VMs. Prerequisites ************* This tutorial assumes you have installed |CL| on your host system. -For detailed instructions on installing |CL| on a bare metal system, visit +For detailed instructions on installing |CL| on a bare metal system, follow the :ref:`bare metal installation tutorial`. If you have Clear Containers installed on your |CL| system, then follow the @@ -28,24 +28,23 @@ Install Kata Containers *********************** Kata Containers is included in the :file:`containers-virt` bundle. To install the -framework, enter: +framework, enter the following command: .. code-block:: bash sudo swupd bundle-add containers-virt -Configure Docker\* to use Kata Containers by default +Configure Docker\* to use Kata Containers by default. .. code-block:: bash sudo mkdir -p /etc/systemd/system/docker.service.d/ - cat < Date: Thu, 26 Jul 2018 16:32:37 -0400 Subject: [PATCH 75/76] Incorporated review feedback. Signed-off-by: MCamp859 --- .../clear-linux/concepts/telemetry-about.rst | 38 +++++++++++-------- .../guides/maintenance/telemetry-enable.rst | 18 ++++----- .../telemetry-backend/telemetry-backend.rst | 8 ++-- 3 files changed, 35 insertions(+), 29 deletions(-) diff --git a/source/clear-linux/concepts/telemetry-about.rst b/source/clear-linux/concepts/telemetry-about.rst index 261cf216..e9249aa6 100644 --- a/source/clear-linux/concepts/telemetry-about.rst +++ b/source/clear-linux/concepts/telemetry-about.rst @@ -3,15 +3,14 @@ Telemetrics ########### -Telemetry is one of the key features of |CLOSIA|. The |CL| team is focused on -the quality of the telemetry data, and is moving from issues that are detected -and reported by users to issues detected and repaired by providers. Ideally, -these issues will be undetected by users. +One of the key features of |CLOSIA| is telemetry, which is used to +monitor system health. Telemetry enables developers to observe and proactively +address issues before end users are impacted. -On the |CL| team, we refer to *telemetrics*, which is a combination word made from: +*Telemetrics* is a combination word made from: -* Telemetry which is sensing and reporting data. -* Analytics which is using visualization and statistical inferencing to make +* *Telemetry* which is sensing and reporting data. +* *Analytics* which is using visualization and statistical inferencing to make sense of the reported data. |CL| telemetry reports system-level debug/crash information using specialized probes. The @@ -21,8 +20,8 @@ failures. Telemetry enables real-time issue reporting to allow system developers to quickly focus on an issue and monitor corrective actions. |CL| telemetry is fully customizable and can be used during software development -for debugging purposes. You can use libtelemetry in your code to create custom -telemetry records. You can also use telem-record-gen in script files or call +for debugging purposes. You can use **libtelemetry** in your code to create custom +telemetry records. You can also use **telem-record-gen** in script files or call it from another program. Architecture @@ -34,7 +33,10 @@ Architecture * Backend: captures records sent from the client and displays the cumulative content through a specialized interface. -Note: To capture records for analysis, you must set up your own backend server. + .. note:: + + If you want to capture your own records for analysis, you must set up + your own backend server. .. figure:: figures/telemetry-about-1.png :scale: 75% @@ -45,10 +47,10 @@ Note: To capture records for analysis, you must set up your own backend server. The telemetry client provides the front end of a complete telemetrics solution and includes the following components: -* telemd, a daemon that prepares the records to send to a telemetrics server or +* **telemd**, a daemon that prepares the records to send to a telemetrics server or spools the records on disk in case it cannot successfully deliver them. * Probes that collect specific types of data from the operating system. -* libtelemetry, that telemetrics probes use to create telemetrics records and +* **libtelemetry**, that telemetrics probes use to create telemetrics records and send them to the telemd daemon for further processing. The telemetry backend provides the server-side component of a complete telemetrics solution and @@ -63,14 +65,18 @@ consists of: * PostgreSQL as the underlying database server. +The default telemetry backend server reports back to the |CL| development team +and is not viewable outside the Intel firewall. If you want to collect your +own records, then you must set up your own telemetry backend server. + Next steps ********** To put this concept into practice, see the following resources: -* :ref:`Enable and disable telemetry in Clear Linux` -* :ref:`Create a telemetry backend server in Clear Linux` +* :ref:`Enable and disable telemetry in Clear Linux` +* :ref:`Create a telemetry backend server in Clear Linux` * `Telemetry feature description`_ -.. _`Telemetry feature description: - `https://clearlinux.org/features/telemetry +.. _`Telemetry feature description`: + https://clearlinux.org/features/telemetry diff --git a/source/clear-linux/guides/maintenance/telemetry-enable.rst b/source/clear-linux/guides/maintenance/telemetry-enable.rst index 1505b2b0..2723c209 100644 --- a/source/clear-linux/guides/maintenance/telemetry-enable.rst +++ b/source/clear-linux/guides/maintenance/telemetry-enable.rst @@ -5,8 +5,8 @@ Enable and disable telemetry in Clear Linux |CLOSIA| includes a telemetry solution as part of the OS that records events of interest and reports them back to the development team via the telemetrics -daemon, :command:`telemd`. This functionality is maintained in the -``telemetrics`` software bundle. +daemon, **telemd**. This functionality is maintained in the +**telemetrics** software bundle. .. note:: The telemetry functionality adheres to `Intel privacy policies`_ @@ -20,10 +20,10 @@ redirect where the records go if they wish to collect records for themselves. Install the telemetry software bundle ************************************* -During the initial installation of |CL| you are requested to join the +During the initial installation of |CL|, you are requested to join the stability enhancement program and allow |CLOSIA| to collect anonymous reports -to improve system stability. If you chose not to join this program at that -time then the telemetry software bundle is not added to your system. +to improve system stability. If you choose not to join this program, then the +telemetry software bundle is not added to your system. To install the telemetry bundle, enter the following command as either the root user or with :command:`sudo` privileges: @@ -105,12 +105,12 @@ Additional resources ******************** * `Telemetry feature description`_ -* :ref:`Telemetry architecture` -* :ref:`Create a telemetry backend server in Clear Linux` +* :ref:`Telemetry architecture` +* :ref:`Create a telemetry backend server in Clear Linux` * https://github.com/clearlinux/telemetrics-client .. _`Intel privacy policies`: https://www.intel.com/content/www/us/en/privacy/intel-privacy-notice.html -.. _`Telemetry feature description: - `https://clearlinux.org/features/telemetry +.. _`Telemetry feature description`: + https://clearlinux.org/features/telemetry diff --git a/source/clear-linux/tutorials/telemetry-backend/telemetry-backend.rst b/source/clear-linux/tutorials/telemetry-backend/telemetry-backend.rst index 9d1ac866..06fe6384 100644 --- a/source/clear-linux/tutorials/telemetry-backend/telemetry-backend.rst +++ b/source/clear-linux/tutorials/telemetry-backend/telemetry-backend.rst @@ -463,8 +463,8 @@ Additional resources ******************** * `Telemetry feature description`_ -* :ref:`Telemetry architecture` -* :ref:`Enable and disable telemetry in Clear Linux` +* :ref:`Telemetry architecture` +* :ref:`Enable and disable telemetry in Clear Linux` * https://github.com/clearlinux/telemetrics-client * https://github.com/clearlinux/telemetrics-backend @@ -474,5 +474,5 @@ Additional resources .. _`Intel privacy policies`: https://www.intel.com/content/www/us/en/privacy/intel-privacy-notice.html -.. _`Telemetry feature description: - `https://clearlinux.org/features/telemetry +.. _`Telemetry feature description`: + https://clearlinux.org/features/telemetry From 27e2ab30a6e68ed2390c501a4061b5937d0a4fad Mon Sep 17 00:00:00 2001 From: MCamp859 Date: Fri, 27 Jul 2018 13:41:08 -0400 Subject: [PATCH 76/76] Corrected references and ref label spelling. Signed-off-by: MCamp859 --- source/clear-linux/concepts/telemetry-about.rst | 4 ++-- source/clear-linux/guides/maintenance/telemetry-enable.rst | 4 ++-- .../tutorials/telemetry-backend/telemetry-backend.rst | 6 +++--- 3 files changed, 7 insertions(+), 7 deletions(-) diff --git a/source/clear-linux/concepts/telemetry-about.rst b/source/clear-linux/concepts/telemetry-about.rst index e9249aa6..b37e6d90 100644 --- a/source/clear-linux/concepts/telemetry-about.rst +++ b/source/clear-linux/concepts/telemetry-about.rst @@ -74,8 +74,8 @@ Next steps To put this concept into practice, see the following resources: -* :ref:`Enable and disable telemetry in Clear Linux` -* :ref:`Create a telemetry backend server in Clear Linux` +* :ref:`telemetry-enable` +* :ref:`telemetry-backend` * `Telemetry feature description`_ .. _`Telemetry feature description`: diff --git a/source/clear-linux/guides/maintenance/telemetry-enable.rst b/source/clear-linux/guides/maintenance/telemetry-enable.rst index 2723c209..6d401226 100644 --- a/source/clear-linux/guides/maintenance/telemetry-enable.rst +++ b/source/clear-linux/guides/maintenance/telemetry-enable.rst @@ -105,8 +105,8 @@ Additional resources ******************** * `Telemetry feature description`_ -* :ref:`Telemetry architecture` -* :ref:`Create a telemetry backend server in Clear Linux` +* :ref:`Telemetry architecture` +* :ref:`telemetry-backend` * https://github.com/clearlinux/telemetrics-client .. _`Intel privacy policies`: diff --git a/source/clear-linux/tutorials/telemetry-backend/telemetry-backend.rst b/source/clear-linux/tutorials/telemetry-backend/telemetry-backend.rst index 06fe6384..ddb16cd3 100644 --- a/source/clear-linux/tutorials/telemetry-backend/telemetry-backend.rst +++ b/source/clear-linux/tutorials/telemetry-backend/telemetry-backend.rst @@ -1,4 +1,4 @@ -.. _telemtry-backend: +.. _telemetry-backend: Create a telemetry backend server in Clear Linux ################################################ @@ -463,8 +463,8 @@ Additional resources ******************** * `Telemetry feature description`_ -* :ref:`Telemetry architecture` -* :ref:`Enable and disable telemetry in Clear Linux` +* :ref:`Telemetry architecture` +* :ref:`telemetry-enable` * https://github.com/clearlinux/telemetrics-client * https://github.com/clearlinux/telemetrics-backend