From 955cc47b2a412e89c697c94101a44621a5b895d1 Mon Sep 17 00:00:00 2001 From: Peter Boy Date: Thu, 17 Aug 2023 20:52:56 +0200 Subject: [PATCH] Fixes various minor issues. --- modules/ROOT/nav.adoc | 2 +- ...rtant-keeping-your-system-up-to-date.adoc} | 0 ...elete-proc_manual-updating-using-cli.adoc} | 0 ...elete-proc_manual-updating-using-gui.adoc} | 0 ...elete-proc_setting-automatic-updates.adoc} | 0 modules/ROOT/pages/fonts.adoc | 2 +- .../pages/installing-and-running-vlc.adoc | 2 +- ...-plugins-for-playing-movies-and-music.adoc | 2 +- modules/ROOT/pages/installing-spotify.adoc | 2 +- modules/ROOT/pages/reset-root-password.adoc | 2 +- ...g-the-system-by-keeping-it-up-to-date.adoc | 135 ++++++++++++++++-- ...adoc => upgrading-fedora-new-release.adoc} | 4 +- ...ade.adoc => upgrading-fedora-offline.adoc} | 3 +- .../ROOT/pages/upgrading-fedora-online.adoc | 2 +- modules/ROOT/pages/zoom.adoc | 4 +- 15 files changed, 139 insertions(+), 21 deletions(-) rename modules/ROOT/pages/_partials/{con_why-it-is-important-keeping-your-system-up-to-date.adoc => 2delete-con_why-it-is-important-keeping-your-system-up-to-date.adoc} (100%) rename modules/ROOT/pages/_partials/{proc_manual-updating-using-cli.adoc => 2delete-proc_manual-updating-using-cli.adoc} (100%) rename modules/ROOT/pages/_partials/{proc_manual-updating-using-gui.adoc => 2delete-proc_manual-updating-using-gui.adoc} (100%) rename modules/ROOT/pages/_partials/{proc_setting-automatic-updates.adoc => 2delete-proc_setting-automatic-updates.adoc} (100%) rename modules/ROOT/pages/{upgrading.adoc => upgrading-fedora-new-release.adoc} (98%) rename modules/ROOT/pages/{dnf-system-upgrade.adoc => upgrading-fedora-offline.adoc} (99%) diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc index f271e1e..0133ab0 100644 --- a/modules/ROOT/nav.adoc +++ b/modules/ROOT/nav.adoc @@ -28,7 +28,7 @@ ** xref:repositories.adoc[Fedora Repositories] ** xref:finding-and-installing-linux-applications.adoc[Finding and installing Linux applications] ** xref:adding-or-removing-software-repositories-in-fedora.adoc[Adding or removing software repositories in Fedora] -** xref:setup_rpmfusion.adoc[Enabling the RPM Fusion repositories] +** xref:rpmfusion-setup.adoc[Enabling the RPM Fusion repositories] ** xref:fonts.adoc[Adding new fonts] ** xref:packagekit-not-found.adoc[PackageKit Items Not Found] ** xref:securing-the-system-by-keeping-it-up-to-date.adoc[Securing the system by keeping it up-to-date] diff --git a/modules/ROOT/pages/_partials/con_why-it-is-important-keeping-your-system-up-to-date.adoc b/modules/ROOT/pages/_partials/2delete-con_why-it-is-important-keeping-your-system-up-to-date.adoc similarity index 100% rename from modules/ROOT/pages/_partials/con_why-it-is-important-keeping-your-system-up-to-date.adoc rename to modules/ROOT/pages/_partials/2delete-con_why-it-is-important-keeping-your-system-up-to-date.adoc diff --git a/modules/ROOT/pages/_partials/proc_manual-updating-using-cli.adoc b/modules/ROOT/pages/_partials/2delete-proc_manual-updating-using-cli.adoc similarity index 100% rename from modules/ROOT/pages/_partials/proc_manual-updating-using-cli.adoc rename to modules/ROOT/pages/_partials/2delete-proc_manual-updating-using-cli.adoc diff --git a/modules/ROOT/pages/_partials/proc_manual-updating-using-gui.adoc b/modules/ROOT/pages/_partials/2delete-proc_manual-updating-using-gui.adoc similarity index 100% rename from modules/ROOT/pages/_partials/proc_manual-updating-using-gui.adoc rename to modules/ROOT/pages/_partials/2delete-proc_manual-updating-using-gui.adoc diff --git a/modules/ROOT/pages/_partials/proc_setting-automatic-updates.adoc b/modules/ROOT/pages/_partials/2delete-proc_setting-automatic-updates.adoc similarity index 100% rename from modules/ROOT/pages/_partials/proc_setting-automatic-updates.adoc rename to modules/ROOT/pages/_partials/2delete-proc_setting-automatic-updates.adoc diff --git a/modules/ROOT/pages/fonts.adoc b/modules/ROOT/pages/fonts.adoc index 1117a82..b548794 100644 --- a/modules/ROOT/pages/fonts.adoc +++ b/modules/ROOT/pages/fonts.adoc @@ -40,7 +40,7 @@ If you prefer working in a C.L.I., you can also install fonts with [application] Add or enable third-party repositories with font packages:: Many fonts are available from the RPM Fusion repository. -To enable the repository on your system, follow xref:setup_rpmfusion.adoc[these instructions]. +To enable the repository on your system, follow xref:rpmfusion-setup.adoc[these instructions]. List all available font packages from enabled repositories:: [source,] diff --git a/modules/ROOT/pages/installing-and-running-vlc.adoc b/modules/ROOT/pages/installing-and-running-vlc.adoc index 92bc226..9cd71c7 100644 --- a/modules/ROOT/pages/installing-and-running-vlc.adoc +++ b/modules/ROOT/pages/installing-and-running-vlc.adoc @@ -12,7 +12,7 @@ include::{partialsdir}/3rdparty-message.adoc[] == Prerequisites -* VLC is provided by the RPMFusion repositories. xref:setup_rpmfusion.adoc[Use these instructions to enable them]. +* VLC is provided by the RPMFusion repositories. xref:rpmfusion-setup.adoc[Use these instructions to enable them]. :leveloffset: +1 diff --git a/modules/ROOT/pages/installing-plugins-for-playing-movies-and-music.adoc b/modules/ROOT/pages/installing-plugins-for-playing-movies-and-music.adoc index 9afc5ac..0bab8cf 100644 --- a/modules/ROOT/pages/installing-plugins-for-playing-movies-and-music.adoc +++ b/modules/ROOT/pages/installing-plugins-for-playing-movies-and-music.adoc @@ -13,7 +13,7 @@ WARNING: If you live in a country where software patents apply, such as in the U == Prerequisites -* xref:setup_rpmfusion.adoc[Enable the RPMFusion repositories]. +* xref:rpmfusion-setup.adoc[Enable the RPMFusion repositories]. == Procedure diff --git a/modules/ROOT/pages/installing-spotify.adoc b/modules/ROOT/pages/installing-spotify.adoc index 3f57505..9f57dfa 100644 --- a/modules/ROOT/pages/installing-spotify.adoc +++ b/modules/ROOT/pages/installing-spotify.adoc @@ -91,7 +91,7 @@ snap install spotify For this method, please refer to the link:https://github.com/leamas/lpf[`lpf GitHub Page`] requirements. -. xref:setup_rpmfusion.adoc[Enable the RPMFusion repositories]. +. xref:rpmfusion-setup.adoc[Enable the RPMFusion repositories]. . Install the `lpf-spotify-client` package: + ---- diff --git a/modules/ROOT/pages/reset-root-password.adoc b/modules/ROOT/pages/reset-root-password.adoc index 842d73f..f6d239c 100644 --- a/modules/ROOT/pages/reset-root-password.adoc +++ b/modules/ROOT/pages/reset-root-password.adoc @@ -85,7 +85,7 @@ Once it is complete, your system is ready and your root password has been succes To _download_ and create a live USB of Fedora Workstation, follow the instructions on the xref:creating-and-using-a-live-installation-image.adoc[Fedora USB Live Media Quick Doc]. __For additional information__, specifically about live media using BTRFS, see also -https://docs.fedoraproject.org/en-US/quick-docs/bootloading-with-grub2/#restoring-bootloader-using-live-disk[Restoring the bootloader using the Live disk] +https://docs.fedoraproject.org/en-US/quick-docs/grub2-bootloader/#restoring-bootloader-using-live-disk[Restoring the bootloader using the Live disk] ==== . Boot the Live installation media and choose `Try Fedora`. diff --git a/modules/ROOT/pages/securing-the-system-by-keeping-it-up-to-date.adoc b/modules/ROOT/pages/securing-the-system-by-keeping-it-up-to-date.adoc index 614764b..f0a5ccc 100644 --- a/modules/ROOT/pages/securing-the-system-by-keeping-it-up-to-date.adoc +++ b/modules/ROOT/pages/securing-the-system-by-keeping-it-up-to-date.adoc @@ -1,10 +1,15 @@ -ifdef::context[:parent-context: {context}] -:context: securing-the-system-by-keeping-it-up-to-date :experimental: include::{partialsdir}/attributes.adoc[] -[id='securing-the-system-by-keeping-it-up-to-date'] = Securing the system by keeping it up-to-date +Connor Lim; Petr Bokoc; Mirek Jahoda +:revnumber: unspecified +:revdate: 2021-01-29 +:category: Administration +:tags: How-to Security Update +//:page-aliases: + + This section explains: @@ -12,13 +17,127 @@ This section explains: * How to apply updates manually by using the xref:securing-the-system-by-keeping-it-up-to-date.adoc#manual-updating-using-gui[GUI] or xref:securing-the-system-by-keeping-it-up-to-date.adoc#manual-updating-using-cli[CLI] * xref:securing-the-system-by-keeping-it-up-to-date.adoc#setting-automatic-updates[How to enable automatic updates] -include::{partialsdir}/con_why-it-is-important-keeping-your-system-up-to-date.adoc[leveloffset=+1] -include::{partialsdir}/proc_manual-updating-using-gui.adoc[leveloffset=+1] -include::{partialsdir}/proc_manual-updating-using-cli.adoc[leveloffset=+1] +== Why it is important to keep your system up-to-date -include::{partialsdir}/proc_setting-automatic-updates.adoc[leveloffset=+1] +// Bara: This section is based on https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/security_guide/chap-keeping_your_system_up-to-date + +This section briefly explains the importance of updating your system on a regular basis. + +All software contains bugs. Often, these bugs can result in a vulnerability that can expose your system to malicious users. Packages that have not been updated are a common cause of computer intrusions. Implement a plan for installing security patches in a timely manner to quickly eliminate discovered vulnerabilities, so they cannot be exploited. + + + +== Manual updating using GUI + +This section describes how to manually download and install new updates by using GUI. + +[discrete] +=== Procedure + +. Hover the cursor over the upper-left corner of the screen and type "Software" and select the Software application to open it. + +. Click the btn:[Updates] button to view the available updates. + +. Click the btn:[Download] button to download new updates. + +. After the updates are downloaded click the btn:[Restart & Update] button. Your system will restart to perform the upgrade. + +image::software-updates.png[Updating by using the Software application] + + + +== Manual updating using CLI + +This section describes how to manually download and install new updates by using the DNF +package manager. + + +[discrete] +=== Procedure + +* Upgrade the system: ++ +---- +sudo dnf upgrade +---- ++ +Confirm to download the available packages. + + +[discrete] +=== Additional Resources + +* The `dnf(8)` manual page + + + +== Setting automatic updates + +This section describes how to use the DNF Automatic application to automatically: + +* Download and install any new updates +* Only download the updates +* Get notified about the updates + +[discrete] +=== Procedure + +. Install the [package]_dnf-automatic_ package: ++ +---- +sudo dnf install dnf-automatic +---- + +. Edit the [filename]`/etc/dnf/automatic.conf` configuration file as needed. See the https://dnf.readthedocs.io/en/latest/automatic.html[DNF Automatic] documentation for details. + +. Enable and start the `systemd` timer: ++ +[literal,subs="+quotes,attributes"] +---- +sudo systemctl enable --now _timer_ +---- ++ +Replace `_timer_` with one of following ones depending on what action you want to do: ++ +-- +* `dnf-automatic-install.timer` to download and install packages +* `dnf-automatic-download.timer` to only download packages +* `dnf-automatic-notifyonly.timer` to only get a notification using configured emitters in the [filename]`/etc/dnf/automatic.conf` file. +-- ++ +For example: ++ +---- +sudo systemctl enable --now dnf-automatic-install.timer +Created symlink /etc/systemd/system/timers.target.wants/dnf-automatic-install.timer → /usr/lib/systemd/system/dnf-automatic-install.timer. +---- + +. Ensure that the timer has been successfully enabled and started: ++ +[literal,subs="+quotes,attributes"] +---- +sudo systemctl status _timer_ +---- ++ +Replace `_timer_` with the timer from the previous step, for example: ++ +---- +sudo systemctl status dnf-automatic-install.timer +● dnf-automatic-install.timer - dnf-automatic-install timer + Loaded: loaded (/usr/lib/systemd/system/dnf-automatic-install.timer; enabled; vendor preset: disabled) + Active: active (waiting) since Fri 2021-01-29 14:50:22 +08; 1s ago + Trigger: Sat 2021-01-30 06:05:57 +08; 15h left + Triggers: ● dnf-automatic-install.service + +Jan 29 14:50:22 localhost.localdomain systemd[1]: Started dnf-automatic-install timer. +---- + +[discrete] +=== Additional Resources + +* The https://dnf.readthedocs.io/en/latest/automatic.html[DNF Automatic] documentation [discrete] @@ -26,5 +145,3 @@ include::{partialsdir}/proc_setting-automatic-updates.adoc[leveloffset=+1] * The xref:f{MAJOROSVER}@fedora:system-administrators-guide:package-management/DNF.adoc[DNF] chapter in the Fedora System Administrator's Guide -ifdef::parent-context[:context: {parent-context}] -ifndef::parent-context[:!context:] diff --git a/modules/ROOT/pages/upgrading.adoc b/modules/ROOT/pages/upgrading-fedora-new-release.adoc similarity index 98% rename from modules/ROOT/pages/upgrading.adoc rename to modules/ROOT/pages/upgrading-fedora-new-release.adoc index a4a5d5e..49bb9c9 100644 --- a/modules/ROOT/pages/upgrading.adoc +++ b/modules/ROOT/pages/upgrading-fedora-new-release.adoc @@ -1,10 +1,10 @@ -= Upgrading to a new release of Fedora += Upgrading Fedora to a New Release Jun Aruga; Kamil Páral; Ben Cotton :revnumber: F37, F38 :revdate: 2022-09-14 :category: Administration :tags: How-to Upgrade -//:page-aliases: +:page-aliases: upgrading.adoc diff --git a/modules/ROOT/pages/dnf-system-upgrade.adoc b/modules/ROOT/pages/upgrading-fedora-offline.adoc similarity index 99% rename from modules/ROOT/pages/dnf-system-upgrade.adoc rename to modules/ROOT/pages/upgrading-fedora-offline.adoc index 7d27aef..8b42064 100644 --- a/modules/ROOT/pages/dnf-system-upgrade.adoc +++ b/modules/ROOT/pages/upgrading-fedora-offline.adoc @@ -1,9 +1,10 @@ -= DNF System Upgrade += Upgrading Fedora Using DNF System Plugin Michael Wu; Anthony McGlone; The Fedora Docs team :revnumber: F38 :revdate: 2023-05-04 :category: Administration :tags: How-to Upgrade +:page-aliases: dnf-system-upgrade.adoc include::ROOT:partial$attributes.adoc[] diff --git a/modules/ROOT/pages/upgrading-fedora-online.adoc b/modules/ROOT/pages/upgrading-fedora-online.adoc index a9b3a27..8698be1 100644 --- a/modules/ROOT/pages/upgrading-fedora-online.adoc +++ b/modules/ROOT/pages/upgrading-fedora-online.adoc @@ -1,4 +1,4 @@ -= Upgrading Fedora using package manager += Upgrading Fedora Online Using Package Manager Ben Cotton; Kamil Páral; Caleb McKee :revnumber: F37, F38 :revdate: 2022-05-04 diff --git a/modules/ROOT/pages/zoom.adoc b/modules/ROOT/pages/zoom.adoc index 3059b51..808b270 100644 --- a/modules/ROOT/pages/zoom.adoc +++ b/modules/ROOT/pages/zoom.adoc @@ -1,7 +1,7 @@ = Installing Zoom on Fedora - N.B.; The Fedora Documentation Team + Akshata Khedekar :revnumber: unknown -:revdate: 2022 +:revdate: 2021 :category: Administration :tags: How-to Video //:page-aliases: