diff options
| author | Luca Boccassi <bluca@debian.org> | 2018-03-16 19:30:50 +0000 |
|---|---|---|
| committer | Luca Boccassi <bluca@debian.org> | 2018-03-22 16:14:01 +0000 |
| commit | 46c95969265fff53173a06419db46133c12f42ae (patch) | |
| tree | c4407ab3e6f996e2f7f6d37bbb1a7d217fa3bc1f /manpages | |
| parent | 8047c2425ac8ca8c89586b76dcce4a4fbe66f303 (diff) | |
| download | vyos-live-build-46c95969265fff53173a06419db46133c12f42ae.tar.gz vyos-live-build-46c95969265fff53173a06419db46133c12f42ae.zip | |
Add options to build ONIE images
Open Network Install Environment is an open image format used by
networking vendor to ship a standardised image for networking white
box switches.
ONIE hardware takes this image at boot and a script to chain load
into the final environment via kexec. We can support Debian and
derivatives on such systems by packing an ISO which then gets
unpacked, kexec'ed and live-booted.
A base ONIE system can be tested in QEMU by building a VM following
these instrunctions:
https://github.com/opencomputeproject/onie/blob/master/machine/kvm_x86_64/INSTALL
Once built, boot onie-recovery-x86_64-kvm_x86_64-r0.iso in QEMU/libvirt
and on the console there will be the terminal prompt. Check the IP
assigned by libvirt and then scp the live image (ssh access is enabled
as root without password...). Then the .bin can be booted with:
ONIE-RECOVERY:/ # onie-nos-install /tmp/live.hybrid.iso-ONIE.bin
The implementation is inspired by ONIE's own scripts that can be found
at:
https://github.com/opencomputeproject/onie/blob/master/contrib/debian-iso/cook-bits.sh
A new option, --onie (false by default) can be set to true to enable
building this new format in addition to an ISO.
An additional option, --onie-kernel-cmdline can be used to specify
additional options that the ONIE system should use when kexec'ing the
final image.
Note that only iso or hybrid-iso formats are supported.
For more information about the ONIE ecosystem see:
http://onie.org
Signed-off-by: Erik Ziegenbalg <eziegenb@Brocade.com>
Signed-off-by: Luca Boccassi <bluca@debian.org>
Diffstat (limited to 'manpages')
| -rw-r--r-- | manpages/en/lb_config.1 | 8 |
1 files changed, 8 insertions, 0 deletions
diff --git a/manpages/en/lb_config.1 b/manpages/en/lb_config.1 index c90f85de3..ac562d209 100644 --- a/manpages/en/lb_config.1 +++ b/manpages/en/lb_config.1 @@ -199,6 +199,10 @@ .br [\fB\-\-net\-tarball\fR true|false] .br + [\fB\-\-onie\fR true|false] +.br + [\fB\-\-onie\-kernel\-cmdline\fR \fI"OPTION1 OPTION2"\fR] +.br [\fB\-\-quiet\fR] .br [\fB\-\-archive\-areas\fR \fIARCHIVE_AREA\fR|\fI"ARCHIVE_AREAS"\fR] @@ -432,6 +436,10 @@ Example: sets the IP or hostname that will be configured in the bootloader configuration for the copy\-on\-write filesystem of your netboot image and is by default empty. .IP "\fB\-\-net\-tarball\fR true|false" 4 defines if a compressed tarball should be created. Disabling this options leads to no tarball at all, the plain binary directory is considered the output in this case. Default is true. +.IP "\fB\-\-onie\fR true|false" 4 +defines if an ONIE.bin image is generated. ONIE binaries can be loaded by supported systems, and will in turn boot the live image. Note that iso or hybrid-iso are the only formats supported. For more information visit <\fIhttp://onie.org/\fR>. Default is false. +.IP "\fB\-\-onie\-kernel\-cmdline\fR \fI""OPTION1 OPTION2""\fR" 4 +defines additional kernel command line options that the ONIE system will use when booting the image. Default is empty string. .IP "\fB\-\-quiet\fR" 4 reduces the verbosity of messages output by \fBlb build\fR. .IP "\fB\-\-archive\-areas\fR \fIARCHIVE_AREA\fR|""\fIARCHIVE_AREAS\fR""" 4 |