Difference between revisions of "System Maintenance"

Revision as of 10:18, 9 March 2018

General Recommendation

Partial updates/upgrades are unsupported Archlinux wiki - System Maintenance

Manjaro is a rolling release distribution. That means when new library versions are pushed to the repos, all developers and packagers, rebuild all packages against the libraries. For example, if two packages depend on the same library, upgrading only one package might also upgrade library (as a dependency), which might then break the other package which depends on an older version of the library.
That is why partial upgrades are not supported. do not use pacman -Sy [package] or any equivalent sua as pacman -Sy followed by pacman -S [package]. Always upgrade (with pacman -Syu) before installing a package. Be very careful when useing IgnorePkg and IgnoreGroup for the same reason. If the system has locally installed packages (such as AUR packages), users will need to rebuild them when theri dependices recieve a soname bump.
If a partial upgrade scenario has been created, and binaries are broken because they cannot find the libraries they are linked against, do not "fix" the problem simply by symlinking. Libraries receive soname bumps when they are not backwards compatible. A simple pacman -Syu to a properly synced mirror will fix the problem as long as pacman is not broken.
The bash script checkupdates, included with the pacman package, provides a safe way to check for upgrades to installed packages without running a system update at the same time.

Act on alerts during an upgrade

When upgrading the system, be sure to pay attention to the alert notices provided by pacman. If any additional actions are required by the user, be sure to take care of them right away. If a pacman alert is confusing, search the forums and the recent news posts for more detailed instructions.

Deal promptly with new configuration files

When pacman is invoked, .pacnew and .pacsave files can be created. Pacman provides notice when this happens and users must deal with these files promptly. Users are referred to the Pacman/Pacnew and Pacsave wiki page for detailed instructions.
Also, think about other configuration files you may have copied or created. If a package had an example configuration that you copied to your home directory, check to see if a new one has been created.

Manjaro Recommandation

In addition to the above mentioned points, Archlinux has only one branch, 'Manjaro has three.

Always follow these Manjaro recommendations:

Do not make temporary branch changes and mix in packages from other branches. It is - we believe - one cause of partial updates which can break systems.

Do a full system update after changing branch or updating your mirror list

sudo pacman -Syyu

Before installing new packages do a full system update

sudo pacman -Syu [some-package-name]

Do not downgrade using the pacman downgrade switch (-Suu).

@@ Line 1: / Line 1: @@
 == General Recommendation ==
+<blockquote>
 === Partial updates/upgrades are unsupported <small>Archlinux wiki - System Maintenance</small>===
-When new library versions are pushed to the repos, all developers and packagers, rebuild all packages against the libraries. For example, if two packages depend on the same library, upgrading only one package might also upgrade library (as a dependency), which might then break the other package which depends on an older version of the library.
+Manjaro is a rolling release distribution. That means when new library versions are pushed to the repos, all developers and packagers, rebuild all packages against the libraries. For example, if two packages depend on the same library, upgrading only one package might also upgrade library (as a dependency), which might then break the other package which depends on an older version of the library.
 That is why partial upgrades are '''not supported'''. do not use <code>pacman -Sy [package]</code> or any equivalent sua as <code>pacman -Sy</code> followed by <code>pacman -S [package]</code>. '''Always''' upgrade (with <code>pacman -Syu</code>) before installing a package. Be very careful when useing <code>IgnorePkg</code> and <code>IgnoreGroup</code> for the same reason. If the system has locally installed packages (such as AUR packages), users will need to rebuild them when theri dependices recieve a soname bump.
-'''Always''' follow these recommendations:
+If a partial upgrade scenario has been created, and binaries are broken because they cannot find the libraries they are linked against, do not "fix" the problem simply by symlinking. Libraries receive soname bumps when they are not backwards compatible. A simple pacman -Syu to a properly synced mirror will fix the problem as long as pacman is not broken.
-* Do not make temporary branch changes and mix in packages from other branches. It is - we believe - one cause of partial updates which can break systems.
+The bash script checkupdates, included with the pacman package, provides a safe way to check for upgrades to installed packages without running a system update at the same time.
-* Do a full system update after changing branch or updating your mirrorlist
+=== Act on alerts during an upgrade ===
+When upgrading the system, be sure to pay attention to the alert notices provided by pacman. If any additional actions are required by the user, be sure to take care of them right away. If a pacman alert is confusing, search the forums and the recent news posts for more detailed instructions.
+=== Deal promptly with new configuration files ===
+When pacman is invoked, .pacnew and .pacsave files can be created. Pacman provides notice when this happens and users must deal with these files promptly. Users are referred to the Pacman/Pacnew and Pacsave wiki page for detailed instructions.
+Also, think about other configuration files you may have copied or created. If a package had an example configuration that you copied to your home directory, check to see if a new one has been created.
+</blockquote>
+== Manjaro Recommandation ==
+In addition to the above mentioned points, Archlinux has only one branch, '''Manjaro'' has three.
+'''Always''' follow these '''Manjaro''' recommendations:
+* '''Do not make temporary branch changes''' and mix in packages from other branches. It is - we believe - one cause of partial updates which can break systems.
+* '''Do a full system update''' after changing branch or updating your mirror list
   sudo pacman -Syyu
-* When you install a package update your system
+* '''Before installing new packages''' do a full system update
   sudo pacman -Syu [some-package-name]
-* '''Do not''' use the pacman downgrade switch (-Suu).
+* '''Do not downgrade''' using the pacman downgrade switch (-Suu).