diff options
Diffstat (limited to 'genome-docs/genome-docs-1.0.0/en-US/QuickStart.xml')
-rw-r--r-- | genome-docs/genome-docs-1.0.0/en-US/QuickStart.xml | 193 |
1 files changed, 0 insertions, 193 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> |