Dear all,
following some work and development in YunoHost, we are now reading to open an alpha-testing phase for YunoHost’s support and migration to Debian Stretch !
We need your feedback to test and debug this delicate operation, such that people with not much technical knowledge will be able to enjoy a migration as smooth and transparent as possible !
Keep in mind that alpha means that bugs are to be expected ! The system will be unstable ! There’s a high chance that we will make strong structural changes in the various piece of software / configuration. Therefore, do not perform the following steps just because you absolutely want to have a YunoHost on Stretch in production !
The following test cases describe specific items we would like to get feedback on (in particular #1 and #2 for now). Feel free to pick one and tell us what you found !
Test case #1 - Install on a fresh system
Goal: test YunoHost on a newly installed system (Debian Stretch)
Difficulty: ~easy (if you are already familiar with YunoHost install process)
Steps:
- Setup a machine with Debian Stretch. Either on a VPS, an ARM board or a regular computer ;
- Connect as root on the machine ;
- Launch the install of YunoHost by running (be careful with the syntax) :
bash <(wget -q -O- https://install.yunohost.org/stretch)
(If wget
is not installed on the system, install it with apt-get install wget
)
What to test: test that the install works as expected. After that, try to do stuff that you would personally do with a real-life instance, e.g. browse the webadmin, create users, install and play with apps, install certificates, send/receive emails, chat on XMPP, …
Test case #2 - Migrate a recently installed system from Jessie to Stretch
Goal: test YunoHost’s “automatic” migration from a recently installed Jessie to Stretch
Difficulty: ~medium (bit more technical that test case #1)
Steps:
- Setup a machine with a YunoHost on Debian Jessie, using the current install instructions available on https://yunohost.org/#/install.
- Do a few things that you would do on a real instance : e.g. create a user, install a few apps…
- Run this script (
Do not run it on a production server !!!
). This will switch your instance to the unstable branch containing the Stretch migration :
bash <(wget -q -O- https://install.yunohost.org/switchToUnstable)
- In the command line, run
yunohost tools migrations migrate
and read what it tells you.
What to test: try to be attentive to what’s happening during the migration. Report anything you find odd in term of UX… After the migration is done, try to make sure that everything worked. In particular, fail2ban should be running, your previously installed apps should still be accessible, and yunohost --version
should tell you that you’re in 3.x.
Test case #3 - Migrate a prod-like instance from Jessie to Stretch
Goal: test YunoHost’s “automatic” migration on a “real-life instance”
Difficulty: ~hard (requires some heavy technical manipulations)
Steps:
- Start with a “real-life” production instance that you have. For instance, a Raspberry Pi which got initially installed with YunoHost 2.2 with a few custom apps and/or manual modifications.
- Make a clone of it … E.g. if this is an ARM board, make a clone of the SD card. For a regular computer or a VPS, it’s a bit trickier, but maybe achievable with rsync… [To be completed]
- Follow same steps as test case #2 on your clone.
What to test: same as test case #2.