1 files changed, 154 insertions, 0 deletions
diff --git a/website/src/learning/start-install-with-virt-manager/index.html b/website/src/learning/start-install-with-virt-manager/index.html
new file mode 100644
index 0000000..29d610c
--- /dev/null
+++ b/website/src/learning/start-install-with-virt-manager/index.html
@@ -0,0 +1,154 @@
+[% topdir = "../.." -%]
+[% PROCESS globals -%]
+[% WRAPPER page
+   title = "Installing a virtual machine with virt-manager"
+   h1 = "Installing a virtual machine with virt-manager"
+   section = "learning"
+%]
+
+<p>
+Installing a virtual machine in virt-manager is a three step
+process.  First <a href="#download">download the operating
+system ISO</a> that you want to install.
+Secondly <a href="#virt-manager">start virt-manager</a>
+and <a href="#new-vm">create a new virtual machine for your
+guest</a>.  Lastly <a href="#installer">run the guest installer
+from the ISO</a>.
+</p>
+
+<p>
+You may also be interested in <a href="../install-with-command-line/">our
+tutorial which explains how to do all of this from the command line</a>.
+</p>
+
+[% WRAPPER h2 h2="Download the ISO" anchor="download" %]
+
+<p>
+Download an ISO of the operating system you want to install.
+Here are some common starting points:
+</p>
+
+<ul>
+<li> XXX FEDORA XXX </li>
+<li> XXX DEBIAN XXX </li>
+<li> XXX UBUNTU XXX </li>
+<li> XXX WINDOWS MSDN XXX </li>
+</ul>
+
+<p>
+Remember the operating system you install as a guest does
+not need to be the same as your host!
+</p>
+
+[% END %]
+
+[% WRAPPER h2 h2="Start virt-manager" anchor="virt-manager" %]
+
+<p>
+Start virt-manager
+(Applications &rarr; System Tools &rarr; Virtual Machine Manager)
+</p>
+
+<p>
+You may be asked to select the hypervisor and/or type your
+root password:
+</p>
+
+<p>
+<img src="authenticate.png" width="477" height="454"
+  longdesc="Image showing authentication." />
+</p>
+
+[% END %]
+
+[% WRAPPER h2 h2="Start new VM wizard" anchor="new-vm" %]
+
+<p>
+Click the button in the top left corner to begin installing
+your virtual machine:
+</p>
+
+<p>
+<img src="new-button.png" width="44" height="40"
+  longdesc="New VM button." />
+</p>
+
+<p>
+<img src="new-vm-1.png" width="457" height="381"
+  longdesc="New VM step 1" />
+</p>
+
+<p>
+Since you have downloaded an ISO, you need to select
+<q>Local install media</q>.  Also choose a name for the
+new guest.
+</p>
+
+<p>
+At the next step you need to tell virt-manager where
+you downloaded the ISO to.  When you click <q>Browse</q>
+you will see the default libvirt storage volume (which
+will probably be empty the first time):
+</p>
+
+<p>
+<img src="new-vm-2-browse.png" width="750" height="500"
+  longdesc="New VM step 2 browse window" />
+</p>
+
+<p>
+Click <q>Browse Local</q> to browse to the ISO on your
+local disk.
+</p>
+
+<p>
+<img src="new-vm-2.png" width="457" height="381"
+  longdesc="New VM step 2" />
+</p>
+
+<p>
+The third step allows you to choose the amount of RAM
+and number of virtual CPUs allocated to the guest.  For
+KVM guests, RAM can be overcommitted carefully (you can allocate
+more RAM to all your guests than you really have available).
+For Xen guests this is not possible.  A modern Linux guest
+requires at least 512 MB of RAM, and more is better.
+</p>
+
+<p>
+<img src="new-vm-3.png" width="457" height="381"
+  longdesc="New VM step 3" />
+</p>
+
+<p>
+If all goes well you should be able to skip through
+the next steps and start your install:
+</p>
+
+<p>
+<img src="new-vm-4.png" width="457" height="381"
+  longdesc="New VM step 4" />
+</p>
+
+<p>
+<img src="new-vm-5.png" width="457" height="381"
+  longdesc="New VM step 5" />
+</p>
+
+[% END %]
+
+[% WRAPPER h2 h2="Run the installer" anchor="installer" %]
+
+<p>
+From now on you should install the guest from the ISO
+as if you were installing it on real hardware:
+</p>
+
+<p>
+<img src="installer.png" width="784" height="563"
+  longdesc="Virtual machine installer running" />
+</p>
+
+[% END %]
+
+[% END -%]