---
## 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.
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/)
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