OpenRC/Baselayout 1 to 2 migration/it

Questa guida fornisce istruzioni riguardo la migrazione da baselayout-1 a baselayout-2 per OpenRC.

Cos'è baselayout?
Baselayout fornisce un insieme base di file che sono necessari per far funzionare adeguatamente tutti i sistemi, come ad esempio. Fornisce anche il layout base del filesystem usato da Gentoo (ad es. le directory, , , ).

Cos'è OpenRC?
OpenRC è un sistema rc (run command) basato sulle dipendenze che funziona con qualsiasi init fornito dal sistema, normalmente. Comunque, OpenRC non è un sostituto per. L'init di default usato da Gentoo Linux è, mentre Gentoo/FreeBSD utilizza l'init di FreeBSD fornito da.

Perchè migrare?
Inizialmente il sistema rc di Gentoo è stato compilato dentro baselayout-1 e scritto interamente in bash. Questo porta a molte limitazioni. Per esempio, certe chiamate di sistema hanno bisogno di essere accedute durante il boot e ciò ha richiesto l'aggiunta di chiamate basate su C. Ognuna di queste chiamate era linkata staticamente, con la conseguenza che il sistema rc ci metteva più tempo ad eseguire le proprie operazioni.

Inoltre, siccome Gentoo si è espansa ad altre piattaforme come Gentoo/FreeBSD e Gentoo Embedded, è diventato impossibile richiedere a un sistema rc basato su bash. Questo ha portato allo sviluppo di baselayout 2, che è scritto in C e richiede unicamente una shell POSIX-compilant. Durante lo sviluppo di baselayout 2, si è determinato come più appropriato se baselayout avesse fornito semplicemente i file base ed il layout del filesystem per Gentoo, ed il sistema rc fu spostato in un suo pacchetto. Da questo nacque OpenRC.

OpenRC fu inizialmente sviluppato da Roy Marples fino al 2010 ed è mantenuto ora dal Gentoo OpenRC Project. OpenRC supporta tutte le correnti variazioni di Gentoo (es. Gentoo Linux, Gentoo/FreeBSD, Gentoo Embedded, e Gentoo Vserver) e altre piattaforme come FreeBSD e NetBSD.

Migrazione ad OpenRC
La migrazione a OpenRC è piuttosto lineare; sarà introdotta come parte del normale processo di aggiornamento dal gestore dei pacchetti. Il passo più importante attualmente avviene dopo l'installazione dei nuovi pacchetti  e. È importantissimo eseguire dispatch-conf ed assicurarsi che i file in siano aggiornati lanciando dispatch-conf (o un altro tool similare) prima di riavviare. ""Un fallimento nel farlo produrrà un sistema non più avviabile"" e richiederà l'uso di un LiveCD per effettuare i passaggi seguenti per riparare il proprio sistema.

Una volta finito di aggiornare i propri file di configurazione, ci sono alcune cose da verificare prima di riavviare.

Il file è stato deprecato. Tutte le impostazioni in esso contenute avranno bisogno di essere trasferite alle impostazioni appropriate in. Si prega di leggere interamente e  e migrare le impostazioni. Una volta finito, cancellare.

Moduli del kernel
Normalmente, quando si vuole che certi moduli del kernel siano caricati all'avvio, li si mette in insieme ad ogni parametro che gli si vuole passare. Nel baselayout-2, questo file non è più utilizzato. Invece, i moduli caricati automaticamente e i loro parametri sono situati in un file,, qualsiasi sia la versione del kernel.

Un esempio di configurazione vecchio stile sarebbe:

Convertire l'esempio precedente risulterà nel seguente:

Negli esempi precedenti, i moduli e i loro parametri saranno passati soltanto ai kernel della serie 2.6.x. La nuova configurazione permette un controllo più preciso sui moduli e sui parametri basato sulla versione del kernel.

Un esempio approfondito sarà:

Boot runlevel
The  runlevel performs several important steps for every machine. For example, making sure the root filesystem is mounted read/write, the filesystems are checked for errors, the mountpoints are available, and the pseudo-filesystem is started at boot.

