This is the early part of the SUSE installation process, before YaST runs.

See https://en.opensuse.org/SDB:Linuxrc.

Debugging

Run on Installed System

Linuxrc can run on installed system. It runs in testmode that make debugging easier. Parameters are passed as common parametrs like: linuxrc linemode=0 manual=1 linuxrc.debug=1

Useful Shortcuts

• ctrl+c then 'q' - exit linuxrc

• ctrl+c then 'c' - change config

• ctrl+c then 'i' - show info detected by linuxrc

• ctrl+c then 's' - start shell

Logging

Linuxrc logs to /var/log/linuxrc.log. To capture a log with maximum verbosity, including the source code location of the logging call, use these linuxrc params: linuxrc.debug=4,trace.

Linuxrc will also try to log (less verbose) to /dev/tty3. You can redirect this to another location if you need. For example, on a serial console it might be helpful to log to the current console: linuxrc.log=/dev/console.

Testing the Installation

A regular SUSE installation DVD gets built via linuxrc.rpm, then installation-images.rpm, then a KIWI image build.

For testing a shortcut is available: mksusecd (GitHub, OBS).

Use:

mksusecd --initrd ./linuxrc.rpm ...

or, without an RPM:

make
mkdir /tmp/initrd
cp linuxrc /tmp/initrd/init
mksusecd --initrd /tmp/initrd ...

You may also use mksusecd --micro in case you only want to test Stage 1 and not a full install.

openSUSE Development

The package is automatically submitted from the master branch to system:install:head OBS project. From that place it is forwarded to openSUSE Factory.

You can find more information about this workflow in the linuxrc-devtools documentation.