Systemd/es

systemd es un moderno reemplazo de sysvinit y RC para los sistemas Línux. Tiene soporte en Gentoo como una alternativa del sistema de inicio (init).

El núcleo de línux
systemd hace uso de muchas características modernas del núcleo de Línux. Ahora mismo, el límite inferior de la versión del núcleo (para usar systemd) se encuentra en el ebuild 02.06.39. En versiones recientes de, hay una manera eficaz de seleccionar las opciones del núcleo, tanto obligatorias como opcionales, para systemd:

Para configurar las opciones del núcleo manualmente (que es la única opción cuando no utilice ), se requieren o recomiendan las siguientes opciones de configuración del núcleo:

Para un sistema UEFI active también las siguientes opciones:

Si el sistema está utilizando el planificador BFQ, se recomienda, por los desarrolladores de BFQ, activar «BFQ hierarchical scheduling support» bajo «Enable the block layer -> IO Schedulers».

Para obtener una lista actualizada, consulte la sección «REQUIREMENTS» en el archivo README.

El directorio
El directorio es utilizado por systemd, y otras aplicaciones, como almacenamiento no persistente para los datos que se ejecutan en tiempo real, como archivos pid, sockets y archivos de estado.

El paquete systemd creará él mismo el directorio. Sin embargo, tenga en cuenta que este cambio provocará el montaje automático del mismo en OpenRC, y puede desencadenar su uso por los diferentes paquetes de software.

Los desarrolladores solo dan soporte al archivo siendo este un enlace simbólico de. Si no se crea este enlace simbólico también causará problemas con mount y df. En el pasado algunas utilidades escribieron información (como opciones de montaje) en y, por lo tanto, se dio por hecho que era un archivo normal. Hoy en día todo el software tiene en cuenta esto que para evitar dicho problema. Sin embargo, antes de cambiar el archivo para convertirse en un vínculo simbólico, revise para asegurarse de que el sistema no está afectado por ninguna regresión reportada.

Para crear el enlace simbólico, ejecute:

Asegurarse de que /usr está presente en el arranque
Para una configuración separada de, utilice un initramfs para que monte antes de iniciar systemd. Consulte la Initramfs Gentoo Guide para obtener instrucciones al respecto.

Utililizar LVM2 y initramfs
Cuando se utiliza sys-fs/lvm2 y el sistema se arranca usando un initramfs, dicho initramfs tendrá que ser creado con, ejecutando:

es, o bien, o bien algún otro objetivo de genkernel que implique la creación de un initramfs. Para obtener más información, mire la salida de genkernel --help:

Cuando se utiliza LVM, el demonio lvmetad debe iniciarse también. De lo contrario systemd será incapaz de montar volúmenes LVM. lvmetad se puede activar en :

Instalación
contiene udev. Una vez instalado, puede retirarse, dado que systemd será asistido por.

Active el parámetro global de USE  (en ). Al mismo tiempo, el parámetro USE  debe ser desactivado para evitar conflictos con el servicio systemd-logind. También es posible cambiar a un subperfil systemd para utilizar parámetros USE por defecto más coherentes, en cuyo caso no es necesario cambiar :

Finalmente, actualice el sistema con los nuevos parámetros:

Cuando se producen problemas de dependencias (como bloqueando ),  podría ser que estuviera registrado en el archivo word. Trate de resolver esto desmarcándolo:

Arrancar con systemd
Para poder arrancar systemd, hay que cambiar el init que el núcleo (o initramfs) utiliza como ejecutable.

Las siguientes subsecciones documentan cómo intercambiar el init en uno de los gestores de arranque o en el núcleo.

Grub Legacy (0.x)
El argumento  debe ser añadido a la línea de órdenes del núcleo. Un extracto de ejemplo de se vería así:

Si a pesar de esto el sistema arranca usando OpenRC, pruebe utilizando  en lugar de.

Grub 2
When grub2-mkconfig</tt> is used, add the init option to :

Cuando el archivo de configuración de GRUB 2 esté hecho a mano (solo expertos), añada el parámetro  a la orden   o.

When using genkernel-next's initrd, use  instead of.

In kernel config
The init configuration can also be hard-coded in the kernel configuration. See "Processor type and features -> Built-in kernel command line". Note that this technique works for both grub and grub2.

