Home Wiki > SDB:Linuxrc
Sign up | Login

SDB:Linuxrc

tagline: From openSUSE

linuxrc is a small program that runs before the actual installation program YaST is started.

It is responsible for the hardware setup and will search for an installation repository. To specify the repository location, use the install option.

The use of linuxrc is not limited to the installation. You can also use it as a boot tool for an installed system and even for an independent RAM disk–based rescue system.

Linuxrc writes its settings to a special file /etc/install.inf that makes them easy-to-read later. See the reference page here.

Passing parameters

linuxrc accepts parameters either by commandline or through configuration files. For this, pass the file location using the info parameter. You can use this option several times - linuxrc will read all files.

linuxrc parameters are case-insensitive and you can add as many hyphens, underscores, or dots as you want.

The option argument can be put in doublequotes.

For example, the following are all equivalent:

SSHPassword=foo
sshpassword="foo"
ssh.password=foo
ssh-password="foo"
ssh_password=foo
S.Shp-AsSw._.orD=foo

Parameters that are unknown to linuxrc but are of the form foo.bar are interpreted as options to kernel modules. See options for details.

Parameter Reference

Some parameters expect a URL as argument. Here is a short overview of the syntax.

Supported schemes:

cd (or cdrom)         # CD-ROM
hd (or harddisk)      # local hard disk
disk                  # any local disk device (CD-ROM, hard disk or floppy)
file                  # local file
floppy                # floppy (better use disk)
ftp                   # ftp server
http                  # http server
nfs                   # nfs server
slp                   # use SLP to get the real URL
smb (or cifs)         # Windows share
tftp                  # tftp server

General format:

scheme://domain;user:password@server:port/path?query

If scheme: is missing, a relative URL is assumed which is normally relative to the repository.

Don't forget the brackets if you enter a literal IPv6 address; e.g.:

http://[2001:db8:42:815::1]/some_dir

For smb/cifs path is preceded with the share name:

path = share/path

domain is only for scheme smb/cifs and specifies the domain/workgroup of the user.

For references to local devices, using cd, disk, floppy, hd, path can optionally be preceded with the device name

 path = device/path

For another way to specify the device, see below.

query may be one or more of

device=device_pattern
type=file|dir           # url points to a file or directory
instsys=URL             # install parameter only
service=slp_service     # slp scheme only
descr=slp_descr         # slp scheme only
url=slp_url             # slp scheme only

separated by '&'.

device specifies the device to use (linuxrc will normally try all devices in turn). You can use typical shell metacharacters here. Like:

install=cd:/?device=sr0                  # first CD-ROM
install=cd:/sr0                          # alternative form
install=cd:/dev/sr0                      # optionally add /dev
install=hd:/?device=sdb*                 # any partition on 2nd hard disk
install=hd:/?device=*label/foo           # partition with fs label 'foo'
install=nfs://foo/bar?device=eth0        # works with network devices, too
install=nfs://foo/bar?device=00:0e:0c:*  # matches MAC addresses, too

instsys is only relevant for the install parameter. Also, see instsys option.

service, descr and url are only useful for scheme slp and limit the list of URLs. Like:

# get URL list via SLP
install=slp:/
# ... but only those with 'openSUSE' in the description
install=slp:/?descr=*openSUSE*
# ... and only ftp URLs
install=slp:/?descr=*openSUSE*&url=ftp:*

You will probably never need any parameter except install. But in case you do, here is the complete list.


Parameter Description
AddSwap

Tries to activate a swap partition. If set to 0, the system does not try to activate a swap partition. If set to a positive number, the partition corresponding to the number is activated as a swap partition. With a negative number, linuxrc will present you a dialog for selecting the swap partition or creating a swap file. Alternatively, specify the full device name of a partition.

Examples:

 addswap=/dev/sda2
 # '/dev/' is optional
 addswap=sda2
 # 3rd swap partition
 addswap=3
 # never ask for swap (even if it might be a good idea)
 addswap=0
 # interactive
 addswap=-1
Alias

AutoYaST

This parameter can be used to initiate an automatic installation using AutoYaST. The value must be a URL pointing to an AutoYaST installation profile. Note that linuxrc does not use this option in any way. It just passes it on to YaST. Note also that AutoYaST uses its own URL schemata that differs from linuxrc's. See the AutoYaST documentation for details.

Example:

 AutoYaST=ftp://autoyast_profile.xml
AutoYaST2

This parameter can be used to initiate an automatic installation using AutoYaST. The value must be a URL pointing to an AutoYaST installation profile. For supported schemes and a syntax description, look here.

In contrast to the AutoYaST option linuxrc loads the AutoYaST file and passes it to YaST.

You can embed linuxrc options into the AutoYaST file as described in the AutoYAST documentation.

This option has no effect if an AutoYaST option is used at the same time.

Example:

 AutoYaST2=ftp://autoyast_profile.xml
AUTOUPGRADE

This parameter can be used to initiate an automatic upgrade using AutoYaST. The value must be 1. The additional path of the AutoYaST configuration file must be given too.

This option has no effect if an AutoYaST or AutoYaST2 option is not used at the same time.

Example:

 autoupgrade=1 AutoYaST2=ftp://autoyast_profile.xml
biosdevname

Use BIOS network interface names (instead of eth*). The option itself is not used by linuxrc but passed on to YaST.

Example:

 biosdevname=1
BOOTPTimeout

Timeout for BOOTP requests in seconds.

Bootpwait

Sets a delay between interface setup and bootp request in seconds.

Example:

 BootpWait=10
Broadcast

Broadcast IP address

Example:

 Broadcast=10.10.255.255
BrokenModules

Comma-separated list of modules that will not be loaded during initialization. You can prepend a '+' or a '-' to the (whole) list indicating the modules should be added or removed (instead of replacing) the broken modules list.

Example:

BrokenModules=ahci,ata_piix
BrokenModules=-tg3
ConsoleDevice

Console device name.

Example:

 ConsoleDevice=/dev/tty9
debug.wait

For debugging purposes linuxrc can stop at a number of places and offer to start a shell to inspect the system. You can pass a comma-separated list of such control points. Each entry is a shell wildcard pattern that must match either a function name or module:line_number.

Examples:

 # stop in the network code around line 2500-2599 and in lxrc_end()
 debug.wait=net:25??,lxrc_end
defaultinstall

Comma-separated list of installation sources to try when no install option is given.

Example:

 # first look at cdroms, then check local disks
 install.default=cd:/,hd:/
defaultrepo

An alias for defaultinstall.

device

Specify the storage device to use when looking for a repository. See device description for allowed values.

Normally, this is not necessary. But if you really need this option, consider adding it to the URL of the install parameter.

Examples:

device=sr1        # 2nd CD-ROM drive
device=sdc*       # partition on 3rd disk
display

Sets the linuxrc color scheme.

  • 1 - Monochromatic display [black/white]
  • 2 - VGA colors [blue/white] (default)
  • 3 - Alternative VGA colors [green/white]

Example:

 # go greenish
 display=3
Display_IP

IP address of X server for remote installation via X11

Example:

 Display_IP=10.10.1.57
DHCP

No longer supported.

DHCPCD

Additional options for dhcpcd (the DHCP client used by linuxrc).

Example:

dhcpcd=-B
DHCPTimeout

Timeout for DHCP requests in seconds.

Example:

dhcptimeout=120
Domain

Domain search path for DNS. Only useful for non-DHCP network config.

Example:

domain=opensuse.org
DoSCSIRename

Reorder SCSI devices so that USB and Firewire devices come last. And do it NOW (that is, when the option is parsed).

Don't use this option.

Example:

doscsirename=1
DriverUpdate

