Fixes clean to restore network config to LF jumphost
[genesis.git] / puppet.md
index 0869be9..2d05fee 100644 (file)
--- a/puppet.md
+++ b/puppet.md
@@ -3,8 +3,8 @@
 ---
 ## Puppet modules
 
-###trystack (quickstack branch)
-[https://github.com/trystack/puppet-trystack/tree/quickstack](https://github.com/trystack/puppet-trystack/tree/quickstack)
+###genesis
+[https://gerrit.opnfv.org/gerrit/genesis](https://gerrit.opnfv.org/gerrit/genesis)
 
 This module is a small set of puppet code. Its intention is mostly to glue the variables in foreman to the quickstack module. These classes could also be used as a site.pp node manifest for running a puppet apply.
 
@@ -26,7 +26,7 @@ The fork is necessary because there is a patch on this fork to teach quickstack
 Once this patch is merged the upstream astapor module can be cloned from upstream at
 [https://github.com/redhat-openstack/astapor](https://github.com/redhat-openstack/astapor).
 
-### openstack-puppet-modules (OPM) 
+### openstack-puppet-modules (OPM)
 *or the stackforge puppet modules*
 
 [https://repos.fedorapeople.org/repos/openstack/openstack-juno/epel-7/](https://repos.fedorapeople.org/repos/openstack/openstack-juno/epel-7/)
@@ -49,6 +49,27 @@ TODO: add details to do a puppet apply install
 
 Foreman is a provisioning and puppet master platform in one project.
 
-TODO: add foreman installation details
-
-
+Get a copy of foreman-installer on a node in an empty broadcast domain. Foreman expects to be the dhcp server on the network.
+
+Run foreman-installer something like this:
+
+
+    sudo foreman-installer \
+        --enable-foreman-proxy \
+        --foreman-proxy-tftp=true \
+        --foreman-proxy-tftp-servername=10.1.254.1 \
+        --foreman-proxy-dhcp=true \
+        --foreman-proxy-dhcp-interface=em1 \
+        --foreman-proxy-dhcp-gateway=10.1.254.254 \
+        --foreman-proxy-dhcp-range="10.1.254.2 10.1.254.40" \
+        --foreman-proxy-dhcp-nameservers="10.1.254.1" \
+        --foreman-proxy-dns=true \
+        --foreman-proxy-dns-interface=em1 \
+        --foreman-proxy-dns-zone=example.com \
+        --foreman-proxy-dns-reverse=254.1.10.in-addr.arpa \
+        --foreman-proxy-dns-forwarders=10.1.16.30 \
+        --foreman-proxy-foreman-base-url=https://foreman.example.com
+
+* dhcp-nameservers is the dns address given to provisioned hosts, point this to foreman
+* dns-forwarders is an external dns address that dns reqs will be forewarded to that foreman do not handle
+* make sure that your foreman-base-url will be resolvable