The boot parameters for Clonezilla live
<a href="https://wiki.ubuntu.com/Kernel/KernelBootParameters"
target=_blank>Kernel boot parameters</a> are text strings which are
interpreted by the system to change specific behaviors and enable or
disable certain features.
Different boot loaders use different config files for the boot
parameters:
<ol>
<li>For Clonezilla live booting from CD on a MBR machine, <a
href="http://www.syslinux.org" target=_blank>isolinux</a> is the boot
loader. Therefore the config file is /syslinux/isolinux.cfg.</li>
<li>For Clonezilla live booting from USB flash drive on a MBR machine, <a
href="http://www.syslinux.org" target=_blank>syslinux</a> is the boot
loader. Therefore the config file is /syslinux/syslinux.cfg.</li>
<li>For Clonezilla live booting from PXE on a MBR machine, <a
href="http://www.syslinux.org" target=_blank>pxelinux</a> is the boot
loader. The config file is on the PXE server, and is configured by the
system administrator. it could be something like
/tftpboot/nbi_img/pxelinux.cfg/default, or different file.</li>
<li>For Clonezilla live booting from a uEFI machine, <a
href="http://en.wikipedia.org/wiki/GNU_GRUB" target=_blank>grub2</a> is
used. Therefore the config file is /EFI/boot/grub.cfg. </li>
</ol>
<p>We now describe the kernel boot parameters related to Clonezilla live.
If you want to modify the boot parameters, make sure you edit the right
config file.</p>
<p>Clonezilla live is based on <a href="http://live.debian.net/"
target=_blank>Debian live</a> with clonezilla installed. Therefore there
are 2 kinds of boot parameters:</p>
<ol>
<li>Boot parameters from Debian live-boot and live-config. You can refer
to the <a href="clonezilla-live/boot-parameters/live-boot.php">manual of
live-boot</a> and <a href="clonezilla-live/boot-parameters/liveconfig.php">manual of live-config.</a>.
<li>Boot parameters specially for Clonezilla. All of them are named as
"ocs_*", e.g. ocs_live_run, ocs_live_extra_param, ocs_live_batch.
<ul>
<li>ocs_live_run is intended for saving/restoring an image or cloning
disk/partition. It is the main program to be run in Clonezilla live.
Available program: ocs-live-general, ocs-live-restore or any command you
write.<br>
e.g. ocs_live_run="ocs-live-general"<br>
<font color="red">//NOTE// You might have to use "sudo" command
inside your own script, or you can assign it like: ocs_live_run="sudo
bash /my-clonezilla"</font><br>
<li>ocs_live_extra_param will be used only when ocs_live_run=ocs-liverestore (not for ocs-live-general or any other), then it will be passed
to ocs-sr. Therefore these parameters are actually those of ocs-sr.<br>
e.g. ocs_live_extra_param="--batch -c restoredisk sarge-r5 hda"
<li>To preset the keyboard layout, use "keyboard-layouts" from <a
href="http://live.debian.net/manual/3.x/html/livemanual.en.html#customizing-locale-and-language" target=_blank>liveconfig</a>.<br>
e.g. keyboard-layouts=NONE (won't change the default layout, which
is US keyboard)<br>
keyboard-layouts=fr (French keyboard)<br>
//NOTE// The ocs_live_keymap used in Clonezilla live 1.x is deprecated.
The following description is only for reference.<br>
ocs_live_keymap is for keymap used in Clonezilla live. Man installkeymap for more details.<br>
e.g. ocs_live_keymap="NONE" (won't change the default layout)<br>
ocs_live_keymap="/usr/share/keymaps/i386/azerty/frlatin9.kmap.gz" (French keyboard)
<li>batch mode or not (yes/no), if no, will run interactively.<br>
e.g. ocs_live_batch="no"
<li>To preset the language, use "locales" from <a
href="http://live.debian.net/manual/3.x/html/livemanual.en.html#customizing-locale-and-language" target=_blank>liveconfig</a>.<br>
e.g. locales=en_US.UTF-8<br>
//NOTE// The "ocs_lang" used in Clonezilla live 1.x is deprecated.
<li>To preset the font name and font size for KMS mode, use
"ocs_fontface" and "ocs_fontsize".<br>
e.g. ocs_fontface="TerminusBold"<br>
ocs_fontsize="24x12"<br>
Check file /etc/default/console-setup and the console-setup(5)
manual page on Debian or Ubuntu system.
<li>ocs_debug (or ocs-debug) is for you to enter command line prompt
before any clonezilla-related action is run. This is easier for you to
debug.
<li>ocs_daemonon, ocs_daemonoff, ocs_numlk, ocs_capslk.<br>
Ex. for the first 2 parameters, ocs_daemonon="ssh", then ssh service will
be turned on when booting. For the last 2 parameters, use "on" or "off",
e.g. ocs_numlk=on to turn on numberlock when booting.
<li>ocs_prerun, ocs_prerun1, ocs_prerun2... is intended for running a
command before an operation of saving/restoring an image or cloning
disk/partition is started. E.g. ocs_prerun="/live/image/myscript.sh". If
you have more commands to run, you can assign them in the order:
ocs_prerun=..., ocs_prerun1=..., ocs_prerun2=.... If more than 10
parameters, remember to use ocs_prerun01, ocs_prerun02..., ocs_prerun11
to make it in order.
<li>ocs_postrun, ocs_postrun1, ocs_postrun2... is intended for running
a command after an operation of saving/restoring an image or cloning
disk/partition has been completed. E.g.
ocs_postrun="/live/image/myscript.sh". If you have more commands to run,
you can assign them in the order: ocs_postrun=..., ocs_postrun1=...,
ocs_postrun2=.... If more than 10 parameters, remember to use
ocs_postrun01, ocs_postrun02..., ocs_postrun11 to make it in order.
<li>echo_ocs_prerun and echo_ocs_postrun are used to echo the commands
of prerun and postrun. By default the command assigned in ocs_prerun or
ocs_postrun will be echoed. By using "no" the command won't be echoed.
This is useful when you want to hide some commands.<br>
e.g. echo_ocs_prerun="no" (Will not show the commands assigned in
boot parameter "ocs_prerun").
<li>ocs_live_run_tty. This option allows you to specify the tty where
$ocs_live_run is run. By default $ocs_live_run is run on /dev/tty1 only.
If you want to use ttyS0, for example, add live-getty and
console=ttyS0,38400n81 in the boot parameter.<br>
<font color=red>//NOTE//</font><br>
<ul>
<li>If "live-getty console=ttyS0,38400n81" are assigned in the boot
parameters, ocs_live_run_tty will honor ttyS0, even other value is
assigned to ocs_live_run_tty in boot parameter.
<li>It's recommended to assign locales and keyboard-layouts in the boot
parameters too.
</ul>
<li>ip, this option allows you to specify the network parameters for
network card. In Clonezilla live a patched live-initramfs is used, which
is different from the original live-initramfs so that you can assign DNS
server, too. Its format is: ip=ethernet port,IP address, netmask,
gateway, DNS. E.g. If you want to assing eth0 with IP address 10.0.100.1,
netmask 255.255.255.0, gateway 10.0.100.254, DNS server 8.8.8.8, you can
assign the following in the boot parameter:<br>
ip=eth0:10.0.100.1:255.255.255.0:10.0.100.254:8.8.8.8<br>
If more than one network card, you can use "," to separate them,
e.g.:<br>
ip=eth0:10.0.100.1:255.255.255.0:10.0.100.254:8.8.8.8,eth1:192.168.120.1:
255.255.255.0:192.168.120.254::<br>
<li>Besides, two parameters could be used to assign the network card
for PXE booting, "live-netdev" (yes, not ocs_live_netdev) and "nicif" can
be used when using PXE booting,<br>
<ol>
<li>For "live-netdev", you can force to assign the network device by
its ethernet device name on GNU/Linux, e.g. eth0, eth1, to get
filesystem.squashfs. This is useful when there are two or more NICs are
linked. E.g. live-netdev="eth1" allows you to force the live-initramfs to
use eth1 to fetch the root file system filesystem.squashfs.
<li>For "nicif", you can force to assign the network device by its MAC
address, e.g. 00:aa:bb:cc:dd:ee, to get filesystem.squashfs. This is
useful when there are two or more NICs are linked. E.g.
nicif="00:aa:bb:cc:dd:ee", allows you to force the live-initramfs to use
the ethernet card with MAC address "00:aa:bb:cc:dd:ee" to fetch the root
file system filesystem.squashfs.
</ol>
</ul>
</ol>
<p>You can find some examples about using these boot parameters in the <a
href="clonezilla-live-doc.php">Clonezilla Live Doc</a>.
<hr>