Obsolete alias for dud parameter. Please use dud instead.

DUD

For documentation on driver updates see http://ftp.suse.com/pub/people/hvogel/Update-Media-HOWTO/index.html.

An easy to use script for creating driver updates is available at http://software.opensuse.org/package/mkdud?search_term=mkdud

There are two semantics: dud=1 and dud=<url>. With dud=1 linuxrc lets you interactively select a driver update. dud=<url> specifies the location of the driver update directly. <url> should point either to a directory with the unpacked driver update or to a driver update archive.

You can use this option several times; linuxrc will load all specified updates.

For supported schemes and a syntax description, look here.

Note that driver updates are automatically searched for on your installation server/media. You don't have to use this option for that.

Examples:

# ask for driver update disk
dud=1
# load 'myupdate' from server 'foo'
dud=ftp://foo/myupdate
# search & load 'update1' on local disks and load update2 from network
dud=disk:/update1 dud=http://foo/update2

For easy testing the semantics has been extended a bit: if <url> does not point to a driver update but rather a normal filesystem image, cpio archive, or rpm, it is unpacked and the files are added to the install (or rescue) system.

Examples:

# add vsftpd ftp server to rescue system
# rescue=1 dud=http://foo/bar/vsftpd.rpm
ESCDelay

ethtool

Run ethtool for any or all network interfaces. Ethtool can change ethernet card settings. See man ethtool for details.

Format:

[if0=]option

Examples:

"ethtool=eth0=duplex full"     # only applies to eth0
"ethtool=speed 10"             # applies to all network interfaces
Exec

Executes an additional binary.

Example:

exec=/usr/bin/top
Expert

deprecated

Combines Textmode and DriverUpdate

 Values:
 0 ignored
 1 enable text mode
 2 ask for driver update disk
 3 both
FloppyDevice

No longer supported. Use install.

ForceRootimage

No longer supported.

Gateway

This specifies the gateway through which the installation server can be reached if it is not located in the subnetwork of the host.

Example:

gateway=192.168.1.1
HasPCMCIA

HostIP

Specifies the static IP address of the host. The number of network bits can be appended, saving you the extra netmask parameter.

Examples:

hostip=192.168.1.101
# or, giving netmask 255.255.255.0 as well
hostip=192.168.1.101/24
Hostname

Full qualified hostname.

HWDetect

Controls hardware detection.

 Values: 0 (off), 1 (on)
IgnoreFeatures

Comma-separated list of features in installer that should not be used. Right now, only import_users (imports local users from previous installation on disk) and import_ssh_keys (imports SSH keys from previous installation on disk) are supported. If you don't want this parameter to be appended to Kernel commandline later, use also PTOptions.

Added in SLE 12.

Examples:

ignore_features=import_users
ignore_features=import_users,import_ssh_keys
Info

Specifies the file to read more options from as URL. For supported schemes and a syntax description, look here.

linuxrc reads all specified files. A file may contain further info parameters.

Examples:

info=cd:/info1
info=disk:/install/info2
info=http://foo/bar/info3
InitrdID

Forces initrd ID to a given value. linuxrc compares instsys and initrd IDs and only proceeds if both are identical.

Insecure

linuxrc checks SHA1 sums of all files it downloads. They are taken from (repository):/content after its signature has been verified.

If you don't want this, do:

insecure=1

Note that it is not possible to bring linuxrc back into secure mode after this. In particular:

insecure=0

will not work.

Insmod

This specifies a module the kernel should load, together with any parameters needed for it. Module parameters must be separated by blanks.

The module is loaded before hardware detection starts. Module dependencies are automatically resolved (the name insmod is a bit misleading here).

Note that modules blacklisted with brokenmodules cannot be loaded this way.

Examples:

# load ahci
insmod=ahci
# remember the quotes
insmod="loop max_loop=100"
# load several modules
insmod=tg3 insmod=e1000
install

