File: configwizard.tex

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 (125 lines) | stat: -rw-r--r-- 4,947 bytes parent folder | download | duplicates (2)
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
%%$Id: configwizard.tex,v 1.9 2009-03-02 16:15:14 potyra Exp $
%% vim:tabstop=8:shiftwidth=8:textwidth=72
%
% Copyright (C) 2003-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.

\package{} comes with a \wizard, which can help you create and configure
new virtual machines quickly without having to learn about the weird
syntax of configuration files.

This chapter shows how to use the \wizard to set up and start
virtual machines.

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section{Starting the \wizard}
\label{s:configwizard.starting}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
You can start the \wizard with the binary called \binlauncher.
This starts the \launcher.
If no virtual machines have been created yet, the \wizard will
automatically be started, too.
You can start it manually by choosing the \GUIMenu{New (Wizard)} entry
from the \GUIMenu{VM} menu.

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section{First Configuration Based on Default Settings}
\label{s:configwizard.first}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
If you simply click \GUIButton{Next} (and \GUIButton{Finish} on the
final page) in the \wizard, a new virtual
machine with the following properties will be created in your home
directory.
\begin{description}
\item[Virtual Machine's Hardware:]{\anchor\\[-2.5ex]
	\begin{description}
	\item[Processor:]{
		A single processor.
	}
	\item[Harddisk:]{
		A single 2GB harddisk.
	}
	\item[CDROM:]{
		A single CDROM-drive.
	}
	\item[Network:]{
		A single network card with a cable plugged in. A new virtual
		network called net0 (for the very first network) will be created
		on the fly and interconnected with the real network (where your
		real machine may be the only computer on the real network).
	}
	\item[Main Memory:]{
		128MB of main memory.
	}
	\item[Graphics Adapter:]{
		VGA Card with 8MB of onboard memory.
	}
	\end{description}
}
\item[Other Configuration Parameters:]{\anchor\\[-2.5ex]
	\begin{description}
	\item[Machine Name:]{
		vm000 for your very first virtual machine, vm001 for
		your second one, and so on.
	}
	\item[Machine Directory:]{
		\Filename{vm000} for your very first
		virtual machine, \Filename{vm001} for your second one, and
		so on. The default is to create new directories which will be created
		in your home directory.
	}
	\item[Host:]{
		The default is to start the virtual machine on the local host.
	}
	\end{description}
}
\end{description}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section{Editing Existing Configurations}
\label{s:configwizard.editing}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
Of course you can edit existing configurations, too. Select the
\GUIMenu{Edit} menu entry from the \GUIMenu{VM} menu and choose one of
the virtual machines from the list, to open its edit window.

Toggle the check buttons to unfold the list of available devices of each
kind, then click on the device to show its editing window.

You can currently configure IDE drives, network adapters, serial and
parallel ports and main memory size as well as the miscellaneous
parameters virtual machine name and host.

Use the online help to guide you through the process.

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section{Files Used by the \launcher}
\label{s:configwizard.files}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
The \wizard keeps information in the hidden directory
\Filename{.FAUmachine} inside your home directory. If that directory
does not exist in your home yet, it will be created as
needed.

The \wizard keeps information about the virtual machines which have been
created in \Filename{.FAUmachine/config}.

The \wizard keeps information about virtual networks it knows about in
directories called \Filename{.FAUmachine/net\replaceable{\#}}. Each
network configuration directory contains the files \Filename{host},
\Filename{name}, and the \netbridge configuration files
\Filename{upstream} and \Filename{upstream-method}.
These files are read by the \netbridge when you choose a virtual network
from the \GUIMenu{Connect} menu entry in the \GUIMenu{Network} menu.
\Filename{host} contains the host the \netbridge should be started on.
\Filename{name} is the name of the virtual network as displayed by the
\launcher in the menues and lists.
The actual \netbridge configuration is described in
chapter~\ref{s:networking} "\cnetworking".

\notgb{%% Leave this here for DBench cross-compilation!
The configuration files generated by the wizard are described in
chapter~\ref{s:configmanual} "\cconfigmanual".
}%\notgb