Hi, For the last few weeks I've been busy looking at the Gentoo/MIPS handbook, which has been in bad need of an overhaul for the past 6 months or so. The attached patch (when I attach it) is intended to bring everything up to date. Major Changes: Section 1.2: Choosing the Right Installation Medium Full overhaul. The original section did not cover the netbooting of Cobalt servers. I've also covered a very brief discussion on configuring DHCP, which whilst covered in depth in the Diskless HOWTO, I felt it was helpful to provide a cut down summary of what is needed. Section 1.4: Preparing the disks The old guide covered resizing the volume header to accomodate bigger kernels -- I have taken this out since booting from the volume header has been deprecated in favour of using arcboot. This section also covers installation on Cobalt servers which have some special needs as far as partition layout is concirned. Section 1.5: Installing the Gentoo Installation Files Nothing much has changed here, simply added a note that -v was not supported on the some boot images as per bug #80662. Section 1.7: Configuring the Kernel Previously this literally sat down and walked you through an entire 'make config' session. Given the expansion to support Cobalt Servers, SGI O2s and other workstations, this is no longer practical. Instead, we've opted to provide example configs with instructions on how to import these into the kernel configuration. Section 1.10: Configuring the Bootloader This previously covered using dvhtool to put a kernel in the volume header. As this isn't supported on all SGI machines, it has been deprecated in favour of using 'arcboot'. This section covers the new method. It also introduces setting up CoLo so that it can load kernels for Cobalt servers, as well as some tweaks for using a serial console. (e.g. disabling local gettys on TTYs, which just keep reloading and hogging the CPU on Cobalt servers) Those are the changes in full. You may peruse a live copy of the guide on my devspace (see URL above) -- I'm open to any suggestions. You can also see the raw XML by deleting the 'index.php' part of the URL. Any queries/comments, email me, or catch me in #gentoo-doc and #gentoo-mips (nick: Redhatter). Reguards, Stuart Longland
Created attachment 50602 [details, diff] Aforementioned patch.
The patch doesn't seem to apply cleanly; anyway, I've found some typo's in it: - "So our first stop" -> "So our first step" - "endevour" -> "endeavour" - "reprogramme" -> "reprogram" - "compilling" -> "compiling" - "referrs" -> "refers" - "surreget" -> "surrogate" - "ammend" -> "amend" - "straight forward" -> "straightforward" - "compilled" -> "compiled" - "priviledges" -> "privileges" - "foul swoop" -> "full swoop" A possible English misuse (not sure, I'm not English native either): - "relevant file" -> "appropriate file" - "[to your] taste" -> "[to your] own preference" or "liking" - "For more those wishing" -> "For those willing" - "having a read of" -> "reading the" - "Much of this" -> "Most of this" - "any hassles" -> "any hassle" - "should be right to" -> "should be all set to" - "like so" -> "like this" or "like the following" or "as is listed next" Some GuideXML usage thingies: - "<c>new</c>" and "<c>working</c>" -> "<path>new</path>" and "<path>working</path>" - "DO NOT" -> "<e>do not</e>" or "<e>DO NOT</e>" - Use ">" instead of ">" in code listings. Not mandatory, but common usage Also, please try to use <comment>(...)</comment> as much as possible instead of <comment>...</comment>. The installation instructions are converted to TXT as well and are regularly read on a non-color-enabled non-graphical browser. Having additional braces around the comment improves the reading for most users (yes, honestly, people do report this). Other people (who do see colours) then again want to see the non-active stuff in our code listings as comment, i.e. <pre caption="..."> <comment># Foobar</comment> some important stuff </pre> instead of <pre caption="..."> # Foobar some important stuff </pre> Further, please use the full names of the sections when you use <uri link="...">...</uri> instead of <uri link="...">this section</uri>. Again, this is due to the fact that the instructions are also converted to TXT (in which links aren't visible). If you could correct these small items I'll be glad to apply the patch.
The "to taste" is fine, although "as desired" may be more familiar for some.
Created attachment 50672 [details, diff] Corrections to spelling errors, etc. Hi, Thanks for that. My spelling normally isn't too bad but I've got one or two bad habits that I'll have to learn to correct. (e.g. doubling letters like in compilling) Then again, some of the corrections were more my term of phrase (e.g. so our first stop -- that was intenional, first stop in a journey) I've changed these anyway as it's probably for the better. I've also tried to edit the <!-- $Header .* $ --> bits so that the patch lines up with what's in CVS -- that would be the main reason why it wouldn't necessarily apply cleanly. Much of the content in that script was taken from a Wiki page I wrote some time back, so things like the > in the <pre> tag are bits I missed when converting it to GuideXML. (It took a bit to find too, as I couldn't just search for '>'). Anyway, here is the updated patch, again diffed against the latest snapshot. Hopefully I've nailed my teething problems in this role for the moment. :-) Regards, (Heh, and that's another spelling error that was pointed out to me :-) Stuart Longland
Created attachment 50674 [details, diff] ... and this time, with correct <comment> lines :-) Heh, and vim just ignored me when I told it %s/<comment>\(.*\)<\/comment>/<comment>(\1)<\/comment/ :-/ Take 2... Cut! :-) Regards, Stuart Longland
Comment on attachment 50674 [details, diff] ... and this time, with correct <comment> lines :-) 4,7c4,7 < retrieving revision 1.16 < diff -u -r1.16 mips-requirements.xml < --- en/mips-requirements.xml 5 Feb 2005 04:56:41 -0000 1.16 < +++ en/mips-requirements.xml 7 Feb 2005 21:58:57 -0000 --- > retrieving revision 1.17 > diff -u -r1.17 mips-requirements.xml > --- en/mips-requirements.xml 8 Feb 2005 01:19:17 -0000 1.17 > +++ en/mips-requirements.xml 8 Feb 2005 02:32:16 -0000 13c13 < +<!-- $Header: /var/cvsroot/gentoo-doc/en/mips-requirements.xml,v 1.16 2005/02/05 04:56:41 stuartl Exp $ --> --- > +<!-- $Header: /var/cvsroot/gentoo-doc/en/mips-requirements.xml,v 1.17 2005/02/08 01:19:17 stuartl Exp $ --> 409,412c409,412 < retrieving revision 1.4 < diff -u -r1.4 handbook-mips.xml < --- en/handbook/handbook-mips.xml 6 Feb 2005 07:13:37 -0000 1.4 < +++ en/handbook/handbook-mips.xml 7 Feb 2005 21:58:57 -0000 --- > retrieving revision 1.5 > diff -u -r1.5 handbook-mips.xml > --- en/handbook/handbook-mips.xml 8 Feb 2005 01:19:17 -0000 1.5 > +++ en/handbook/handbook-mips.xml 8 Feb 2005 02:32:16 -0000 418c418 < +<!-- $Header: /var/cvsroot/gentoo-doc/en/handbook/handbook-mips.xml,v 1.4 2005/02/06 07:13:37 stuartl Exp $ --> --- > +<!-- $Header: /var/cvsroot/gentoo-doc/en/handbook/handbook-mips.xml,v 1.5 2005/02/08 01:19:17 stuartl Exp $ --> 448,451c448,451 < retrieving revision 1.4 < diff -u -r1.4 hb-install-mips-bootloader.xml < --- en/handbook/hb-install-mips-bootloader.xml 7 Feb 2005 21:58:37 -0000 1.4 < +++ en/handbook/hb-install-mips-bootloader.xml 7 Feb 2005 21:58:57 -0000 --- > retrieving revision 1.6 > diff -u -r1.6 hb-install-mips-bootloader.xml > --- en/handbook/hb-install-mips-bootloader.xml 8 Feb 2005 01:45:00 -0000 1.6 > +++ en/handbook/hb-install-mips-bootloader.xml 8 Feb 2005 02:32:16 -0000 457c457 < +<!-- $Header: /var/cvsroot/gentoo-doc/en/handbook/hb-install-mips-bootloader.xml,v 1.4 2005/02/07 21:58:37 stuartl Exp $ --> --- > +<!-- $Header: /var/cvsroot/gentoo-doc/en/handbook/hb-install-mips-bootloader.xml,v 1.6 2005/02/08 01:45:00 stuartl Exp $ --> 539c539 < +<comment>#</comment> --- > +# 569c569 < +<comment>Create the /boot/etc directory</comment> --- > +<comment>(Create the /boot/etc directory)</comment> 572c572 < +<comment>Put our configuration into the target directory</comment> --- > +<comment>(Put our configuration into the target directory)</comment> 575c575 < +<comment>Create a symlink back to /etc</comment> --- > +<comment>(Create a symlink back to /etc)</comment> 578c578 < +<comment>... and a symlink in /boot pointing to itself</comment> --- > +<comment>(... and a symlink in /boot pointing to itself)</comment> 580,584c580,582 < </pre> < < <p> < -To set up your system to boot Gentoo/MIPS you need to go tweak some settings in < -the MIPS PROM. --- > +</pre> > + > +<p> 586,587c584,585 < +Personally, I prefer to set up two kernel images: <c>new</c>, a freshly built < +image that may or may not work; and <c>working</c>, a proven trustworthy --- > +Personally, I prefer to set up two kernel images: <path>new</path>, a freshly built > +image that may or may not work; and <path>working</path>, a proven trustworthy 589,590c587,588 < </p> < --- > +</p> > + 606,607c604 < <p> < -Continue with <uri link="#reboot">Rebooting the System</uri>. --- > +<p> 612,616c609,613 < </p> < < </body> < </subsection> < </section> --- > +</p> > + > +</body> > +</subsection> > +</section> 660c657 < +endevour. Should anything go wrong, you will need to physically remove the --- > +endeavour. Should anything go wrong, you will need to physically remove the 786,788c783,787 < +</pre> < + < +<p> --- > </pre> > > <p> > -To set up your system to boot Gentoo/MIPS you need to go tweak some settings in > -the MIPS PROM. 796,797c795,796 < +</p> < + --- > </p> > 811c810,811 < +<p> --- > <p> > -Continue with <uri link="#reboot">Rebooting the System</uri>. 817,818c817,818 < +</p> < + --- > </p> > 820c820 < +<comment>/dev/ttyS0 -- the traditional name for the first serial port</comment> --- > +<comment>(/dev/ttyS0 -- the traditional name for the first serial port)</comment> 823,824c823,824 < +<comment>Lately, Linux also calls this /dev/tts/0 -- so we add this < +too</comment> --- > +<comment>(Lately, Linux also calls this /dev/tts/0 -- so we add this > +too)</comment> 828,830c828,830 < +</body> < +</subsection> < +</section> --- > </body> > </subsection> > </section> 866,901d865 < @@ -106,26 +408,23 @@ < Option? <i>5</i> < Command Monitor. Type "exit" to return to the menu. < < -<comment>(<root device> = Gentoo's root partition, e.g. /dev/sda3)</comment> < ->> <i>setenv OSLoadPartition <root device></i> < - < -<comment>(To list the available kernels, type "ls")</comment> < ->> <i>setenv OSLoader <kernel name></i> < ->> <i>setenv OSLoadFilename <kernel name></i> < +<comment>Use arcboot as the OS Loader</comment> < +>> <i>setenv OSLoader arcboot</i> < < -<comment>(Declare the kernel parameters you want to pass)</comment> < ->> <i>setenv OSLoadOptions <kernel parameters></i> < +<comment><image name> referrs to the name of the image in < +arcboot.conf</comment> < +>> <i>setenv OSLoadFilename <image name></i> < < -<comment>(Provide the location of the Volume Header)</comment> < +<comment>Provide the location of the Volume Header</comment> < >> <i>setenv SystemPartition scsi(0)disk(1)rdisk(0)partition(8)</i> < < -<comment>(Automatically boot Gentoo)</comment> < +<comment>Automatically boot Gentoo</comment> < >> <i>setenv AutoLoad Yes</i> < < -<comment>(Set the timezone)</comment> < +<comment>Set the timezone</comment> < >> <i>setenv TimeZone EST5EDT</i> < < -<comment>(Use the serial console - graphic adapter users should have "g" instead of "d1" (one))</comment> < +<comment>Use the serial console - graphic adapter users should have "g" instead of "d1" (one)</comment> < >> <i>setenv console d1</i> < </pre> < 905,908c869,872 < retrieving revision 1.9 < diff -u -r1.9 hb-install-mips-disk.xml < --- en/handbook/hb-install-mips-disk.xml 7 Feb 2005 21:58:37 -0000 1.9 < +++ en/handbook/hb-install-mips-disk.xml 7 Feb 2005 21:58:57 -0000 --- > retrieving revision 1.14 > diff -u -r1.14 hb-install-mips-disk.xml > --- en/handbook/hb-install-mips-disk.xml 8 Feb 2005 02:16:52 -0000 1.14 > +++ en/handbook/hb-install-mips-disk.xml 8 Feb 2005 02:32:16 -0000 914c878 < +<!-- $Header: /var/cvsroot/gentoo-doc/en/handbook/hb-install-mips-disk.xml,v 1.9 2005/02/07 21:58:37 stuartl Exp $ --> --- > +<!-- $Header: /var/cvsroot/gentoo-doc/en/handbook/hb-install-mips-disk.xml,v 1.14 2005/02/08 02:16:52 stuartl Exp $ --> 983c947 < +<comment>Notice how fdisk only allows Partition #1 to be re-created starting at a --- > +<comment>(Notice how fdisk only allows Partition #1 to be re-created starting at a 988c952 < +cylinder to 101, which will roughly be 50MB (+/- 1-5MB).</comment> --- > +cylinder to 101, which will roughly be 50MB (+/- 1-5MB).)</comment> 992d955 < -<comment>(Delete Partition #9 (SGI Volume Header))</comment> 994c957 < +<comment>Delete Partition #9 (SGI Volume Header)</comment> --- > <comment>(Delete Partition #9 (SGI Volume Header))</comment> 1000d962 < -<comment>(Re-Create Partition #9, ending just before Partition #1)</comment> 1002c964 < +<comment>Re-Create Partition #9, ending just before Partition #1</comment> --- > <comment>(Re-Create Partition #9, ending just before Partition #1)</comment> 1111c1073 < +<comment>Start by clearing out any existing partitions</comment> --- > +<comment>(Start by clearing out any existing partitions)</comment> 1126c1088 < +<comment>You can now verify the partition table is empty using the 'p' command</comment> --- > +<comment>(You can now verify the partition table is empty using the 'p' command)</comment> 1136c1098 < +<comment>Create the /boot partition</comment> --- > +<comment>(Create the /boot partition)</comment> 1145c1107 < +<comment>Just press ENTER here to accept the default</comment> --- > +<comment>(Just press ENTER here to accept the default)</comment> 1150c1112 < +<comment>and now if we type 'p' again, we should see the new partition</comment> --- > +<comment>(and now if we type 'p' again, we should see the new partition)</comment> 1160c1122 < +<comment>The rest, I prefer to put in an extended partition, so I'll create that</comment> --- > +<comment>(The rest, I prefer to put in an extended partition, so I'll create that)</comment> 1169c1131 < +<comment>Again, the default is fine, just press ENTER.</comment> --- > +<comment>(Again, the default is fine, just press ENTER.)</comment> 1174c1136 < +<comment>We want to use the whole disk here, so just press ENTER again</comment> --- > +<comment>(We want to use the whole disk here, so just press ENTER again)</comment> 1178,1179c1140,1141 < +<comment>Now, the / partition -- I use separate partitions for /usr, /var, < +etc... so / can be small. Adjust to taste.</comment> --- > +<comment>(Now, the / partition -- I use separate partitions for /usr, /var, > +etc... so / can be small. Adjust as per your preference.)</comment> 1190c1152 < +<comment>... and similar for any other partitions ...</comment> --- > +<comment>(... and similar for any other partitions ...)</comment> 1192,1193c1154,1155 < +<comment>Last but not least, the swap space. I recommend at least 250MB swap, < +preferrably 1GB</comment> --- > +<comment>(Last but not least, the swap space. I recommend at least 250MB swap, > +preferrably 1GB)</comment> 1205,1206c1167,1168 < +<comment>Now, if we check our partition table, everything should mostly be ship < +shape except for one thing...</comment> --- > +<comment>(Now, if we check our partition table, everything should mostly be ship > +shape except for one thing...)</comment> 1224c1186 < +<comment>Notice how #10, our swap partition is still type 83?</comment> --- > +<comment>(Notice how #10, our swap partition is still type 83?)</comment> 1231c1193 < +<comment>That should fix it... just to verify...</comment> --- > +<comment>(That should fix it... just to verify...)</comment> 1249c1211 < +<comment>Now, we write out the new partition table.</comment> --- > +<comment>(Now, we write out the new partition table.)</comment> 1257c1219 < +<comment>#</comment> --- > +# 1264c1226 < +<uri link="#filesystems">next stage</uri>. --- > +next stage: <uri link="#filesystems">Creating Filesystems</uri>. 1317,1320c1279,1282 < retrieving revision 1.10 < diff -u -r1.10 hb-install-mips-kernel.xml < --- en/handbook/hb-install-mips-kernel.xml 7 Feb 2005 21:58:37 -0000 1.10 < +++ en/handbook/hb-install-mips-kernel.xml 7 Feb 2005 21:58:57 -0000 --- > retrieving revision 1.13 > diff -u -r1.13 hb-install-mips-kernel.xml > --- en/handbook/hb-install-mips-kernel.xml 8 Feb 2005 02:27:02 -0000 1.13 > +++ en/handbook/hb-install-mips-kernel.xml 8 Feb 2005 02:32:16 -0000 1326c1288 < +<!-- $Header: /var/cvsroot/gentoo-doc/en/handbook/hb-install-mips-kernel.xml,v 1.10 2005/02/07 21:58:37 stuartl Exp $ --> --- > +<!-- $Header: /var/cvsroot/gentoo-doc/en/handbook/hb-install-mips-kernel.xml,v 1.13 2005/02/08 02:27:02 stuartl Exp $ --> 1337c1299,1310 < @@ -54,8 +54,18 @@ --- > @@ -21,9 +21,7 @@ > symlink to <path>/etc/localtime</path> using <c>ln</c>: > </p> > > -<pre caption="Setting the timezone information"> > -# <i>ls /usr/share/zoneinfo</i> > -<comment>(Suppose you want to use GMT)</comment> > +<pre caption="Setting the timezone information to GMT"> > # <i>ln -sf /usr/share/zoneinfo/GMT /etc/localtime</i> > </pre> > > @@ -54,8 +52,18 @@ 1348c1321 < +<comment>For SGI machines:</comment> --- > +<comment>(For SGI machines)</comment> 1351c1324 < +<comment>For Cobalt machines:</comment> --- > +<comment>(For Cobalt machines)</comment> 1356c1329 < @@ -87,252 +97,56 @@ --- > @@ -87,252 +95,70 @@ 1386c1359,1360 < +matches your system and kernel version. --- > +matches your system and kernel version. You may also find other configuration > +samples at the URLs mentioned below. 1403,1405c1377,1379 < + <uri link="http://dev.gentoo.org/~kumba/mips/cobalt-2605.config">2.6.5</uri> < + <uri link="http://dev.gentoo.org/~kumba/mips/cobalt-2606.config">2.6.6</uri> < + <uri link="http://dev.gentoo.org/~kumba/mips/cobalt-config-2609">2.6.9</uri> --- > + <uri link="http://dev.gentoo.org/~kumba/mips/cobalt/kernel/cobalt-2605.config">2.6.5</uri> > + <uri link="http://dev.gentoo.org/~kumba/mips/cobalt/kernel/cobalt-2606.config">2.6.6</uri> > + <uri link="http://dev.gentoo.org/~kumba/mips/cobalt/kernel/cobalt-config-2609">2.6.9</uri> 1409a1384,1398 > +<ul> > + <li> > + IP22 (Indy, Indigo2, Challenge S) Configurations: > + <uri link="http://www.longlandclan.hopto.org/~stuartl/mips-linux/sgi/ip22/config"> > + <c>http://www.longlandclan.hopto.org/~stuartl/mips-linux/sgi/ip22/config</c> > + </uri> > + </li> > + <li> > + Cobalt Server Configurations: > + <uri link="http://dev.gentoo.org/~kumba/mips"> > + <c>http://dev.gentoo.org/~kumba/mips</c> > + </uri> > + </li> > +</ul> > + 1422,1423c1411 < +<comment>Just press ENTER at each prompt to accept the defaults... we'll < +customise later</comment> --- > +<comment>(Just press ENTER at each prompt to accept the defaults... we'll customise later)</comment> 1425d1412 < +<comment>or you can use xconfig, config or gconfig (Linux 2.6 only)</comment> 1648c1635 < @@ -372,13 +186,15 @@ --- > @@ -372,13 +198,15 @@ 1665c1652 < @@ -389,9 +205,20 @@ --- > @@ -389,9 +217,20 @@ 1689c1676 < @@ -406,12 +233,11 @@ --- > @@ -406,12 +245,10 @@ 1700d1686 < +<comment>Example for 2.4 kernels</comment> 1704c1690 < @@ -420,6 +246,15 @@ --- > @@ -420,6 +257,15 @@ 1713c1699 < +<comment> or 2.6, or /etc/modules.autoload...</comment> --- > +<comment>(or kernel-2.6, or /etc/modules.autoload...)</comment> 1723,1726c1709,1712 < retrieving revision 1.26 < diff -u -r1.26 hb-install-mips-medium.xml < --- en/handbook/hb-install-mips-medium.xml 7 Feb 2005 21:58:37 -0000 1.26 < +++ en/handbook/hb-install-mips-medium.xml 7 Feb 2005 21:58:57 -0000 --- > retrieving revision 1.35 > diff -u -r1.35 hb-install-mips-medium.xml > --- en/handbook/hb-install-mips-medium.xml 8 Feb 2005 02:10:09 -0000 1.35 > +++ en/handbook/hb-install-mips-medium.xml 8 Feb 2005 02:32:16 -0000 1732c1718 < +<!-- $Header: /var/cvsroot/gentoo-doc/en/handbook/hb-install-mips-medium.xml,v 1.26 2005/02/07 21:58:37 stuartl Exp $ --> --- > +<!-- $Header: /var/cvsroot/gentoo-doc/en/handbook/hb-install-mips-medium.xml,v 1.35 2005/02/08 02:10:09 stuartl Exp $ --> 1749c1735 < @@ -234,69 +234,494 @@ --- > @@ -234,69 +234,505 @@ 1874a1861 > + <c><http://www.linux-mips.org/wiki/index.php/Instruction_Set_Architecture></c> 1878c1865 < + Linux/MIPS Website: Endianness --- > + Linux/MIPS Website: Endianness 1879a1867,1873 > + <c><http://www.linux-mips.org/wiki/index.php/Endianess></c> > + </li> > + <li> > + <uri link="http://www.linux-mips.org/wiki/index.php/Processors"> > + Linux/MIPS Website: Processors > + </uri> > + <c><http://www.linux-mips.org/wiki/index.php/Processors></c> 1884a1879 > + <c><http://en.wikipedia.org/wiki/Instruction_set></c> 1918,1919c1913,1914 < </p> < --- > +</p> > + 1957,1961c1952,1956 < +friend). < +<uri < +link="http://www.arbeitsplatzvernichtung-durch-outsourcing.de/marty44/sgihard. html">This < +site</uri> describes making such a cable. It's in German, but has a reasonably < +good wiring diagram. --- > +friend). The following site describes making such a cable. It's in German, > +but has a reasonably good wiring diagram. > +<uri link="http://www.arbeitsplatzvernichtung-durch-outsourcing.de/marty44/sgihard.html"> > + <c>http://www.arbeitsplatzvernichtung-durch-outsourcing.de/marty44/sgihard.html</c> > +</uri> 1964c1959 < +<p> --- > +<note> 1970c1965 < +</p> --- > +</note> 1972c1967 < +<p> --- > +<note> 1977,1979c1972,1976 < +<uri link="http://www.metzner.org/projects/qube/">This site</uri> has a guide < +for installing Gentoo on these machines. < +</p> --- > +The following site has a guide for installing Gentoo on these machines. > +<uri link="http://www.metzner.org/projects/qube/"> > + <c>http://www.metzner.org/projects/qube/</c> > +</uri> > +</note> 1991,1996c1988,1993 < +support netbooting. Most of this also applies to running PXE clients (Intel), < +so for more detail, you might want to look at the < +<uri link="/doc/en/diskless-howto.xml">Diskless HOWTO</uri>. < +</p> < + < +<p> --- > +support netbooting. > </p> > > <p> > -Depending on your setup, you might need to create or download a kernel image for > -your system. 2026c2023 < + # Address pool for our booting clients. Don't forget the 'dynamic-bootp' bit! --- > + <comment># Address pool for our booting clients. Don't forget the 'dynamic-bootp' bit!</comment> 2031c2028 < + # DNS servers and default gateway -- substitute as appropriate --- > + <comment># DNS servers and default gateway -- substitute as appropriate</comment> 2035c2032 < + # Tell the DHCP server it's authoritative for this subnet. --- > + <comment># Tell the DHCP server it's authoritative for this subnet.</comment> 2038c2035 < + # Allow BOOTP to be used on this subnet. --- > + <comment># Allow BOOTP to be used on this subnet.</comment> 2043,2045c2040 < <p> < -Depending on your setup, you might need to create or download a kernel image for < -your system. --- > +<p> 2058c2053 < +<comment># emerge net-ftp/tftp-hpa</comment> --- > +# <i>emerge net-ftp/tftp-hpa</i> 2091,2092c2086,2087 < +</p> < + --- > </p> > 2138,2139c2133,2137 < +<p> < +Also in the filename, r4k referrs to R4000-series processors, r5k for R5000, --- > <p> > -First download one of the available net boot images from one of <uri > -link="/main/en/mirrors.xml">our mirrors</uri>. The net boot images are available > -in the <path>experimental/mips/netboot</path> directory. > +Also in the filename, r4k refers to R4000-series processors, r5k for R5000, 2141c2139,2140 < +<uri link="http://dev.gentoo.org/~kumba/mips/netboot">this location</uri>. --- > +<uri link="http://dev.gentoo.org/~kumba/mips/netboot"> > +<c>http://dev.gentoo.org/~kumba/mips/netboot</c></uri>. 2151,2153c2150,2152 < -First download one of the available net boot images from one of <uri < -link="/main/en/mirrors.xml">our mirrors</uri>. The net boot images are available < -in the <path>experimental/mips/netboot</path> directory. --- > -Now configure your DHCP server to send this file to the booting client. SGI > -machines however need some minor tweaks to the host system in order for TFTP to > -work properly: 2157,2158c2156,2157 < </p> < --- > +</p> > + 2166c2165 < + # ... usual stuff here ... --- > + <comment># ... usual stuff here ...</comment> 2168c2167 < + # SGI Workstation... change 'sgi' to your SGI machine's hostname. --- > + <comment># SGI Workstation... change 'sgi' to your SGI machine's hostname.</comment> 2171,2172c2170,2171 < + # MAC Address of SGI Machine. Normally this is written on the back < + # or base of the machine. --- > + <comment># MAC Address of SGI Machine. Normally this is written on the back</comment> > + <comment># or base of the machine.</comment> 2175c2174 < + # TFTP Server to download from (by default, same as DHCP server) --- > + <comment># TFTP Server to download from (by default, same as DHCP server)</comment> 2178c2177 < + # IP address to give to the SGI machine --- > + <comment># IP address to give to the SGI machine</comment> 2181c2180 < + # Filename for the PROM to download and boot --- > + <comment># Filename for the PROM to download and boot</comment> 2192,2195c2191 < <p> < -Now configure your DHCP server to send this file to the booting client. SGI < -machines however need some minor tweaks to the host system in order for TFTP to < -work properly: --- > +<p> 2201,2202c2197 < -<comment>(Disable "Path Maximum Transfer Unit", otherwise SGI Prom won't find the kernel)</comment> < +<comment>Disable "Path Maximum Transfer Unit", otherwise SGI Prom won't find the kernel</comment> --- > <comment>(Disable "Path Maximum Transfer Unit", otherwise SGI Prom won't find the kernel)</comment> 2205c2200,2201 < +<comment>Set the port range usable by the SGI PROM</comment> --- > + > +<comment>(Set the port range usable by the SGI PROM)</comment> 2214,2216c2210,2211 < </p> < < -<pre caption="Net booting a MIPS"> --- > +</p> > + 2250c2245 < +udp 0 0 *:tftp *:* <comment><-- look for this line</comment> --- > +udp 0 0 *:tftp *:* <comment><-- (look for this line)</comment> 2265,2266c2260,2262 < +</p> < + --- > </p> > > -<pre caption="Net booting a MIPS"> 2271c2267 < @@ -312,34 +737,81 @@ --- > @@ -312,34 +748,78 @@ 2283c2279 < +<uri link="?part=1&chap=3">continue your installation</uri>. --- > +move on to <uri link="?part=1&chap=3">Configuring Your Network</uri>. 2285,2288c2281 < +<!-- < + Yeah, this is actually my example of what should happen on a cobalt < + TODO: Netboot the indy and actually get real output < +--> --- > + 2364c2357 < @@ -347,13 +819,441 @@ --- > @@ -347,13 +827,441 @@ 2411,2412c2404,2407 < +Inside <uri link="http://dev.gentoo.org/~kumba/mips/cobalt/netboot/">this < +directory</uri> you'll find the necessary boot images for getting a Cobalt up --- > +Inside > +<uri link="http://dev.gentoo.org/~kumba/mips/cobalt/netboot/"> > +<c>http://dev.gentoo.org/~kumba/mips/cobalt/netboot/</c></uri> > +you'll find the necessary boot images for getting a Cobalt up 2422c2417,2418 < +<uri link="http://www.colonel-panic.org/cobalt-mips/">this site</uri> and --- > +<uri link="http://www.colonel-panic.org/cobalt-mips/"> > +<c>http://www.colonel-panic.org/cobalt-mips/</c></uri> and 2427c2423 < +<path>vmlinux_raq-2800.gz</path>. You can do this in one full swoop using these --- > +<path>vmlinux_raq-2800.gz</path>. You can do this in one hit using these 2434c2430 < +# <i>gzip -9vc colo-chain.elf > /nfsroot/vmlinux_raq-2800.gz</i> --- > +# <i>gzip -9vc colo-chain.elf > /nfsroot/vmlinux_raq-2800.gz</i> 2493c2489 < + # ... usual stuff here ... --- > + <comment># ... usual stuff here ...</comment> 2495,2496c2491,2492 < + # Configuration for a Cobalt Server < + # Set the hostname here: --- > + <comment># Configuration for a Cobalt Server</comment> > + <comment># Set the hostname here:</comment> 2498,2499c2494,2495 < + # Path to the nfsroot directory. < + # This is mainly for when using the TFTP boot option on CoLo --- > + <comment># Path to the nfsroot directory.</comment> > + <comment># This is mainly for when using the TFTP boot option on CoLo</comment> 2502c2498 < + # Cobalt server's ethernet MAC address --- > + <comment># Cobalt server's ethernet MAC address</comment> 2505c2501 < + # Server to download image from --- > + <comment># Server to download image from</comment> 2508c2504 < + # IP address of cobalt server --- > + <comment># IP address of cobalt server</comment> 2511,2512c2507,2508 < + # Image to download < + # Again, this has more to do with CoLo --- > + <comment># Image to download</comment> > + <comment># Again, this has more to do with CoLo</comment> 2535c2531 < +If nothing went wrong in that last step you should be right to power on the --- > +If nothing went wrong in that last step you should be all set to power on the 2664,2665c2660,2661 < +the Busybox <c>ash</c> shell as shown below, where you can < +<uri link="?part=1&chap=3">continue your installation</uri>. --- > +the Busybox <c>ash</c> shell as shown below, where you can go onto > +<uri link="?part=1&chap=3">Configuring Your Network</uri>. 2667,2670c2663 < +<!-- < + Yeah, this is actually my example of what should happen on a cobalt < + TODO: Netboot the indy and actually get real output < +--> --- > + 2815c2808 < +++ en/handbook/hb-install-stage.xml 7 Feb 2005 21:58:57 -0000 --- > +++ en/handbook/hb-install-stage.xml 8 Feb 2005 02:32:16 -0000
Comment on attachment 50674 [details, diff] ... and this time, with correct <comment> lines :-) 4,7c4,16 < retrieving revision 1.16 < diff -u -r1.16 mips-requirements.xml < --- en/mips-requirements.xml 5 Feb 2005 04:56:41 -0000 1.16 < +++ en/mips-requirements.xml 7 Feb 2005 22:00:36 -0000 --- > retrieving revision 1.17 > diff -u -r1.17 mips-requirements.xml > --- en/mips-requirements.xml 8 Feb 2005 01:19:17 -0000 1.17 > +++ en/mips-requirements.xml 8 Feb 2005 02:32:16 -0000 > @@ -1,7 +1,7 @@ > <?xml version='1.0' encoding="UTF-8"?> > <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> > > -<!-- $Header: /var/www/www.gentoo.org/raw_cvs/gentoo/xml/htdocs/doc/en/mips-requirements.xml,v 1.4 2005/01/31 17:16:08 swift Exp $ --> > +<!-- $Header: /var/cvsroot/gentoo-doc/en/mips-requirements.xml,v 1.17 2005/02/08 01:19:17 stuartl Exp $ --> > > <guide link="/doc/en/mips-requirements.xml"> > 400,403c409,421 < retrieving revision 1.4 < diff -u -r1.4 handbook-mips.xml < --- en/handbook/handbook-mips.xml 6 Feb 2005 07:13:37 -0000 1.4 < +++ en/handbook/handbook-mips.xml 7 Feb 2005 22:00:36 -0000 --- > retrieving revision 1.5 > diff -u -r1.5 handbook-mips.xml > --- en/handbook/handbook-mips.xml 8 Feb 2005 01:19:17 -0000 1.5 > +++ en/handbook/handbook-mips.xml 8 Feb 2005 02:32:16 -0000 > @@ -1,7 +1,7 @@ > <?xml version='1.0' encoding='UTF-8'?> > <!DOCTYPE book SYSTEM "/dtd/book.dtd"> > > -<!-- $Header: /var/www/www.gentoo.org/raw_cvs/gentoo/xml/htdocs/doc/en/handbook/handbook-mips.xml,v 1.100 2005/01/04 18:11:20 swift Exp $ --> > +<!-- $Header: /var/cvsroot/gentoo-doc/en/handbook/handbook-mips.xml,v 1.5 2005/02/08 01:19:17 stuartl Exp $ --> > > <book link="handbook-mips.xml"> > <title>Gentoo Linux/MIPS Handbook</title> 430,433c448,451 < retrieving revision 1.4 < diff -u -r1.4 hb-install-mips-bootloader.xml < --- en/handbook/hb-install-mips-bootloader.xml 7 Feb 2005 21:58:37 -0000 1.4 < +++ en/handbook/hb-install-mips-bootloader.xml 7 Feb 2005 22:00:36 -0000 --- > retrieving revision 1.6 > diff -u -r1.6 hb-install-mips-bootloader.xml > --- en/handbook/hb-install-mips-bootloader.xml 8 Feb 2005 01:45:00 -0000 1.6 > +++ en/handbook/hb-install-mips-bootloader.xml 8 Feb 2005 02:32:16 -0000 439c457 < +<!-- $Header: /var/www/www.gentoo.org/raw_cvs/gentoo/xml/htdocs/doc/en/handbook/hb-install-mi ps-bootloader.xml,v 1.10 2005/02/07 21:58:37 stuartl Exp $ --> --- > +<!-- $Header: /var/cvsroot/gentoo-doc/en/handbook/hb-install-mips-bootloader.xml,v 1.6 2005/02/08 01:45:00 stuartl Exp $ --> 562,566c580,582 < </pre> < < <p> < -To set up your system to boot Gentoo/MIPS you need to go tweak some settings in < -the MIPS PROM. --- > +</pre> > + > +<p> 571,572c587,588 < </p> < --- > +</p> > + 588,589c604 < <p> < -Continue with <uri link="#reboot">Rebooting the System</uri>. --- > +<p> 594,598c609,613 < </p> < < </body> < </subsection> < </section> --- > +</p> > + > +</body> > +</subsection> > +</section> 642c657 < +endevour. Should anything go wrong, you will need to physically remove the --- > +endeavour. Should anything go wrong, you will need to physically remove the 768,770c783,787 < +</pre> < + < +<p> --- > </pre> > > <p> > -To set up your system to boot Gentoo/MIPS you need to go tweak some settings in > -the MIPS PROM. 778,779c795,796 < +</p> < + --- > </p> > 793c810,811 < +<p> --- > <p> > -Continue with <uri link="#reboot">Rebooting the System</uri>. 799,800c817,818 < +</p> < + --- > </p> > 810,812c828,830 < +</body> < +</subsection> < +</section> --- > </body> > </subsection> > </section> 848,879d865 < @@ -106,26 +408,23 @@ < Option? <i>5</i> < Command Monitor. Type "exit" to return to the menu. < < -<comment>(<root device> = Gentoo's root partition, e.g. /dev/sda3)</comment> < ->> <i>setenv OSLoadPartition <root device></i> < - < -<comment>(To list the available kernels, type "ls")</comment> < ->> <i>setenv OSLoader <kernel name></i> < ->> <i>setenv OSLoadFilename <kernel name></i> < +<comment>(Use arcboot as the OS Loader)</comment> < +>> <i>setenv OSLoader arcboot</i> < < -<comment>(Declare the kernel parameters you want to pass)</comment> < ->> <i>setenv OSLoadOptions <kernel parameters></i> < +<comment>(<image name> referrs to the name of the image in < +arcboot.conf)</comment> < +>> <i>setenv OSLoadFilename <image name></i> < < <comment>(Provide the location of the Volume Header)</comment> < >> <i>setenv SystemPartition scsi(0)disk(1)rdisk(0)partition(8)</i> < < <comment>(Automatically boot Gentoo)</comment> < >> <i>setenv AutoLoad Yes</i> < < <comment>(Set the timezone)</comment> < >> <i>setenv TimeZone EST5EDT</i> < < <comment>(Use the serial console - graphic adapter users should have "g" instead of "d1" (one))</comment> < >> <i>setenv console d1</i> < </pre> < 883,886c869,872 < retrieving revision 1.9 < diff -u -r1.9 hb-install-mips-disk.xml < --- en/handbook/hb-install-mips-disk.xml 7 Feb 2005 21:58:37 -0000 1.9 < +++ en/handbook/hb-install-mips-disk.xml 7 Feb 2005 22:00:36 -0000 --- > retrieving revision 1.14 > diff -u -r1.14 hb-install-mips-disk.xml > --- en/handbook/hb-install-mips-disk.xml 8 Feb 2005 02:16:52 -0000 1.14 > +++ en/handbook/hb-install-mips-disk.xml 8 Feb 2005 02:32:16 -0000 892c878 < +<!-- $Header: /var/www/www.gentoo.org/raw_cvs/gentoo/xml/htdocs/doc/en/handbook/hb-install-mi ps-disk.xml,v 1.9 2005/02/07 21:58:37 stuartl Exp $ --> --- > +<!-- $Header: /var/cvsroot/gentoo-doc/en/handbook/hb-install-mips-disk.xml,v 1.14 2005/02/08 02:16:52 stuartl Exp $ --> 955,959c941,952 < <comment>(Notice how fdisk only allows Partition #1 to be re-created starting at a minimum of cylinder 5)</comment> < <comment>(Had you attempted to delete & re-create the SGI Volume Header this way, this is the same issue < you would have encountered.)</comment> < <comment>(In our example, we want /boot to be 50MB, so we start it at cylinder 51 (the Volume Header needs to < start at cylinder 0, remember?), and set its ending cylinder to 101, which will roughly be 50MB (+/- 1-5MB))</comment> --- > -<comment>(Notice how fdisk only allows Partition #1 to be re-created starting at a minimum of cylinder 5)</comment> > -<comment>(Had you attempted to delete & re-create the SGI Volume Header this way, this is the same issue > - you would have encountered.)</comment> > -<comment>(In our example, we want /boot to be 50MB, so we start it at cylinder 51 (the Volume Header needs to > - start at cylinder 0, remember?), and set its ending cylinder to 101, which will roughly be 50MB (+/- 1-5MB))</comment> > + > +<comment>(Notice how fdisk only allows Partition #1 to be re-created starting at a > +minimum of cylinder 5? Had you attempted to delete & re-create the SGI > +Volume Header this way, this is the same issue you would have encountered. > +In our example, we want /boot to be 50MB, so we start it at cylinder 51 (the > +Volume Header needs to start at cylinder 0, remember?), and set its ending > +cylinder to 101, which will roughly be 50MB (+/- 1-5MB).)</comment> 1148c1141 < +etc... so / can be small. Adjust to personal preference.)</comment> --- > +etc... so / can be small. Adjust as per your preference.)</comment> 1233c1226 < +<uri link="#filesystems">next stage</uri>. --- > +next stage: <uri link="#filesystems">Creating Filesystems</uri>. 1286,1289c1279,1282 < retrieving revision 1.10 < diff -u -r1.10 hb-install-mips-kernel.xml < --- en/handbook/hb-install-mips-kernel.xml 7 Feb 2005 21:58:37 -0000 1.10 < +++ en/handbook/hb-install-mips-kernel.xml 7 Feb 2005 22:00:36 -0000 --- > retrieving revision 1.13 > diff -u -r1.13 hb-install-mips-kernel.xml > --- en/handbook/hb-install-mips-kernel.xml 8 Feb 2005 02:27:02 -0000 1.13 > +++ en/handbook/hb-install-mips-kernel.xml 8 Feb 2005 02:32:16 -0000 1295c1288 < +<!-- $Header: /var/www/www.gentoo.org/raw_cvs/gentoo/xml/htdocs/doc/en/handbook/hb-install-mi ps-kernel.xml,v 1.10 2005/02/07 21:58:37 stuartl Exp $ --> --- > +<!-- $Header: /var/cvsroot/gentoo-doc/en/handbook/hb-install-mips-kernel.xml,v 1.13 2005/02/08 02:27:02 stuartl Exp $ --> 1306c1299,1310 < @@ -54,8 +54,18 @@ --- > @@ -21,9 +21,7 @@ > symlink to <path>/etc/localtime</path> using <c>ln</c>: > </p> > > -<pre caption="Setting the timezone information"> > -# <i>ls /usr/share/zoneinfo</i> > -<comment>(Suppose you want to use GMT)</comment> > +<pre caption="Setting the timezone information to GMT"> > # <i>ln -sf /usr/share/zoneinfo/GMT /etc/localtime</i> > </pre> > > @@ -54,8 +52,18 @@ 1317c1321 < +<comment>(For SGI machines:)</comment> --- > +<comment>(For SGI machines)</comment> 1320c1324 < +<comment>(For Cobalt machines:)</comment> --- > +<comment>(For Cobalt machines)</comment> 1325c1329 < @@ -87,252 +97,56 @@ --- > @@ -87,252 +95,70 @@ 1355c1359,1360 < +matches your system and kernel version. --- > +matches your system and kernel version. You may also find other configuration > +samples at the URLs mentioned below. 1372,1374c1377,1379 < + <uri link="http://dev.gentoo.org/~kumba/mips/cobalt-2605.config">2.6.5</uri> < + <uri link="http://dev.gentoo.org/~kumba/mips/cobalt-2606.config">2.6.6</uri> < + <uri link="http://dev.gentoo.org/~kumba/mips/cobalt-config-2609">2.6.9</uri> --- > + <uri link="http://dev.gentoo.org/~kumba/mips/cobalt/kernel/cobalt-2605.config">2.6.5</uri> > + <uri link="http://dev.gentoo.org/~kumba/mips/cobalt/kernel/cobalt-2606.config">2.6.6</uri> > + <uri link="http://dev.gentoo.org/~kumba/mips/cobalt/kernel/cobalt-config-2609">2.6.9</uri> 1378a1384,1398 > +<ul> > + <li> > + IP22 (Indy, Indigo2, Challenge S) Configurations: > + <uri link="http://www.longlandclan.hopto.org/~stuartl/mips-linux/sgi/ip22/config"> > + <c>http://www.longlandclan.hopto.org/~stuartl/mips-linux/sgi/ip22/config</c> > + </uri> > + </li> > + <li> > + Cobalt Server Configurations: > + <uri link="http://dev.gentoo.org/~kumba/mips"> > + <c>http://dev.gentoo.org/~kumba/mips</c> > + </uri> > + </li> > +</ul> > + 1391,1392c1411 < +<comment>(Just press ENTER at each prompt to accept the defaults... we'll < +customise later)</comment> --- > +<comment>(Just press ENTER at each prompt to accept the defaults... we'll customise later)</comment> 1394d1412 < +<comment>(or you can use xconfig, config or gconfig (Linux 2.6 only))</comment> 1617c1635 < @@ -372,13 +186,15 @@ --- > @@ -372,13 +198,15 @@ 1634c1652 < @@ -389,9 +205,20 @@ --- > @@ -389,9 +217,20 @@ 1658c1676 < @@ -406,12 +233,11 @@ --- > @@ -406,12 +245,10 @@ 1668c1686 < <comment>(Example for 2.4 kernels)</comment> --- > -<comment>(Example for 2.4 kernels)</comment> 1672c1690 < @@ -420,6 +246,15 @@ --- > @@ -420,6 +257,15 @@ 1681c1699 < +<comment>(or 2.6, or /etc/modules.autoload...)</comment> --- > +<comment>(or kernel-2.6, or /etc/modules.autoload...)</comment> 1691,1694c1709,1721 < retrieving revision 1.26 < diff -u -r1.26 hb-install-mips-medium.xml < --- en/handbook/hb-install-mips-medium.xml 7 Feb 2005 21:58:37 -0000 1.26 < +++ en/handbook/hb-install-mips-medium.xml 7 Feb 2005 22:00:36 -0000 --- > retrieving revision 1.35 > diff -u -r1.35 hb-install-mips-medium.xml > --- en/handbook/hb-install-mips-medium.xml 8 Feb 2005 02:10:09 -0000 1.35 > +++ en/handbook/hb-install-mips-medium.xml 8 Feb 2005 02:32:16 -0000 > @@ -4,7 +4,7 @@ > <!-- The content of this document is licensed under the CC-BY-SA license --> > <!-- See http://creativecommons.org/licenses/by-sa/1.0 --> > > -<!-- $Header: /var/www/www.gentoo.org/raw_cvs/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-medium.xml,v 1.8 2005/01/04 18:11:20 swift Exp $ --> > +<!-- $Header: /var/cvsroot/gentoo-doc/en/handbook/hb-install-mips-medium.xml,v 1.35 2005/02/08 02:10:09 stuartl Exp $ --> > > <sections> > 1708c1735 < @@ -234,69 +234,494 @@ --- > @@ -234,69 +234,505 @@ 1833a1861 > + <c><http://www.linux-mips.org/wiki/index.php/Instruction_Set_Architecture></c> 1837c1865 < + Linux/MIPS Website: Endianness --- > + Linux/MIPS Website: Endianness 1838a1867,1873 > + <c><http://www.linux-mips.org/wiki/index.php/Endianess></c> > + </li> > + <li> > + <uri link="http://www.linux-mips.org/wiki/index.php/Processors"> > + Linux/MIPS Website: Processors > + </uri> > + <c><http://www.linux-mips.org/wiki/index.php/Processors></c> 1843a1879 > + <c><http://en.wikipedia.org/wiki/Instruction_set></c> 1877,1878c1913,1914 < </p> < --- > +</p> > + 1916,1920c1952,1956 < +friend). < +<uri < +link="http://www.arbeitsplatzvernichtung-durch-outsourcing.de/marty44/sgihard. html">This < +site</uri> describes making such a cable. It's in German, but has a reasonably < +good wiring diagram. --- > +friend). The following site describes making such a cable. It's in German, > +but has a reasonably good wiring diagram. > +<uri link="http://www.arbeitsplatzvernichtung-durch-outsourcing.de/marty44/sgihard.html"> > + <c>http://www.arbeitsplatzvernichtung-durch-outsourcing.de/marty44/sgihard.html</c> > +</uri> 1923c1959 < +<p> --- > +<note> 1929c1965 < +</p> --- > +</note> 1931c1967 < +<p> --- > +<note> 1936,1938c1972,1976 < +<uri link="http://www.metzner.org/projects/qube/">This site</uri> has a guide < +for installing Gentoo on these machines. < +</p> --- > +The following site has a guide for installing Gentoo on these machines. > +<uri link="http://www.metzner.org/projects/qube/"> > + <c>http://www.metzner.org/projects/qube/</c> > +</uri> > +</note> 1950,1955c1988,1993 < +support netbooting. Most of this also applies to running PXE clients (Intel), < +so for more detail, you might want to look at the < +<uri link="/doc/en/diskless-howto.xml">Diskless HOWTO</uri>. < +</p> < + < +<p> --- > +support netbooting. > </p> > > <p> > -Depending on your setup, you might need to create or download a kernel image for > -your system. 1985c2023 < + # Address pool for our booting clients. Don't forget the 'dynamic-bootp' bit! --- > + <comment># Address pool for our booting clients. Don't forget the 'dynamic-bootp' bit!</comment> 1990c2028 < + # DNS servers and default gateway -- substitute as appropriate --- > + <comment># DNS servers and default gateway -- substitute as appropriate</comment> 1994c2032 < + # Tell the DHCP server it's authoritative for this subnet. --- > + <comment># Tell the DHCP server it's authoritative for this subnet.</comment> 1997c2035 < + # Allow BOOTP to be used on this subnet. --- > + <comment># Allow BOOTP to be used on this subnet.</comment> 2002,2004c2040 < <p> < -Depending on your setup, you might need to create or download a kernel image for < -your system. --- > +<p> 2050,2051c2086,2087 < +</p> < + --- > </p> > 2097,2098c2133,2137 < +<p> < +Also in the filename, r4k referrs to R4000-series processors, r5k for R5000, --- > <p> > -First download one of the available net boot images from one of <uri > -link="/main/en/mirrors.xml">our mirrors</uri>. The net boot images are available > -in the <path>experimental/mips/netboot</path> directory. > +Also in the filename, r4k refers to R4000-series processors, r5k for R5000, 2100c2139,2140 < +<uri link="http://dev.gentoo.org/~kumba/mips/netboot">this location</uri>. --- > +<uri link="http://dev.gentoo.org/~kumba/mips/netboot"> > +<c>http://dev.gentoo.org/~kumba/mips/netboot</c></uri>. 2110,2112c2150,2152 < -First download one of the available net boot images from one of <uri < -link="/main/en/mirrors.xml">our mirrors</uri>. The net boot images are available < -in the <path>experimental/mips/netboot</path> directory. --- > -Now configure your DHCP server to send this file to the booting client. SGI > -machines however need some minor tweaks to the host system in order for TFTP to > -work properly: 2116,2117c2156,2157 < </p> < --- > +</p> > + 2125c2165 < + # ... usual stuff here ... --- > + <comment># ... usual stuff here ...</comment> 2127c2167 < + # SGI Workstation... change 'sgi' to your SGI machine's hostname. --- > + <comment># SGI Workstation... change 'sgi' to your SGI machine's hostname.</comment> 2130,2131c2170,2171 < + # MAC Address of SGI Machine. Normally this is written on the back < + # or base of the machine. --- > + <comment># MAC Address of SGI Machine. Normally this is written on the back</comment> > + <comment># or base of the machine.</comment> 2134c2174 < + # TFTP Server to download from (by default, same as DHCP server) --- > + <comment># TFTP Server to download from (by default, same as DHCP server)</comment> 2137c2177 < + # IP address to give to the SGI machine --- > + <comment># IP address to give to the SGI machine</comment> 2140c2180 < + # Filename for the PROM to download and boot --- > + <comment># Filename for the PROM to download and boot</comment> 2151,2154c2191 < <p> < -Now configure your DHCP server to send this file to the booting client. SGI < -machines however need some minor tweaks to the host system in order for TFTP to < -work properly: --- > +<p> 2160,2161c2197 < -<comment>(Disable "Path Maximum Transfer Unit", otherwise SGI Prom won't find the kernel)</comment> < +<comment>(Disable "Path Maximum Transfer Unit", otherwise SGI PROM won't find the kernel)</comment> --- > <comment>(Disable "Path Maximum Transfer Unit", otherwise SGI Prom won't find the kernel)</comment> 2163a2200 > + 2173,2175c2210,2211 < </p> < < -<pre caption="Net booting a MIPS"> --- > +</p> > + 2201c2237 < +fine. (Look for the line pointed to by the arrow) --- > +fine. 2224,2225c2260,2262 < +</p> < + --- > </p> > > -<pre caption="Net booting a MIPS"> 2230c2267 < @@ -312,34 +737,81 @@ --- > @@ -312,34 +748,78 @@ 2242c2279 < +<uri link="?part=1&chap=3">continue your installation</uri>. --- > +move on to <uri link="?part=1&chap=3">Configuring Your Network</uri>. 2244,2247c2281 < +<!-- < + Yeah, this is actually my example of what should happen on a cobalt < + TODO: Netboot the indy and actually get real output < +--> --- > + 2323c2357 < @@ -347,13 +819,441 @@ --- > @@ -347,13 +827,441 @@ 2370,2371c2404,2407 < +Inside <uri link="http://dev.gentoo.org/~kumba/mips/cobalt/netboot/">this < +directory</uri> you'll find the necessary boot images for getting a Cobalt up --- > +Inside > +<uri link="http://dev.gentoo.org/~kumba/mips/cobalt/netboot/"> > +<c>http://dev.gentoo.org/~kumba/mips/cobalt/netboot/</c></uri> > +you'll find the necessary boot images for getting a Cobalt up 2381c2417,2418 < +<uri link="http://www.colonel-panic.org/cobalt-mips/">this site</uri> and --- > +<uri link="http://www.colonel-panic.org/cobalt-mips/"> > +<c>http://www.colonel-panic.org/cobalt-mips/</c></uri> and 2386c2423 < +<path>vmlinux_raq-2800.gz</path>. You can do this in one full swoop using these --- > +<path>vmlinux_raq-2800.gz</path>. You can do this in one hit using these 2393c2430 < +# <i>gzip -9vc colo-chain.elf > /nfsroot/vmlinux_raq-2800.gz</i> --- > +# <i>gzip -9vc colo-chain.elf > /nfsroot/vmlinux_raq-2800.gz</i> 2452c2489 < + # ... usual stuff here ... --- > + <comment># ... usual stuff here ...</comment> 2454,2455c2491,2492 < + # Configuration for a Cobalt Server < + # Set the hostname here: --- > + <comment># Configuration for a Cobalt Server</comment> > + <comment># Set the hostname here:</comment> 2457,2458c2494,2495 < + # Path to the nfsroot directory. < + # This is mainly for when using the TFTP boot option on CoLo --- > + <comment># Path to the nfsroot directory.</comment> > + <comment># This is mainly for when using the TFTP boot option on CoLo</comment> 2461c2498 < + # Cobalt server's ethernet MAC address --- > + <comment># Cobalt server's ethernet MAC address</comment> 2464c2501 < + # Server to download image from --- > + <comment># Server to download image from</comment> 2467c2504 < + # IP address of cobalt server --- > + <comment># IP address of cobalt server</comment> 2470,2471c2507,2508 < + # Image to download < + # Again, this has more to do with CoLo --- > + <comment># Image to download</comment> > + <comment># Again, this has more to do with CoLo</comment> 2494c2531 < +If nothing went wrong in that last step you should be right to power on the --- > +If nothing went wrong in that last step you should be all set to power on the 2623,2624c2660,2661 < +the Busybox <c>ash</c> shell as shown below, where you can < +<uri link="?part=1&chap=3">continue your installation</uri>. --- > +the Busybox <c>ash</c> shell as shown below, where you can go onto > +<uri link="?part=1&chap=3">Configuring Your Network</uri>. 2626,2629c2663 < +<!-- < + Yeah, this is actually my example of what should happen on a cobalt < + TODO: Netboot the indy and actually get real output < +--> --- > + 2774c2808,2817 < +++ en/handbook/hb-install-stage.xml 7 Feb 2005 22:00:36 -0000 --- > +++ en/handbook/hb-install-stage.xml 8 Feb 2005 02:32:16 -0000 > @@ -4,7 +4,7 @@ > <!-- The content of this document is licensed under the CC-BY-SA license --> > <!-- See http://creativecommons.org/licenses/by-sa/1.0 --> > > -<!-- $Header: /var/www/www.gentoo.org/raw_cvs/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v 1.78 2005/01/11 17:15:28 swift Exp $ --> > +<!-- $Header: /var/cvsroot/gentoo-doc/en/handbook/hb-install-stage.xml,v 1.8 2005/02/06 09:04:20 stuartl Exp $ --> > > <sections> >
Created attachment 50691 [details, diff] lastly, a patch that cleanly applies to the latest snapshot. Sorry all... Take 3. :-/ The 'edit patch' feature in Bugzilla doesn't like me. On top of this, having fully woken up, I spotted some more mistakes that needed fixing. This one should be clean and bug free now........... almost Stuart Longland
There are still a few issues. The GuideXML ones: handbook-mips.xml: - abstract element cannot contain a <c> tag hb-install-mips-kernel.xml: - no <c> inside <uri> - no <info> tag -> changed to <note> hb-install-mips-medium.xml: - no <c> inside <uri> You should be able to detect GuideXML issues yourself with xmllint as noted in http://www.gentoo.org/proj/en/gdp/doc/doc-tipsntricks.xml Next, the mips-requirements.xml and hb-install-mips-bootloader.xml patches fail miserably. I'll attach the .rej files of those so you can take a look. Also, why do you first use <uri link="foobar">name</uri> with <c><foobar></c> immediately following it? You already have the link in the document, there is no need to duplicate it.
Created attachment 51189 [details] mips-requirements.xml.rej
Created attachment 51190 [details] hb-install-mips-bootloader.xml.rej
Comment on attachment 51189 [details] mips-requirements.xml.rej Sorry; I had an old mips-requirements.xml
I've committed the mips-requirements changes. The handbook ones are the only ones that remain.
Hi, okay... Commenting Inline > handbook-mips.xml: > - abstract element cannot contain a <c> tag No problems, fixed. > hb-install-mips-kernel.xml: > - no <c> inside <uri> > - no <info> tag -> changed to <note> > > hb-install-mips-medium.xml: > - no <c> inside <uri> Okay... the <c> bit was more of a readability thing for those who have printed material -- I thought it better to display a URL using a fixed-width font, but if this is not allowed using GuideXML, that's fair enough. I have removed it in the next patchset. The <info> tag must've been a lapse of brain function momentarily... I shall have to check my code more carefully. :-) > Also, why do you first use <uri link="foobar">name</uri> with <c><foobar></c> immediately following it? You already have the link in the document, there is no need to duplicate it. Okay, I did that for those who can't see hyperlinks (as you noted in comment #2). People who are viewing the plaintext version, or have printed out a hard copy of the document then still are able to see the URL. This is also where the use of <c>http://blah</c> comes in -- as using a fixed-width font makes it easier to distinguish the characters when working from printed material. This time, I have checked my files using xmllint (actually, I've stuck it in the Makefile I use to generate the patches -- so it won't get forgotten next time), and the patch applies cleanly against the current latest snapshot at time of creation -- barring the differences in the CVS Header (e.g. the problem you hit with mips-requirements.xml), they should apply cleanly. There's also just one more tweak with mips-requirements -- as we're no longer using colour to denote support, it seems reasonable to take out the <note> tags that describe the colour coding. I've just commented it out for the moment, but I may remove it totally later. Some of these sections though -- are complete rewrites -- if it makes it easier, I can put up the raw XML file that can be put in the repository if patch won't play nice. Anyway, I'll attach the updated patch... Hopefully I should have nailed all the problems this time. :-)
Created attachment 51202 [details, diff] Updated Patch If a hunk fails miserably... my complete version of the file is here: http://www.longlandclan.hopto.org/~stuartl/gentoo/docs/gentoo-doc/en/handbook/
I needed to download your hb-install-mips-bootloader.xml file (a hunk still failed) but other than that everything's fine. All updates committed. *Pfew* :)
