aboutsummaryrefslogtreecommitdiff
path: root/content/docs/gentoo/upgrades.md
blob: 07d5c6b4e44377f104c58ea524324d4cce6ff6f6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
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