Browse Source

more polishing

master
Ralph Rönnquist 4 months ago
parent
commit
6e521c4bd4
  1. 74
      README.adoc

74
README.adoc

@ -7,20 +7,23 @@ system while preserving all user data. (In fact, the script will
handle a Debian system of either +bullseye+ or +buster+ into your
choice of either +chimaera+ or +beowulf+)
The script has two stages:
The script performs a 2-stage migration with minimal operator
intervention:
1. replace the init system to be +sysvinit+ and reboot,
* The first stage replaces the init system to be +sysvinit+ and
reboots,
2. upgrade to the standard +chimaera+/+beowulf+ distribution and reboot
* The second stage upgrades the software to the standard
+chimaera+/+beowulf+ distribution and reboots again.
.Quick How To
[caption=""]
====
1. First you should enter a separate, non-GUI virtual terminal (maybe
with ctrl-alt-f3), and login as +root+. In some setups this is done
1. First you enter a separate, non-GUI virtual terminal (maybe with
control-alt-f3), and login as +root+. In some setups this is done
using a +systemd-rescue+ option. In others it works with the key
combination Control-Alt-Function-3.
combination control-alt-f3.
2. Next, copy +script.sh+ to +/root+ of the host you want to migrate,
and make the script executable. E.g.
@ -30,14 +33,14 @@ and make the script executable. E.g.
# chmod a+x script.sh
----
+
NOTE: You should now review the script before executing it!.
NOTE: You should now review the script before executing it!
+
----
# shasum script.sh
40e1e6fe09f2b4a7b5552b07cc97db8b38550b36 script.sh
----
3. Run the transition script with (note the digit 1 at the end):
3. Then, run the migration script with (note the digit 1 at the end):
+
----
# DE=xfce ./start 1
@ -49,42 +52,43 @@ NOTE: You should now review the script before executing it!.
# systemctl reboot
----
5. The machine will then reboot and run the rest of the transition
hands-free. Just wait while lots of messages scroll past until
eventually the machine reboots again and stops at the new login
screen.
5. The machine will then reboot and automatically perform the rest of
the migration hands-free. Just wait while a lot of messages scroll
past until eventually the machine reboots again and stops at the new
login screen.
====
====
NOTE: The above instruction takes you to Devuan chimaera with the
xfce4 desktop environment. If you want to use something else, the
script can handle +mate+, +cinnamon, or +kde+ instead of +xfce+.
====
NOTE: The above instruction takes you to a Devuan +chimaera+ system
with the +xfce4+ desktop environment. If you want to use something
else, the script can handle +mate+, +cinnamon+, or +kde+ instead of
+xfce+.
Description
Other Notes
-----------
The script performs the 2-stage migration with minimal operator
intervention.
1. The first stage prepares the system for using +sysvinit+ rather
than +systemd+, and this stage ends in requesting a manual reboot with
the system primed (via +/etc/rc.local+) to enter the second stage
automatically at next boot.
The first stage of the migration prepares the system for using
+sysvinit+ rather than +systemd+, and this stage ends in requesting a
manual reboot with the system primed (via +/etc/rc.local+) to enter
the second stage automatically at next boot.
That second migration stage automatically performs all requested
installations for the target +chimaera+/+beowulf+ system and it also
ends with another reboot.
2. The second stage performs all requested installations for the
target +chimaera+/+beowulf+ system and the stage ends with another
request of manual reboot. The second stage also includes an explicit
+sshd+ as a possible "resuce entry" option if it runs into trouble.
During the second stage an explicit +sshd+ is run to provide a
possible "resuce entry" option just in case the script does run into
trouble.
The script will migrate the system to +chimaera+ unless +DIST=beowulf+
is used in which case it will migrate to +beowulf+.
The system is migrated to Devuan +chimaera+ unless you prefix the
command line with +DIST=beowulf+, in which case it will migrate to
+beowulf+.
The script may uninstall the desktop environment used in Debian and
then not install a desktop environment unless +DE=desktop+ is set in
which case it will install +xfce4+ (using +task-xfce-desktop+). The
script also handles +xfce+, +mate+, +cinnamon, or +kde+ instead of
+desktop+.
The script replaces the original desktop environment that was used in
Debian with the chosen desktop environment as mentioned on the command
line, e.g. +DE=xfce+. The script also handles +mate+, +cinnamon+, or
+kde+ instead of +xfce+. Further, if the +DE+ setting is omitted, then
the Devuan system starts as a server system, i.e., without desktop.
====
IMPORTANT: this script only handles systems with Ethernet cable

Loading…
Cancel
Save