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
|