<html>
<head>
<meta content="text/html; charset=windows-1252"
http-equiv="Content-Type">
</head>
<body text="#000000" bgcolor="#FFFFFF">
<p>Thanks for the information. I haven't done forks or requests
with Github. I appreciate the offer and at some point my take you
up on it but right now I'm swamped and just can't handle one more
thing and it sounds like the fork/pull is not trival. I things
slow down I'll try and get back to you on it. Right now it's a
LibreOffice document that I made from the notes I did in a text
editor while struggling with the install.</p>
<p><br>
</p>
<br>
<div class="moz-cite-prefix">On 09/04/2016 06:59 PM, Tom Gamull
wrote:<br>
</div>
<blockquote
cite="mid:CEB7733D-64BE-46D4-9177-A7C09C4CD0ED@redhat.com"
type="cite">
<meta http-equiv="Content-Type" content="text/html;
charset=windows-1252">
The docs do suck but I would challenge you to submit a pull
request. It’s a pain if you haven’t done github forks and pull
requests. However, if you do this and it doesn’t get merged, you
have every right to complain and I’ll be behind you 100%. I’ve
been in your shoes and just recently started helping in little
bits on some projects.
<div class=""><br class="">
</div>
<div class="">If you can fork the documents, change them to
include your notes, I’d be happy to hand hold or explain how to
do the pull request (think merging your changes back). you can
even email me direct if needed.</div>
<div class=""><br class="">
</div>
<div class="">Tom Gamull</div>
<div class=""><br class="">
</div>
<div class="">
<br class="">
<div>
<blockquote type="cite" class="">
<div class="">On Sep 4, 2016, at 4:26 PM, Brett I. Holcomb
<<a moz-do-not-send="true"
href="mailto:biholcomb@l1049h.com" class="">biholcomb@l1049h.com</a>>
wrote:</div>
<br class="Apple-interchange-newline">
<div class="">
<meta content="text/html; charset=windows-1252"
http-equiv="Content-Type" class="">
<div text="#000000" bgcolor="#FFFFFF" class="">
<p class="">Yeah, its frustrating for sure as I spent a
lot of wasted time trying to figure out what applied,
what didn't, what was out of date and a lot of what
did apply assumed I already knew parts I needed. I
came from VMware and Hyper-V worlds and really like
oVirt and what it's doing but the documentation can be
frustrating for sure. Unfortunately, that seems to be
the way of a lot of OpenSource and along with that
very few people like to do documentation and when they
do it's from the perspective of someone who already
knows the answers so it really doesn't help a brand
new person who has no clue. I had to do several
hosted engine installs before I got it working (the
stupid installer can't recover from an error so it
makes you start over) on 3.6 (thanks be to VMware
Workstation that let me start over <G>). I took
a lot of notes and when I get time I'll post them. I
know some will say we should contribute to the docs
but I know I already have a full schedule with work
and family and can't do anymore.</p>
<p class="">I've found this mailing list is the best
source of information and sometimes they can link to
sources we haven't found. The people in this group
are really knowledgeable and helpful so until the do
get updated docs ask here.</p>
On 09/04/2016 04:14 PM, zero four wrote:<br class="">
<blockquote
cite="mid:CACBeWZOZMUxKAPVWZFvv08pC1zMRJ=B8Hafcubqxn3pJrHaGrw@mail.gmail.com"
type="cite" class="">
<div dir="ltr" class="">
<p style="margin-bottom:0in;line-height:100%"
class="">As a prospective user of oVirt I have
noticed quite a lot of glaring problems with the
documentation, is it still being maintained?
Since outdated or incomplete documentation is
often worse than nothing, a possible solution
would be to just link to the official Red Hat
Virtualization documentation.</p>
<p style="margin-bottom:0in;line-height:100%"
class="">Here are some examples I found after
looking for less than 5 minutes:</p>
<p style="margin-bottom:0in;line-height:100%"
class="">1. </p>
<p style="margin-bottom:0in;line-height:100%"
class=""><a moz-do-not-send="true"
class="moz-txt-link-freetext"
href="http://www.ovirt.org/documentation/">http://www.ovirt.org/documentation/</a></p>
<p style="margin-bottom:0in;line-height:100%"
class="">The top of this web page has two videos
from 2012. The left one "oVirt Open Virtualization
Basics -- Single Machine Install" is a guide for
the all in one install. This is misleading as it
no longer possible to perform an all in one
install since 3.6, and in general it would appear
the oVirt project does not support deploying oVirt
to a single machine. The right video is a guide on
creating VMs using the GUI from 2012 which has
since changed.</p>
<p style="margin-bottom:0in;line-height:100%"
class="">Overall both videos should be removed
from the Documentation page as they only confuse
and mislead new users. I, and I am sure many
other users would greatly appreciate more current
video guides.<br class="">
</p>
<p style="margin-bottom:0in;line-height:100%"
class="">2.</p>
<p style="margin-bottom:0in;line-height:100%"
class=""><a moz-do-not-send="true"
class="moz-txt-link-freetext"
href="https://www.ovirt.org/documentation/how-to/hosted-engine/#fresh-install">https://www.ovirt.org/documentation/how-to/hosted-engine/#fresh-install</a></p>
<p style="margin-bottom:0in;line-height:100%"
class="">Under the notes for this there is the
following passage:</p>
<p style="margin-bottom:0in;line-height:100%"
class=""><span class="gmail-Apple-tab-span" style="white-space:pre"> </span>“Although
hosted-engine and engine-setup use different
wording for the admin password <span class="gmail-Apple-tab-span" style="white-space:pre"> </span>("'admin@internal'
user password" vs "Engine admin password"), they
are asking for the same <span class="gmail-Apple-tab-span" style="white-space:pre"> </span>thing.
If you enter different passwords, the
hosted-engine setup will fail.”</p>
<p style="margin-bottom:0in;line-height:100%"
class="">Why is the wording different? This
appears to be entirely unnecessary, and also
confusing as to why it is asking for the password
a second time at all.</p>
<p style="margin-bottom:0in;line-height:100%"
class="">3.</p>
<p style="margin-bottom:0in;line-height:100%"
class=""><a moz-do-not-send="true"
class="moz-txt-link-freetext"
href="https://www.ovirt.org/documentation/how-to/hosted-engine/#fresh-install">https://www.ovirt.org/documentation/how-to/hosted-engine/#fresh-install</a></p>
<p style="margin-bottom:0in;line-height:100%"
class="">After finishing the hosted engine
deployment script the guide states:</p>
<p style="margin-bottom:0in;line-height:100%"
class=""><span class="gmail-Apple-tab-span" style="white-space:pre"> </span>“After
completing the OS installation on the VM, return
to the host and continue. The installer <span class="gmail-Apple-tab-span" style="white-space:pre"> </span>on
the host will sync with the VM and ask for the <span class="gmail-Apple-tab-span" style="white-space:pre"> </span>engine
to be installed on the new VM:”</p>
<p style="margin-bottom:0in;line-height:100%"
class="">It is unclear how you are expected to
access the VM, is the Web UI up at this point? Do
you need to use virsh to connect to the VM? The
guide should be explicit.</p>
<p style="margin-bottom:0in;line-height:100%"
class="">4.</p>
<p style="margin-bottom:0in;line-height:100%"
class=""><a moz-do-not-send="true"
class="moz-txt-link-freetext"
href="https://www.ovirt.org/documentation/quickstart/quickstart-guide/#prerequisites">https://www.ovirt.org/documentation/quickstart/quickstart-guide/#prerequisites</a></p>
<p style="margin-bottom:0in;line-height:100%"
class=""> I. The documentation discusses Fedora
19, Fedora is currently on version 24 and 19 is
EOL.</p>
<p style="margin-bottom:0in;line-height:100%"
class="">II. Under “Storage and Networking” there
is no mention that oVirt requires at least 3
GlusterFS bricks to achieve quorum.</p>
<p style="margin-bottom:0in;line-height:100%"
class="">III. Under “Virtual Machines” there is no
mention of Windows 10, Fedora past version 20, or
RHEL/CentOS 7.X.</p>
</div>
<br class="">
<fieldset class="mimeAttachmentHeader"></fieldset>
<br class="">
<pre class="" wrap="">_______________________________________________
Users mailing list
<a moz-do-not-send="true" class="moz-txt-link-abbreviated" href="mailto:Users@ovirt.org">Users@ovirt.org</a>
<a moz-do-not-send="true" class="moz-txt-link-freetext" href="http://lists.ovirt.org/mailman/listinfo/users">http://lists.ovirt.org/mailman/listinfo/users</a>
</pre>
</blockquote>
<br class="">
</div>
_______________________________________________<br
class="">
Users mailing list<br class="">
<a moz-do-not-send="true" href="mailto:Users@ovirt.org"
class="">Users@ovirt.org</a><br class="">
<a class="moz-txt-link-freetext" href="http://lists.ovirt.org/mailman/listinfo/users">http://lists.ovirt.org/mailman/listinfo/users</a><br class="">
</div>
</blockquote>
</div>
<br class="">
</div>
</blockquote>
<br>
</body>
</html>