mirror of https://github.com/tLDP/LDP
597 lines
18 KiB
XML
597 lines
18 KiB
XML
|
|
<sect1 id="MetaInfoChapter">
|
|
<title>META Information</title>
|
|
|
|
<para>
|
|
This section lists the meta-information of this document. The
|
|
hows, whys, location and changes to the structure of the document
|
|
are documented here. The main content begins in the next chapter.
|
|
</para>
|
|
|
|
|
|
<sect2 id="DocumentPurposeSection">
|
|
<title>The Purpose of this Document</title>
|
|
|
|
<para>
|
|
This document is to serve as a comprehensive HOWTO and <acronym>FAQ</acronym>
|
|
collection regarding the <productname>Sun JavaStation <acronym>NC</acronym>
|
|
</productname> and enabling the <application><acronym>GNU</acronym>/Linux
|
|
<acronym>OS</acronym> </application> on it.
|
|
</para>
|
|
|
|
<para>
|
|
The intended audience of this document is anyone who has an interest
|
|
in enabling <application>Linux</application> on the <productname>Sun
|
|
JavaStations</productname>. The document structure is laid out to
|
|
serve as either a top-to-bottom read for a newcomer, or as quick
|
|
reference on a single topic for advanced users. Pointers
|
|
to sample files submitted by users are included for
|
|
extremely hurried readers.
|
|
</para>
|
|
|
|
<para>
|
|
The author of this document is Robert Dubinski
|
|
<email>rsd@dubinski-family.org</email>. Robert is the former
|
|
computer technician and UNIX systems administrator for
|
|
<ulink url ="http://www.marquette.edu">Marquette University's</ulink>
|
|
<ulink url="http://www.mscs.mu.edu"> Math, Statistics and Computer
|
|
Science Department</ulink>, where he had
|
|
125 <productname>JavaStations</productname> running
|
|
<application>Linux</application>. These machines were
|
|
all configured using the information, techniques and files
|
|
presented in this document.
|
|
</para>
|
|
|
|
<para>
|
|
In early 1999, Eric Brower <email>ebrower@usa.net</email> wrote the
|
|
first informal HOWTO for the <productname>JavaStation</productname>. Parts
|
|
of this document are inspired by his work, and all unique information
|
|
presented there have since been merged into this document. Eric's
|
|
original mini-HOWTO is saved for posterity at:
|
|
<ulink
|
|
url = "http://dubinski-family.org/~jshowto/Files/texts/eric_brower_js_howto_19980218.txt">
|
|
http://dubinski-family.org/~jshowto/Files/texts/eric_brower_js_howto_19980218.txt
|
|
</ulink>
|
|
</para>
|
|
|
|
<para>
|
|
This HOWTO also aims to serve as a member document of the Linux Documentation
|
|
Project. The <acronym>LDP</acronym> can be reached at:
|
|
<ulink url="http://www.linuxdoc.org"> http://www.linuxdoc.org</ulink>
|
|
</para>
|
|
|
|
</sect2>
|
|
|
|
<sect2 id="DocumentAcknowledgementsSection">
|
|
<title>Acknowledgments</title>
|
|
|
|
<para>
|
|
Enabling <application>Linux</application> on the <productname>JavaStations
|
|
</productname>, and allowing this HOWTO to come to be would never have
|
|
been possible without the fine work of the following people:
|
|
</para>
|
|
|
|
<para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>
|
|
Pete Zaitcev <email>zaitcev@yahoo.com</email>
|
|
(Primary <productname>JavaStation</productname> kernel mod author)
|
|
</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>
|
|
Eric Brower <email>ebrower@usa.net</email>
|
|
(<application>XFree</application> mods and author of the original
|
|
embedded-build HOWTO)
|
|
</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>
|
|
Varol Kaptan <email>varol@ulakbim.gov.tr</email>
|
|
(made available his <productname>Krups</productname> images and patches.
|
|
Backported kernel support to 2.2.x series)
|
|
</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>
|
|
David Miller <email>davem@redhat.com</email>
|
|
(the original <application>Linux/SPARC</application> kernel porter)
|
|
</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>
|
|
The <application>Linux/SPARC</application> kernel porters and mailing list
|
|
</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>
|
|
The thousands of contributors to the <application>Linux kernel</application>
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</para>
|
|
|
|
<para>
|
|
The HOWTO author wishes to give a second thank-you to Pete
|
|
and Eric for their work:
|
|
</para>
|
|
|
|
<blockquote>
|
|
<attribution>Robert Dubinski, March 2000</attribution>
|
|
|
|
<para>
|
|
Pete got me going with <application>Linux</application> on the
|
|
<productname>JavaStation</productname> in December 1998, has
|
|
been the main kernel programmer adding in support for the
|
|
<productname>JavaStation</productname> line, and despite his busy
|
|
work schedule was nice enough to find time to answer all my email
|
|
queries for help over the last 15 months.
|
|
</para>
|
|
|
|
<para>
|
|
Eric worked on bringing <application>X</application> support to the
|
|
<productname>JavaStation</productname> when it had none.
|
|
He had been working on a dedicated server for the <productname>
|
|
JavaStation</productname> in early 1999, and kept me informed of
|
|
his progress. In mid-1999, he switched tactics and sent a working
|
|
framebuffer example to test out. He also wrote the first comprehensive
|
|
mini-HOWTO for the <productname>JavaStations</productname>,
|
|
answered my email questions, and got me interested in the embedded
|
|
solution which I employ here at Marquette.
|
|
</para>
|
|
|
|
<para>
|
|
Thank-you Pete and Eric!
|
|
</para>
|
|
|
|
</blockquote>
|
|
|
|
|
|
<sect3 id="DocumentContributorsSection">
|
|
<title>Document Contributors</title>
|
|
|
|
<para>
|
|
The following people have contributed to this specific document:
|
|
</para>
|
|
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>
|
|
Pete Zaitcev <email>zaitcev@yahoo.com</email>
|
|
(Proofreading and factual corrections of initial drafts)
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Eric Brower <email>ebrower@usa.net</email>
|
|
(Proofreading and factual corrections of initial drafts)
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Richard Tomlinson <email>Richard.Tomlinson@one2one.co.uk</email>
|
|
(Document reader, Krups tester, feedback)
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Michael R. Eckhoff <email>foobar@null.net</email>
|
|
(feedback on sample kernel)
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
John Bodo <email>sales_nospam@bodoman.com</email>
|
|
(JavaStation prototype info)
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Simon Whiting <email>Simon.Whiting@mysun.com</email>
|
|
(Typo Fix in DHCP config)
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Alex Cellarius<email>alexc@mail.systems104.co.za</email>
|
|
("Dover" info and pic)
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Matt Lowry<email>mclowry@cs.adelaide.edu.au</email>
|
|
(Suggestion of Boot Sequence Visuals Section)
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
David Tinker<email>david@hemtech.co.za</email>
|
|
(Dover model info)
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
David O'Brien<email>obrien@NUXI.com</email>
|
|
(Fox prototype info)
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Olaf Pueschel<email>olf@olmos.de</email>
|
|
(OBP info, true color info)
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Richard Tomlinson<email>richard@sysgen.co.uk</email>
|
|
(Boot monitoring key combinations)
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Zachary Drew<email>zach@math.umn.edu</email>
|
|
(Troubleshooting Suggestions)
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Robert Thornburrow<email>robert@tsac.fsnet.co.uk</email>
|
|
(non-SPARC piggyback info)
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Bill Childers<email>bill@nulldevice.net</email>
|
|
(Assorted Dover Info)
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Simon Kuhn<email>address_lost!</email>
|
|
(Donated a Sun4 for kernel builds)
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Nate Carlson<email>address_lost!</email>
|
|
(supplied pre-compiled kernels, but the HOWTO author lost the info during disk failures.)
|
|
</para>
|
|
</listitem>
|
|
|
|
</itemizedlist>
|
|
|
|
<para>
|
|
If you contributed a tidbit of info and are not listed, please email
|
|
the document author to get yourself listed. Everyone deserves recognition
|
|
helping this document evolve.
|
|
</para>
|
|
|
|
</sect3>
|
|
</sect2>
|
|
|
|
<sect2 id="DocumentHistorySection">
|
|
<title>History</title>
|
|
|
|
<para>
|
|
|
|
<revhistory id="revhistory">
|
|
|
|
<revision>
|
|
<revnumber>1.30</revnumber>
|
|
<date>31 Oct 2001</date>
|
|
<revremark>
|
|
Many major changes: restructured for better layout,
|
|
new chapters added, updated files and file pointers,
|
|
new master distribution location, source broken into
|
|
parts, new sample files, md5sums on all sample files,
|
|
overall update and proofread of materials. Thank-you
|
|
very much to Simon Kuhn for donating an old Sun4 to
|
|
enable more sample files be made. Thank-you also to
|
|
Nate Carlson for donating sample kernels (unfortunately
|
|
that info was lost during a disk crash...Nate, please
|
|
contact me.). If anyone contributed items between
|
|
May 31 and Oct 31 and it does not show up in this
|
|
revision, please resubmit it.
|
|
</revremark>
|
|
</revision>
|
|
|
|
<revision>
|
|
<revnumber>1.25</revnumber>
|
|
<date>30 Oct 2001</date>
|
|
<revremark>This is called the "@#!$?" release. It is
|
|
called such because there were some small-mid
|
|
size changes to the document which were lost
|
|
in a disk failure, prior to me re-uploading to
|
|
the LDP site. To give you an idea of how bad
|
|
the situation was, the last version I had on
|
|
backup was in Docbook SGML, while I had switched
|
|
to Docbook XML many months prior. Simply put,
|
|
any contributed changes or email contacts I had
|
|
with contributors were lost, and are hopefully on
|
|
their way back in with this release. If you
|
|
contributed something, and it disappeared, please
|
|
contact me immediately, and it'll get back in. --RSD
|
|
</revremark>
|
|
</revision>
|
|
|
|
|
|
<revision>
|
|
<revnumber>1.22</revnumber>
|
|
<date>31 May 2001</date>
|
|
<revremark>Changed file links, some sample file formats,
|
|
and clarified info relating to the sample files,
|
|
following requests on the sparclinux mailing list.
|
|
</revremark>
|
|
</revision>
|
|
|
|
<revision>
|
|
<revnumber>1.20</revnumber>
|
|
<date>08 May 2001</date>
|
|
<revremark>Information Refresh up to the current date,
|
|
and change to GNU Free Documentation License 1.1
|
|
</revremark>
|
|
</revision>
|
|
|
|
<revision>
|
|
<revnumber>1.15</revnumber>
|
|
<date>01 May 2001</date>
|
|
<revremark>Migrate source to DocBook XML 4.12</revremark>
|
|
</revision>
|
|
|
|
<revision>
|
|
<revnumber>1.13</revnumber>
|
|
<date>02 Feb 2001</date>
|
|
<revremark>Minimal Bugfixes</revremark>
|
|
</revision>
|
|
|
|
<revision>
|
|
<revnumber>1.12</revnumber>
|
|
<date>29 Dec 2000</date>
|
|
<revremark>Additional info on the "Fox" model</revremark>
|
|
</revision>
|
|
|
|
<revision>
|
|
<revnumber>1.11</revnumber>
|
|
<date>23 Nov 2000</date>
|
|
<revremark>Krups truecolor blurb, removed one acknowlegement per email request</revremark>
|
|
</revision>
|
|
|
|
<revision>
|
|
<revnumber>1.1</revnumber>
|
|
<date>15 Nov 2000</date>
|
|
<revremark>Numerous updates and additions
|
|
revisions</revremark>
|
|
</revision>
|
|
|
|
<revision>
|
|
<revnumber>1.05</revnumber>
|
|
<date>16 Jun 2000</date>
|
|
<revremark>Requested Format Changes and Fixes</revremark>
|
|
</revision>
|
|
|
|
<revision>
|
|
<revnumber>1.04</revnumber>
|
|
<date>13 Jun 2000</date>
|
|
<revremark>Suggested Fixes and Added Requests</revremark>
|
|
</revision>
|
|
|
|
<revision>
|
|
<revnumber>1.03</revnumber>
|
|
<date>04 May 2000</date>
|
|
<revremark>Minor Fixes, Requests</revremark>
|
|
</revision>
|
|
|
|
<revision>
|
|
<revnumber>1.02</revnumber>
|
|
<date>28 Apr 2000</date>
|
|
<revremark>Small fixes.</revremark>
|
|
</revision>
|
|
|
|
<revision>
|
|
<revnumber>1.01</revnumber>
|
|
<date>25 Apr 2000</date>
|
|
<revremark>"Brown Paper Bag" Revision.</revremark>
|
|
</revision>
|
|
|
|
<revision>
|
|
<revnumber>1.0</revnumber>
|
|
<date>24 Apr 2000</date>
|
|
<revremark>First submission to the LDP.</revremark>
|
|
</revision>
|
|
|
|
<revision>
|
|
<revnumber>0.9</revnumber>
|
|
<date>18 Apr 2000</date>
|
|
<revremark>Continued reorganization and final merges.
|
|
</revremark>
|
|
</revision>
|
|
|
|
<revision>
|
|
<revnumber>0.7</revnumber>
|
|
<date>15 Apr 2000</date>
|
|
<revremark>Migration from LinuxDoc DTD to Docbook DTD.
|
|
</revremark>
|
|
</revision>
|
|
|
|
<revision>
|
|
<revnumber>0.71</revnumber>
|
|
<date>14 Apr 2000</date>
|
|
<revremark>Received word doc was forwarded inside Sun.
|
|
</revremark>
|
|
</revision>
|
|
|
|
<revision>
|
|
<revnumber>0.7</revnumber>
|
|
<date>14 Apr 2000</date>
|
|
<revremark>Linked on Metabyte Website.
|
|
</revremark>
|
|
</revision>
|
|
|
|
<revision>
|
|
<revnumber>0.6</revnumber>
|
|
<date>9 Apr 2000</date>
|
|
<revremark>First semi-public release.
|
|
</revremark>
|
|
</revision>
|
|
|
|
<revision>
|
|
<revnumber>0.4</revnumber>
|
|
<date>24 Mar 2000</date>
|
|
<revremark>First move to comprehensive HOWTO.
|
|
</revremark>
|
|
</revision>
|
|
|
|
<revision>
|
|
<revnumber>0.2</revnumber>
|
|
<date>15 Oct 1999</date>
|
|
<revremark>More notes collected and merged.
|
|
</revremark>
|
|
</revision>
|
|
|
|
<revision>
|
|
<revnumber>0.1</revnumber>
|
|
<date>24 Jun 1999</date>
|
|
<revremark>Initial scraps put together.
|
|
</revremark>
|
|
</revision>
|
|
|
|
</revhistory>
|
|
|
|
</para>
|
|
|
|
</sect2>
|
|
|
|
|
|
<sect2 id="DocumentCopyrightSection">
|
|
<title>Document Copyright and Licenses</title>
|
|
|
|
<blockquote><para>
|
|
Copyright (c) 1999-2001 Robert S. Dubinski.
|
|
Permission is granted to copy, distribute and/or modify this document
|
|
under the terms of the GNU Free Documentation License, Version 1.1
|
|
or any later version published by the Free Software Foundation;
|
|
with the Invariant Sections being: "Why JavaStations are No Longer
|
|
Produced", with one Front-Cover Text: "Linux on JavaStation HOWTO",
|
|
and with one Back-Cover Text: "This document was written
|
|
by Robert S. Dubinski in the hope that more people can put
|
|
their JavaStation hardware to good use. Thank-you to the
|
|
Linux kernel hackers who made this happen, and thank-you to
|
|
Sun for a rock-solid piece of hardware." A copy of the
|
|
license is included in the section entitled
|
|
"GNU Free Documentation License".
|
|
</para></blockquote>
|
|
|
|
<para>
|
|
The document author makes <emphasis>no</emphasis> warranties that all
|
|
the information presented here is completely accurate, and cannot be
|
|
held liable to any loss you experience as a result of the information
|
|
you use from here.
|
|
</para>
|
|
|
|
<para>
|
|
Best efforts have been made to ensure everything included is accurate as
|
|
of the publication date listed at the beginning of this document, but
|
|
there is always a possibility something may be wrong. In this case,
|
|
doublecheck with alternative sources first before considering implementing
|
|
anything at a production-level. If you find something wrong, drop the author
|
|
a line at <email>rsd@dubinski-family.org</email> or send a patch to the
|
|
document source, and corrections will be made immediately.
|
|
</para>
|
|
|
|
<para>
|
|
This document is an official member document of
|
|
the <ulink url="http://www.linuxdoc.org"> Linux Documentation Project</ulink>.
|
|
</para>
|
|
|
|
</sect2>
|
|
|
|
|
|
<sect2 id="DocumentLocationSection">
|
|
<title>Location of the Latest Version and Source</title>
|
|
|
|
<para>
|
|
The latest online version of this document can be found at:
|
|
<ulink url="http://dubinski-family.org/~jshowto">
|
|
http://dubinski-family.org/~jshowto</ulink>
|
|
.
|
|
</para>
|
|
|
|
<para>
|
|
The pre-processed <acronym>XML</acronym> source to this document, written
|
|
to the Docbook <acronym>DTD</acronym>, version 4.1.2, is available from:
|
|
<ulink
|
|
url="http://dubinski-family.org/~jshowto/doc/src/"
|
|
>http://dubinski-family.org/~jshowto/doc/src/</ulink>
|
|
</para>
|
|
|
|
<para>
|
|
The pre-processed <acronym>XML</acronym> source to the GNU Free Documentation
|
|
License, written to the Docbook <acronym>DTD</acronym>, and which this
|
|
document is licensed under, is available from:
|
|
<ulink
|
|
url="http://dubinski-family.org/~jshowto/doc/src/gfdl.xml"
|
|
>http://dubinski-family.org/~jshowto/doc/src/gfdl.xml</ulink>
|
|
</para>
|
|
|
|
<para>
|
|
Copies of this document are also available from the Linux Documentation
|
|
Project at: <ulink url="http://www.linuxdoc.org/HOWTO/JavaStation-HOWTO/">http://www.linuxdoc.org/HOWTO/JavaStation-HOWTO</ulink>.
|
|
</para>
|
|
|
|
<para>
|
|
This project used to be available at the URL
|
|
'http://javastation-howto.homeip.net'. In Spring 2001, homeip.net
|
|
discontinued their free service and moved to a fee based scheme.
|
|
Given the hundreds of mirrors of LDP documents, I do not find
|
|
the fees justifiable. I have changed all references in this document back to
|
|
my home server. Between my server's address, <ulink url=
|
|
"http://dubinski-family.org/~jshowto">
|
|
http://dubinski-family.org/~jshowto</ulink>,
|
|
the LDP website, and its hundreds of mirrors, you should be able to always
|
|
find the JavaStation-HOWTO. If this is not the case, email me immediately
|
|
at either <email>rsd@dubinski-family.org</email> or
|
|
<email>dubinski@mscs.mu.edu</email>.
|
|
</para>
|
|
|
|
</sect2>
|
|
|
|
|
|
<sect2 id="ReportingHOWTOBugs">
|
|
<title>Reporting Bugs Found In or Additions to the HOWTO</title>
|
|
|
|
<para>
|
|
Any problems or concerns about the HOWTO should be reported via email
|
|
to the author, Robert Dubinski, at <email>rsd@dubinski-family.org</email>.
|
|
Do <emphasis>NOT</emphasis> send document bug reports to the
|
|
SparcLinux mailing list, the debian-sparc mailing list, or the Linux
|
|
Documentation Project. The folks on there really do not care about my
|
|
typos or server misconfigurations, so please don't trouble them.
|
|
</para>
|
|
|
|
</sect2>
|
|
|
|
<sect2 id="TODO">
|
|
<title>TODO List for this HOWTO</title>
|
|
|
|
<orderedlist>
|
|
|
|
<listitem>
|
|
<para>
|
|
As NetBSD now supports JavaStations as well, it would be good
|
|
to talk about support and sample files for it too.
|
|
</para>
|
|
</listitem>
|
|
|
|
</orderedlist>
|
|
|
|
</sect2>
|
|
|
|
</sect1>
|
|
|