Specifies the installation repository as URL. For supported schemes and a syntax description, look here.

It must point to either a directory or an ISO image.

Additionally, a special scheme exec is supported which does not need a repository but just runs the argument after linuxrc did the hardware setup.

Examples:

# from CD-ROM
install=cd:/
# ftp from server foo, directory pub/bar
install=ftp://foo/pub/bar
# local disk, ISO image zap.iso in directory bar
install=hd:/bar/zap.iso
# Windows share bar, ISO image zap.iso on server foo
install=smb://foo/bar/zap.iso
# get real URL via SLP
install=slp:/
# just start a shell
install=exec:/bin/sh

The installation program is normally loaded from the repository. If for some reason you don't want this, you can specify the installation system image to use explicitly by adding ?instsys= or using the instsys parameter; for example:

install=cd:/?instsys=ftp://testserver/foo
# is the same as
instsys=ftp://testserver/foo install=cd:/
instsys

Specifies the installation system to use. Default value is boot/<arch>/root. May point to a filesystem image or to a directory. For supported schemes and a syntax description, look here. See install for an alternative way to specify it.

Example:

instsys=my/zappel          # use my/zappel from repository
instsys=http://foo/zappel  # use zappel from server foo
instsys.complain

Controls what initrd should do if initrd ID and instsys ID do not match.

 Values:
 0 ignore
 1 print a warning
 2 abort with an error

In non-Beta systems this parameter defaults to 0 (ignore).

InstsysID

Force instsys ID to a given value. linuxrc compares instsys and initrd IDs and only proceeds if both are identical.

ipv4

Enable or disable IPv4 support. (Both IPv4 and IPv6 are enabled by default.)

Example:

 # disable IPv4
 ipv4=0
ipv4only

Enable IPv4 support, disable IPv6.

Example:

 ipv4only=1
 # is identical to
 ipv4=1 ipv6=0
 # or
 ipv6only=0
ipv6

Enable or disable IPv6 support. (Both IPv4 and IPv6 are enabled by default.)

Example:

 # disable IPv6
 ipv6=0
ipv6only

Enable IPv6 support, disable IPv4.

Example:

 ipv6only=1
 # is identical to
 ipv4=0 ipv6=1
 # or
 ipv4only=0
KBDTimeout

windowed only

Keyboard timeout in seconds. The time after which linuxrc proceeds with default values if no input is made. Default to 0 (off).

Kexec

If set to 1, linuxrc will load kernel and initrd from the repository and restart with them.

Spares people installing via network the download of the Boot-CD as you can keep using an old one.

Available only for x86 and x86-64 currently.

Example:

 kexec=1
kexec_reboot

If set to 1 (the default on most machines), then kexec will be used to reboot the machine after finishing the 1st stage of installation. If set to 0, a normal reboot will be used. There is some blacklist maintained in YaST (for example for VirtualBox) for machine that are known to be broken with kexec.


Keytable

Virtual console keyboard map to load.

Example:

 Keytable=fr-latin1
Lang

Alias for Language parameter.

Language

Language preselected for the installation.

Example:

 Language=de_DE
 Language=fr_FR
 Language=cs_CZ
Linemode

Enables line-mode usable on dumb terminals.

Example:

 linemode=1
linuxrc

Obsolete. Please don't use.

linuxrc.debug

Comma-separated list of a numerical debug level (max. 4) and debug flags. Flags can be turned on or off (prepend '+' or '-'). Debug flags currently supported are:

  • tmpfs: move everything into tmpfs at startup (default)
  • udev: use udev to manage /dev tree (default)
  • udev.mods: let udev load modules (default)
  • wait: stop at critical points and wait for a keypress
  • trace: enable backtrace

See also debug.wait.

Examples:

