[2024-feb-29] Sad news: Eric Layton aka Nocturnal Slacker aka vtel57 passed away on Feb 26th, shortly after hospitalization. He was one of our Wiki's most prominent admins. He will be missed.
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision | ||
howtos:general_admin:openrc [2017/02/17 18:12 (UTC)] – [Sources] aaditya | howtos:general_admin:openrc [2020/04/12 15:08 (UTC)] – [Note] remove extra word aaditya | ||
---|---|---|---|
Line 2: | Line 2: | ||
====== OpenRC ====== | ====== OpenRC ====== | ||
- | OpenRC is a dependency based init system | + | OpenRC is a dependency based service management |
- | ====== Features | + | ===== Features ===== |
- | OpenRC provides a number of features | + | OpenRC provides a number of features like hardware initiated initscript run and cgroups support, without requiring large layout changes. |
====== Installation ====== | ====== Installation ====== | ||
- | ===== Pre installation ===== | + | Two [[slackware: |
- | The /etc/init.d directory (a symlink to /// | + | ===== Post installation ===== |
- | # mv /etc/init.d / | + | |
- | ===== Installing ===== | + | After installation, |
- | Two [[slackware: | + | === Setup the agetty |
- | ===== Post installation ===== | + | # main tty |
+ | ln -s / | ||
+ | / | ||
+ | |||
+ | cp / | ||
+ | echo ' | ||
+ | |||
+ | # additional ttys | ||
+ | for i in {2..6}; do | ||
+ | ln -s / | ||
+ | / | ||
+ | done | ||
+ | |||
+ | # serial tty (for servers) | ||
+ | ln -s / | ||
+ | / | ||
+ | |||
+ | cp / | ||
+ | echo ' | ||
+ | |||
+ | === Update boot parameters | ||
+ | |||
+ | Add the following to your boot parameters (via /// | ||
+ | init=/ | ||
+ | |||
+ | Regenerate boot configuration ('lilo -v' or ' | ||
- | After installing, /// | + | === Enable boot logging === |
- | # cp / | + | |
- | # mv / | + | |
- | The main configuration file for OpenRC is /// | + | The main configuration file for OpenRC is ///etc/openrc/rc.conf//, and contains various options. |
A common option that could be changed is to enable boot logging by setting '' | A common option that could be changed is to enable boot logging by setting '' | ||
Line 31: | Line 53: | ||
===== On reboot ===== | ===== On reboot ===== | ||
- | After installing openrc and openrc-services, | + | On rebooting, one is booted to a command line with only the bare minimum of services enabled. |
It may show a warning about deprecated support for /// | It may show a warning about deprecated support for /// | ||
- | # cp /etc/mtab /etc/mtab.bak | + | # cp /etc/mtab /etc/mtab.bkp |
# ln -snf / | # ln -snf / | ||
| | ||
Line 56: | Line 78: | ||
# rc-update add sysklogd default | # rc-update add sysklogd default | ||
# rc-update add dcron default | # rc-update add dcron default | ||
- | # rc-update add alsasound | + | # rc-update add alsasound |
# rc-update add consolekit default | # rc-update add consolekit default | ||
# rc-update add sshd default | # rc-update add sshd default | ||
Line 82: | Line 104: | ||
If using wifi with laptops the **NetworkManager** or **wicd** service could be enabled. The combination of dhcpcd and wpa_supplicant (along with a frontend like wpa_gui or wpa_cli) could also be used as a lightweight alternative. | If using wifi with laptops the **NetworkManager** or **wicd** service could be enabled. The combination of dhcpcd and wpa_supplicant (along with a frontend like wpa_gui or wpa_cli) could also be used as a lightweight alternative. | ||
- | A static network can be configured by editing /// | + | A static network can be configured by editing ///etc/openrc/ |
=== Display manager === | === Display manager === | ||
- | To boot to a graphical display manager, /// | + | To boot to a graphical display manager, ///etc/openrc/ |
# rc-update add xdm default | # rc-update add xdm default | ||
Line 116: | Line 138: | ||
====== Configuration ====== | ====== Configuration ====== | ||
- | OpenRC services are present in the /// | + | OpenRC services are present in the ///etc/openrc/init.d// folder, and corresponding configuration files are present in ///etc/openrc/conf.d// |
Some common configuration files include: | Some common configuration files include: | ||
- | / | + | /etc/openrc/ |
- | / | + | /etc/openrc/ |
- | / | + | /etc/openrc/ |
- | ===== Services | + | ===== Service management |
Services can be started/ | Services can be started/ | ||
Line 133: | Line 155: | ||
# rc-service sshd start | # rc-service sshd start | ||
+ | |||
+ | | ||
+ | ===== Shutdown/ | ||
+ | |||
+ | To shutdown or reboot, one will need to use **openrc-shutdown**. To shutdown from a desktop environment using ConsoleKit2, | ||
+ | |||
+ | ==== Note ==== | ||
+ | |||
+ | The **ck-system-stop** and **ck-system-restart** files in the [[https:// | ||
====== Troubleshooting ====== | ====== Troubleshooting ====== | ||
Line 138: | Line 169: | ||
At the moment only a subset of the included services have been tested, so some of them may not run correctly. | At the moment only a subset of the included services have been tested, so some of them may not run correctly. | ||
- | If some service does not work try the system provided one in /// | + | If some service does not work, try the system provided one in /// |
==== mysqld ==== | ==== mysqld ==== | ||
Line 151: | Line 182: | ||
socket = / | socket = / | ||
+ | ==== Dealing with crashed services ==== | ||
+ | |||
+ | Sometimes openrc reports a service' | ||
+ | |||
+ | If one tries to start a crashed service, `rc-service` reports: | ||
+ | |||
+ | * WARNING: < | ||
+ | |||
+ | So one tries to stop it before starting again. | ||
+ | |||
+ | However in some situations, the service does not stop. This leads to a deadlock where one can neither stop the service nor start it. For such cases: | ||
+ | |||
+ | # rc-service < | ||
+ | * Manually resetting < | ||
+ | |||
+ | **zap** resets the service state, allowing us to start it again. | ||
+ | |||
+ | ===== openrc-init ===== | ||
+ | |||
+ | Since version **0.25**, openrc provides // | ||
+ | |||
+ | This allows switching between OpenRC and other init systems, for example sysvinit, just by changing boot parameters. | ||
+ | |||
+ | For more info, check out the [[https:// | ||
+ | |||
+ | ===== Migrating from /etc/init.d to / | ||
+ | |||
+ | OpenRC 0.39+, as shipped via SBo, changes the service and configuration directory to /// | ||
+ | |||
+ | This is being done to maintain greater compatibility with a vanilla Slackware install. | ||
+ | |||
+ | Existing services will need to be migrated, details below on how it can be done. | ||
+ | |||
+ | === 1. Install openrc-0.39.2 and openrc-services-20181107 === | ||
+ | |||
+ | These packages ship the configuration and service files in /// | ||
+ | |||
+ | === 2. Migrate existing services === | ||
+ | |||
+ | This involves 4 steps: | ||
+ | |||
+ | # migrate existing services | ||
+ | for service in / | ||
+ | svcname=$(basename " | ||
+ | if [ ! -e "/ | ||
+ | if [ -f "/ | ||
+ | cp -v "/ | ||
+ | elif [ -L "/ | ||
+ | # check if symlink is of a service | ||
+ | service_target=$(readlink -f " | ||
+ | service_target_name=$(basename " | ||
+ | if [ $(dirname " | ||
+ | ln -sv "/ | ||
+ | fi | ||
+ | fi | ||
+ | fi | ||
+ | done | ||
+ | | ||
+ | # enable existing services | ||
+ | for runlevel in / | ||
+ | for service in ${runlevel}/ | ||
+ | svcname=$(basename " | ||
+ | rvlname=$(basename " | ||
+ | if [ ! -e / | ||
+ | ln -sv / | ||
+ | fi | ||
+ | done | ||
+ | done | ||
+ | | ||
+ | # check config changes | ||
+ | for file in / | ||
+ | filename=$(basename " | ||
+ | extension=" | ||
+ | if [ " | ||
+ | continue | ||
+ | fi | ||
+ | if [ -e "/ | ||
+ | diff -Nupr "/ | ||
+ | fi | ||
+ | done | ||
+ | # main config file | ||
+ | diff -Nupr / | ||
+ | | ||
+ | # check local.d changes | ||
+ | for file in / | ||
+ | filename=$(basename " | ||
+ | if [ ! -e "/ | ||
+ | cp -v "/ | ||
+ | elif [ -e "/ | ||
+ | # show changes | ||
+ | diff -Nupr "/ | ||
+ | fi | ||
+ | done | ||
+ | |||
+ | Config changes found above can be updated by hand or copy pasted in new location. | ||
+ | |||
+ | === 3. Check and reboot === | ||
+ | |||
+ | Verify if '' | ||
+ | |||
+ | Reboot and check whether things are working expected, make changes as necessary. | ||
+ | |||
+ | The old files and folders can be renamed (or removed). | ||
+ | |||
+ | mv /etc/init.d / | ||
+ | mv /etc/conf.d / | ||
+ | mv / | ||
+ | mv / | ||
+ | mv / | ||
+ | |||
+ | Finally, any changes done to the default Slackware system can be reverted: | ||
+ | |||
+ | mv / | ||
====== See Also ====== | ====== See Also ====== | ||
- | https:// | + | [[https:// |
+ | |||
+ | [[https:// | ||
+ | |||
+ | [[https:// | ||
- | https:// | + | [[https:// |
- | [[https:// | + | [[https:// |
- | [[https://bitbucket.org/ | + | [[https://gitlab.com/ |
Line 172: | Line 320: | ||
<!-- Please do not modify anything below, except adding new tags.--> | <!-- Please do not modify anything below, except adding new tags.--> | ||
<!-- You must remove the tag-word " | <!-- You must remove the tag-word " | ||
- | {{tag> | + | {{tag> |