From 51de93e5b6b7a6b497e78b999a754f7d5086ddcc Mon Sep 17 00:00:00 2001
From: Julien Dessaux
Date: Fri, 16 Apr 2021 17:42:55 +0200
Subject: Added articles

---
 content/docs/gentoo/upgrades.md | 39 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 content/docs/gentoo/upgrades.md

(limited to 'content/docs/gentoo')

diff --git a/content/docs/gentoo/upgrades.md b/content/docs/gentoo/upgrades.md
new file mode 100644
index 0000000..07d5c6b
--- /dev/null
+++ b/content/docs/gentoo/upgrades.md
@@ -0,0 +1,39 @@
+---
+title: "Gentoo Packages Upgrades"
+description: Gentoo packages upgrades on adyxax.org
+---
+
+## Introduction
+
+Here is my go to set of commands when I upgrade a gentoo box :
+{{< highlight sh >}}
+emerge-webrsync
+eselect news read
+{{< /highlight >}}
+
+The news have to be reviewed carefully and if I cannot act on it immediately I copy paste the relevant bits to my todolist.
+
+## The upgrade process
+
+I run the upgrade process in two steps. The first one is a straightforward upgrade that will stop upon any error to let you asses the situation :
+{{< highlight sh >}}
+emerge --update --newuse --deep --with-bdeps=y @world -q
+{{< /highlight >}}
+
+If all went well we can get to the cleaning pass :
+{{< highlight sh >}}
+unset ld_library_path && unset e_src && emerge -qaavutdn world --verbose-conflicts --keep-going && emerge --depclean -a && revdep-rebuild -i -- -q --keep-going; eclean distfiles
+{{< /highlight >}}
+
+After all this completes it is time to evaluate configuration changes :
+{{< highlight sh >}}
+etc-update
+{{< /highlight >}}
+
+If a new kernel has been emerged, have a look at [the specific process for that]({{< ref "kernel_upgrades" >}}).
+
+## Post-upgrade
+
+Depending of the changes it is now time to :
+- restart services that have been upgraded
+- reboot if the kernel or a crucial system component (like openssl) has been upgraded
-- 
cgit v1.2.3