From e2316340eb28e38926dfb2709f0f0dfb2b50fc99 Mon Sep 17 00:00:00 2001 From: Kristal Dale Date: Mon, 24 Sep 2018 11:34:32 -0700 Subject: [PATCH 1/9] Initial commit for new hostname guide. Updated landing page to add link to new guide. Signed-off-by: Kristal Dale --- .../guides/maintenance/hostname.rst | 78 +++++++++++++++++++ .../guides/maintenance/maintenance.rst | 5 +- 2 files changed, 81 insertions(+), 2 deletions(-) create mode 100644 source/clear-linux/guides/maintenance/hostname.rst diff --git a/source/clear-linux/guides/maintenance/hostname.rst b/source/clear-linux/guides/maintenance/hostname.rst new file mode 100644 index 00000000..43dfa814 --- /dev/null +++ b/source/clear-linux/guides/maintenance/hostname.rst @@ -0,0 +1,78 @@ +.. _hostname: + +Modify hostname on |CL-ATTR| +############################ + +This guide describes how to modify and view the hostname of your +|CL-ATTR| system. + + +By default, |CL| installations have a machine generated name. This +long string of letters and numbers is fine for computers, but is not +human-friendly. Administrators and users will often want to rename +their machines with a name that is easier to remember, type, and search +for. Renaming a machine also makes it easier to identify, by including +meaningful data in the name. A meaningful, human-friendly machine +name might: + + * indicate the computer purpose e.g. “regression-test” + * indicate the owner e.g. “sally-test-box1” + * indicate the geographical location e.g. “az-bld2-lab” + + +.. note:: + + There are three types of hostname: “static”, “transient”, and “pretty”. + The most common is the static hostname. If the static hostname exists, + it is used to generate the transient hostname, which is maintained by the + kernel. Note that the transient hostname can be changed by DHCP or mDNS + at runtime. The pretty hostname is a human readable name that is used + for presentation to the user. + + Static hostnames must be between 2 and 63 characters long, must start + and end with a letter or number, and may contain letters (case-insensitive), + numbers, dashes or dots. Pretty hostnames can use free-form UTF8 characters, + to make the hostname more aesthetically pleasing for the user. + + +Setting your hostname +********************* + +|CL| uses the :command:`hostnamectl` command to display and modify the +machine name. :command:`hostnamectl` is part of the **os-core** bundle. + +This example sets the hostname to “telemetry-test-2-h15”, to identify a +|CL| telemetry test machine on the second floor at grid location H15. +Make sure to reboot after setting a new hostname. + + .. code-block:: bash + + sudo hostnamectl set-hostname telemetry-test-2-h15 + sudo reboot + + +View your hostname +****************** + +View your current hostname using the following command: + + .. code-block:: bash + + hostnamectl + +You should see output similar to: + + .. code-block:: console + + Static hostname: telemetry-test-2-h15 + Pretty hostname: telemetry-test-2-h15 + Icon name: computer-desktop + Chassis: desktop + Machine ID: 4d0d60207a904ebbab96680a51ac1339 + Boot ID: 98d3514e5a984e8cbbdf46a2f0d6b397 + Operating System: Clear Linux OS + Kernel: Linux 4.18.8-632.native + Architecture: x86-64 + + +**Congratulations!** You successfully modified the hostname of your |CL| system. diff --git a/source/clear-linux/guides/maintenance/maintenance.rst b/source/clear-linux/guides/maintenance/maintenance.rst index 09737c90..f8f1349c 100644 --- a/source/clear-linux/guides/maintenance/maintenance.rst +++ b/source/clear-linux/guides/maintenance/maintenance.rst @@ -3,8 +3,8 @@ Maintenance guide ################# -This guide provides step-by-step instructions for common tasks associated with -maintaining |CLOSIA| after :ref:`installation ` is completed. +These guides provide step-by-step instructions for common tasks associated with +maintaining |CL-ATTR| after :ref:`installation ` is completed. .. toctree:: :maxdepth: 2 @@ -19,6 +19,7 @@ maintaining |CLOSIA| after :ref:`installation ` is completed. validate-signatures telemetry-enable time + hostname increase-virtual-disk-size download-verify-uncompress-linux download-verify-uncompress-mac From 7720c914237738ca95648f858981f7a8f985c9d2 Mon Sep 17 00:00:00 2001 From: Kristal Dale Date: Mon, 24 Sep 2018 13:45:59 -0700 Subject: [PATCH 2/9] Edits for grammar. Signed-off-by: Kristal Dale --- .../guides/maintenance/hostname.rst | 38 +++++++++---------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/source/clear-linux/guides/maintenance/hostname.rst b/source/clear-linux/guides/maintenance/hostname.rst index 43dfa814..2d058091 100644 --- a/source/clear-linux/guides/maintenance/hostname.rst +++ b/source/clear-linux/guides/maintenance/hostname.rst @@ -15,23 +15,23 @@ for. Renaming a machine also makes it easier to identify, by including meaningful data in the name. A meaningful, human-friendly machine name might: - * indicate the computer purpose e.g. “regression-test” - * indicate the owner e.g. “sally-test-box1” - * indicate the geographical location e.g. “az-bld2-lab” + * indicate the computer purpose e.g. “regression-test.” + * indicate the owner e.g. “sally-test-box1.” + * indicate the geographical location e.g. “az-bld2-lab.” .. note:: - There are three types of hostname: “static”, “transient”, and “pretty”. + There are three types of hostname: “static”, “transient”, and “pretty.” The most common is the static hostname. If the static hostname exists, - it is used to generate the transient hostname, which is maintained by the - kernel. Note that the transient hostname can be changed by DHCP or mDNS - at runtime. The pretty hostname is a human readable name that is used - for presentation to the user. + it is used to generate the transient hostname, which is maintained by + the kernel. The transient hostname can be changed by DHCP or mDNS at + runtime. The pretty hostname is a human readable name that is used for + presentation to the user. - Static hostnames must be between 2 and 63 characters long, must start + Static hostnames must be between two and 63 characters long, must start and end with a letter or number, and may contain letters (case-insensitive), - numbers, dashes or dots. Pretty hostnames can use free-form UTF8 characters, + numbers, dashes, or dots. Pretty hostnames can use free-form UTF8 characters to make the hostname more aesthetically pleasing for the user. @@ -41,7 +41,7 @@ Setting your hostname |CL| uses the :command:`hostnamectl` command to display and modify the machine name. :command:`hostnamectl` is part of the **os-core** bundle. -This example sets the hostname to “telemetry-test-2-h15”, to identify a +This example sets the hostname to “telemetry-test-2-h15,” to identify a |CL| telemetry test machine on the second floor at grid location H15. Make sure to reboot after setting a new hostname. @@ -64,15 +64,15 @@ You should see output similar to: .. code-block:: console - Static hostname: telemetry-test-2-h15 - Pretty hostname: telemetry-test-2-h15 - Icon name: computer-desktop - Chassis: desktop - Machine ID: 4d0d60207a904ebbab96680a51ac1339 - Boot ID: 98d3514e5a984e8cbbdf46a2f0d6b397 + Static hostname: telemetry-test-2-h15 + Pretty hostname: telemetry-test-2-h15 + Icon name: computer-desktop + Chassis: desktop + Machine ID: 4d0d60207a904ebbab96680a51ac1339 + Boot ID: 98d3514e5a984e8cbbdf46a2f0d6b397 Operating System: Clear Linux OS - Kernel: Linux 4.18.8-632.native - Architecture: x86-64 + Kernel: Linux 4.18.8-632.native + Architecture: x86-64 **Congratulations!** You successfully modified the hostname of your |CL| system. From 408d5817b8858251fce1341f2659d1bc72d6c3dc Mon Sep 17 00:00:00 2001 From: Kristal Dale Date: Tue, 25 Sep 2018 12:46:51 -0700 Subject: [PATCH 3/9] Revisions to simplify sentences and examples, bring in-line with collaboration guidelines. Signed-off-by: Kristal Dale --- .../guides/maintenance/hostname.rst | 51 +++++++++---------- 1 file changed, 25 insertions(+), 26 deletions(-) diff --git a/source/clear-linux/guides/maintenance/hostname.rst b/source/clear-linux/guides/maintenance/hostname.rst index 2d058091..1571f813 100644 --- a/source/clear-linux/guides/maintenance/hostname.rst +++ b/source/clear-linux/guides/maintenance/hostname.rst @@ -7,41 +7,25 @@ This guide describes how to modify and view the hostname of your |CL-ATTR| system. -By default, |CL| installations have a machine generated name. This -long string of letters and numbers is fine for computers, but is not -human-friendly. Administrators and users will often want to rename +By default, |CL| installations have a machine generated name, which is a +long string of letters and numbers. The generated name is fine for computers +but is not human-friendly. Administrators and users will often want to rename their machines with a name that is easier to remember, type, and search for. Renaming a machine also makes it easier to identify, by including -meaningful data in the name. A meaningful, human-friendly machine -name might: +meaningful data in the name. The following examples show human-friendly machine names: - * indicate the computer purpose e.g. “regression-test.” - * indicate the owner e.g. “sally-test-box1.” - * indicate the geographical location e.g. “az-bld2-lab.” + * *regression-test* + * *sally-test-box1* + * *az-bldg2-lab* -.. note:: - - There are three types of hostname: “static”, “transient”, and “pretty.” - The most common is the static hostname. If the static hostname exists, - it is used to generate the transient hostname, which is maintained by - the kernel. The transient hostname can be changed by DHCP or mDNS at - runtime. The pretty hostname is a human readable name that is used for - presentation to the user. - - Static hostnames must be between two and 63 characters long, must start - and end with a letter or number, and may contain letters (case-insensitive), - numbers, dashes, or dots. Pretty hostnames can use free-form UTF8 characters - to make the hostname more aesthetically pleasing for the user. - - -Setting your hostname -********************* +Set your hostname +***************** |CL| uses the :command:`hostnamectl` command to display and modify the machine name. :command:`hostnamectl` is part of the **os-core** bundle. -This example sets the hostname to “telemetry-test-2-h15,” to identify a +This example sets the hostname to *telemetry-test-2-h15*, to identify a |CL| telemetry test machine on the second floor at grid location H15. Make sure to reboot after setting a new hostname. @@ -51,6 +35,21 @@ Make sure to reboot after setting a new hostname. sudo reboot +.. note:: + + There are three types of hostname: *static*, *transient*, and *pretty*. + The most common is the static hostname. Static hostnames must be between + two and 63 characters long, must start and end with a letter or number, + and may contain letters (case-insensitive), numbers, dashes, or dots. + + If the static hostname exists, it is used to generate the transient hostname, + which is maintained by the kernel. The transient hostname can be changed + by DHCP or mDNS at runtime. + + The pretty hostname is a free-form UTF8 name used for presentation to the user. + + + View your hostname ****************** From 16c13d4079c4661ca36e5cccfe59e970da861e5c Mon Sep 17 00:00:00 2001 From: Kristal Dale Date: Thu, 27 Sep 2018 09:25:51 -0700 Subject: [PATCH 4/9] reST formatting clean up Signed-off-by: Kristal Dale --- .../guides/maintenance/hostname.rst | 45 +++++++++---------- 1 file changed, 21 insertions(+), 24 deletions(-) diff --git a/source/clear-linux/guides/maintenance/hostname.rst b/source/clear-linux/guides/maintenance/hostname.rst index 1571f813..718173e2 100644 --- a/source/clear-linux/guides/maintenance/hostname.rst +++ b/source/clear-linux/guides/maintenance/hostname.rst @@ -14,26 +14,25 @@ their machines with a name that is easier to remember, type, and search for. Renaming a machine also makes it easier to identify, by including meaningful data in the name. The following examples show human-friendly machine names: - * *regression-test* - * *sally-test-box1* - * *az-bldg2-lab* - +* *regression-test* +* *sally-test-box1* +* *az-bldg2-lab* Set your hostname ***************** -|CL| uses the :command:`hostnamectl` command to display and modify the -machine name. :command:`hostnamectl` is part of the **os-core** bundle. +|CL| uses the :command:`hostnamectl` command to display and modify the machine +name. :command:`hostnamectl` is part of the **os-core** bundle, which provides +a basic Linux\* user space and utilities. This example sets the hostname to *telemetry-test-2-h15*, to identify a |CL| telemetry test machine on the second floor at grid location H15. Make sure to reboot after setting a new hostname. - .. code-block:: bash - - sudo hostnamectl set-hostname telemetry-test-2-h15 - sudo reboot +.. code-block:: bash + sudo hostnamectl set-hostname telemetry-test-2-h15 + sudo reboot .. note:: @@ -48,30 +47,28 @@ Make sure to reboot after setting a new hostname. The pretty hostname is a free-form UTF8 name used for presentation to the user. - - View your hostname ****************** View your current hostname using the following command: - .. code-block:: bash +.. code-block:: bash - hostnamectl + hostnamectl You should see output similar to: - .. code-block:: console +.. code-block:: console - Static hostname: telemetry-test-2-h15 - Pretty hostname: telemetry-test-2-h15 - Icon name: computer-desktop - Chassis: desktop - Machine ID: 4d0d60207a904ebbab96680a51ac1339 - Boot ID: 98d3514e5a984e8cbbdf46a2f0d6b397 - Operating System: Clear Linux OS - Kernel: Linux 4.18.8-632.native - Architecture: x86-64 + Static hostname: telemetry-test-2-h15 + Pretty hostname: telemetry-test-2-h15 + Icon name: computer-desktop + Chassis: desktop + Machine ID: 4d0d60207a904ebbab96680a51ac1339 + Boot ID: 98d3514e5a984e8cbbdf46a2f0d6b397 + Operating System: Clear Linux OS + Kernel: Linux 4.18.8-632.native + Architecture: x86-64 **Congratulations!** You successfully modified the hostname of your |CL| system. From 0894c919c6a906ce9085e19a4eb871b9fa7c1cf8 Mon Sep 17 00:00:00 2001 From: Tudor Marcu Date: Fri, 7 Sep 2018 14:49:28 -0700 Subject: [PATCH 5/9] Update mixer docs to current release Signed-off-by: Tudor Marcu --- .../clear-linux/guides/maintenance/mixer.rst | 133 ++++++++---------- 1 file changed, 57 insertions(+), 76 deletions(-) diff --git a/source/clear-linux/guides/maintenance/mixer.rst b/source/clear-linux/guides/maintenance/mixer.rst index 1e9dc19f..adb4cfce 100644 --- a/source/clear-linux/guides/maintenance/mixer.rst +++ b/source/clear-linux/guides/maintenance/mixer.rst @@ -22,6 +22,13 @@ add it with the :command:`swupd bundle-add` command as follows: Current mixing workflow *********************** +Mixer by default runs *all* build commands in a container to ensure the +correct version of the tooling is being used. This also allows custom mixes +to automatically perform downstream format bumps when upstream releases +a format bump. You can still run mixer natively by appending --native to +any of the commands. Note that you cannot run mixer if you are already in a +container, unless you pass --native to the command. Nested containerization +is not supported, nor is building images using the container mode. There are two different workflows to create your own mix. First, if your mix only uses |CL| content, *skip step 5* below. @@ -191,7 +198,7 @@ For example: .. code-block:: bash - mixer init --clear-version 21060 --mix-version 100 + mixer init --upstream-version 21060 --mix-version 10 Additionally, to build a mix with your own custom RPMs, use the optional @@ -228,7 +235,7 @@ up automatically with the optional *--git* flag, for example: .. code-block:: bash - mixer init --clear-version 21060 --mix-version 100 --local-rpms --all-upstream --git + mixer init --upstream-version 21060 --mix-version 10 --local-rpms --all-upstream --git Edit builder.conf ***************** @@ -260,26 +267,29 @@ following example: .. code-block:: console - [Mixer] - LOCAL_BUNDLE_DIR=/home/clr/mix/local-bundles + #VERSION 1.0 [Builder] - SERVER_STATE_DIR=/home/clr/mix/update - BUNDLE_DIR=/home/clr/mix/mix-bundles - YUM_CONF=/home/clr/mix/.yum-mix.conf - CERT=/home/clr/mix/Swupd_Root.pem - VERSIONS_PATH=/home/clr/mix + CERT = "/home/clr/mix/Swupd_Root.pem" + SERVER_STATE_DIR = "/home/clr/mix/update" + VERSIONS_PATH = "/home/clr/mix" + YUM_CONF = "/home/clr/mix/.yum-mix.conf" - [swupd] - BUNDLE=os-core-update - CONTENTURL= - VERSIONURL= - FORMAT=1 + [Swupd] + BUNDLE = "os-core-update" + CONTENTURL = "" + VERSIONURL = "" [Server] - debuginfo_banned=true - debuginfo_lib=/usr/lib/debug/ - debuginfo_src=/usr/src/debug/ + DEBUG_INFO_BANNED = "true" + DEBUG_INFO_LIB = "/usr/lib/debug" + DEBUG_INFO_SRC = "/usr/src/debug" + + [Mixer] + LOCAL_BUNDLE_DIR = "/home/clr/mix/local-bundles" + LOCAL_REPO_DIR = "" + LOCAL_RPM_DIR = "" + DOCKER_IMAGE_PATH = "clearlinux/mixer" The following variables require further explanation: @@ -292,13 +302,6 @@ The following variables require further explanation: content. Mixer automatically creates the path for you, but the path can be set to any location. In this example, we use the workspace directory. -* The `BUNDLE_DIR` variable sets the path where mixer temporarily stores the - bundle definition files while building chroots. Only the legacy - chroot-builder uses this path. By default, mixer does not generate this - directory until the directory is needed. In our example, the path is set to - :file:`/home/clr/mix/mix-bundles`. The new chroot-builder does not generate - 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. @@ -333,15 +336,14 @@ The following variables require further explanation: from where to download the updated content. These links are equivalent to the |CL| `update page`_ but for the mix. -* The `FORMAT` variable relates to format bumps. To learn more about the - `FORMAT` option, refer to :ref:`mixer-format` and the `format bumps wiki`_. - For now, leave the `FORMAT` value unchanged. - * The `VERSIONS_PATH` variable sets the path for the mix version and upstream |CL| version's two state files: :file:`mixversion` and :file:`upstreamversion`. Mixer creates both files for you when you set up the workspace. +* The `DOCKER_IMAGE_PATH` variable sets the base name of the docker image + mixer will pull down in order to run builds in the proper container. + .. note:: If you are working only with |CL| bundles, then skip to `List, edit, create, add, remove, or validate bundles`_. @@ -390,7 +392,7 @@ Create a local RPM repo .. code-block:: bash - sudo mixer add-rpms + mixer add-rpms After the tool exits, you should see the RPMs and a repository data directory in :file:`/home/clr/mix/local-yum`. If the RPMs are not all in this @@ -644,29 +646,18 @@ command in your workspace: .. code-block:: bash - sudo mixer build chroots + mixer build bundles If the mix has many bundles, this step might take some time. -By default, mixer uses the legacy chroot-builder. In this mode, mixer -automatically gathers the bundle definition files for the bundles in the mix -into a :file:`mix-bundles` directory. The directory's path is set in the -`BUNDLE_DIR` variable in the :file:`builder.conf`. **Do not edit these -files.** Mixer automatically deletes the contents of the :file:`mix-bundles` -directory before repopulating the directory on-the-fly as mixer builds the -chroots. +Mixer automatically gathers the bundle definition files for the upstream +bundles into a :file:`upstream-bundles` directory, and user bundles should +be placed directly into :file:`local-bundles`. The local path is set in +the `LOCAL_BUNDLE_DIR` variable in the :file:`builder.conf`. **Do not edit +files in upstream-bundles.** Mixer automatically deletes the contents of +the :file:`upstream-bundles` directory before repopulating the directory +on-the-fly if a new version must be downloaded. -We have added a new chroot-builder to the mixer tool itself. While this is -currently an experimental feature, you should use the new chroot-builder. To -use the new chroot-builder, use the following command with the -*--new-chroots* flag: - -.. code-block:: bash - - sudo mixer build chroots --new-chroots - -We will soon deprecate the legacy chroot-builder. When we do, mixer will use -the new version automatically. Create an update **************** @@ -675,25 +666,16 @@ Create an update with the following command: .. code-block:: bash - sudo mixer build update + mixer build update When the build completes, you can find the mix update content under :file:`/home/clr/mix/update/www/VER`. In our example, the update content is found in :file:`/home/clr/mix/update/www/{}`. `` is the defined mix version, which is 10 by default. -By default, mixer uses the legacy `swupd-server` to generate the update -content. However, we have built a new implementation into the mixer tool -itself. While this is currently an experimental feature, you should use the -new `swupd-server`. To use the the new `swupd-server`, use the following -command with the *--new-swupd* flag: - .. code-block:: bash - sudo mixer build update --new-swupd - -We will soon deprecate the legacy `swupd-server`. When we do, mixer will use -the new version automatically. + mixer build update Mixer creates all the content needed to make a fully usable mix with this step. However, only *zero packs* are automatically generated. Zero packs are @@ -705,13 +687,12 @@ mix version to another, with the following command: .. code-block:: bash - sudo mixer-pack-maker.sh --to --from -S /home/clr/mix/update + mixer build delta-packs --to --from -The pack-maker generates all delta packs for the bundles changed from -`PAST_VERSION` to `MIX_VERSION`. If your `STATE_DIR` is in a different -location, specify the location with the *-S* flag. Mixer cannot -create delta packs for the first build because the update is from version 0. -Version 0 implicitly has no content. Thus, mixer can generate no deltas. +This command generates all delta packs for the bundles changed from +`PAST_VERSION` to `MIX_VERSION`. Mixer cannot create delta packs for the +first build because the update is from version 0. Version 0 implicitly has +no content, thus mixer can generate no deltas. For subsequent builds, you can run :file:`mixer-pack-maker.sh` to generate delta content between them, for example: 10 to 20. @@ -755,7 +736,7 @@ With the `ister` tool configured, build the image with the following command: .. code-block:: bash - sudo mixer build image --format 1 + sudo mixer build image Mixer automatically looks for the :file:`release-image-config.json` file, but you can freely choose the filename. To use a different name, simply pass the @@ -763,7 +744,7 @@ you can freely choose the filename. To use a different name, simply pass the .. code-block:: bash - sudo mixer build image --format 1 --template path/to/file.config + sudo mixer build image --template path/to/file.config By default, `ister` uses the format version of the build machine it runs on. Therefore, if the format you are building differs from the format of the |CL| @@ -789,14 +770,14 @@ amount, use the *--increment* flag, for example: .. code-block:: bash - mixer versions update --increment 100 + mixer versions update --increment 10 Alternatively, to set the mix version to a specific value, use the *--mix-version* flag, for example: .. code-block:: bash - mixer versions update --mix-version 200 + mixer versions update --mix-version 20 The :command:`mixer versions update` command does not allow you to set the mix version to a value less than its current value. The mix version is @@ -842,20 +823,19 @@ modifications as needed, for example: .. code-block:: bash - sudo mixer build chroots + mixer build chroots #. Build and update with: .. code-block:: bash - sudo mixer build update + mixer build update #. Optionally, you can create delta packs with: .. code-block:: bash - sudo mixer-pack-maker.sh --to --from -S / - home/clr/mix/update + mixer build delta-packs --to --from .. _mixer-format: @@ -881,9 +861,10 @@ reaching the final release in the old format can a client continue to update to releases in the new format. When creating a custom mix, the format version should start at "1" or some -known number. The format version should increment only when a compatibility -breakage is introduced. Normal updates, like updating a software package for -example, do not require a format increment. +known number such as the host system format. The format version should +increment only when a compatibility breakage is introduced. Normal updates, +like updating a software package for example, do not require a format +increment. .. _update page: https://cdn.download.clearlinux.org/update/ From 04522e1b016fa06571b8d233cfa6b0dc670f2988 Mon Sep 17 00:00:00 2001 From: Kristal Dale Date: Fri, 14 Sep 2018 17:05:59 -0700 Subject: [PATCH 6/9] Applied the following minor edits: - Move note into a note box - enclose flag names in ** - Minor text revisions for readability/grammar Signed-off-by: Kristal Dale --- .../clear-linux/guides/maintenance/mixer.rst | 23 +++++++++++-------- 1 file changed, 13 insertions(+), 10 deletions(-) diff --git a/source/clear-linux/guides/maintenance/mixer.rst b/source/clear-linux/guides/maintenance/mixer.rst index adb4cfce..ce375206 100644 --- a/source/clear-linux/guides/maintenance/mixer.rst +++ b/source/clear-linux/guides/maintenance/mixer.rst @@ -1,6 +1,6 @@ .. _mixer: -Use mixer tool +Use the mixer tool ############## *Mixing* refers to composing an operating system for specific use cases. @@ -22,18 +22,21 @@ add it with the :command:`swupd bundle-add` command as follows: Current mixing workflow *********************** -Mixer by default runs *all* build commands in a container to ensure the +Mixer by default runs **all** build commands in a container to ensure the correct version of the tooling is being used. This also allows custom mixes to automatically perform downstream format bumps when upstream releases -a format bump. You can still run mixer natively by appending --native to -any of the commands. Note that you cannot run mixer if you are already in a -container, unless you pass --native to the command. Nested containerization -is not supported, nor is building images using the container mode. +a format bump. You can still run mixer natively by appending the *--native* flag to +any of the commands. + +.. note:: + You cannot run mixer if you are already in a container, unless you pass + *--native* to the command. Nested containerization is not supported, nor + is building images using the container mode. 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. +:abbr:`RPMs (RPM Package Manager files)`, follow all steps below. #. `Create ngninx web server to host mixer updates`_ #. `Create a workspace`_ @@ -57,9 +60,9 @@ Create nginx 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. +server, where you can host custom |CL| mixes: -#. Install ``web-server-basic``: +#. Install ``web-server-basic``. .. code-block:: bash @@ -122,7 +125,7 @@ server, where you can host custom |CL| mixes. sudo systemctl start nginx -#. To verify the web server is running, enter in an Internet browser: +#. To verify the web server is running, check it in an Internet browser: .. code-block:: bash From 429de66f728b973ffec8a01ef08b6216503e361d Mon Sep 17 00:00:00 2001 From: Kristal Dale Date: Mon, 17 Sep 2018 11:50:54 -0700 Subject: [PATCH 7/9] Revert emphasis on word to original. Signed-off-by: Kristal Dale --- source/clear-linux/guides/maintenance/mixer.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/clear-linux/guides/maintenance/mixer.rst b/source/clear-linux/guides/maintenance/mixer.rst index ce375206..14844fa1 100644 --- a/source/clear-linux/guides/maintenance/mixer.rst +++ b/source/clear-linux/guides/maintenance/mixer.rst @@ -22,7 +22,7 @@ add it with the :command:`swupd bundle-add` command as follows: Current mixing workflow *********************** -Mixer by default runs **all** build commands in a container to ensure the +Mixer by default runs *all* build commands in a container to ensure the correct version of the tooling is being used. This also allows custom mixes to automatically perform downstream format bumps when upstream releases a format bump. You can still run mixer natively by appending the *--native* flag to From 307dc6dcd71b693035e41b539685b9b29da1a68e Mon Sep 17 00:00:00 2001 From: Kristal Dale Date: Fri, 28 Sep 2018 13:43:08 -0700 Subject: [PATCH 8/9] - Added clarification about the os-core bundle - Clean up reST formatting Signed-off-by: Kristal Dale --- source/clear-linux/guides/maintenance/hostname.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/clear-linux/guides/maintenance/hostname.rst b/source/clear-linux/guides/maintenance/hostname.rst index 718173e2..04173288 100644 --- a/source/clear-linux/guides/maintenance/hostname.rst +++ b/source/clear-linux/guides/maintenance/hostname.rst @@ -6,13 +6,13 @@ Modify hostname on |CL-ATTR| This guide describes how to modify and view the hostname of your |CL-ATTR| system. - By default, |CL| installations have a machine generated name, which is a long string of letters and numbers. The generated name is fine for computers but is not human-friendly. Administrators and users will often want to rename their machines with a name that is easier to remember, type, and search for. Renaming a machine also makes it easier to identify, by including -meaningful data in the name. The following examples show human-friendly machine names: +meaningful data in the name. The following examples show human-friendly machine +names: * *regression-test* * *sally-test-box1* From 1fe62a0c41d79a34699a928d53265fcad1179d2f Mon Sep 17 00:00:00 2001 From: Kristal Dale Date: Fri, 28 Sep 2018 16:23:26 -0700 Subject: [PATCH 9/9] - corrected reST formatting (indentation) Signed-off-by: Kristal Dale --- .../guides/maintenance/hostname.rst | 24 +++++++++---------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/source/clear-linux/guides/maintenance/hostname.rst b/source/clear-linux/guides/maintenance/hostname.rst index 04173288..04c7108e 100644 --- a/source/clear-linux/guides/maintenance/hostname.rst +++ b/source/clear-linux/guides/maintenance/hostname.rst @@ -31,8 +31,8 @@ Make sure to reboot after setting a new hostname. .. code-block:: bash - sudo hostnamectl set-hostname telemetry-test-2-h15 - sudo reboot + sudo hostnamectl set-hostname telemetry-test-2-h15 + sudo reboot .. note:: @@ -54,21 +54,21 @@ View your current hostname using the following command: .. code-block:: bash - hostnamectl + hostnamectl You should see output similar to: .. code-block:: console - Static hostname: telemetry-test-2-h15 - Pretty hostname: telemetry-test-2-h15 - Icon name: computer-desktop - Chassis: desktop - Machine ID: 4d0d60207a904ebbab96680a51ac1339 - Boot ID: 98d3514e5a984e8cbbdf46a2f0d6b397 - Operating System: Clear Linux OS - Kernel: Linux 4.18.8-632.native - Architecture: x86-64 + Static hostname : telemetry-test-2-h15 + Pretty hostname : telemetry-test-2-h15 + Icon name : computer-desktop + Chassis : desktop + Machine ID : 4d0d60207a904ebbab96680a51ac1339 + Boot ID : 98d3514e5a984e8cbbdf46a2f0d6b397 + Operating System : Clear Linux OS + Kernel : Linux 4.18.8-632.native + Architecture : x86-64 **Congratulations!** You successfully modified the hostname of your |CL| system.