wiki:SaliUsage/Installationparameters

Version 25 (modified by bas, 12 years ago) (diff)

--

Introduction

All of the documented kernel boot parameters plus those below may be used during the installation. All the parameters can be appended to the kernel boot parameters in /etc/systemimager/pxelinux.cfg/syslinux.cfg on your image server.

Note that ALL kernel parameters listed below are CASE SENSITIVE, and that a trailing = on the name of any parameter states that that parameter will be entered as an environment variable, whereas its absence indicates that it will appear as a kernel argument readable via /proc/cmdline by programs running once the system is up. The number of kernel parameters is not limited, but the length of the kernel command line (including parameters, spaces, etc.) is limited to a fixed number of characters. This limit depends on the architecture and is between 256 and 4096 characters. It is defined in the file ./include/asm/setup.h as COMMAND_LINE_SIZE

SALI kernel boot parameters

BITTORRENT=y|n

If set to y use the BitTorrent transport (recommended if you need to install a huge amount of clients). See BitTorrent for more details. This option is deprecated and being replaced by: PROTOCOL=protocol Default is: n.

BITTORRENT_STAGING=directory

This option is deprecated and being replaced by: STAGING=directory

BLACKLIST=kernel_modules

Specify which kernel modules must be blacklisted to prevent udev from loading them.

Specify as: BLACKLIST=module_a;module_b;module_c

BROADCAST=x.x.x.x

Set the broadcast address of the client to x.x.x.x.

DEVICE=ethi

Set the management interface of the client to ethi. The client will contact the image server on that interface. Starting from SystemImager 3.8.1 this parameter can be used also to force the execution of the DHCP client only on a single interface (default is to try all the available interface on the client).

DOMAINNAME=domainname

Set the domain of the client to domainname.

ETHER_SLEEP=sec

Give the switch time to start passing packets. Some switches won't forward packets until 30 seconds or so after an interface comes up. This means the DHCP server won't even get the request for 30 seconds. Set this parameter if your client doesn't seem to receive the DHCPOFFER from the DHCP server. Default is: 0.

HOSTNAME=hostname

Set the hostname of the client to hostname.

GATEWAY=gateway

Use the default gateway.

GRUB2=yes|no

This flag has been added to be used in the installation script. A recommendation with grub2 is to install it on a separate partition with the flag bios_grub. This is only posible with GPT enabled disk. So this variable has been added to determine which disk table must be used. For a example see this install script and partition function. Default is: no

IMAGENAME=imagename

Install the image imagename on the client.

IMAGESERVER=imageserver

Use the image server imageserver to download the image on the client.

IPADDR=x.x.x.x

Set the IP address of the client to x.x.x.x.

LOG_SERVER=logserver

Use logserver as the log server. Remember to configure syslog on that host to accept remote logs and configure the firewall to accept connections on the port 514/UDP.

LOG_SERVER_PORT=port

Use the UDP port port to send log to the log server, instead of using the default port 514/UDP. Remember to configure the firewall on your log server to accept connections on port port/UDP.

MONITOR_CONSOLE=yes|no

If set to yes enable full console view. With full console is enabled it is possible to follow the full installation process on clients (stdout and stderr). See Monitoring for more details. Default is: no.

MONITOR_PORT=port

Use the port port/TCP to send client informations to the monitor server. See Monitoring for more details. Default is: 8181.

MONITOR_SERVER=monitorserver

Enable Monitoring feature and use monitorserver as monitor server. See Monitoring for more details.

NETMASK=x.x.x.x

Set the netmask of the client to x.x.x.x.

NETWORK=x.x.x.x

Set the network address of the client to x.x.x.x.

PROTOCOL=protocol

Select which protocol must be used for installation of the node(s):

  • rsync
  • bittorrent

Defautl is: rsync.

RESCUE=yes|no

Open a shell window when RESCUE=yes is specified.

SCRIPTNAME=script

This parameter can be specified to force the use of the autoinstallation script script. If it is not specified (and, in general, this is the case) the first script found from the followings is taken: IMAGENAME.master (if IMAGENAME is defined in the installation parameters) HOSTNAME.sh BASE_HOSTNAME.master (e.g. if you have from node001 to node100 the BASE_HOSTNAME is node) You can play with your autoinstall scripts, create symlinks, etc. in /var/lib/systemimager/scripts on your image server.

SCRUB=?

SCRUB_DISKS=?

SCRUB_REBOOT=?

SCRUB_HALT=?

SCRUB_OPTIONS=?

SSH=y|n

Enable the SSH transport if SSH=y. See SSH for more details. Default is: n

SSHD=y|n

If SSHD=y a SSH daemon is started on the imaging client. By default only passwordless login are allowed (via /root/.ssh/authorized_keys). This option is only available in version 3.8.0 and above.

SSH_DOWNLOAD_URL

Use the url http://url to download the authorized_keys to install via SSH tunnel. See SSH for more details.

SSH_USER=user

Use the user user to download the image via a SSH tunnel from the image server. See SSH for more details.

STAGING=directory

Download the image BitTorrent tarball in the specified directory. Default: if not set autodetect the best staging directory.

VERBOSELEVEL=number

Specify the verbose level from 0 to 255.

Default is: 2