Chapter 5. Using RHN Bootstrap

Red Hat provides a tool designed to accomplish much of the reconfiguration described within this guide in one fell swoop: RHN Bootstrap. This tool plays an integral role in the RHN Satellite Server Installation Program, enabling generation of the bootstrap script during installation.

But RHN Proxy Server customers and those who've updated their Satellite settings need a bootstrap tool that can be used separately. The RHN Bootstrap, invoked with the command /usr/bin/rhn-bootstrap, serves that purpose and comes installed by default on either RHN Server.

If used correctly, the script this tool generates can be run from any client system to conduct the following tasks:

Customers should note, however, the inherent risks of using a script to conduct configuration. Because security tools such as SSL certificates are being installed by the script itself, they do not yet exist on the systems and cannot be used to process transactions. This does allow for the possibility of someone impersonating the Satellite and transmitting bad data. This is mitigated by the fact that virtually all Satellites and client systems operate behind customer firewalls and are restricted from outside traffic. Registration is conducted via SSL and therefore protected.

The bootstrap script bootstrap.sh is automatically placed in the /var/www/html/pub/bootstrap/ directory of the RHN Server. From there it can be downloaded and run on all client systems. Note that some preparation and post-generation editing is required, as identified in the following sections. Refer to Section 5.4 RHN Bootstrap Options for the tool's complete list of options. Finally, refer to the Appendix A Sample Bootstrap Script for an example script.

5.1. Preparation

Since RHN Bootstrap (rhn-bootstrap) depends on other components of the Red Hat Network infrastructure to properly configure client systems, those components must be prepared before script generation. The following list identifies suggested measures to be taken first: