1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
<?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-genomeappliance">Cloud Appliance</glossterm></simpara>
</listitem>
<listitem>
<simpara>An arbitrary number of <glossterm linkend="glossary-genomeappliance">Cloud Members</glossterm></simpara>
</listitem>
</itemizedlist>
</para>
<important>
<para>
Be sure to 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.
</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-8-i386-CD.iso">Genome Appliance boot CD</ulink>
</simpara>
</listitem>
<listitem>
<simpara>
Download and burn the
<ulink url="http://ftp.redhat.com/pub/redhat/genome/isos/Cloud-8-i386-CD.iso">Cloud Appliance boot CD</ulink>
</simpara>
</listitem>
</itemizedlist>
</section>
<section id="quickstart-Genome">
<title>Setting Up the Genome Appliance</title>
<para>
Choose a server to be the Genome Appliance and boot with the Genome Appliance CD.
At the boot menu, choose the default option (Install from Kickstart).
Booting the CD will kickstart the server with the appropriate Genome Appliance
operating system. After the kickstart finishes, the genome-firstboot service
will start and initialize the server as a Genome Appliance.
</para>
<important>
<simpara>
The kickstart reboots the server when it completes. Be sure to remove the
CD from the drive when the kickstart finishes to ensure it does not try to
run the kickstart after rebooting.
</simpara>
</important>
</section>
<section id="quickstart-Cloud">
<title>Setting Up the Cloud Appliance</title>
<para>
Choose a server to be the Cloud Appliance and boot with the Cloud Appliance CD.
Booting the CD will kickstart the server with the appropriate Cloud Appliance
operating system.
</para>
<para>
This server now serves as both the Cloud Appliance and the first
<glossterm linkend="glossary-cloudmember">cloud member</glossterm>. You can always add
additional cloud members.
</para>
<important>
<simpara>
The kickstart reboots the server when it completes. Be sure to remove the
CD from the drive when the kickstart finishes to ensure it does not try to
run the kickstart after rebooting.
</simpara>
</important>
</section>
<section id="quickstart-FirstDistro">
<title>Setting Up the First Distro</title>
<para>
Use the following command to import a OS distro into cobbler. This will import the Fedora 8 distro into
your cobbler server. You can replace the mirror URL with any other rsync-based mirror.
</para>
<screen>
cobbler import --mirror=rsync://rsync.gtlib.gatech.edu/fedora-enchilada/linux/releases/8/Fedora/i386/ --name=F8
</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):
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:
Enter your email address for cloud notification:
Your cobbler system name consists of two parts
* a system prefix
* a machine type
The system prefix can be used to help group common systems
together using some canonical name. For instance, this can be
helpful when configuring clustered JBoss servers
Enter your system prefix:
Now, you can select your machine type.
To see a description of these machine types visit: http://GENOME-APPLIANCE.domain.com/genome/machine_types.html
1. django-example
Select your machine type:
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-F8-i386
2. NormalGenomeGuest-F8-i386
Select your cobbler profile (This determines the OS):
</screen>
</section>
</chapter>
|
