File: quick-start.xml

package info (click to toggle)
faumachine 20100527-2
  • links: PTS
  • area: main
  • in suites: squeeze
  • size: 53,836 kB
  • ctags: 20,552
  • sloc: ansic: 179,550; asm: 3,645; makefile: 3,611; perl: 2,103; sh: 1,529; python: 600; xml: 563; lex: 210; vhdl: 204
file content (91 lines) | stat: -rw-r--r-- 3,274 bytes parent folder | download | duplicates (3)
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
<!-- 
 Copyright (C) 2004-2009 FAUmachine Team <info@faumachine.org>.
 This program is free software. You can redistribute it and/or modify it
 under the terms of the GNU General Public License, either version 2 of
 the License, or (at your option) any later version. See COPYING.
-->
<para>
This chapter will give a quick introduction into FAUmachine.
</para>


<section>
<title>Installing FAUmachine</title>

<para>
The easiest way to install FAUmachine is to use prebuild packages.  You can
obtain them from our <ulink url='http://www.faumachine.org/download.html'>
Download Site</ulink>.
</para>

<para>
Please note that FAUmachine currently needs modified versions of the
guest operating system to get acceptable performance.
These modified versions are already available for many Linux
distributions. Each one is contained in its own software package.
<emphasis>
	If you want to download prebuild packages, you have to select both the
	Linux distribution you are currently using and the distribution you
	want to start in your virtual machine.
</emphasis>
There is one directory per distribution for which we have packages.
In this directory there is one <filename>faumachine-base</filename>
package and several other packages that have to be installed to run
that distribution inside FAUmachine.
You have to install the base package and one or several support
packages, depending on the distributions you intend to start in the
virtual machine.
</para>

<para>
For Debian users there is a special APT-Repository. Just add
<programlisting>
deb http://www3.informatik.uni-erlangen.de/FAUmachine/debian ./
</programlisting>
to your <filename>/etc/apt/sources.list</filename>.
</para>
</section>

<!--=====================================================================-->

<section>
<title>Starting the first virtual machine</title>

<para>
After installing, you can type <command>faum</command> to start the
virtual machine launcher. You can use it to create and edit the
configuration of your virtual machines and to start them.
</para>

<para>
The launcher will present a <guilabel>New VM</guilabel> Wizard when started
for the first time.
This wizard will create all the configuration files that are needed to
start a virtual machine in FAUmachine.
Just click <guibutton>Next</guibutton> on each page,
then click <guibutton>Finish</guibutton>.
</para>

<para>
To start the new virtual machine, select <guisubmenu>Start</guisubmenu>
in the <guimenu>VM</guimenu> menu.
A list of virtual machines will be shown, just select the newly created one
to start it.
</para>

<para>
The virtual machine will open in a new window, containing a menu, some
toolbar buttons and one big area for the display of the machine.
The new virtual machine first needs a valid boot media.
Select <guimenu>Machine</guimenu> and <guisubmenu>Change CD in
idecdrom-1-0</guisubmenu> to insert a CDROM or DVD into the virtual CD
drive.
You can eighter use your real CDROM drive by selecting
<guimenuitem>Use host CDROM</guimenuitem> or browse for an image file
which will be used instead.
The image file must contain a valid ISO-9660 filesystem.
Now click the <guibutton>On</guibutton> button to boot from the CDROM and
install the operating system to your virtual hard disk.
</para>

</section>