Hi, folks!
Every release, the dedicated volunteers in the Documentation team produce the Fedora Installation Guide, an exhaustive and detailed guide to installing Fedora. For Fedora 11, they have asked us in the QA team to co-ordinate 'testing' of the Installation Guide. By doing installations following the instructions in the Installation Guide, we can find issues in both the Guide and the installation process itself, and thus improve both.
So, I have written up an installation guide 'Test Case' here:
https://fedoraproject.org/wiki/QA:Testcase_installguide
As you can see, essentially what we'd like you to do is to take a look at the Fedora 11 Installation Guide as it currently stands - it's at http://docs.fedoraproject.org/install-guide/ - and try installing either Fedora 11 Beta or current Rawhide according to the instructions found in the Installation Guide. Report any problems you find - any bugs in the installer itself, or errors or missing information or bits where what's written in the guide doesn't correspond to what you see in the actual installer - to Bugzilla.
As this is a wide-ranging case which doesn't involve any particular component or developer, we aren't running a Test Day for this, but instead would like it to be an ongoing process throughout the rest of the Fedora 11 release cycle. Please, if you have the spare time and resources, try and take part in this testing! Please discuss any questions, problems or issues as a reply to this thread. Thanks!
As you can see, essentially what we'd like you to do is to take a look at the Fedora 11 Installation Guide as it currently stands - it's at http://docs.fedoraproject.org/install-guide/ - and try installing either Fedora 11 Beta or current Rawhide according to the instructions found in the Installation Guide.
Should section 7.2 of the install guide have more detail about this feature? https://fedoraproject.org/wiki/Features/NewTextUI
As the developer himself recommends, should users be recommended to try xdriver=vesa before resorting to text mode?
--Gireesh
On Wed, 2009-04-01 at 02:29 +0530, Gireesh Sreekantan wrote:
As you can see, essentially what we'd like you to do is to take a look at the Fedora 11 Installation Guide as it currently stands - it's at http://docs.fedoraproject.org/install-guide/ - and try installing either Fedora 11 Beta or current Rawhide according to the instructions found in the Installation Guide.
Should section 7.2 of the install guide have more detail about this feature? https://fedoraproject.org/wiki/Features/NewTextUI
As the developer himself recommends, should users be recommended to try xdriver=vesa before resorting to text mode?
Thanks for the feedback, but I inadvertently sent an incorrect link in the initial email. It should have pointed you to http://ke4qqq.fedorapeople.org/Installation_Guide.pdf for the f11 install guide. Please check that one instead. Sorry!
On Wed, 2009-04-01 at 08:45 -0700, Adam Williamson wrote:
It should have pointed you to http://ke4qqq.fedorapeople.org/Installation_Guide.pdf for the f11 install guide. Please check that one instead. Sorry! -- Adam Williamson Fedora QA Community Monkey IRC: adamw | Fedora Talk: adamwill AT fedoraproject DOT org http://www.happyassassin.net
Wow, a tour de force - 274 pages. But the index has only one reference to RAID.
Bob G
On Thu, Apr 2, 2009 at 7:53 PM, Bob Gustafson bobgus@rcn.com wrote:
On Wed, 2009-04-01 at 08:45 -0700, Adam Williamson wrote:
It should have pointed you to http://ke4qqq.fedorapeople.org/Installation_Guide.pdf for the f11 install guide. Please check that one instead. Sorry!
There are a number of places where ext3 has to be replaced with ext4. As of the Beta, ext4 is expected to be the default anyway.
For example, a quick looks shows that the installation section still refers to ext3.
section 7.21.1 - screenshot shows ext3 chosen by default. figure 7.22 table 7.4, 7.5 section 7.21.5 - should add a description of ext4 with preferably a point about backwards compatibility
I can't get to Bugzilla right now but I will hopefully get to it after I get home from work.
On Tue, 2009-03-31 at 13:44 -0700, Adam Williamson wrote:
Hi, folks!
Sorry, important correction to this: the current F-11 install guide is at http://ke4qqq.fedorapeople.org/Installation_Guide.pdf , not http://docs.fedoraproject.org/install-guide/ .
On Wed, Apr 01, 2009 at 08:44:56AM -0700, Adam Williamson wrote:
On Tue, 2009-03-31 at 13:44 -0700, Adam Williamson wrote:
Hi, folks!
Sorry, important correction to this: the current F-11 install guide is at http://ke4qqq.fedorapeople.org/Installation_Guide.pdf , not http://docs.fedoraproject.org/install-guide/ .
And thanks to David Nalley for getting that draft guide up and available for everyone!
This extremely welcome installation guide is wonderful! With relatively little time and effort, I was able to zero in on the requirements for doing a medialess install on an existing system that has the Grub bootloader, and it was a great experience. Too bad Anaconda crashed while creating the encrypted filesystem, but the intelligence of the bug reporting process for Bugzilla is amazing. The installer found an existing bug for this crash automagically, and added my traceback to the bug as a comment. This is quite heartening. It means a serious bug is more likely to get rapid attention because there is sufficient traceback detail posted to pinpoint the error.
The Installation Guide section on Cobbler needs to be rewritten. First off, I can and did simply mount my entire *DVD.iso image to an http (web document) directory simply and quickly using the mount command. The Guide does not explain what Cobbler does, and why I might want to use it. It gives the impression that one must use Cobbler to do an http install. The guide should mention that for the http installation message, it is sufficient to mount the iso image to an web document directory and all will be well. That would seem to match the Red Hat Enterprise Linux documentation I've read, although the last time I had to review that was a long while ago.
So, I didn't have to read the entire Guide through from page 1. I was able to locate the information I wanted quickly and use it quickly. That is one indication of a very promising, well-done document.
Bob
Adam Williamson wrote:
Hi, folks!
Every release, the dedicated volunteers in the Documentation team produce the Fedora Installation Guide, an exhaustive and detailed guide to installing Fedora. For Fedora 11, they have asked us in the QA team to co-ordinate 'testing' of the Installation Guide. By doing installations following the instructions in the Installation Guide, we can find issues in both the Guide and the installation process itself, and thus improve both.
So, I have written up an installation guide 'Test Case' here:
https://fedoraproject.org/wiki/QA:Testcase_installguide
As you can see, essentially what we'd like you to do is to take a look at the Fedora 11 Installation Guide as it currently stands - it's at http://docs.fedoraproject.org/install-guide/ - and try installing either Fedora 11 Beta or current Rawhide according to the instructions found in the Installation Guide. Report any problems you find - any bugs in the installer itself, or errors or missing information or bits where what's written in the guide doesn't correspond to what you see in the actual installer - to Bugzilla.
As this is a wide-ranging case which doesn't involve any particular component or developer, we aren't running a Test Day for this, but instead would like it to be an ongoing process throughout the rest of the Fedora 11 release cycle. Please, if you have the spare time and resources, try and take part in this testing! Please discuss any questions, problems or issues as a reply to this thread. Thanks!
On Sun, 2009-04-05 at 14:53 -0400, Robert L Cochran wrote:
This extremely welcome installation guide is wonderful! With relatively little time and effort, I was able to zero in on the requirements for doing a medialess install on an existing system that has the Grub bootloader, and it was a great experience. Too bad Anaconda crashed while creating the encrypted filesystem, but the intelligence of the bug reporting process for Bugzilla is amazing. The installer found an existing bug for this crash automagically, and added my traceback to the bug as a comment. This is quite heartening. It means a serious bug is more likely to get rapid attention because there is sufficient traceback detail posted to pinpoint the error.
The Installation Guide section on Cobbler needs to be rewritten. First off, I can and did simply mount my entire *DVD.iso image to an http (web document) directory simply and quickly using the mount command. The Guide does not explain what Cobbler does, and why I might want to use it. It gives the impression that one must use Cobbler to do an http install. The guide should mention that for the http installation message, it is sufficient to mount the iso image to an web document directory and all will be well. That would seem to match the Red Hat Enterprise Linux documentation I've read, although the last time I had to review that was a long while ago.
So, I didn't have to read the entire Guide through from page 1. I was able to locate the information I wanted quickly and use it quickly. That is one indication of a very promising, well-done document.
Thanks for the feedback Bob!
I've experienced the same issue. While the DVD procedure you outlined is noted in section 3.5.1 [1], the section on preparing an installation server [2] could provide more details (or point to offsite cobbler documentation).
[1] http://rlandmann.fedorapeople.org/Installation% 20Guide/en-US/html/s1-steps-network-installs-x86.html#d0e1471
[2] http://rlandmann.fedorapeople.org/Installation% 20Guide/en-US/html/ap-install-server.html#sn-install-cobbler
Thanks, James
Adam Williamson wrote:
Hi, folks!
Every release, the dedicated volunteers in the Documentation team produce the Fedora Installation Guide, an exhaustive and detailed guide to installing Fedora. For Fedora 11, they have asked us in the QA team to co-ordinate 'testing' of the Installation Guide. By doing installations following the instructions in the Installation Guide, we can find issues in both the Guide and the installation process itself, and thus improve both.
So, I have written up an installation guide 'Test Case' here:
https://fedoraproject.org/wiki/QA:Testcase_installguide
As you can see, essentially what we'd like you to do is to take a look at the Fedora 11 Installation Guide as it currently stands - it's at http://docs.fedoraproject.org/install-guide/ - and try installing either Fedora 11 Beta or current Rawhide according to the instructions found in the Installation Guide. Report any problems you find - any bugs in the installer itself, or errors or missing information or bits where what's written in the guide doesn't correspond to what you see in the actual installer - to Bugzilla.
As this is a wide-ranging case which doesn't involve any particular component or developer, we aren't running a Test Day for this, but instead would like it to be an ongoing process throughout the rest of the Fedora 11 release cycle. Please, if you have the spare time and resources, try and take part in this testing! Please discuss any questions, problems or issues as a reply to this thread. Thanks!
On Tue, 2009-04-07 at 13:14 -0400, James Laska wrote:
Thanks for the feedback Bob!
I've experienced the same issue. While the DVD procedure you outlined is noted in section 3.5.1 [1], the section on preparing an installation server [2] could provide more details (or point to offsite cobbler documentation).
Just to note - David Nalley isn't replying but he is reading, he's seen this feedback and it will be taken into account :)
On Sun, Apr 5, 2009 at 2:53 PM, Robert L Cochran cochranb@speakeasy.net wrote:
This extremely welcome installation guide is wonderful! With relatively little time and effort, I was able to zero in on the requirements for doing a medialess install on an existing system that has the Grub bootloader, and it was a great experience. Too bad Anaconda crashed while creating the encrypted filesystem, but the intelligence of the bug reporting process for Bugzilla is amazing. The installer found an existing bug for this crash automagically, and added my traceback to the bug as a comment. This is quite heartening. It means a serious bug is more likely to get rapid attention because there is sufficient traceback detail posted to pinpoint the error.
The Installation Guide section on Cobbler needs to be rewritten. First off, I can and did simply mount my entire *DVD.iso image to an http (web document) directory simply and quickly using the mount command. The Guide does not explain what Cobbler does, and why I might want to use it. It gives the impression that one must use Cobbler to do an http install. The guide should mention that for the http installation message, it is sufficient to mount the iso image to an web document directory and all will be well. That would seem to match the Red Hat Enterprise Linux documentation I've read, although the last time I had to review that was a long while ago.
So, I didn't have to read the entire Guide through from page 1. I was able to locate the information I wanted quickly and use it quickly. That is one indication of a very promising, well-done document.
Bob:
Thanks for the compliments - most of the expansion of the Install Guide (it went from ~70 pages to over 250) is due to Ruediger Landmann who writes the RHEL IG, and thanks to Red Hat's move to a vanilla OPL license we are able to reuse some significant content, and hopefully position the changes to the Fedora IG upstream for the RHEL6 IG.
We've been discussing (and silent on this list) this issue, and we are going to try and get some corrections in to deal with this. The Cobbler rewrite is the only thing really in question, adding the iso loopback mounting and things like that shouldn't be a problem, but larger overview of Cobbler might miss the April 14th deadline for translation, but it should make it in.
Let me also start thanking everyone who has submitted comments thus far. I think this is the only comment we haven't at least started working on addressing. One of the reasons that I think this particular guide is so important is due to the fact that Red Hat is hoping to leverage what becomes the F11 Install Guide to become the RHEL 6 Install Guide. This means RH gets some better review and more input and the IG writers get a bit more audience and use for their work.
Thanks,
David Nalley