1RHN-BOOTSTRAP(1)                                              RHN-BOOTSTRAP(1)
2
3
4

NAME

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

SYNOPSIS

10       rhn-bootstrap [ options ... ] [ -h|--help ]
11
12

DESCRIPTION

14       rhn-bootstrap generates bootstrap scripts to be used by RHN client sys‐
15       tems  for  the  purpose  of simplifying their initial configuration and
16       bootstrapping them to an RHN Satellite and/or Proxy Server. This  is  a
17       script  generator.  You  then use those scripts to configure & register
18       RHN clients.
19
20       Once    the    bootstrap    script    is    generated    (by    default
21       /var/www/html/pub/bootstrap/bootstrap.sh).  The  admin  must edit it by
22       hand to verify it is correct, and to enable it. It is then used to con‐
23       figure and register client systems as such:
24
25       cd /var/www/html/pub/bootstrap/
26
27       cat bootstrap-<edited_name>.sh | ssh root@<client-hostname> /bin/bash
28
29       ...or...
30
31       wget -qO- https://<hostname>/pub/bootstrap/bootstrap-<edited_name>.sh |
32       /bin/bash
33
34       ...or...
35
36       curl -Sks https://<hostname>/pub/bootstrap/bootstrap-<edited_name>.sh |
37       /bin/bash
38

OPTIONS

40       --activation-keys=ACTIVATION_KEYS
41              activation  key(s)  as  defined  in  the  RHN web UI - format is
42              XKEY,YKEY,...
43
44       --overrides=OVERRIDES_FILE
45              configuration overrides  filename  (by  default:  client-config-
46              overrides.txt).
47
48       --script=GENERATED_SCRIPT
49              bootstrap script filename (by default: boostrap.sh).
50
51       --hostname=FQDN
52              hostname (FQDN) to which clients connect (default: this server's
53              hostname)
54
55       --ssl-cert=SSL_CERT_PATH
56              path to corporate CA public SSL certificate - an RPM  or  a  raw
57              certificate. It will be copied to --pub-tree. A value of "" will
58              force a search of --pub-tree.
59
60       --gpg-key=GPG_KEY_PATH
61              path to the corporate public GPG key, if used. It will be copied
62              to --pub-tree. (default: "").
63
64       --http-proxy=HOSTNAME:PORT
65              HTTP  proxy  setting  for  the clients - hostname:port.  --http-
66              proxy="" disables. (default: "")
67
68       --http-proxy-username=HTTP_PROXY_USERNAME
69              if using an  authenticating  HTTP  proxy,  specify  a  username.
70              --http-proxy-username="" disables. (Default: "").
71
72       --http-proxy-password=HTTP_PROXY_PASSWORD
73              if  using  an  authenticating  HTTP  proxy,  specify a password.
74              (default: "")
75
76       --allow-config-actions
77              boolean; allow all configuration actions -  requires  installing
78              certain rhncfg-* RPMs probably via an activation key.
79
80       --allow-remote-commands
81              boolean;  allow  arbitrary remote commands - requires installing
82              certain rhncfg-* RPMs probably via an activation key.
83
84       --no-ssl
85              (not recommended) boolean; turn off SSL  authentication  by  the
86              clients.
87
88       --no-gpg
89              (not  recommended)  boolean;  turn  off  GPG verification by the
90              clients.
91
92       --no-up2date
93              (not recommended) boolean; will  not  run  the  up2date  section
94              (full update usually) once bootstrapped.
95
96       --pub-tree
97              (change  not recommended) public directory tree where the CA SSL
98              cert/cert-RPM will land as well as the bootstrap  directory  and
99              scripts.
100
101       --force
102              (not recommended) boolean; force bad decisions.
103
104       -v | --verbose
105              be verbose (accumulative: -vvv means "be *really* verbose").
106
107       -h | --help
108              Display the help screen with a list of options.
109

FILES

111       /usr/bin/rhn-bootstrap
112
113       /usr/bin/client_config_update.py
114
115       /usr/bin/client-config-overrides.txt
116

EXAMPLES

118       rhn-bootstrap   --activation-key  XXX  --http-proxy=""  --allow-config-
119       actions --allow-remote-commands
120
121       rhn-bootstrap --activation-key XXX --gpg-key ~/taw-pub.key
122

AUTHORS

124       Todd Warner <taw@redhat.com>
125
126
127
128Version 4.0                     07 October 2010               RHN-BOOTSTRAP(1)
Impressum