rhn-bootstrap

Langue: en

Version: 07 October 2010 (fedora - 01/12/10)

Section: 1 (Commandes utilisateur)

NAME

rhn-bootstrap - generate bootstrap scripts to aid in the deployment / configuration of RHN client systems.

SYNOPSIS

     
 
 rhn-bootstrap [ options ... ] [ -h|--help ]
 
 

DESCRIPTION

rhn-bootstrap generates bootstrap scripts to be used by RHN client systems for the purpose of simplifying their initial configuration and bootstrapping them to an RHN Satellite and/or Proxy Server. This is a script generator. You then use those scripts to configure & register RHN clients.

Once the bootstrap script is generated (by default /var/www/html/pub/bootstrap/bootstrap.sh). The admin must edit it by hand to verify it is correct, and to enable it. It is then used to configure and register client systems as such:

cd /var/www/html/pub/bootstrap/

cat bootstrap-<edited_name>.sh | ssh root@<client-hostname> /bin/bash

...or...

wget -qO- https://<hostname>/pub/bootstrap/bootstrap-<edited_name>.sh | /bin/bash

...or...

curl -Sks https://<hostname>/pub/bootstrap/bootstrap-<edited_name>.sh | /bin/bash

OPTIONS

--activation-keys=ACTIVATION_KEYS
activation key(s) as defined in the RHN web UI - format is XKEY,YKEY,...
--overrides=OVERRIDES_FILE
configuration overrides filename (by default: client-config-overrides.txt).
--script=GENERATED_SCRIPT
bootstrap script filename (by default: boostrap.sh).
--hostname=FQDN
hostname (FQDN) to which clients connect (default: this server's hostname)
--ssl-cert=SSL_CERT_PATH
path to corporate CA public SSL certificate - an RPM or a raw certificate. It will be copied to --pub-tree. A value of "" will force a search of --pub-tree.
--gpg-key=GPG_KEY_PATH
path to the corporate public GPG key, if used. It will be copied to --pub-tree. (default: "").
--http-proxy=HOSTNAME:PORT
HTTP proxy setting for the clients - hostname:port. --http-proxy="" disables. (default: "")
--http-proxy-username=HTTP_PROXY_USERNAME
if using an authenticating HTTP proxy, specify a username. --http-proxy-username="" disables. (Default: "").
--http-proxy-password=HTTP_PROXY_PASSWORD
if using an authenticating HTTP proxy, specify a password. (default: "")
--allow-config-actions
boolean; allow all configuration actions - requires installing certain rhncfg-* RPMs probably via an activation key.
--allow-remote-commands
boolean; allow arbitrary remote commands - requires installing certain rhncfg-* RPMs probably via an activation key.
--no-ssl
(not recommended) boolean; turn off SSL authentication by the clients.
--no-gpg
(not recommended) boolean; turn off GPG verification by the clients.
--no-up2date
(not recommended) boolean; will not run the up2date section (full update usually) once bootstrapped.
--pub-tree
(change not recommended) public directory tree where the CA SSL cert/cert-RPM will land as well as the bootstrap directory and scripts.
--force
(not recommended) boolean; force bad decisions.
-v | --verbose
be verbose (accumulative: -vvv means "be *really* verbose").
-h | --help
Display the help screen with a list of options.

FILES

/usr/bin/rhn-bootstrap

/usr/bin/client_config_update.py

/usr/bin/client-config-overrides.txt

EXAMPLES

rhn-bootstrap --activation-key XXX --http-proxy="" --allow-config-actions --allow-remote-commands

rhn-bootstrap --activation-key XXX --gpg-key ~/taw-pub.key

AUTHORS

Todd Warner <taw@redhat.com>