# a reasonable amount of debug info
linuxrc.debug=1
# ... and stop at some critical points
linuxrc.debug=1,wait
# linuxrc loads drivers itself
linuxrc.debug=-udev.mods
# don't copy files into tmpfs (but keep them in ramfs)
linuxrc.debug=-tmpfs
linuxrc.log

Device to print log messages to. Defaults to /dev/tty3. To see more log messages, increase the debug level.

If you want you log to be automatically saved to the target system, place it in /var/log/YaST2/.

Example:

# save all log messages to 'foo.log'
linuxrc.log=/foo.log
# show them on the default console (ideally together with linemode)
linuxrc.log=/dev/console linemode=1
linuxrc.stderr

Obsolete. Use linuxrc.log.

listen

* experimental *

linuxrc sets up the network and listens on the specified port for input. (You may want to use manual=1 along with this option and then connect via telnet to linuxrc.)

Examples:

# wait for input on port 1234
listen=1234
Loghost

Hostname to redirect syslog to. Also YaST will log both to y2log and to the remote syslog.

To enable log reception on the destination host, see "source" section in /etc/syslog-ng/syslog-ng.conf

LogLevel

Set kernel log level.

 Values: 1 - 8

Defaults to 1 for serial consoles, 7 for all other consoles.

LXRCDebug

Obsolete. Use linuxrcdebug.

Manual

Start linuxrc in manual mode.

 Values:
 0 automatic mode (this is the default)
 1 manual mode
 2 really manual manual mode (E.g. no USB keyboard since no USB setup is done!)

There's normally no reason to use manual mode. Please avoid it. You can pass everything directly via command line.

manual=1 still uses hardware detection to some degree (e.g. to mark suitable modules in module loading dialogs) but you basically have to take care to load all necessary drivers yourself.

manual=2 does no automatic hardware detection at all and is useful only if the hardware detection has some problem. A typical example would be linuxrc not letting you select a network interface even though the driver is loaded and the interface exists.

MemLimit

Amount of free memory in kB below which linuxrc will ask the user to set up a swap partition.

MemLoadImage

Amount of free memory in kB below which linuxrc will not copy the root image into RAM.

MemYaST

Amount of free memory in kB below which linuxrc will start YaST in text mode.

MemYaSTText

Amount of free memory in kB below which linuxrc will ask the user to set up a swap partition before starting YaST.

MinMemory

Amount of memory in kB below which linuxrc will refuse to start. Defaults to 0.

Modeset

Some gfxchips are incompatible with kernel modesetting. Modeset=0 does not work. If X malfunction occurs, try nomodeset, or one of the following specific to your gfxchip:

 i915.modeset=0
 nouveau.modeset=0
 radeon.modeset=0
ModuleDelay

Wait some seconds after loading each module. Useful if your hardware is a bit slow.

Example:

 # wait 5 seconds
 ModuleDelay=5

Defaults to 0.

ModuleDisks

No longer supported.

NameScheme

[openSUSE 11.3+]

Selects the device name scheme linuxrc uses. Value can be by-id, by-path, by-label or "".

Default setting is by-id

Examples:

# back to classical device names (like /dev/sda)
namescheme=
# use /dev/disk/by-path/...
namescheme=by-path
Nameserver

Comma-separated list of DNS servers.

Examples:

# just one
Nameserver=192.168.1.1
# or more
Nameserver=192.168.1.2,192.168.1.3
Netdevice

Specify the network interface. See device description for allowed values.

Normally, this is not necessary. But if you really need this option, consider adding it to the URL of the Install parameter.

Examples:

netdevice=eth1        # 2nd ethernet interface
netdevice=wlan*       # wlan interface
Netmask

also via DHCP

Static IP netmask of the installing host.

Netretry

Netretry=N will retry all network connection attempts N times (e.g., when trying to reach the FTP server). This is mainly for debugging network problems.

NetSetup

Prompt for network parameters and setup network. Normally linuxrc will do this automatically when you install via network. But if you want to configure the network even if you install from local media, use this option.