Setting root password
At this point don't forget to set the system's root password. If something goes wrong, systemd will prompt for the root password to go into maintenance mode.

Post Installation Configuration
systemd supports a few system configuration files to set the most basic system details.

Hostname
To set the hostname, create/edit and simply provide the desired hostname.

When booted using systemd, a tool called hostnamectl</tt> exists for editing and. To change the hostname, run:

Refer to man hostnamectl for more options.

Locale
Usually, locales will be properly migrated from OpenRC when installing systemd. When required, the locale can be set in as per the Gentoo handbook instructions:

Once booted with systemd, the tool localectl</tt> is used to set locale and console or X11 keymaps. To change the system locale, run the following command:

To change the virtual console keymap:

And finally, to set the X11 layout:

If needed the model, variant and options can be specified as well:

Time & Date
Time and date can be set using the timedatectl</tt> utility. That will also allow users to set up synchronization without needing to rely on or other providers than systemd's own implementation.

To learn how to use timedatectl</tt> simply run:

Automatic module loading
Automatic module loading is configured in a different file, or rather directory of files. The configuration files are stored in. On boot every file with a list of modules will be loaded. The file format is a list of modules separated by newlines and can have any name as long as it ends with. The module loading can be separated by program, service or whatever way that fits personal preference. An example virtualbox.conf</tt> is listed below:

systemd-networkd
systemd-networkd is useful for simple configuration of wired network interfaces. It is disabled by default.

To configure systemd-networkd, create a file under. See systemd.network(5) for reference. A simple DHCP configuration is given below.

Note that systemd-networkd does not update by default. To have systemd manage the DNS settings, replace with a symlink and start systemd-resolved.

NetworkManager
Often NetworkManager is used to configure network settings. For that purpose, simply run the following command when using an X11-powered desktop:

If that is not the case and the network needs to be configured from console, give nmcli a try, or follow a guided configuration process through nmtui</tt>:

nmtui is a curses frontend that will guide the user in the process while running in console mode.

Handling of log files
systemd has its own way of handling log files without needing to rely on any external log system (like syslog-ng or rsyslog). Messages can now be read with journalctl</tt>. Anyway, it can still be configured to use a preferred external tool for handling them. Please type man journald.conf for learning about how to configure journald to suit personal needs.

/tmp is now in tmpfs
Unless some other filesystem is explicitly mounted to in, systemd will mount  as tmpfs. That means it will be emptied on every boot and its size will be limited to 50% of the system's RAM size. To know why this is the desired behavior and how to modify it, take a look at API File Systems.

Configure verbosity of boot process
When migrating to systemd users usually notice differences regarding verbosity of boot process:
 * The boot option  not only influences the kernel output, but also that of systemd itself. Then, while setting up systemd for the machine, drop the option to see any errors could arise more easily. After that, add it back to get a quiet (and faster) boot.
 * Even passing the  boot option, systemd can still be configured to show its status by also passing.
 * When not using the  boot option, some messages might be overwriting consoles. That is caused by the kernel configuration (see man 5 proc and look for ). To tweak it pass the   boot parameter to the kernel (and update the value according to preference, for instance set a lower value like 1).

Services
At some point the system will need to be rebooted in order to get systemd running (in system mode). Be sure to read all of this document to ensure systemd is configured as completely as possible before rebooting. Note that journalctl</tt> works with systemd not running, but that systemctl</tt> will not do anything useful without systemd running. Complete the service configuration (enabling and starting of services) after logging in to the system running systemd.

OpenRC services
Although systemd originally intended to support running old init.d scripts, that support is not suited well for a dependency-based RC like OpenRC and thus is completely disabled on Gentoo. OpenRC provides additional measures to ensure that init.d scripts can't be run when OpenRC was not used to boot the system (otherwise the results would be unpredictable).

Listing available services
All available service units can be listed using the  argument of systemctl</tt>:

The following file suffixes are of interest:

Alternatively, systemctl</tt> tool can be used to list all services (including implicit ones):

And finally check for services that failed to start:

Enabling, disabling, starting and stopping services
The usual way of enabling a service is using the following command:

