3:26 p.m.
This is a multi-part message in MIME format.
--------------AB4D4E998350BBE7D998613E
Content-Type: text/plain; charset=windows-1252; format=flowed
Content-Transfer-Encoding: 8bit
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.
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.
On 09/04/2016 04:14 PM, zero four wrote:
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.
Here are some examples I found after looking for less than 5 minutes:
1.
http://www.ovirt.org/documentation/
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.
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.
2.
https://www.ovirt.org/documentation/how-to/hosted-engine/#fresh-install
Under the notes for this there is the following passage:
Although hosted-engine and engine-setup use different wording for the
admin password ("'admin@internal' user password" vs "Engine admin
password"), they are asking for the same thing. If you enter different
passwords, the hosted-engine setup will fail.
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.
3.
https://www.ovirt.org/documentation/how-to/hosted-engine/#fresh-install
After finishing the hosted engine deployment script the guide states:
After completing the OS installation on the VM, return to the host
and continue. The installer on the host will sync with the VM and ask
for the engine to be installed on the new VM:
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.
4.
https://www.ovirt.org/documentation/quickstart/quickstart-guide/#prerequi...
I. The documentation discusses Fedora 19, Fedora is currently on
version 24 and 19 is EOL.
II. Under Storage and Networking there is no mention that oVirt
requires at least 3 GlusterFS bricks to achieve quorum.
III. Under Virtual Machines there is no mention of Windows 10,
Fedora past version 20, or RHEL/CentOS 7.X.
_______________________________________________
Users mailing list
Users(a)ovirt.org
http://lists.ovirt.org/mailman/listinfo/users
--------------AB4D4E998350BBE7D998613E
Content-Type: text/html; charset=windows-1252
Content-Transfer-Encoding: 8bit
<html>
<head>
<meta content="text/html; charset=windows-1252"
http-equiv="Content-Type">
</head>
<body text="#000000" bgcolor="#FFFFFF">
<p>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>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>
<blockquote
cite="mid:CACBeWZOZMUxKAPVWZFvv08pC1zMRJ=B8Hafcubqxn3pJrHaGrw@mail.gmail.com"
type="cite">
<div dir="ltr">
<p style="margin-bottom:0in;line-height:100%">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%">Here are some
examples I found after looking for less than 5 minutes:</p>
<p style="margin-bottom:0in;line-height:100%">1. </p>
<p style="margin-bottom:0in;line-height:100%"><a
moz-do-not-send="true"
href="http://www.ovirt.org/documentation/"><a
class="moz-txt-link-freetext"
href="http://www.ovirt.org/documentation/">http://www.ovirt....
<p style="margin-bottom:0in;line-height:100%">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%">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>
</p>
<p style="margin-bottom:0in;line-height:100%">2.</p>
<p style="margin-bottom:0in;line-height:100%"><a
moz-do-not-send="true"
href="https://www.ovirt.org/documentation/how-to/hosted-engine/#fres...
class="moz-txt-link-freetext"
href="https://www.ovirt.org/documentation/how-to/hosted-engine/#fres...
<p style="margin-bottom:0in;line-height:100%">Under the notes
for this there is the following passage:</p>
<p style="margin-bottom:0in;line-height:100%"><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%">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%">3.</p>
<p style="margin-bottom:0in;line-height:100%"><a
moz-do-not-send="true"
href="https://www.ovirt.org/documentation/how-to/hosted-engine/#fres...
class="moz-txt-link-freetext"
href="https://www.ovirt.org/documentation/how-to/hosted-engine/#fres...
<p style="margin-bottom:0in;line-height:100%">After finishing
the hosted engine deployment script the guide states:</p>
<p style="margin-bottom:0in;line-height:100%"><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%">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%">4.</p>
<p style="margin-bottom:0in;line-height:100%"><a
moz-do-not-send="true"
href="https://www.ovirt.org/documentation/quickstart/quickstart-guid...
class="moz-txt-link-freetext"
href="https://www.ovirt.org/documentation/quickstart/quickstart-guid...
<p style="margin-bottom:0in;line-height:100%"> 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%">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%">III. Under
Virtual Machines there is no mention of Windows 10, Fedora
past version 20, or RHEL/CentOS 7.X.</p>
</div>
<br>
<fieldset class="mimeAttachmentHeader"></fieldset>
<br>
<pre wrap="">_______________________________________________
Users mailing list
<a class="moz-txt-link-abbreviated"
href="mailto:Users@ovirt.org">Users@ovirt.org</a>
<a class="moz-txt-link-freetext"
href="http://lists.ovirt.org/mailman/listinfo/users">http://...
</pre>
</blockquote>
<br>
</body>
</html>
--------------AB4D4E998350BBE7D998613E--