Linux on the Sun JavaStation NC HOWTO

Robert S. Dubinski

2001-May-31

This is a HOWTO document describing how to enable the GNU/Linux OS on the Sun JavaStation NC.

Table of Contents

1. META Information

1.1. The Purpose of this Document

1.2. Acknowledgments

1.2.1. Document Contributors

1.3. History

1.4. Document Copyright and Licenses

1.5. Location of the Latest Version and Source

1.6. Reporting Bugs Found In or Additions to the HOWTO

1.7. TODO List for this HOWTO

2. What is a JavaStation?

2.1. What is a JavaStation NC?

2.2. Definition of an NC including the Differentiation from PC's

2.3. Description of the JavaStation Model Line including Hardware Specs

2.3.1. JavaStation-1 [ "Mr. Coffee"] ["the brick"] [Sun Option No. JJ-xx]
2.3.2. JavaStation-NC [" JavaStation-10"] [" Krups"] ["the tower"] ["the percolator"] [ Sun Option No. JK-xx]
2.3.3. JavaStation-E ["Espresso"] [Sun Option No. JE-xx]
2.3.4. JavaEngine-1 ["JE-1"]
2.3.5. The "Dover" JavaStation model
2.3.6. The Generation 3 "Super JavaStation"
2.3.7. The Pre-Mr. Coffee JavaStation Prototype
2.3.8. The Pre-Mr. Coffee JavaStation/Fox

2.4. Reasons for Running Linux and NC Myths Dispelled

2.5. Why JavaStations are No Longer Produced

2.6. Where to Purchase a JavaStation

3. Background Requirements for Linux on a JavaStation

3.1. Complete Hardware Requirements

3.2. Network Service Requirements

3.3. Understand the JavaStation Boot Sequence

3.4. Additional Software Requirements: Replacement Firmware ( PROLL)

3.5. Decide on your Filesystem: NFS-Root, or Embedded?

3.5.1. "NFS-Root" Filesystem
3.5.2. "Embedded-Root" Filesystem

3.6. Support Sites to Check Out: Zaitcev's Linux Site

4. Build Your Kernel

4.1. Before you begin

4.2. Make sure you use 32-bit mode

4.3. Supported Linux Kernel Versions

4.4. Required Kernel Configuration Options

4.5. Necessary Patch for "Embedded-Root" FS Configurations

4.6. Build the JavaStation-Ready Kernel

4.7. JavaStation-Ready Kernel Images, System.map and ".config" File Samples

4.7.1. Sample ".config" Files
4.7.2. Sample JavaStation-Ready Kernel Files
4.7.3. Outside kernel mirrors

5. Build A JavaStation-Ready FileSystem

5.1. Preparing Yourself to Build Your Own Filesystem

5.2. Contents of the "/etc/fstab" File

5.2.1. "NFS-Root" Filesystem fstab
5.2.2. "Embedded-Root" Filesystem fstab

5.3. The "Embedded-Root" Image Creation Procedure

5.4. Sample FileSystems

5.4.1. Outside Sample Filesystems

6. Set up Your Server

6.1. Preface
6.2. Setting up the RARP service
6.3. Setting up the DHCP service
6.4. Set up NFS service ("NFS-Root Options " Only)
6.5. Setting up for Boot with TFTP
6.6. The Last Configuration Step
6.7. What to See When Booting Linux

7. Troubleshooting

7.1. When booting, the message "The file just loaded does not appear to be executable." Why?
7.2. When booting, the message "no a.out magic" appears and halts the boot. Why?
7.3. I tried booting a Krups but JavaOS comes up. I don't even have JavaOS!
7.4. Cannot Boot an "Embedded-Root" image > 10 MB on my JavaStation. Why?
7.5. After Booting, Typing Anything Yields Garbage Characters. Why?
7.6. In X Sessions to a Solaris server, the font server "xfs" crashes. Why?
7.7. Performing Indirect XDMCP to a Solaris Server Results in Session Login Failures. Why?
7.8. TFTPd config doesn't work on SUSE. Why?

8. Answers to Miscellaneous Questions

8.1. Regarding RARP: Is it Needed or Not?
8.2. Can One Use the Smart Card Reader on the Espresso models?
8.3. Can One Use the Solaris DHCP server instead of ISC?
8.4. Can One Pass Arguments to "/sbin/init" in a Diskless Boot like This?
8.5. Enabling X on the JavaStation
8.6. Is There Mailing List Help?
8.7. Can One Boot a JavaStation from Onboard Flash Memory?
8.8. Does "Piggyback" work for the x86 too?
8.9. I put new memory in, but now it doesn't boot. Why?
8.10. Now that JavaStations work with Linux, what about other Free OSs?
8.11. Do the Linux 2.4 kernels work? What's the latest that works?
8.12. Can I compile the kernel on a non-SPARC machine?
8.13. Can I get an ok> prompt like other Sun equipment?
8.14. My keyboard isn't recognized. What can I do?
8.15. Proll reports "TFTP: ARP Timeout". Why?
8.16. Why Can't I Get TrueColor on Krups?
8.17. I followed this HOWTO, but my Dover doesn't work. Why?

9. Unanswered Questions

9.1. Where Can One Find Espressos for Sale?
9.2. Do Tools Exist to Configure Net Boot Entries Quickly?
9.3. What can one use the Krups Flash memory for?
9.4. Can framebuffer be loaded following a serial console initialization?

10. Miscellaneous Info

10.1. Mr. Coffee Jumper Info
10.2. Krups Jumper Info
10.3. JavaStation Press Release
10.4. JavaOS Download
10.5. Espresso IDE circuit
10.6. JavaStation Boot Monitoring Key Combinations
10.7. JavaStation Photo Gallery

A. GNU Free Documentation License

0. Preamble
1. Applicability and Definitions
2. Verbatim Copying
3. Copying in Quantity
4. Modifications
5. Combining Documents
6. Collections of Documents
7. Aggregation with Independent Works
8. Translation
9. Termination
10. Future Revisions of this License
How to use this License for your documents