2008-08-02 16:18:07 +00:00
=head1 NAME
B<geninitrd> - Regenerates the initrd for a stateless image to be used for a diskless install.
=head1 SYNOPSIS
2010-09-25 07:13:37 +00:00
B<geninitrd> [B<-i> I<nodebootif>] [B<-n> I<nodenetdrivers>] [B<-o> I<OS>] [B<-p>] [I<profile>] [B<-l> I<rootlimit>] [B<-k> I<kernel_version>] [B<--permission> I<permission>]
B<geninitrd> [B<-i> I<nodebootif>] [B<-n> I<nodenetdrivers>] [B<-o> I<OS>] [B<-p>] [I<profile>] [B<-l> I<rootlimit>] [B<-k> I<kernel_version>] [B<--permission> I<permission>] imagename
2008-08-02 16:18:07 +00:00
B<geninitrd> [B<-h> | B<--help> | B<-v> | B<--version>]
=head1 DESCRIPTION
2010-09-25 07:13:37 +00:00
Regenerates the initrd that is part of a stateless/statelite image that is used to boot xCAT nodes in a stateless/statelite mode.
2008-08-02 16:18:07 +00:00
The generated initrd will be put in /install/netboot/<OS>/<arch>/<profile>.
The B<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.
2010-09-25 07:13:37 +00:00
The B<geninitrd> command will generate two initial ramdisks, one is B<initrd-statelite.gz> for B<statelite> mode, the other one is B<initrd-stateless.gz> for B<stateless> mode.
2008-08-02 16:18:07 +00:00
=head1 OPTIONS
=over 12
=item B<-o> I<OS>
The operating system for the image: fedora8, rhel5, sles10, etc. The OS packages must be in
/install/<OS>/<arch> (use L<copycds(8)|copycds.8>).
=item B<-p> I<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.
=item B<-i> I<nodebootif>
The network interface the diskless node will boot over (e.g. eth0).
=item B<-n> I<nodenetdrivers>
The driver modules needed for the network interface. Note: the order that the drivers are specified in
is important.
=item B<-l> I<rootlimit>
The maximum size allowed for the root file system in the image. Specify in bytes, or can append k, m, or g.
=item B<-k> I<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.
=item B<-v>
Display version.
=item B<-h>
Display usage message.
=back
=head1 RETURN VALUE
0 The command completed successfully.
1 An error has occurred.
=head1 EXAMPLES
=over 3
=item 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
=back
=head1 FILES
/opt/xcat/share/xcat/netboot/<OS>/geninitrd
=head1 SEE ALSO
2010-09-25 07:13:37 +00:00
L<genimage(1)|genimage.1>, L<packimage(1)|packimage.1>
