| Usage: mk-initramfs-oneSIS | [OPTION]...  initramfs kernel-version |
| -o, | -overlay=DIR | Overlay one or more directories on top of the |
| initramfs template being used | ||
| -b, | -basedir=DIR | Look for files relative to DIR (default: /) |
| -cf, | -config=FILE | Configuration file to use for tayloring initramfs. |
| Any commandline parameters override settings | ||
| specified in the config file | ||
| (default: basedir/etc/oneSIS/initrams.conf) | ||
| -v, | -variant=STRING | If multiple variants of a config file exists, |
| specify the class or node variant to use | ||
| -d, | -scsi | Include all scsi_hostadapter modules that are listed |
| in basedir/etc/modprobe.conf | ||
| -p, | -preload=STRING | Add the specified module (loads before SCSI modules) |
| -m, | -module=STRING | Add the specified module (loads after SCSI modules) |
| -w, | -with=STRING | Add the specified module (deprecated) |
| -c, | -copy=PATH | Copy given PATH to the ramfs image |
| -rc, | -recursecopy=PATH | Recursively copy given PATH to the ramfs image |
| -nl, | -nolibs | Do not copy library dependencies for files copied to ramfs |
| -t, | -template=FILE | Use the specified initramfs template. |
| (default: /usr/share/oneSIS/initramfs-templates/initramfs-x86.tar.gz) | ||
| -f, | -force | Force overwrite of an existing output file |
| -td, | -tempdir=DIR | Use alternate staging directory instead of /tmp |
| -r, | -readme | Show the README of a given initramfs (ie: to see what options were used) |
| -q, | -quiet | Suppress output |
| -vb, | -verbose | Verbose output |
| --- Initrd Behavior Flags (deprecated) --- | ||
| -i, | -initrd | Output an initrd image instead of an initramfs image |
| -s, | -size=NUM | Hard code the size of an initrd. By default, |
| the size is determined automatically and a small | ||
| buffer is added on for usable empty space | ||
| -bs, | -buffersize=NUM | Specify initrd empty space buffer size (default: 1024) |
| --- Initramfs Behavior Flags --- | ||
| -rr, | -ramdiskroot | Use the ramdisk as the root filesystem |
| -ro, | -ram_overlay[=SIZE] | Overlay a RAM disk onto the NFS root filesystem |
| -am, | -automount | Auto-mount labeled partitions and swapon swap |
| partitions from the initramfs | ||
| -rw, | -readwrite=STRING | Auto-mount specified labeled partitions read-write |
| The string 'ALL' will mount all partitions read-write | ||
| -nd, | -nodhcp | Don't run a DHCP client from the initramfs |
| -di, | -dhcp_if | Run DHCP over the specified interface. (default: eth0) |
| -dr, | -dhcp_retries=NUM | Attempt to retry DHCP this many times before failing |
| (0 means infinite retries, default: 5) | ||
| -nr, | -nfs_retries=NUM | Attempt to retry mounting the NFS root NUM times |
| before failing. (default: 5) | ||
| -nc, | -net_check=NUM | Perform NUM network connectivity checks before |
| attempting to mount the NFS root. (default: 5) | ||
| -bi, | -bond_ifs=STRING | Comma seperated list of interface names to create |
| a bonded interface from. | ||
| -nn, | -nonfs | Do not attempt to mount an NFS root |
| -nm, | -nomods | Do not copy any modules listed in modprobe.conf, |
| only those explicity requested (and their deps) | ||
| -nf, | -nofw | Do not copy any firmware dependencies of any modules |
| -ra, | -raid | Attempt to assemble any existing raid arrays |
| -re, | -resume=DEVICE | Attempt to resume from swsusp image on DEVICE |
An alternate method for booting oneSIS systems is to bootstrap using an
initial ramdisk (initramfs).
By using mk-initramfs-oneSIS, an initramfs can be built that
is customized for an entire cluster or for any subset of nodes.
Kernel modules needed for NFS and those specified by any
eth0 aliases in /etc/modules.conf are included
automatically in the initramfs and loaded at boot time. Likewise, any
scsi_hostadapter alias in /etc/modules.conf will
cause the
corresponding driver to be loaded when the -scsi option is given.
Any other modules can be included with command-line arguments.
All modules must exist in
/lib/modules/kernel-version relative to the basedir.
For example, to create an initramfs for a node running a 3.10.0 kernel
with an e1000 network card and IDE disk support built into
the kernel, assuming kernel modules are installed in
/lib/modules/3.10.0, you would type:
Local disk partitions that have been created with
DEPLOYMOUNT, or DEPLOYSWAP directives and the
mk-diskful script (see section 6.5) can be
mounted automatically (or swapped-on) from the initramfs.
To automount locally deployed partitions on the system described above: