View source for Update/P11

The update procedure from p10 to p11 is similar to the [[Update/p10|update to p10]].

= Upgrade =

{{Attention|The license agreement of the originally installed system remains in effect during the upgrade process.}}
{{Note|All the commands in this article require [[root]] permissions}}
{{Attention|Since the upgrade affects the D-Bus service as well, the upgrade process may cause Xorg to crash. Therefore, it is better to run the distribution upgrade command {{cmd|apt-get dist-upgrade}} directly in the text console ({{button|Ctrl}}+{{button|Alt}}+{{button|F2}})}}
{{Attention|First read the "[[#Known issues|Known issues]]" section at the end of the article.}}
== 0. Make a backup of your system before upgrading ==

{{Attention|If you are not sure that you can fix the system yourself in case of a failed upgrade, make sure to make a [[Shadow Copy+Recovery point|system backup]] ([https://www.altlinux.org/Теневое_копирование%2BТочка_восстановления [ru]])!}}
It is advisable to [[Synaptic#Uninstall_programs|uninstall all packages you don't need]] ([https://www.altlinux.org/Synaptic [ru]]), and [[Alterator-services|disable unneeded services]] ([https://www.altlinux.org/Alterator-services [ru]]) before upgrading your system. This will save you some time during the upgrade process, and reduce the traffic of downloaded packages.

Third-party packages that are not in the p10 repository may not be supported by the upgraded system and may interfere with a successful upgrade.

== 1. Upgrade the distribution to the latest p10 ==

All operations must be done [[root|with root user permissions]].

 # apt-get update
 # apt-get dist-upgrade

== 2. Check [[apt-repo]] ==
Most likely the utility has already been installed and updated in the first step, but just in case, check for the following:
 # apt-get install apt-repo

== 3. Change the update sources ==
{{Note|The following command will replace all sources in the {{path|/etc/apt/sources.list}} file. If you have third-party repositories defined, make a backup of the file.}}
 # apt-repo set p11

To upgrade from p10 to p11, it is not enough to just change sources. apt-repo does everything necessary: in addition to changing sources, it creates a file {{path|/etc/rpm/macros.d/priority_distbranch}} with the following contents: <source lang="text">%_priority_distbranch p11</source>

<!-- Пакета нет в p11!
== 4. Install the libcrypto1.1 library ==

{{Attention|Normally, this item does not need to be executed. However, if the number of packages to be removed is large (more than 61), it may be required.}}

The libcrypto1.1 library must be installed for the upgrade to work correctly:
 # apt-get update
 # apt-get install libcrypto1.1
-->

== 4. Upgrade to p11 ==
{{Attention|Since the upgrade affects the D-Bus service as well, the upgrade process may cause Xorg to crash. Therefore, it is better to run the distribution upgrade command {{cmd|apt-get dist-upgrade}} directly in the text console (press {{button|Ctrl}}+{{button|Alt}}+{{button|F2}}, enter root and your root user password).}}
{{Note|You can use {{prg|screen}} or {{prg|tmux}}. In this case, a crash of xorg should not cause the console running the upgrade procedure to close, and it can be reconnected from the text console accessible from {{button|Ctrl}}+{{button|Alt}}+{{button|F2}}.On a system with systemd, pre-install the {{pkg|systemd-settings-disable-kill-user-processes}} package, restart the systemd-logind<ref>https://bugzilla.altlinux.org/40840</ref> service and log in (re-login) again.}}
 # apt-get update

{{Note|Optional step:
 # apt-get clean
 # apt-get dist-upgrade -d
The first command will remove all old packages from the apt cache, the second will download (but not install) all the packages you need. If you have already downloaded something new, it may be advantageous to use autoclean instead of clean. The resulting contents of /var/cache/apt can be used for a subsequent bulk installation of packages via rpm in case of upgrade problems.}}

{{Attention|On systems using SecureBoot, it is mandatory to update the kernel with the {{cmd|update-kernel}} command '''<u>before rebooting</u>'''. Otherwise, the system may become unbootable!}}

Perform the actual upgrade:
 # apt-get dist-upgrade
 # update-kernel

If at the end of the upgrade it says <source lang="text">E: Transaction errors occurred</source> run <source lang="text"># apt-get -f install
# apt-get dist-upgrade</source>

== 5. Reboot ==
{{Attention|On systems using SecureBoot, it is mandatory to update the kernel with the {{cmd|update-kernel}} command '''<u>before rebooting</u>'''. Otherwise the system may become unbootable!}}
Reboot the system.

== 6. Removing obsolete packages ==

Use the tips at [[APT in ALT Linux/Tips for using]] to remove obsolete packages.

= Upgrade via [http://wiki.etersoft.ru/EPM EPM] =
You can upgrade from p10 to p11 using the epm program by first installing the latest version:
 # apt-get install eepm <!-- && epm install 281952 -->
and then commanding:
 # epm release-upgrade
{{Attention|It is recommended to run the remote update either through a screen or tmux session (but even in these you will get a relogin warning and things won't go any further), or with <code>--force --auto</code> &mdash; with no guarantee of successful completion. So it's better to do it from the physical console.}}
Next, update the kernel:
 # update-kernel
Remove obsolete packages with the command:
 # epm autoremove --direct
The program will perform all necessary actions for the upgrade, including the commands described above in the manual upgrade order.

= Known issues =

1. Removing {{pkg|scilab}} (the Higher Education profile in Alt Education). The new version has not been built yet.

2. Removing {{pkg|qgis3-python}}. Install
  apt-get install qgis-python

3. Removing {{pkg|swi-prolog}}. The new version has not been built yet.

4. Removing {{pkg|transcode}}. The package is no longer supported.

5. Removing {{pkg|gz-sim}}. Install
  apt-get install gz-sim

6. Removing {{pkg|postgresql14-1C-server}}. To upgrade to the new major version of {{pkg|postgresql16-1C-server}}, please use the following instructions https://www.postgresql.org/docs/10/upgrading.html and use the intermediate {{pkg|postgresql14-server}} package.

= Notes =
{{Notes}}

[[Category:Eleventh Platform]]

{{Category navigation|title=More about the Eleventh Platform|category=Eleventh Platform}}