netsetup accepts a comma-separated list of default, dhcp, hostip, gateway, nameserver, vlanid, or all.

Flags can be turned on or off (prepend '+' or '-').

Examples:

# default = dhcp,hostip,gateway,nameserver
netsetup=default
# same as 'default'
netsetup=1
# do dhcp
netsetup=dhcp
# setup all interfaces
netsetup=dhcp,all
_NetStop

internal

NetUniqueID
NetWait

Wait some seconds after activating the network interface. This might be needed in rare cases for some cards.

If you have problems with DHCP, also look at dhcpcd; for BOOTP, try bootpwait

Example:

 # wait 8 seconds
 NetWait=8
Network

also via DHCP

NewID
NFSOpts

NFS mount options. A comma-separated list. Supported options are vers, tcp, udp, rsize and wsize.

Examples:

# use NFSv2 via UDP
nfsopts=udp,vers=2
# different block size
nfsopts=rsize=4096,wsize=4096
NFS.RSize

Obsolete. Use NFSOpts.

NFS.TCP

No longer supported. Use NFSOpts.

NFS.WSize

Obsolete. Use NFSOpts.

NoMDNS

Turn off MDNS usage.

Example:

nomdns=1
NoPCMCIA

deprecated

Do not start the PCMCIA card manager. This option may not be useful any more.

NoShell

Do not start any shell. By default, linuxrc starts /bin/bash at /dev/tty2, /dev/tty9 and if memory requirements permit (well, about always) also at /dev/tty5 and /dev/tty6.

See also parameters MemLimit, MemYaST and MemYaSTText.

Example:

 noshell=1
Options

Pass options to kernel modules. Syntax is "module.parameter" or "module=parameter".

Examples:

# "tzp=50" for module "thermal"
options=thermal.tzp=50
# looks a bit weird, but means the same:
options=thermal=tzp=50
# create 100 loop devices
options=loop.max_loop=100

Alternatively, all options that are unknown but have the form foo.bar are interpreted as option bar to module foo.

Examples:

thermal.tzp=50
loop.max_loop=100

To pass several options to a module, use, e.g.:

libata.atapi_enabled=1 libata.ignore_hpa=1
# same as above, but in one go:
options="libata.atapi_enabled=1 ignore_hpa=1"
Partition

No longer supported. Use device or install.

password

An alias for ssh.password.

password.enc

An alias for ssh.password.enc.

plymouth

Defines whether plymouth is active during installation.

Example:

plymouth=0
pt.options

Comma-separated list of options linuxrc recognizes and passes on to YaST but does nothing else with. Options are stored in /etc/install.inf using the spelling given in pt.options. You can prepend a '+' or '-' to the (whole) option list indicating that those options should be added or removed to the internal list.

Example:

 pt.options=foo,bar Foo=123 BAR=Nice_Bar
 # this will cause
 #   foo: 123
 #   bar: Nice_Bar
 # to be written to /etc/install.inf
proxy

Defines a HTTP proxy server. For a URL syntax overview, look here.

Examples:

# use proxy.foo.org at port 3128
proxy=http://proxy.example.com:3128
# using 'http://' is optional:
proxy=proxy.example.com:3128
# or, with authentication
proxy=http://foo:bar@proxy.example.com:3128
proxy.port

No longer supported. Use proxy.

proxy.proto

No longer supported. Use proxy.

repo

An alias for install.

rescue

Load the rescue system. See install for syntax.

Alternatively, use rescue=1 and install or instsys.

rescue.image

Location of the rescue system image within the installation source.

restart

If set to 1 and restarted is 0 linuxrc is immediately restarted. The new linuxrc sets restarted automatically to 1 to indicate that it has already been restarted to prevent it from looping. If you want it restarted again, set restarted to 0 first.

Another way to restart linuxrc is to send it the USR2 signal.

This options is basically there to allow linuxrc to be updated while running.