Services can be disabled likewise:

These commands enable services using their default name in default target (both specified in "Install" section of the service file). However, sometimes services either don't provide that information or users prefer to have another name/target.

Note that these commands only enable or disable the system to be started on a next boot; to start the service right now, use:

Services can be stopped likewise:

Installing custom unit files
Custom unit files can be placed in, where they'll be recognized after running systemctl daemon-reload</tt>:

is reserved for service files installed by the package manager.

Customizing unit files
When only minor changes to a unit are needed, there's no need to create a full copy of the original unit file in. Overriding settings in a package management provided unit can be achieved by drop-in files in a directory named after the original unit (e.g. ) in.

A reload of systemd is needed to inform it of the changes:

Then the service needs to be restarted to apply the changes:

Verify that the changed property was applied to the service:

Enabling a service under a custom name
When the name provided by "Alias" in the unit's "[Install]" section does not meet the expectations and providing a permanent new value for this through a customization is not desired, a symlink can be created manually in. The name of the directory can either specify a target or another service which will depend on the new one.

For example, to install as  in the :

To disable the service, just remove the symlink:

Native services
Some of Gentoo packages already install systemd unit files. For these services, it is enough to enable them. A quick summary of packages installing unit files can be seen on systemd eclass users list.

The following table lists systemd services matching OpenRC ones:

Timer services
Since version 197 systemd supports timers, making cron unnecessary on a systemd system. Since version 212 persistent services are supported, replacing even anacron. Persistent timers are run at the next opportunity if the system was powered down when the timer was scheduled.

The following is an example on how to make a simple timer that runs in the context of a user. It will even run if the user is not logged in. Every timed service needs a timer and a service file that is activated by the timer as follows:

Firstly, tell systemd to rescan the service files:

It is possible to trigger the backup manually by running the following command:

Start and stop the timer manually as follows:

Finally, to activate the timer at every system start, run:

To check the last results of running the service:

Emailing failures
If a timed service runs and fails an e-mail can be send out to inform the user or administrator. This is possible with the "OnFailure" stanza which specifies what should happen if a service fails. A failure is detected by a non-zero return code of the invoked script.

For that change the script as follows:

This requires to have the service installed, which can be found in kylemanna's systemd-utils repository.

Replacing cron
The above timer and service files can also be added to to make them available system-wide. The install section should then say  to enable the service at system start.

However, cron also runs the scripts in and other locations. Several packages place scripts there that they expect to be run daily. This behavior can be emulated with systemd by first installing and then systemd-cron. Just run ./configure --enable-persistent and make. Ignore the systemd-crontab-generator stuff if only running the files in is of interest. Just copy the files from to. Then ensure to adjust the path to run-parts</tt> in the service files. The run-parts</tt> script is located in gentoo at. Then activate the new cron replacement with the following commands:

Troubleshooting

 * Upstream debugging guide
 * Upstream debugging guide
 * Upstream debugging guide

lvm
When switching from OpenRC to systemd and lvm is needed to properly mount the system volumes, activate the lvm service:

While it might not be needed for activation of the root volume (if lvm is integrated into the initramfs) it might not work for other lvm volumes, unless the service is activated.

systemd-bootchart
As systemd-bootchart attempts to start, reconfigure it to invoke systemd instead:

The result of the bootchart is a report in SVG format located in.

syslog-ng conflicts with systemd
systemd creates as datagram socket  so syslog-ng needs to be told to read from a unix-dgram instead of a unix-stream as otherwise syslog-ng would be using a "wrong" stream:

sys-fs/cryptsetup configuration
systemd doesn't seem to respect (see ) so it needs to be configured through the  file:

Check for units that failed to start
Check for units that failed to start with:

Enable Debug Mode
To get more informations set the following in :

Or enable the debug-shell, that opens a terminal at tty9. This helps to debug services during the boot process.

e4rat usage
Please remember to edit setting 'init' to, otherwise it will keep booting OpenRC.

GRSecurity hardening
With grsecurity enabled, systemd-networkd might log the following error:

The error raises due to systemd-networkd working under a non-root user with grsecurity refusing access to the complete structure for such users. To disable this option, disable the kernel option.

External resources

 * FAQ
 * Tips and tricks