/[gentoo]/xml/htdocs/doc/en/gentoo-sparc-netboot-howto.xml
Gentoo

Diff of /xml/htdocs/doc/en/gentoo-sparc-netboot-howto.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.2 Revision 1.3
1<?xml version='1.0' encoding="UTF-8"?> 1<?xml version='1.0' encoding="UTF-8"?>
2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3<guide link="/doc/en/gentoo-sparc-netboot-howto.xml"> 3<guide link="/doc/en/gentoo-sparc-netboot-howto.xml">
4<title>Gentoo Linux based Netboot HOWTO</title> 4<title>Gentoo Linux based Netboot HOWTO</title>
5<author title="SPARC Developer"> 5<author title="SPARC Developer">
6 <mail link="weeve@gentoo.org">Jason Wever</mail> 6 <mail link="weeve@gentoo.org">Jason Wever</mail>
7</author> 7</author>
8<abstract> 8<abstract>
9Guide for setting up a netboot server for use with the Gentoo/SPARC netboot installation images. 9Guide for setting up a netboot server for use with the Gentoo/SPARC netboot installation images.
10</abstract> 10</abstract>
11<!-- The content of this document is licensed under the CC-BY-SA license --> 11<!-- The content of this document is licensed under the CC-BY-SA license -->
12<!-- See http://creativecommons.org/licenses/by-sa/1.0 --> 12<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
13<license/> 13<license/>
14 14
15<version>1.0</version> 15<version>1.1</version>
16<date>April 11 2004</date> 16<date>September 22, 2004</date>
17 17
18<chapter> 18<chapter>
19<title>Introduction</title> 19<title>Introduction</title>
20<section> 20<section>
21<body> 21<body>
22 22
23<note> 23<note>
24This howto is currently very SPARC-centric and expecting that you will be 24This howto is currently very SPARC-centric and expecting that you will be
25setting up your netboot server on an existing Gentoo Linux machine. 25setting up your netboot server on an existing Gentoo Linux machine.
26</note> 26</note>
27 27
28<p> 28<p>
29This document will describe how to setup a network booting environment for a 29This document will describe how to setup a network booting environment for a
30Sun Microsystems SPARC or UltraSPARC based computer. The document assumes that 30Sun Microsystems SPARC or UltraSPARC based computer. The document assumes that
31you have an existing Gentoo Linux computer available to act as the netboot 31you have an existing Gentoo Linux computer available to act as the netboot
455planning to boot a sparc64 host using the 455planning to boot a sparc64 host using the
456gentoo-sparc64-1.4_rc4-20040102.tftpboot image. 456gentoo-sparc64-1.4_rc4-20040102.tftpboot image.
457</p> 457</p>
458 458
459<p> 459<p>
460Once you have an image, copy the image into /tftpboot; 460Once you have an image, copy the image into /tftpboot;
461</p> 461</p>
462 462
463<pre caption="Copying the image"> 463<pre caption="Copying the image">
464# <i>cp gentoo-sparc64-1.4_rc4-20040102.tftpboot /tftpboot</i> 464# <i>cp gentoo-sparc64-1.4_rc4-20040102.tftpboot /tftpboot</i>
465</pre> 465</pre>
466 466
467<p> 467<p>
468Now, when the netboot client makes a tftp request, it looks for a file that is 468Now, when the netboot client makes a tftp request, it looks for a file that is
469the hexidecimal number of its current IP address, and on some platforms an 469the hexidecimal number of its current IP address, and on some platforms an
470.ARCH suffix. 470.ARCH suffix. The hexidecimal number should use <e>capital</e> characters.
471</p> 471</p>
472 472
473<p> 473<p>
474A guide on how to convert decimal to hexidecimal is available at 474A guide on how to convert decimal to hexidecimal is available at
475<uri>http://www.permadi.com/tutorial/numDecToHex/</uri> 475<uri>http://www.permadi.com/tutorial/numDecToHex/</uri>
476</p> 476</p>
477 477
478<p> 478<p>
479And for the lazy/impatient, you can find a decimal to hexidecimal conversion 479And for the lazy/impatient, you can find a decimal to hexidecimal conversion
480tool at <uri>http://dan.drydog.com/hextemp.html</uri> 480tool at <uri>http://dan.drydog.com/hextemp.html</uri>
481</p> 481</p>
482 482
483<note> 483<note>
484For each octet in the IP address (the 10 in 10.0.1.15 for instance), you 484For each octet in the IP address (the 10 in 10.0.1.15 for instance), you
485will need to convert it to hexidecimal, rather than converting the IP address asa singular number. 485will need to convert it to hexidecimal, rather than converting the IP address asa singular number.
486</note> 486</note>
487 487
488<p>So for our example IP address, 10.0.1.15, let's look at its hexidecimal 488<p>So for our example IP address, 10.0.1.15, let's look at its hexidecimal
489equivalent; 489equivalent;
490</p> 490</p>
491 491
492<pre caption="Example IP address"> 492<pre caption="Example IP address">
493decimal 10 0 1 15 493decimal 10 0 1 15
494hexidecimal 0a 00 01 0f 494hexidecimal 0A 00 01 0F
495</pre> 495</pre>
496 496
497<p> 497<p>
498So for the example sparc64 netboot client, it would look for a file named 498So for the example sparc64 netboot client, it would look for a file named
4990a00010f when it tftpboots. 4990A00010F when it tftpboots.
500</p>
501
502<p> 500</p>
501
502<p>
503On sparc however, the file would be 0a00010f.SUN4M, 0a00010f.SUN4C or 503On sparc however, the file would be 0A00010F.SUN4M, 0A00010F.SUN4C or
5040a00010f.SUN4D depending on what type of sparc system. 5040A00010F.SUN4D depending on what type of sparc system.
505</p> 505</p>
506 506
507<p> 507<p>
508Additionally, if you are really really lazy (like me), you can netboot the host 508Additionally, if you are really really lazy (like me), you can netboot the host
509to get the filename the client is looking for from the netboot server logs. 509to get the filename the client is looking for from the netboot server logs.
510</p> 510</p>
511 511
512<p> 512<p>
513Make sure that both the rarpd and tftpd daemon you've chosen are currently 513Make sure that both the rarpd and tftpd daemon you've chosen are currently
514running, then boot the host as described below in "Netbooting the client". 514running, then boot the host as described below in "Netbooting the client".
515</p> 515</p>
516 516
517<p> 517<p>
518The client will appear to hang after the boot net command is issued. 518The client will appear to hang after the boot net command is issued.
519Then on the netboot server, check the system logs for an entry for in.tftpd. 519Then on the netboot server, check the system logs for an entry for in.tftpd.
520</p> 520</p>
521 521
522<p> 522<p>
523An example entry from a netboot server running sysklogd and tftp-hpa looks 523An example entry from a netboot server running sysklogd and tftp-hpa looks
524like; 524like;
525</p> 525</p>
526 526
527<pre caption="Log entry for netboot server"> 527<pre caption="Log entry for netboot server">
528Jan 3 22:48:59 stargazer in.tftpd[8368]: RRQ from 10.0.1.15 filename 0a00010f 528Jan 3 22:48:59 stargazer in.tftpd[8368]: RRQ from 10.0.1.15 filename 0A00010F
529</pre> 529</pre>
530 530
531<p> 531<p>
532The filename is shown above after "filename" in the log entry, which in this 532The filename is shown above after "filename" in the log entry, which in this
533case is 0a00010f. 533case is 0A00010F.
534</p> 534</p>
535 535
536<p> 536<p>
537As a way to keep track of what netboot image you are using, and to allow 537As a way to keep track of what netboot image you are using, and to allow
538multiple machines to use the same netboot image, you can use a soft link to 538multiple machines to use the same netboot image, you can use a soft link to
539create the file with the hexidecimal value. To create this using our sample 539create the file with the hexidecimal value. To create this using our sample
540sparc64 host and the gentoo-sparc64-1.4_rc4-20040102.tftpboot, use the 540sparc64 host and the gentoo-sparc64-1.4_rc4-20040102.tftpboot, use the
541following command; 541following command;
542</p> 542</p>
543 543
544<pre caption="Linking the image files"> 544<pre caption="Linking the image files">
545# <i>/bin/ln -s /tftpboot/gentoo-sparc64-1.4_rc4-20040102.tftpboot \ 545# <i>/bin/ln -s /tftpboot/gentoo-sparc64-1.4_rc4-20040102.tftpboot \
546/tftpboot/0a00010f</i> 546/tftpboot/0A00010F</i>
547</pre> 547</pre>
548 548
549<p> 549<p>
550Now everything should be set for netbooting! 550Now everything should be set for netbooting!
551</p> 551</p>
552 552
553</body> 553</body>
554</section> 554</section>
555</chapter> 555</chapter>
556 556
557<chapter> 557<chapter>
558<title>Netbooting the client</title> 558<title>Netbooting the client</title>
559 559
560<section> 560<section>
561<body> 561<body>

Legend:
Removed from v.1.2  
changed lines
  Added in v.1.3

  ViewVC Help
Powered by ViewVC 1.1.20