restarted

Indicates whether linuxrc has been restarted and prevents further restarts unless reset to 0. See restart.

root.image

Location of root image (installation system image) within the installation source.

root.password

If set to 'ask', linuxrc will show a dialog to enter the root password.

Example:

 root.password=ask
Screenmap

Obsolete, do not use (it does not do what you probably think [if you think of anything it could do ;) ]).

SCSIBeforeUSB
SCSIRename
Server
Serverdir

No longer supported. Use install.

SetupCmd
SetupNetIF
Share

No longer supported. Use install.

Splash

Defines whether a splash-screen is used during initialization.

Example

 Splash=silent
 Splash=verbose
ssh

This parameter enables access to linuxrc via SSH when performing the installation with YaST in text mode or via X11 forwarding. Use ssh -X root@hostname or ssh -Y root@hostname for X11 forwarding.

 Values: 0 (off), 1 (on)

Example:

 # use ssh and set ssh password
 ssh=1 sshpassword=foobar123
sshd

This parameter enables login to the installation system while the installation is running. Use ssh -X root@hostname to connect. You must also set a password to be able to login. This option is for debugging and does not enable an installation via ssh like the ssh option.

Note that this has no influence on the ssh settings of the target (installed) system.

 Values: 0 (off), 1 (on)

Example:

 # start sshd ssh and set root password
 sshd=1 password=foobar123
ssh.password

This sets the password for the user root for logging into the SSH server during installation if ssh or sshd is set. This is not the password of the system to be installed. See RootPassword.

Example:

 ssh.password=12345678
ssh.password.enc

This sets the password for the user root for logging into the SSH server during installation if ssh or sshd is set. This is not the password of the system to be installed.

The password is passed in encrypted form.

Example:

 ssh.password.enc=$1$Bdh9Ixdo$0me9ZFlYZ7tfKq.T5xTVQ.
startshell

Boots into the installation system and starts a shell. Waits until user exits the shell. User can modify the installation system, mount or remount partitions or start YaST installation manually by running yast.

It also stops again after YaST has finished the installation.

Example:

 startshell=1
TERM

Terminal type on which linuxrc is running

Example:

 TERM=dumb
textmode

Enables starting YaST in text mode otherwise it uses the Qt interface if possible.

Example:

 textmode=1
udev.rule

Write udev rules. Currently only writing network rules to 70-persistent-net.rules is implemented. If the need arises, more can follow.

Note that this option is only useful on command line or in linuxrc.config as the rules need to be written before udevd is started (which is rather early).

The option can be given more than once to pass several rules.

Example:

 # add entry to 70-persistent-net.rules
 udev.rule="mac=00:11:d8:39:4e:d0,name=eth0"
USBWait

Number of seconds to wait after loading USB modules.

UseDHCP

If an automatic network setup is required, defines whether DHCP or BOOTP should be used. Default is DHCP.

Example:

 # use BOOTP
 UseDHCP=0
Username

No longer supported. Use install.

UseSax2

Alias for sax2 parameter.

SSH

This parameter enables access to linuxrc via SSH when performing the installation with YaST in text mode or via X11 forwarding. Use ssh -X root@hostname or ssh -Y root@hostname for X11 forwarding.

 Values: 0 (off), 1 (on)

Example:

 # use ssh and set ssh password
 ssh=1 sshpassword=foobar123
UseSSH

Alias for ssh parameter.

UseVNC

Alias for vnc parameter.

vlanid

If you want to setup a vlan specify the id here.

Note: normally you can't enter a vlan id in manual mode. To enable the vlan dialog set any non-empty value with this option or use the netsetup option.

Example:

 # set v lan id to 12
 vlanid=12
 # enable vlan, but don't set an id
 vlanid=0
 
VNC

The VNC parameter enables the installation process via VNC, making the installation more convenient on hosts that have no or no really usable local console. If enabled, a VNC server is activated on the installation host. See also VNCPassword.