With OpenRC, volume management services for block storage devices are no longer run automatically at boot. This includes LVM, RAID, swap, device-mapper (dm), dm-crypt, and the like. System administrators must ensure the appropriate initscript for these services has been added to the  runlevel, otherwise it is possible the system will not be able to boot.

While the OpenRC ebuild will attempt to do this migration, administrators should verify the volume management services have been migrated properly:

If, , , , and are missing in the above listing, perform the following commands to add them to the   runlevel:

If the system uses mdraid and LVM and they are not mentioned in the list above, then the following initscripts should be added to the  runlevel:

Udev
OpenRC no longer starts by default; it does need to be present in the   runlevel to be started. The OpenRC ebuild should detect if was previously enabled and add it to the   runlevel. However, to be safe, check if is present:

If is not listed, add it to the correct runlevel:

Network
Due to baselayout and OpenRC being broken into two different packages, the net.eth0 initscript may disappear during the upgrade process. To replace this initscript and re-add it to the default runlevel, please perform the following:

When missing any other network initscripts, follow the instructions above to re-add them. Simply replace  with the name of the missing network device.

Also, (oldnet) no longer uses bash-style arrays for configuration. Please review for configuration instructions. Conversion should be relatively straight-forward, converting to newlines for separate entries, for example a static IP assignment would change as follows:

Clock
Clock settings have been renamed from to the system's native tool for adjusting the clock. On Linux it will be and on FreeBSD it will be. Systems without a working real time clock (RTC) chip should use, which sets the system time based on the mtime of a file which is created at system shutdown. The initscripts in have also been renamed accordingly, so make sure the appropriate script for the system has been added to the boot runlevel.

Additionally, the  variable is no longer in this file. Its contents are instead found in the file. If it does not exist, it will need to be created with the appropriate timezone. Please review both of these files to ensure their contents.

The proper value for this file is the path relative to the timezone from the directory. For example, for users living on the east coast of the United States, the following would be a correct setting:

XSESSION
The  variable is no longer found in. Instead, the  variable can be set on a per-user basis in the  file (or equivalent), or system-wide in.

Here is an example of setting the default  for the whole system:

EDITOR and PAGER
The  variable is no longer found in. Both  and   are set by default in. Adjust as needed in the file (or equivalent) or create  and set the system default there.

Boot log
Previously, the boot process could be logged using the package. However, OpenRC now handles all logging internally, so there is no need for the hacks that showconsole employed. showconsole can now be safely unmerged. To continue logging boot messages, set the appropriate variable in the  file. Logs will appear in.

and
With OpenRC, and  have been deprecated. During the migration to OpenRC, the files are moved to and gain the suffix  or. OpenRC then executes those in alpha-numeric order.

System sub-types: Virtualization special cases
Earlier versions of OpenRC detected multiple types of virtualization, which was used to note when certain init scripts should be skipped, using the  call in the   functions.

However, as of the 0.7.0 release, administers are required to explicitly configure the sub-type using the  variable in. The sub-type should be set to match the virtualization environment that the given root is in. In general, the non-empty  value should be within the virtual containers; The host node will have.

The detection algorithm had to be replaced with manual configuration due to the introduction of new sub-types and changes to the kernel that made prior detection unreliable.

Cleaning up stale configuration files
After migration, there will be files left on the file system that are not cleaned up by Portage. Those are configuration files which are protected by Portage' configuration file protection feature.

The most notable example would be which is superseded by.

Finishing up
Once finished updating the config files and initscripts, the last thing to do is to type reboot with root privileges at a terminal. This is necessary because system state information is not preserved during the upgrade, so a fresh boot is needed.

The pause action
Previously it was possible to temporarily stop a service without taking down all the depending services by using /etc/init.d/service pause</tt>. In OpenRC, the  action was removed; this functionality is supported by the /etc/init.d/service --nodeps stop</tt>, which also works in the old baselayout.

rootfs entry in
Previously, the initial  entry was removed from, and only the real root  entry was present. The duplicate rootfs item was actually added back during shutdown. In OpenRC, both entries must be present for full support of initramfs and tmpfs-on-root. This also means that less writing is required during shutdown.