NAME

geninitrd - Regenerates the initrd for a stateless image to be used for a diskless install.


SYNOPSIS

geninitrd [-i nodebootif] [-n nodenetdrivers] [-o OS] [-p] [profile] [-l rootlimit] [-k kernel_version] [--permission permission]

geninitrd [-i nodebootif] [-n nodenetdrivers] [-o OS] [-p] [profile] [-l rootlimit] [-k kernel_version] [--permission permission] imagename

geninitrd [-h | --help | -v | --version]


DESCRIPTION

Regenerates the initrd that is part of a stateless/statelite image that is used to boot xCAT nodes in a stateless/statelite mode. The generated initrd will be put in /install/netboot/<OS>/<arch>/<profile>.

The geninitrd command must be run on a system that is the same architecture as the nodes it will be used on. If the management node is not the same architecture, copy the contents of /opt/xcat/share/xcat/netboot/<OS> to a system that is the proper architecture, and mount /install from the management node to that system.

The geninitrd command will generate two initial ramdisks, one is initrd-statelite.gz for statelite mode, the other one is initrd-stateless.gz for stateless mode.


OPTIONS

-o OS

The operating system for the image: fedora8, rhel5, sles10, etc. The OS packages must be in /install/<OS>/<arch> (use copycds(8)).

-p profile

The profile (e.g. compute, service) to use to create the image. This determines what package lists are used from /opt/xcat/share/xcat/netboot/<OS> to create the image with. When deploying nodes with this image, the nodes' nodetype.profile attribute must be set to this same value.

-i nodebootif

The network interface the diskless node will boot over (e.g. eth0).

-n nodenetdrivers

The driver modules needed for the network interface. Note: the order that the drivers are specified in is important.

-l rootlimit

The maximum size allowed for the root file system in the image. Specify in bytes, or can append k, m, or g.

-k kernel_version

Use this flag if you want to use a specific version of the kernel in the image. Defaults to the first kernel found in the install image.

-v

Display version.

-h

Display usage message.


RETURN VALUE

0 The command completed successfully.

1 An error has occurred.


EXAMPLES

  1. To regenerate the initrd for a fedora8 image for a compute node architecture x86_64 and place it in the /install/netboot/fedora8/x86_64/compute/rootimg directory: change directory to /opt/xcat/share/xcat/netboot/fedora and run:

     geninitrd -i eth0 -n tg3,bnx2 -o fedora8 -p compute


FILES

/opt/xcat/share/xcat/netboot/<OS>/geninitrd


SEE ALSO

genimage(1), packimage(1)