mirror of
https://github.com/xcat2/xcat-core.git
synced 2026-09-21 08:33:20 +00:00
Vinícius Ferrão
6eba1277fe
Add the riscv64 page to the cluster management guide (UEFI + grub2 boot path, discovery through mknb's grub2 network configurations, stateful and stateless provisioning, the dependency picture for a management node on riscv64, limitations), list riscv64 in the node object attributes and in the support matrices, add the architecture to the cross-build page for stateless images, extend the grub2 install guide (and fix its swapped x86_64/aarch64 file names), the uninstall package lists, the DHCP backend validation matrix and the mknb/genimage man pages, and carry the riscv64 schema values into the generated nodetype, osimage, noderes, node and group references.
63 lines
3.2 KiB
INI
63 lines
3.2 KiB
INI
=head1 NAME
|
|
|
|
B<mknb> - creates a network boot root image for node discovery and flashing
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
B<mknb> I<arch>
|
|
|
|
B<mknb> I<arch> B<--remove-openembedded>
|
|
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
The B<mknb> command is run by xCAT automatically when xCAT is installed on the management node.
|
|
It creates a network boot root image (used for node discovery, BMC programming, and flashing)
|
|
for the same architecture that the management node is. So you normally do not need to run the
|
|
B<mknb> command yourself.
|
|
|
|
If you make custom changes to the network boot root image, run B<mknb> again to regenerate it. In an xCAT hierarchical cluster where service nodes have local C</tftpboot> directories (C<site.sharedtftp=0>), install and refresh an OpenEmbedded image on the service nodes before the management node starts using its exact architecture name. Legacy images must still be copied to each service node.
|
|
|
|
An OpenEmbedded Genesis package installs an exported image under C</opt/xcat/share/xcat/netboot/genesis-openembedded/ARCH>. B<mknb> prefers that image when it is installed. Otherwise it uses the old image under C</opt/xcat/share/xcat/netboot/genesis/ARCH>.
|
|
|
|
An export is identified by C<xcat-genesis.manifest>, which records its format version and architecture. The directory also contains C<kernel>, C<initramfs.cpio.gz>, and C<SHA256SUMS>. B<mknb> verifies the manifest and both boot files before publishing them under the configured TFTP root. An incomplete or invalid export leaves the current boot files unchanged. The legacy C<fs/> layout remains supported and is packed locally.
|
|
|
|
When multiple IPv4 addresses are configured for the same network, B<mknb> uses a locally assigned C<site.master> for the xcatd endpoint, or the first address reported by the operating system when C<site.master> is not local. POWER discovery configurations also use this address for their kernel and initrd URLs.
|
|
|
|
OpenEmbedded images use the exact architecture names C<x86>, C<x86_64>, C<ppc64>, C<ppc64le>, C<armv7hf>, C<aarch64>, and C<riscv64>. If an OpenEmbedded C<ppc64le> image is not installed, B<mknb> keeps the old behavior and uses the legacy C<ppc64> image.
|
|
|
|
Canonical C<ppc64> images are big-endian. xCAT marks them so C<ppc64le> nodes do not use them as a legacy little-endian fallback. B<mknb> also refuses to replace a marked C<ppc64> image with that fallback.
|
|
|
|
riscv64 nodes boot through UEFI firmware and grub2. For riscv64, B<mknb> publishes the Genesis kernel and initramfs and writes one grub2 configuration per network under C</tftpboot/boot/grub2>, named C<grub.cfg-> followed by the network hex prefix, so that C<grub2.riscv64> loaded by the firmware can start node discovery. The per-node files written by B<nodeset> take priority over these network files. Networks served by a C<:noboot> interface in C<site.dhcpinterfaces> get no discovery configuration.
|
|
|
|
=head1 OPTIONS
|
|
|
|
=over 12
|
|
|
|
=item I<arch>
|
|
|
|
The hardware architecture for which to build the boot image.
|
|
|
|
=item B<--remove-openembedded>
|
|
|
|
Remove the published boot files for the selected OpenEmbedded architecture. Image packages use this option when they are removed.
|
|
|
|
=back
|
|
|
|
=head1 RETURN VALUE
|
|
|
|
=over 2
|
|
|
|
=item 0.
|
|
The command completed successfully.
|
|
|
|
=item 1.
|
|
An error has occurred.
|
|
|
|
=back
|
|
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<makedhcp(8)|makedhcp.8>
|