From daa1a459971f45b2b44c13135c55457ab21eb8c9 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Thu, 28 Jun 2018 13:28:43 -0700 Subject: [PATCH 1/9] 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 7386f26245e964fd274a1610a58795f7f372afba Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Mon, 2 Jul 2018 12:21:18 -0700 Subject: [PATCH 2/9] 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 3/9] 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 4/9] 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 5/9] 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 6/9] 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 7/9] 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 8/9] 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 963039ec224aaaa0647a2988ef9c93e025646f47 Mon Sep 17 00:00:00 2001 From: Kevin Putnam Date: Tue, 3 Jul 2018 16:59:34 -0700 Subject: [PATCH 9/9] 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