Example:

vnc=1 # enable VNC
VNCPassword

This sets the VNC password for an installation via VNC.

Example:

 VNCPassword=12345678
WaitReboot
WithiSCSI

The YaST:iscsi configuration module is automatically started before before YaST starts the harddisk partitioner module.

WlanAuth

Sets wireless authentication mode:

1=None; 2=WEP Open; 3=WEP Restriced; 4=WPA-PSK

Example:

WlanAuth=4   # WPA-PSK
WlanESSID
WlanKeyAscii
WlanKeyHex
WlanKeyLen
WlanKeyPass
WorkDomain

No longer supported. Use install.

YaST2update
YaST2color
Zen

No longer supported.

ZenConfig

No longer supported.

Zombies

If you don't want linuxrc to take care of zombie processes during installation, set this to 0. (Don't do this.)

Example:

zombies=0

Special parameters for S/390 and zSeries

Parameter Description
CTCProtocol

CTC protocol to use.

 Values:
 0 compatible
 1 extended
 2 z/OS
DataChannel

CCW data channel for CU3088 and QDIO devices

 Format: h.h.hhhh
InstNetDev

Network device to install from.

 Values:
 osa OSA-2 or OSA Express
 hsi Hipersocket
 ctc CTC (deprecated)
 escon ESCON (deprecated)
 iucv IUCV (deprecated)
IUCVPeer

Name of peer for IUCV networking.

Layer2

Turn on OSI layer 2 access for OSA Express Ethernet interfaces.

 Values: 0 (off), 1 (on)
OSAHWAddr

introduced in SLE10 SP1
Manual MAC address setting for Layer 2-enabled OSA devices. Note that this is distinct from HWAddr, which contains the default MAC address as detected by linuxrc.

Example: OSAHWAddr=11:22:33:44:55:66

OSAInterface

Software interface for OSA devices.

 Values:
 qdio QDIO
 lcs LCS
OSAMedium

Physical medium for OSA devices.

 Values:
 eth Ethernet
 tr Token Ring
Portname

Portname for OSA devices.

ReadChannel

CCW read channel for CU3088 and QDIO devices.

 Format: h.h.hhhh
WriteChannel

CCW write channel for CU3088 and QDIO devices.

 Format: h.h.hhhh


Special parameters not handled by Linuxrc itself

Parameter Description
Mem

Defines a maximum RAM that will be used by the installation system. It's helpful for testing installation memory requirements.

Example:

 mem=128M
Y2_BRAILLE

This environment variable sets the style of installation textmode UI to 'braille' i.e. it is optimized for visually impaired people. Use together with 'textmode=1'

Example:

 Y2_BRAILLE=1
Y2DEBUG

Turns all YaST debugging messages on. These messages are logged into the /var/log/YaST2/y2log file marked with <0> flag. This parameter is handled by Portal:YaST itself and can be also prepended to the command-line when starting any YaST module.

TERM

Setting this environment variable influences the color style that will be used in installation text mode UI. E.g. TERM=xterm sets the theme to xterm, some TERM not supporting colors will use monochromatic theme. When not set, default theme linux is applied. However, be careful and before setting any TERM value, check that it has valid terminfo entry. Otherwise installation may abort.

Available terms can be found in the /yast/instsource/inst-sys/usr/share/terminfo directory - installation system has another set of available terms than a running system. To get a monochromatic term, use linux-m.

Use this parameter together with textmode=1.

Example:

 TERM=xterm
 TERM=linux-m
ZYPP_FULLLOG

Sets LibZYPP logging level to the highest value. Useful for debugging products, packages and patches dependency problems. This variable can be also set on a running system before running every Portal:YaST module.

Example:

 ZYPP_FULLLOG=1                           # Linuxrc
 ZYPP_FULLLOG=1 /sbin/yast2 online_update # Running system