Re: [ovirt-users] documentation change suggestion / question
--_000_9cff90f6acfe44c2ab30837610301bceexch24sluse_ Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 DQpEZW4gOCBva3QuIDIwMTYgMTk6MTUgc2tyZXYgQ2hhcmxlcyBLb3psZXIgPGNrb3psZXJpaWlA Z21haWwuY29tPjoNCj4NCj4gR29vZ2xpbmcgIm92aXJ0IHdpbmRvd3MgYWdlbnQiIHRoaXMgaXMg dGhlIGZpcnN0IGxpbmsgdGhhdCBwb3BzIHVwOiBodHRwOi8vd3d3Lm92aXJ0Lm9yZy9kb2N1bWVu dGF0aW9uL2ludGVybmFsL2d1ZXN0LWFnZW50L2d1ZXN0LWFnZW50LWZvci13aW5kb3dzLw0KPg0K PiBUaGlzIGRvYyBzZWVtcyBub24taW50dWl0aXZlIGFuZCBvdmVyIGNvbXBsaWNhdGVkDQo+DQo+ IFNwZWNpZmljYWxseSwgdGhlIFJlZEhhdCBkb2N1bWVudGF0aW9uIHRoYXQgaXMgNCBsaW5rcyBi ZWxvdyBpcyBzaW1wbGUgYXMgImluc3RhbGwgdGhpcyBwYWNrYWdlIGFuZCBtb3VudCB0aGUgaXNv IjogaHR0cHM6Ly9jb21tdW5pdHkucmVkaGF0LmNvbS9ibG9nLzIwMTUvMDUvaG93LXRvLWluc3Rh bGwtYW5kLXVzZS1vdmlydHMtd2luZG93cy1ndWVzdC10b29scy8NCj4NCj4gVGhlIGZvcm1lciB3 YXMgdXBkYXRlZCBhcyBlYXJseSBhcyBKdW5lIG9mIHRoaXMgeWVhcg0KPg0KPiAxLikgVGhlIFJl ZEhhdCBkb2N1bWVudCB3b3JrZWQgZm9yIG1lIHNvIEkgZG9udCB0aGluayBvVmlydCA0LnggY2Fu dCB1c2UgdGhlIHNhbWUNCj4gMi4pIFdoeSBoYXZlIHNlcGFyYXRlIGFyZWFzIG9mIGRvY3VtZW50 YXRpb24gdGhhdCBhcmUgc28gZGlmZmVyZW50IGZyb20gZWFjaCBvdGhlcj8gVGhpcyBoYXMgY2F1 c2VkIG1lIGlzc3VlcyBpbiB0aGUgcGFzdCB3aGVyZWJ5IEkgZm91bmQgUkggZG9jcyB0aGF0IHdl cmUgbXVjaCBtb3JlIGNsZWFyIGFuZCBjb25jaXNlDQoNClRoYXQncyBiZWNhdXNlIGFsbCBvVmly dCBkb2N1bWVudGF0aW9uIGlzIGNvbW11bml0eSBkcml2ZW4uIFRoaXMgc3BlY2lmaWMgcGFnZSB3 YXMgd3JpdHRlbiBieSBhIGd1eSBJIGhhcHBlbiB0byBrbm93IHF1aXRlIHdlbGwgKEkgd3JvdGUg aXQpOikNCg0KVGhpcyB3YXMgd3JpdHRlbiBiYWNrIHdoZW4gdGhlcmUgd2FzIG5vIGVhc3kgdG8g aW5zdGFsbCBwYWNrYWdlLCB3aGVyZSB5b3UgaGFkIHRvIGRvIHRoYXQgYnkgaGFuZCwgYW5kIGlm IHlvdSB3YW50IHRvLCB5b3Ugc3RpbGwgY2FuLCB0aGUgbWV0aG9kIHN0aWxsIHdvcmtzLiBCdXQg SSBhZ3JlZSB0aGF0IGlmIHRoZXJlJ3MgYW4gZWFzaWVyIHdheSB0b2RheSwgSSB0aGluayB3ZSBz aG91bGQgZ28gd2l0aCB0aGF0IGZpcnN0IGFuZCBrZWVwIHRoaXMgY29tcGlsaW5nIG1ldGhvZCBh cyB0aGUgZmFsbGJhY2suDQoNCj4gMy4pIElzIHRoZXJlIGFueW9uZSB3aG8gbWlnaHQgd2FudCB0 byBtZXJnZSBSSCBkb2NzIHdpdGggb1ZpcnQgZG9jcyB3aGVyZSB0aGUgUkggZG9jcyBhcmUgYmV0 dGVyIHRoYW4gb1ZpcnQ/DQoNCkhvcGluZyBzb21lb25lIEBSSCBjYW4gYW5zd2VyIHRoaXMsIGJl Y2F1c2UgSSBkb24ndCBrbm93IGlmIEknbSBhbGxvd2VkIHRvIGRvIHRoYXQ/DQoNCi9LDQoNCj4N Cj4gVGhhbmtzIHNvIG11Y2ggZm9yIHByb3ZpZGluZyBzdWNoIGEgZ3JlYXQgcHJvZHVjdCEgSSBq dXN0IGZlZWwgc29tZXRpbWVzIHRoZSBkb2NzIGFyZSBhIGxpdHRsZSBtb3JlIGRldmVsb3Blci1j ZW50cmljIHdoZXJlYXMgdGhlIFJlZEhhdCBkb2NzIGFyZSBtb3JlIGVhc2lseSByZWFkYWJsZQ0K --_000_9cff90f6acfe44c2ab30837610301bceexch24sluse_ Content-Type: text/html; charset="utf-8" Content-ID: <7C7FB8E8E6F9084D92C4FF0EBE6AE5CC@ad.slu.se> Content-Transfer-Encoding: base64 PGh0bWw+DQo8aGVhZD4NCjxtZXRhIGh0dHAtZXF1aXY9IkNvbnRlbnQtVHlwZSIgY29udGVudD0i dGV4dC9odG1sOyBjaGFyc2V0PXV0Zi04Ij4NCjwvaGVhZD4NCjxib2R5Pg0KPHAgZGlyPSJsdHIi Pjxicj4NCkRlbiA4IG9rdC4gMjAxNiAxOToxNSBza3JldiBDaGFybGVzIEtvemxlciAmbHQ7Y2tv emxlcmlpaUBnbWFpbC5jb20mZ3Q7Ojxicj4NCiZndDs8YnI+DQomZ3Q7IEdvb2dsaW5nICZxdW90 O292aXJ0IHdpbmRvd3MgYWdlbnQmcXVvdDsgdGhpcyBpcyB0aGUgZmlyc3QgbGluayB0aGF0IHBv cHMgdXA6Jm5ic3A7aHR0cDovL3d3dy5vdmlydC5vcmcvZG9jdW1lbnRhdGlvbi9pbnRlcm5hbC9n dWVzdC1hZ2VudC9ndWVzdC1hZ2VudC1mb3Itd2luZG93cy88YnI+DQomZ3Q7PGJyPg0KJmd0OyBU aGlzIGRvYyBzZWVtcyBub24taW50dWl0aXZlIGFuZCBvdmVyIGNvbXBsaWNhdGVkPGJyPg0KJmd0 Ozxicj4NCiZndDsgU3BlY2lmaWNhbGx5LCB0aGUgUmVkSGF0IGRvY3VtZW50YXRpb24gdGhhdCBp cyA0IGxpbmtzIGJlbG93IGlzIHNpbXBsZSBhcyAmcXVvdDtpbnN0YWxsIHRoaXMgcGFja2FnZSBh bmQgbW91bnQgdGhlIGlzbyZxdW90OzombmJzcDtodHRwczovL2NvbW11bml0eS5yZWRoYXQuY29t L2Jsb2cvMjAxNS8wNS9ob3ctdG8taW5zdGFsbC1hbmQtdXNlLW92aXJ0cy13aW5kb3dzLWd1ZXN0 LXRvb2xzLzxicj4NCiZndDs8YnI+DQomZ3Q7IFRoZSBmb3JtZXIgd2FzIHVwZGF0ZWQgYXMgZWFy bHkgYXMgSnVuZSBvZiB0aGlzIHllYXImbmJzcDs8YnI+DQomZ3Q7PGJyPg0KJmd0OyAxLikgVGhl IFJlZEhhdCBkb2N1bWVudCB3b3JrZWQgZm9yIG1lIHNvIEkgZG9udCB0aGluayBvVmlydCA0Lngg Y2FudCB1c2UgdGhlIHNhbWU8YnI+DQomZ3Q7IDIuKSBXaHkgaGF2ZSBzZXBhcmF0ZSBhcmVhcyBv ZiBkb2N1bWVudGF0aW9uIHRoYXQgYXJlIHNvIGRpZmZlcmVudCBmcm9tIGVhY2ggb3RoZXI/IFRo aXMgaGFzIGNhdXNlZCBtZSBpc3N1ZXMgaW4gdGhlIHBhc3Qgd2hlcmVieSBJIGZvdW5kIFJIIGRv Y3MgdGhhdCB3ZXJlIG11Y2ggbW9yZSBjbGVhciBhbmQgY29uY2lzZSZuYnNwOzwvcD4NCjxwIGRp cj0ibHRyIj5UaGF0J3MgYmVjYXVzZSBhbGwgb1ZpcnQgZG9jdW1lbnRhdGlvbiBpcyBjb21tdW5p dHkgZHJpdmVuLiBUaGlzIHNwZWNpZmljIHBhZ2Ugd2FzIHdyaXR0ZW4gYnkgYSBndXkgSSBoYXBw ZW4gdG8ga25vdyBxdWl0ZSB3ZWxsIChJIHdyb3RlIGl0KTopPC9wPg0KPHAgZGlyPSJsdHIiPlRo aXMgd2FzIHdyaXR0ZW4gYmFjayB3aGVuIHRoZXJlIHdhcyBubyBlYXN5IHRvIGluc3RhbGwgcGFj a2FnZSwgd2hlcmUgeW91IGhhZCB0byBkbyB0aGF0IGJ5IGhhbmQsIGFuZCBpZiB5b3Ugd2FudCB0 bywgeW91IHN0aWxsIGNhbiwgdGhlIG1ldGhvZCBzdGlsbCB3b3Jrcy4gQnV0IEkgYWdyZWUgdGhh dCBpZiB0aGVyZSdzIGFuIGVhc2llciB3YXkgdG9kYXksIEkgdGhpbmsgd2Ugc2hvdWxkIGdvIHdp dGggdGhhdCBmaXJzdA0KIGFuZCBrZWVwIHRoaXMgY29tcGlsaW5nIG1ldGhvZCBhcyB0aGUgZmFs bGJhY2suPC9wPg0KPHAgZGlyPSJsdHIiPiZndDsgMy4pIElzIHRoZXJlIGFueW9uZSB3aG8gbWln aHQgd2FudCB0byBtZXJnZSBSSCBkb2NzIHdpdGggb1ZpcnQgZG9jcyB3aGVyZSB0aGUgUkggZG9j cyBhcmUgYmV0dGVyIHRoYW4gb1ZpcnQ/PC9wPg0KPHAgZGlyPSJsdHIiPkhvcGluZyBzb21lb25l IEBSSCBjYW4gYW5zd2VyIHRoaXMsIGJlY2F1c2UgSSBkb24ndCBrbm93IGlmIEknbSBhbGxvd2Vk IHRvIGRvIHRoYXQ/PC9wPg0KPHAgZGlyPSJsdHIiPi9LPC9wPg0KPHAgZGlyPSJsdHIiPiZndDs8 YnI+DQomZ3Q7IFRoYW5rcyBzbyBtdWNoIGZvciBwcm92aWRpbmcgc3VjaCBhIGdyZWF0IHByb2R1 Y3QhIEkganVzdCBmZWVsIHNvbWV0aW1lcyB0aGUgZG9jcyBhcmUgYSBsaXR0bGUgbW9yZSBkZXZl bG9wZXItY2VudHJpYyB3aGVyZWFzIHRoZSBSZWRIYXQgZG9jcyBhcmUgbW9yZSBlYXNpbHkgcmVh ZGFibGUmbmJzcDs8L3A+DQo8L2JvZHk+DQo8L2h0bWw+DQo= --_000_9cff90f6acfe44c2ab30837610301bceexch24sluse_--
On Sun, Oct 9, 2016 at 11:26 AM, Karli Sjöberg <karli.sjoberg@slu.se> wrote:
Den 8 okt. 2016 19:15 skrev Charles Kozler <ckozleriii@gmail.com>:
Googling "ovirt windows agent" this is the first link that pops up: http://www.ovirt.org/documentation/internal/guest-agent/guest-agent-for-wind...
Patches are welcome :-)
This doc seems non-intuitive and over complicated
Specifically, the RedHat documentation that is 4 links below is simple as "install this package and mount the iso": https://community.redhat.com/blog/2015/05/how-to-install-and-use-ovirts-wind...
That's true for oVirt as well, since 3.5. Please check this: https://www.ovirt.org/develop/release-management/features/engine/windows-gue...
The former was updated as early as June of this year
1.) The RedHat document worked for me so I dont think oVirt 4.x cant use the same 2.) Why have separate areas of documentation that are so different from each other? This has caused me issues in the past whereby I found RH docs that were much more clear and concise
I guess one of the main reasons is that this particular part, the windows tools iso, is one of the biggest differences between oVirt and RHV. RHV uses InstallShield to create the installer, and RHV uses NSIS. The installers are completely unrelated. Other than that, the iso content is similar (drivers, agents etc).
That's because all oVirt documentation is community driven. This specific page was written by a guy I happen to know quite well (I wrote it):)
Thanks! :-)
This was written back when there was no easy to install package, where you had to do that by hand, and if you want to, you still can, the method still works. But I agree that if there's an easier way today, I think we should go with that first and keep this compiling method as the fallback.
3.) Is there anyone who might want to merge RH docs with oVirt docs where the RH docs are better than oVirt?
Hoping someone @RH can answer this, because I don't know if I'm allowed to do that?
/K
Thanks so much for providing such a great product! I just feel sometimes the docs are a little more developer-centric whereas the RedHat docs are more easily readable
_______________________________________________ Users mailing list Users@ovirt.org http://lists.ovirt.org/mailman/listinfo/users
-- Didi
participants (2)
-
Karli Sjöberg -
Yedidyah Bar David