summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorChris Alfonso <calfonso@redhat.com>2008-07-22 14:39:41 -0400
committerChris Alfonso <calfonso@redhat.com>2008-07-22 14:39:41 -0400
commit0d9a82e40fdbd59e29d9ce4c928f4256cfa3227d (patch)
treeb33858fb889d75416ffb0d666724ddb66a615bb3
parent350468e03cb0e106b40427486c479373377ff97a (diff)
downloadtools-0d9a82e40fdbd59e29d9ce4c928f4256cfa3227d.tar.gz
tools-0d9a82e40fdbd59e29d9ce4c928f4256cfa3227d.tar.xz
tools-0d9a82e40fdbd59e29d9ce4c928f4256cfa3227d.zip
Removed quickstart
-rw-r--r--genome-docs/genome-docs-1.0.0/en-US/QuickStart.xml193
-rw-r--r--genome-docs/genome-docs-1.0.0/en-US/genome.xml3
2 files changed, 1 insertions, 195 deletions
diff --git a/genome-docs/genome-docs-1.0.0/en-US/QuickStart.xml b/genome-docs/genome-docs-1.0.0/en-US/QuickStart.xml
deleted file mode 100644
index c9846f3..0000000
--- a/genome-docs/genome-docs-1.0.0/en-US/QuickStart.xml
+++ /dev/null
@@ -1,193 +0,0 @@
-<?xml version='1.0'?>
-<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-]>
-
-<chapter id="genome-QuickStart">
- <title>Quick Start</title>
- <para>
- This quick start will you get up and running with the &PRODUCT;
- framework. However, this is not intended to provide comprehensive
- coverage of the &PRODUCT; framework. It is important to take the
- time to read the rest of this document in order to have a full
- understanding of the &PRODUCT; framework.
- </para>
- <para>
- Additionally, the <link linkend="genome-Cookbook">cookbook</link>
- section contains a number of helpful examples.
- </para>
-
- <section id="quickstart-Understanding">
- <title>Understanding the Framework</title>
- <para>
- It is very important that you have a full understanding of the &PRODUCT; framework.
- Without that understanding, it will be hard to understand system requirements of
- the various portions of the framework. After completing this quick start, please
- take the time to read through the rest of this document.
- </para>
- <para>
- The &PRODUCT; framework consists of three parts:
- <itemizedlist>
- <listitem>
- <simpara><glossterm linkend="glossary-genomeappliance">Genome Appliance</glossterm></simpara>
- </listitem>
- <listitem>
- <simpara><glossterm linkend="glossary-cloudappliance">Cloud Appliance</glossterm></simpara>
- </listitem>
- <listitem>
- <simpara>An arbitrary number of <glossterm linkend="glossary-genomeappliance">Cloud Members</glossterm></simpara>
- </listitem>
- </itemizedlist>
- </para>
- <important>
- <para>
- When using the default quick start setup with Fedora, you
- only need to dedicate one machine for your &PRODUCT;
- environment. This machine <emphasis>must</emphasis> have
- hardware virtualization support. Check the following link
- to see if your machine meets the requirements: <ulink
- url="http://kvm.qumranet.com/kvmwiki/FAQ#head-a78f5f083749cb9c2e57d7d4efaf2ecf25b9db60">KVM
- Information</ulink> Also check the system
- requirements for the <link
- linkend="genome-appliance-systemreqs">Genome
- Appliance</link> and the <link
- linkend="genome-cloud-appliance-systemreqs">Cloud
- Appliance</link> before beginning the quick start.
- If you don't have a machine that supports hardware
- virtualization, you won't be able to use Fedora for your
- <link linkend="genome-cloud-appliance-systemreqs">Cloud
- Appliance</link> but you can still use any
- distribution that supports Xen (e.g. Red Hat Enterprise
- Linux).
- </para>
- </important>
- </section>
- <section id="quickstart-Prereqs">
- <title>Prerequisites</title>
- <itemizedlist>
- <listitem>
- <simpara>
- Download and burn the <ulink
- url="http://ftp.redhat.com/pub/redhat/genome/isos/Genome-Combo-Fedora-9-i386-CD.iso">Genome/Cloud
- Appliance boot CD</ulink>
- </simpara>
- </listitem>
- </itemizedlist>
-
- <important>
- <simpara>
- The quick start guide uses a combination <link
- linkend="genome-appliances">Genome</link> and
- <link linkend="genome-cloud-appliance">Cloud</link>
- appliance distribution for purpose of getting up and
- running without further ado.
- </simpara>
- </important>
- </section>
- <section id="quickstart-Genome">
- <title>Setting Up the Appliance</title>
-
- <para>
- Boot a machine with the Genome Appliance CD. At the boot menu,
- choose the default option (Install from Kickstart). That will
- begin the installation process.
- </para>
- <important>
- <simpara>
- All data on the machine will be lost once the kickstart begins.
- When it completes the machine will reboot. Be sure to remove
- the CD from the drive when the kickstart finishes to ensure it
- does not try to run start the entire process over again.
- </simpara>
- </important>
- </section>
- <section id="quickstart-FirstDistro">
- <title>Setting Up the First Distro</title>
- <para>
- While there are several ways to import a distro into cobbler, we
- highly recommend downloading and mounting an ISO image and
- importing it. Run these commands on the &PRODUCT;/Cloud Appliance
- to import the Fedora distribution.
- </para>
- <screen>
-mkdir /mnt/Fedora-9-i386
-wget -O /tmp/Fedora-9-i386-DVD.iso http://download.fedoraproject.org/pub/fedora/linux/releases/9/Fedora/i386/iso/Fedora-9-i386-DVD.iso
-mount -o loop /tmp/Fedora-9-i386-DVD.iso /mnt/Fedora-9-i386
-cobbler import --mirror=/mnt/Fedora-9-i386 --name=F9-i386
-
-# This is a temporary fix for the ISO
-cp /etc/cobbler/Guest.ks /etc/cobbler/Fedora.ks
-chown genome:genome /etc/cobbler/Fedora.ks
- </screen>
- </section>
- <section id="quickstart-FirstGuest">
- <title>Setting Up the First Guest</title>
- <para>
- Use <application><link linkend="genome-GenomeBootstrap">genome-bootstrap</link></application>
- to setup the first guest machine.
- </para>
- <screen linenumbering="numbered" startinglinenumber="1">
-$ genome-bootstrap
-
-Your genome repo server is the system that serves as the
-puppet master, git server, and cobbler server all in one.
-Enter your Genome repo fully qualified domain name (fqdn): genome.example.org
-
-Your cloud master is the server that determines where the
-machine you're trying to create will be provisioned. Typically
-cloud masters control several machines in a cloud. However,
-cloud masters can be configured to simply manage their own disk space.
-Enter your cloud master fqdn: cloud.example.org
-Enter your email address for cloud notification: johndoe@example.org
-
-Your system prefix is added to your machine name to help identify
-it as your own. It must be a single word and should be short (e.g. username).
-Enter your system prefix: johndoe
-
-Now, you can select your machine type.
-To see a description of these machine types visit: http://GENOME-APPLIANCE/genome/machine_types.html
-1. django-example
-Select your machine type: 1
-
-Your cobbler profile determines the OS, the disk space, and
-the amount of memory that should be allocated to the system
-that you are provisioning.
-1. LargeGenomeGuest-Fedora-9-i386
-2. NormalGenomeGuest-Fedora-9-i386
-Select your cobbler profile (This determines the OS): 2
-
-Your system is now being provisioned
-Trying to determine the ip address.
-We'll try and maximum of 20 times.
-Polling for cobbler status...
-Retrying in 5 seconds
-Polling for cobbler status...
-Retrying in 5 seconds
-Polling for cobbler status...
-Retrying in 5 seconds
-Polling for cobbler status...
-Retrying in 5 seconds
-Polling for cobbler status...
-Retrying in 5 seconds
-Polling for cobbler status...
-Retrying in 5 seconds
-Polling for cobbler status...
-Retrying in 5 seconds
-Your new system is being provisioned on cloud-7.example.org.
-The IP address of the new system is 1.2.3.4.
- </screen>
- <para>
- Once you have created that machine, you should be able to see it
- in the cloud at http://COMBO-APPLIANCE/cloud/status.html. In a few
- minutes, your machine should have finished installing and will be
- ready for use.
- </para>
- <para>
- At this point, you are ready to move onto some more interesting
- scenarios like adding more &PRODUCT; Appliances for the various
- teams in your organization or creating custom machine types for
- your own use. You can find most of these examples in the Cookbook,
- like <link linkend="genome-AddMachineType">creating your own
- machine type</link>.
- </para>
- </section>
-</chapter>
diff --git a/genome-docs/genome-docs-1.0.0/en-US/genome.xml b/genome-docs/genome-docs-1.0.0/en-US/genome.xml
index 1eaa079..62b8dd6 100644
--- a/genome-docs/genome-docs-1.0.0/en-US/genome.xml
+++ b/genome-docs/genome-docs-1.0.0/en-US/genome.xml
@@ -4,8 +4,7 @@
<book>
<xi:include href="Book_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="QuickStart.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="MachineTypes.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="GettingStarted.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="Tooling.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />