mirror of
https://github.com/YunoHost/doc.git
synced 2024-09-03 20:06:26 +02:00
Fix typos in english Bullseye migration doc (#2140)
This commit is contained in:
parent
0292baa9ff
commit
50d1503eec
1 changed files with 17 additions and 17 deletions
|
@ -13,9 +13,9 @@ This page is dedicated to help you migrating an instance from YunoHost 4.4.x (ru
|
|||
|
||||
- The YunoHost team did its best to make sure that the migration is as smooth as possible and was tested over the course of several months in several cases.
|
||||
|
||||
- With that said, please be aware that this is a delicate operation. System administration is a complicated topic and covering every particular cases is quite hard. Therefore, if you host critical data and services, please [make backups](/backup). And in any case, be patient and attentive during the migration.
|
||||
- With that said, please be aware that this is a delicate operation. System administration is a complicated topic and covering every particular case is quite hard. Therefore, if you host critical data and services, please [make backups](/backup). And in any case, be patient and attentive during the migration.
|
||||
|
||||
- Please don't rush into thinking that you should need to reinstall your system from scratch thinking it would be "simpler" (sigh). (A common attitude is to be willing to reinstall a server at the slightest complication...) Instead, if you happen to run into issues, we encourage you to try to investigate and understand what's going on and [reach for help on the chat and the forum](/help).
|
||||
- Please don't rush into thinking that you should need to reinstall your system from scratch thinking it would be "simpler" (sigh). (A common attitude is to be willing to reinstall a server at the slightest complication...). Instead, if you happen to run into issues, we encourage you to try to investigate and understand what's going on and [reach for help on the chat and the forum](/help).
|
||||
|
||||
- **You should watch the known issues at the bottom of this page, to be sure your migrations will work properly.**
|
||||
|
||||
|
@ -45,18 +45,18 @@ Note that even if you close the webadmin page for some reason, the migration wil
|
|||
|
||||
#### If the migration crashed / failed at some point.
|
||||
|
||||
If the migration failed at some point, it should be possible to relaunch it. If it still doesn't work, you can try to [get help](/help) (please provide the corresponding messages or whatever makes you tell that it's not working).
|
||||
If the migration failed at some point, it should be possible to relaunch it. If it still doesn't work, you can try to [get help](/help) (please provide the corresponding messages or whatever makes you say that it's not working).
|
||||
|
||||
## What to do after the upgrade
|
||||
|
||||
#### Check that you actually are on Debian Bullseye and YunoHost 11.x
|
||||
|
||||
For this, go in Diagnosis (category Base system) or look at the footer of the webadmin. In the command line, you can use `lsb_release -a` and `yunohost --version`.
|
||||
For this, go to Diagnosis (category Base system) or look at the footer of the webadmin. In the command line, you can use `lsb_release -a` and `yunohost --version`.
|
||||
|
||||
#### Run the migration to repair your python app
|
||||
After upgrading, your python apps should be unavailable cause their virtual env need to be rebuild.
|
||||
After upgrading, your python apps should be unavailable because their virtual environment (venv) needs to be rebuilt.
|
||||
|
||||
To do that you can run the pending migrations in `Webadmin > Update`. The apps below won't be automatically repaired, you need to force upgrade them manually instead with `yunohost app upgrade -F APP`.
|
||||
To do that you can run the pending migrations in `Webadmin > Update`. The apps below won't be automatically repaired, you need to force-upgrade them manually instead with `yunohost app upgrade -F APP`.
|
||||
|
||||
Apps which won't be automatically repaired and need a force upgrade:
|
||||
* calibreweb
|
||||
|
@ -73,19 +73,19 @@ Apps which won't be automatically repaired and need a force upgrade:
|
|||
* weblate
|
||||
|
||||
|
||||
!!! If needed, you can disable the automatic rebuild for a specific python app, by removing the dedicated file ended by `.requirements_backup_for_bullseye_upgrade.txt` before to apply the migration. You can find this file near the venv of your app inside `/opt` or `/var/www`.
|
||||
!!! If needed, you can disable the automatic rebuild for a specific python app, by removing the dedicated file ending with `.requirements_backup_for_bullseye_upgrade.txt` before applying the migration. You can find this file near the venv (Python virtual environment) of your app inside `/opt` or `/var/www`.
|
||||
|
||||
#### Check that no issue appeared in the diagnosis
|
||||
|
||||
Also in the Diagnosis in the webadmin, make sure that no specific issue appeared after running the migration (for example a service that crashed for some reason).
|
||||
Also in the webadmin Diagnosis section, make sure that no specific issue appeared after running the migration (for example a service that crashed for some reason).
|
||||
|
||||
If the service php7.3-fpm appears to be dead, you should upgrade your PHP apps like the custom web app. Next, you can run `apt autoremove`.
|
||||
If the service `php7.3-fpm` appears to be dead, you should upgrade your PHP apps like the custom web app. Next, you can run `apt autoremove`.
|
||||
|
||||
#### Check that your applications are working
|
||||
|
||||
Test that your applications are working. If they aren't, you should try to upgrade them (it is also a good idea to upgrade them even if they are working anyway).
|
||||
|
||||
If your app is broken and you were already with the last version, you can rerun the upgrade thanks to the `-F` option:
|
||||
If your app is broken and you were already with the latest version, you can rerun the upgrade thanks to the `-F|--force` option:
|
||||
```
|
||||
yunohost app upgrade --force APP_NAME
|
||||
```
|
||||
|
@ -94,24 +94,24 @@ yunohost app upgrade --force APP_NAME
|
|||
|
||||
### Can't run the migration due to `libc6-dev : Breaks: libgcc-8-dev issue`.
|
||||
Note: This issue should be resolved in yunohost_version: 4.4.2.13
|
||||
You have an app that depends of build-essential package.
|
||||
You have an app that depends on the `build-essential` package.
|
||||
|
||||
See this [solution](https://forum.yunohost.org/t/migration-to-11-wont-start-libc6-dev-breaks-libgcc-8-dev/20617/42) to fix it manually
|
||||
|
||||
### DNSmasq is not running anymore
|
||||
|
||||
We haven't yet a solution for this issues.
|
||||
We haven't yet found solution for this issue.
|
||||
|
||||
### No ethernet connexion after a reboot after the migration on a rpi 4
|
||||
### No ethernet connexion after rebooting following a migration on a Raspberry Pi 4
|
||||
|
||||
! If you have not yet rebooted your server, don't do it we are searching a solution, to avoid the use of a keyboard and screen.
|
||||
! If you have not yet rebooted your server, don't do it (we are looking for a solution). This will avoid you the use of a keyboard and screen.
|
||||
|
||||
We found this in Rpi documentation
|
||||
We found this in the Raspberry Pi documentation
|
||||
```
|
||||
when the dhcpcd5 package is updated to the latest version (1:8.1.2-1+rpt1 -> 1:8.1.2-1+rpt2), the Raspberry Pi will fail to obtain a DHCP IP address following the next reboot or startup. This problem can be avoided by disabling and re-enabling the "System Options -> Network at Boot" option using the latest raspi-config after the dhcpcd5 package has been updated and prior to the system being shutdown or rebooted
|
||||
```
|
||||
|
||||
If you are using a rpi 4 (or maybe 3), see this [solution](https://forum.yunohost.org/t/aucun-acces-a-internet-suite-a-migration-4-4-to-11-depuis-raspberry-pi-4-pi-400/20652/17)
|
||||
If you are using a Raspberry Pi 4 (or maybe 3), see this [solution](https://forum.yunohost.org/t/aucun-acces-a-internet-suite-a-migration-4-4-to-11-depuis-raspberry-pi-4-pi-400/20652/17)
|
||||
|
||||
### Restore ynh4 backup onto a fresh ynh11
|
||||
|
||||
|
@ -120,5 +120,5 @@ If you can't restore your app but your system has been restored, you probably sh
|
|||
yunohost tools regenconf nginx --force
|
||||
```
|
||||
|
||||
After what you should be able to restore your apps. Don't forget to force upgrade theme if you have 502 errors.
|
||||
After that you should be able to restore your apps. Don't forget to force upgrade theme if you have 502 errors.
|
||||
|
||||
|
|
Loading…
Reference in a new issue