Added articles

1 files changed, 39 insertions, 0 deletions

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