From 04fed04b72aacee3153a89fbb522ce5d101506bc Mon Sep 17 00:00:00 2001 From: Rodrigo Caballero Date: Tue, 13 Jun 2017 09:12:55 -0500 Subject: [PATCH 1/3] Update the instructions to run swupd to account for auto-update. Signed-off-by: Rodrigo Caballero --- source/clear-linux/how-to/swupd/run.rst | 73 +++++++++++++------------ 1 file changed, 37 insertions(+), 36 deletions(-) diff --git a/source/clear-linux/how-to/swupd/run.rst b/source/clear-linux/how-to/swupd/run.rst index 8fa4bb20..250eab3f 100644 --- a/source/clear-linux/how-to/swupd/run.rst +++ b/source/clear-linux/how-to/swupd/run.rst @@ -1,59 +1,60 @@ .. _swupd-run: -How to run the updater -###################### +How to update Clear Linux +######################### -This section describes how to manually trigger the software update code in -Clear Linux\* OS for Intel® Architecture. +This section describes how to update |CLOSIA|. Prerequisites ============= -- System is up and running a Clear Linux OS for Intel - Architecture official build, 7420 later. +* The system is up and running the Clear Linux 15400 build or later. -- Device is on a well-connected network. +* Device is on a well-connected network. -- Device is able to connect to release infrastructure. For example: - http://update.clearlinux.org/update/300/ +* Device is able to connect to the release infrastructure. For example: + http://update.clearlinux.org/update/300/ -Running the updater -=================== +How to update the system +======================== -#. Open a Terminal Emulator. +Starting with version 15400, Clear Linux supports auto-update. By default, it +is turned on. -#. Become root and trigger an update with this command: +To verify the current auto-update setting: .. code-block:: console - $ swupd update + $ swupd autoupdate -#. If the updater console output indicates a kernel update occurred, - then at your convenience reboot to begin using the new OS version. +To enable auto-update: -Updater options -=============== + .. code-block:: console -Help options: + $ sudo swupd autoupdate --enable -.. code-block:: console +To disable auto-update: - -h, --help Display help options. + .. code-block:: console -Application options: + $ sudo swupd autoupdate --disable -.. code-block:: console +If you wish to force a manual update: - -d, --download Download all content, but do not actually install the update - -u, --url=[URL] RFC-3986 encoded url for version string and content file downloads - -P, --port=[port #] Port number to connect to at the url for version string and content file downloads - -c, --contenturl=[URL] RFC-3986 encoded url for content file downloads - -v, --versionurl=[URL] RFC-3986 encoded url for version string download - -s, --status Show current OS version and latest version available on server - -F, --format=[staging,1,2,etc.] the format suffix for version file downloads - -p, --path=[PATH...] Use [PATH...] as the path to verify (eg: a chroot or btrfs subvol - -x, --force Attempt to proceed even if non-critical errors found - -n, --nosigcheck Do not attempt to enforce certificate or signature checking - -S, --statedir Specify alternate swupd state directory - -C, --certpath Specify alternate path to swupd certificates - -t, --time Show verbose time output for swupd operations + .. code-block:: console + + $ sudo swupd update + +.. note:: + + If the updater console output indicates a kernel update occurred, then at + your convenience reboot to begin using the new OS version. + +Additional information +====================== + +To see the man page listing additional swupd options, enter: + + .. code-block:: console + + $ man swupd From 9d5e13a7fb29a6cd4bb65cad5fbc9f637da051e6 Mon Sep 17 00:00:00 2001 From: Rodrigo Caballero Date: Tue, 13 Jun 2017 14:15:12 -0500 Subject: [PATCH 2/3] Apply feedback on updated swupd content. Signed-off-by: Rodrigo Caballero --- source/clear-linux/how-to/swupd/run.rst | 19 +++++++++++++------ 1 file changed, 13 insertions(+), 6 deletions(-) diff --git a/source/clear-linux/how-to/swupd/run.rst b/source/clear-linux/how-to/swupd/run.rst index 250eab3f..293fd06c 100644 --- a/source/clear-linux/how-to/swupd/run.rst +++ b/source/clear-linux/how-to/swupd/run.rst @@ -8,12 +8,18 @@ This section describes how to update |CLOSIA|. Prerequisites ============= -* The system is up and running the Clear Linux 15400 build or later. +* The system is up and running the Clear Linux 15400 release or later. -* Device is on a well-connected network. +* The device is on a well-connected network. -* Device is able to connect to the release infrastructure. For example: - http://update.clearlinux.org/update/300/ +* 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 ======================== @@ -47,8 +53,9 @@ If you wish to force a manual update: .. note:: - If the updater console output indicates a kernel update occurred, then at - your convenience reboot to begin using the new OS version. + When the swupd console output indicates a kernel update, then reboot + immediately for the enhancements to take effect. + Additional information ====================== From 4c417f9f002e91ec11963bc3d81d109173db48b5 Mon Sep 17 00:00:00 2001 From: Rodrigo Caballero Date: Wed, 14 Jun 2017 09:27:04 -0500 Subject: [PATCH 3/3] Fix minor wording issues for consistency and clarity. Signed-off-by: Rodrigo Caballero --- source/clear-linux/how-to/swupd/run.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/clear-linux/how-to/swupd/run.rst b/source/clear-linux/how-to/swupd/run.rst index 293fd06c..83d1ecb3 100644 --- a/source/clear-linux/how-to/swupd/run.rst +++ b/source/clear-linux/how-to/swupd/run.rst @@ -45,7 +45,7 @@ To disable auto-update: $ sudo swupd autoupdate --disable -If you wish to force a manual update: +To force a manual update: .. code-block:: console @@ -53,7 +53,7 @@ If you wish to force a manual update: .. note:: - When the swupd console output indicates a kernel update, then reboot + When the swupd console output indicates a kernel update, reboot immediately for the enhancements to take effect.