Updating Repo Appliance documentation

5 files changed, 52 insertions, 3 deletions

diff --git a/genome-docs/genome-docs-1.0.0/en-US/Appendix.xml b/genome-docs/genome-docs-1.0.0/en-US/Appendix.xml
index 04c3a9a..7dda053 100644
--- a/genome-docs/genome-docs-1.0.0/en-US/Appendix.xml
+++ b/genome-docs/genome-docs-1.0.0/en-US/Appendix.xml
@@ -17,7 +17,7 @@
 			if you do any provisioning with Koan in the &PRODUCT;
 			environment your root password will be
 			<emphasis>&GENOMEPASSWORD;</emphasis>.  Users can
-			change the password to anything they like once the log
+			change the password to anything they like once logged
 			in.
 		</para>
 	</section>
diff --git a/genome-docs/genome-docs-1.0.0/en-US/Cookbook.xml b/genome-docs/genome-docs-1.0.0/en-US/Cookbook.xml
index 3e4f4bb..d637d51 100644
--- a/genome-docs/genome-docs-1.0.0/en-US/Cookbook.xml
+++ b/genome-docs/genome-docs-1.0.0/en-US/Cookbook.xml
@@ -122,6 +122,11 @@
 						repositories from
 						another Repo Appliance.</para>
 				</listitem>
+				<listitem>
+					<para>
+						Define access controls
+					</para>
+				</listitem>
 			</itemizedlist>
 		</para>
 
@@ -277,6 +282,49 @@ genome-sync save
 				</para>
 			</important>
 	        </section>
+
+	        <section>
+			<title>Define access controls</title>
+			<para>
+				All machines in the &PRODUCT; environment have
+				a default root password set as detailed in
+				<link linkend="genome-LoggingIn">the
+					appendix</link>.  By default Repo
+				Appliances have a local user named &GENOMEUSER;
+				who owns all content under
+				<filename>/pub/git</filename>.  Out of the box
+				there is no password set and users of Repo
+				Appliances should feel free to use whatever
+				method of authentication they choose.
+			</para>
+
+			<para>
+				Typical methods of authentication are:
+
+				<itemizedlist>
+					<listitem>
+						<para>
+							Setting a password
+						</para>
+					</listitem>
+					<listitem>
+						<para>
+							Using SSH public key authentication
+						</para>
+					</listitem>
+				</itemizedlist>
+			</para>
+
+			<note>
+				<title>Note</title>
+				<para>
+					There is a good chance &PRODUCT; will
+					make use of <ulink
+						url="http://freeipa.org">FreeIPA</ulink>
+					someday.
+				</para>
+			</note>
+	        </section>
 	</section>
 
 	<section> 
diff --git a/genome-docs/genome-docs-1.0.0/en-US/MachineTypes.xml b/genome-docs/genome-docs-1.0.0/en-US/MachineTypes.xml
index 1105395..2615538 100644
--- a/genome-docs/genome-docs-1.0.0/en-US/MachineTypes.xml
+++ b/genome-docs/genome-docs-1.0.0/en-US/MachineTypes.xml
@@ -33,7 +33,7 @@
 				Repo machines are the center of development in the
 				&PRODUCT; environment.  In a nutshell they are the
 				self-contained provisioning, configuration and artifact
-				store.  For this reason &PRODUCT; machines types are
+				store.  For this reason these machines are
 				generally not considered volatile. 
 			</para>
 
diff --git a/genome-docs/genome-docs-1.0.0/en-US/genome.ent b/genome-docs/genome-docs-1.0.0/en-US/genome.ent
index d6ea16c..253584e 100644
--- a/genome-docs/genome-docs-1.0.0/en-US/genome.ent
+++ b/genome-docs/genome-docs-1.0.0/en-US/genome.ent
@@ -7,6 +7,7 @@
 <!ENTITY PUPPETSSLDIR "<filename>/var/lib/puppet/ssl</filename>">
 <!ENTITY FIRSTBOOTFILE "<filename>/usr/sbin/genome-firstboot</filename>">
 <!ENTITY GENOMEPASSWORD "password">
+<!ENTITY GENOMEUSER "<emphasis>genome</emphasis>">
 <!ENTITY GENOMEREPO "genome-repo.usersys.redhat.com">
 <!ENTITY BOOTSTRAPRPM "rubygem-genome-bootstrap">
 <!ENTITY BOOTSTRAPTOOL "<application>genome-bootstrap</application>">
diff --git a/genome-docs/genome-docs.spec b/genome-docs/genome-docs.spec
index 3402e44..4187a37 100644
--- a/genome-docs/genome-docs.spec
+++ b/genome-docs/genome-docs.spec
@@ -1,6 +1,6 @@
 Name:           genome-docs
 Version:        1.0.0
-Release:        25%{?dist}
+Release:        26%{?dist}
 Summary:        Genome documentation 
 
 Group:          Applications/System