home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #27 / NN_1992_27.iso / spool / comp / sys / att / 2537 < prev    next >
Encoding:
Internet Message Format  |  1992-11-20  |  61.8 KB

  1. Xref: sparky comp.sys.att:2537 news.answers:4108
  2. Newsgroups: comp.sys.att,news.answers
  3. Path: sparky!uunet!zaphod.mps.ohio-state.edu!cs.utexas.edu!uwm.edu!linac!uchinews!machine!ddsw1!gagme!gagme!greg
  4. From: greg@gagme.chi.il.us (Gregory Gulik)
  5. Subject: AT&T 3B2 (and related) Frequently Asked Questions and Answers
  6. Message-ID: <1992Nov20.232227.10450@gagme.chi.il.us>
  7. Followup-To: comp.sys.att
  8. Originator: greg@gagme
  9. Lines: 1591
  10. Sender: usenet@serveme.chi.il.us
  11. Organization: GAGME Public Access UNIX, Chicago, Illinois, USA
  12. Date: Fri, 20 Nov 1992 23:22:27 GMT
  13. Approved: news-answers-request@MIT.Edu
  14.  
  15. Archive-name: 3b2-faq
  16.  
  17.               AT&T 3B2 FREQUENTLY ASKED QUESTIONS
  18.  
  19. This article contains the answers to many Frequently Asked Questions
  20. (FAQ) often posed to the net. It is posted because the same questions
  21. pop up time after time. This will hopefully help out by not having
  22. these questions posted over and over, and help new users know what
  23. questions there are to ask in the first place! 8^)
  24.  
  25. This article includes answers to the following questions.  Much of the
  26. information included in this article is compatible with the 3B2 series
  27. of WE32000 series based computers.
  28.  
  29. First, the questions:
  30.  
  31. Subject:  0 SPECIAL NOTE
  32. Subject:  1 How do I install a second ST-506 drive on my 3B2?
  33. Subject:  2 How do I create a second swap partition?
  34. Subject:  3 How can I get X11 for the 3B2?
  35. Subject:  4 How do I install a non AT&T SCSI drive on my 3B2?
  36. Subject:  5 How do I prevent data overrun errors when using a high
  37.             speed modem on an EPORTS card at 19.2K baud or higher?
  38. Subject:  6 What does the 'NOTICE: File Table Overflow' error mean?
  39. Subject:  7 How do I set up anonymous ftp?
  40. Subject:  8 Is there a reposity of ftp-able 3B2 programs?
  41. Subject:  9 How do I run Unix from floppy (for example, to repair a damage
  42.             hard drive file system)?
  43. Subject: 10 What is/was the 3B Journal?
  44. Subject: 11 What are the various models of 3B2s and their differences?
  45. Subject: 12 How do I build GCC on the 3B2?
  46. Subject: 13 What is the NVRAM SANITY FAILURE?
  47. Subject: 14 Is there an implementation of SLIP for the 3B2?
  48. Subject: 15 What are the known bugs in the Wollongong WIN TCP software?
  49. Subject: 16 Is there an implementation of NFS for the 3B2?
  50.  
  51. Now, the answers:
  52.  
  53.  
  54. ------------------------------------------------------------------------------
  55. Subject:  0 SPECIAL NOTE
  56. ------------------------------------------------------------------------------
  57.  
  58. If you are going to be at all serious about the 3B2, and especially if
  59. you are relying on yourself for maintenance, the first thing you want
  60. to do is obtain the AT&T 3B2 Computer Maintenance Manual.
  61.  
  62. It contains diagrams of all 3B2 computers up to the 3B2/600, parts
  63. lists, breakdown procedures, troubleshooting information, and sources
  64. of additional documentation.
  65.  
  66. In addition, it contains the "3B2 Computer Maintenance Utilities"
  67. diskette called "idtools" (formerly known as "devtools").  This floppy
  68. is bootable, and once running, the following options are available:
  69.  
  70.         > format floppy diskettes
  71.         > format hard disk drives
  72.         > verifies hard disk format
  73.         > disk-to-disk high speed copies
  74.         > disk-to-disk copy by sectors
  75.         > disk-to-memory copies
  76.         > defect table builder
  77.         > writes sanity track
  78.         > change default boot information
  79.  
  80. While some of these options are also available from UNIX, all the
  81. utilities here can be run on a machine with a damaged (or missing) hard
  82. disk, often allowing the drive to be repaired that is otherwise
  83. unbootable.
  84.  
  85. This manual and disk can be ordered from the AT&T Customer Information
  86. Center in Indianapolis, IN.  It has select code 305-395, and at press
  87. time it sold for about $125.  The AT&T CuIC can be reached at:
  88.  
  89.     (800) 432-6600    Continental US
  90.     (317) 322-6556    elsewhere
  91.  
  92. The CuIC takes phone orders with a credit card, and with a purchase
  93. order for qualifying companies.  They have many other UNIX-related
  94. books as well, so be sure to ask for their free "AT&T Documentation
  95. Guide", select code 000-011.
  96.  
  97. ------------------------------------------------------------------------------
  98. Subject:  1 How do I install a second ST-506 drive on my 3B2?
  99. ------------------------------------------------------------------------------
  100.  
  101. Copyright 1989 by Owens-Laing Publications.
  102.  
  103. Title:  Disk Expansion on the 3B2
  104. Author: Stephen Friedl (friedl@mtndew.Tustin.CA.US)
  105. Issue:  3B Journal, 4Q 1989
  106. [Edited by Gregory Gulik]
  107.  
  108. [ conventions are:  *bold* and _italics_ ]
  109.  
  110.  Introduction
  111.  ------------
  112.  
  113. The 3B2/400 family (/300, /310 and /400) computers use standard MFM
  114. disk drives, and it is possible to add or replace these drives yourself
  115. -- in this article we show you how to do this.
  116.  
  117. The 3B2/500 and larger machines all have SCSI (Small Computer Systems
  118. Interface) disk drives, so these instructions do not apply to them.
  119. For the duration of this article, "3B2" means the 3B2/400 and below,
  120. and in the case where there are differences among these included models
  121. we will mention them.
  122.  
  123. Before doing any drive replacement, you must obtain the _3B2 Computer
  124. Maintenance Reference Manual_ from AT&T.  This document contains quite
  125. a bit of useful information about your 3B2 hardware, and it is helpful
  126. in its own right.  What makes it so special is the "idtools" diskette
  127. that comes with it.  This floppy disk contains numerous utilities that
  128. will help you diagnose and troubleshoot your computer, as well as the
  129. disk formatting tools we need for our expansion project.
  130.  
  131.  What we don't tell you
  132.  ----------------------
  133.  
  134. This is a fairly technical topic, and it relies on substantial
  135. knowledge of UNIX system administration.  Those steps directly related
  136. to the formatting operation are covered here, but others such as backup
  137. and restore from tape, disk space allocation, and rebooting the machine
  138. are prerequisite knowledge.  AT&T's sysadm documentation covers a great
  139. deal of it, but if these things are new to you, perhaps you're not
  140. ready to give this a go just yet.
  141.  
  142. Please keep in mind that if this is not done correctly (especially the
  143. backups), you could lost most or all of your computer's data in a very
  144. short time.  You must have at least one full, verified backup of all
  145. filesystems, with _two_ backups being safer.  In addition, it is a good
  146. idea to try this during an off time when you can afford to be down for
  147. while if things don't go so well.
  148.  
  149. Finally, we have tried to present this information as accurately and
  150. clearly as we can, but we cannot guarantee that there are no bugs.
  151. Check everything, verify steps with the manual, and ask a local wizard
  152. if you get stuck.  Of course, you undertake this procedure at your own
  153. risk.
  154.  
  155.  Selecting a drive
  156.  -----------------
  157.  
  158. There are many drives on the market that are satisfactory, and we
  159. present some guidelines here for selecting one.  We have our favorites,
  160. but most available ST-506 drives can be used in the 3B2.  Note that
  161. these are suggestions only, not endorsements or guarantees of
  162. compatibility.
  163.  
  164. The first restriction is that the idtools software will not format more
  165. than 1024 cylinders in a single drive, and a drive with more will
  166. simply have the excess cylinders ignored.  This is an unfortunate but
  167. unavoidable waste of disk space, giving us a practical limit of about
  168. 135Mbyte.  (15 heads x 1024 cyls x 18 blks/track x 512 bytes/block).
  169.  
  170. Most of the drives found in the original 3B2 are made by Control Data
  171. (or their subsidiary, Imprimis), and these Wren II drives are of
  172. excellent quality, and they represent a very safe route.  These drives
  173. are available with formatted capacities of 30 and 72 megabytes, and
  174. they have an average access time of about 28 msec.  Other brands known
  175. to work include Maxtor, Miniscribe, Priam, Micropolis and others.  Some
  176. of these drives have more than 1024 cylinders which allows them to be
  177. used, but at less than their advertised capacity.
  178.  
  179.  Disk types and the Equipped Device Table
  180.  ----------------------------------------
  181.  
  182. Each drive in the 3B2 is formatted with a _disk type_, which is a small
  183. number that identifies the drive to the machine.  The disk type indexes
  184. into a table of drive information, and this table is part of the
  185. /dgn/edt_data file.  This file is used to fill the Equipped Device
  186. Table, a list of currently-available hardware devices maintained by the
  187. firmware.  Part of this list, the _subdevice table_, describes the
  188. possible hard disk drives.
  189.  
  190.  Getting started
  191.  ---------------
  192.  
  193. Now that the formatting tools have arrived and a drive has been
  194. obtained, we are ready to do the installation.  It is at this point
  195. that a full backup of the entire system is in order and to review the
  196. relevent portions of the Maintenance Manual.
  197.  
  198. After backing up the current drives, shut down the machine, turn off
  199. the power, and remove the power plug.  Open the case, note the current
  200. configuration of the drive cables, and remove them along with the power
  201. connectors.
  202.  
  203. Select "drive 0" on the drive select jumpers, insert/enable the
  204. terminating resistor, and place the drive back in the cage.  Connect
  205. drive zero's data cable (the thin ribbon cable), the last connector on
  206. the wide control cable, and the power cable to the rear of the drive.
  207. Pay particular attention to pin one orientation, and insure that all
  208. connections are snug.
  209.  
  210. At this point you are ready to turn on the machine.  Plug in the 3B2
  211. power cable and turn the switch to "ON".  The console should show a
  212. SELF CHECK, followed shortly by
  213.  
  214.     FW ERROR 1-02: DISK SANITY FAILURE
  215.                EXECUTION HALTED
  216.  
  217.     SYSTEM FAILURE: CONSULT YOUR SYSTEM ADMINISTRATION UTILITIES GUIDE
  218.  
  219. This ominous message is actually expected, and it just means that the
  220. disk drive is not formatted yet.  At this point, type your current
  221. firmware password (usually "mcp") followed by RETURN, and you will be
  222. presented with the normal firmware menu.
  223.  
  224. At this point you should boot "/idtools" from the floppy drive (load
  225. device 0, FD5).  Once booted, idtools displays an informational message
  226. and asks that RETURN be hit.
  227.  
  228. Note that this entire process is covered in Appendix B of the
  229. Maintenance Reference Manual, and we strongly recommend that you review
  230. sections
  231.  
  232.     Hard Disk Formatter (B-8),
  233.     Defect Table Builder (B-33), and
  234.     Writing Sanity Track (B-47)
  235.  
  236. plus the introduction before continuing.
  237.  
  238.  Running Idtools
  239.  ---------------
  240.  
  241. At the first menu, "formhard" should be entered.  It will ask which disk
  242. should be formatted, and the proper response is zero in most cases.  If
  243. you are doing this procedure on a machine with two drives installed, be
  244. _very_ careful when answering this question.
  245.  
  246. Next, you are asked for drive configuration information.  You must
  247. enter the drive type (from a previous section) plus the drive
  248. dimensions, and the following table summarizes several models we know
  249. about.  If your drive is not shown, consult your vendor documentation
  250. for this information.
  251.  
  252. Drive type    drv id    cyls trk/cyl sec/trk byte/cyl     abbrev
  253. --------------- ------    ---- ------- ------- --------      ------
  254. Wren II 30MB       3     697     5    18    512       HD30
  255. Wren II 72MB       5     925     9    18    512       HD72
  256. Fujitsu M2243AS       8     754    11      18      512       HD72C
  257. Micropolis 1325    5    1024     8      18      512       HD72
  258. Maxtor 1140       4*     918    15    18    512       HD120
  259. Maxtor 1190      11    1224+   15    18    512       HD135
  260. Miniscribe XXXX    4*
  261. Priam XXXX
  262.  
  263. * selected by user
  264. + can only use 1024 cylinders on this drive
  265.  
  266. Note that "tracks/cylinder" means "heads", and the sectors/track and
  267. bytes/cylinder values the same for all drives.  The drive ID is shown
  268. as 4 for high-capacity drives, and it assumes that this number was
  269. inserted into the Equipped Device Table subdevice listing.
  270.  
  271. In the following examples, user responses are in *bold*, and the drive
  272. shown is a Maxtor 1140.  Note that the default entries shown may vary
  273. from machine to machine.
  274.  
  275.     Format which disk [ 0 or 1 ] (0)?  *0*
  276.  
  277.     Drive id: 3- ? *4*
  278.     Number of cylinders: 687 - ?  *918*
  279.     Numbers tracks/cyl: 5 - ?  *15*
  280.     Number sectors/track: 18 - ? *18*
  281.     Number bytes/sector: 512 - ? *512*
  282.  
  283. Once these values have been entered, idtools shows where it will place
  284. various housekeeping areas on the disk, almost all stored on the first
  285. two cylinders.  You need not concern yourself with the specific values
  286. printed.
  287.  
  288.  Defect Mapping
  289.  --------------
  290.  
  291. The bad block listing (with various alternate names, such as "Flag
  292. Track Log") is usually found on a sticker on top of the drive.  To
  293. simplify data entry, it is a good idea to photocopy this sticker while
  294. it is on the drive, because later the drive might not be in such a
  295. comfortable reading position (especially if it is in a drive cage).
  296.  
  297. The first prompt in this section asks if the backup defect table should
  298. be modified.  A formatted drive normally has two copies of the defect
  299. table on disk in case one is lost, but a blank drive has no such
  300. table.  Answering "yes" to this question means that the data you enter
  301. here is stored in both places.
  302.  
  303. To enter the defects, enter "new" when asked, then "bc" for the type of
  304. defect byte count.  Then, for each bad sector, enter the cylinder
  305. number, the head number, and the byte count, all separated by spaces.
  306. This "byte count" field is often shown on the disk label as "BFIND"
  307. (bytes from index) or "BCAI" (byte count after index), and it is
  308. distinct from the sector number.  Most entries have a block length of
  309. one, but if the label shows more than this then it must be the fourth
  310. field on the line.
  311.  
  312. An entry of "q" terminates the input, and displays the entire list of
  313. blocks entered.  It is vital that this list be checked completely, and
  314. edits made if necessary.  An entry of just a RETURN accepts the current
  315. list and moves onto the next prompt.
  316.  
  317.                Format entire disk - type 1
  318.               Format single track - type 2
  319.     Format from selected track to end - type 3
  320.  
  321.     Select type of format [1, 2, or 3] (1) ?
  322.  
  323. Entering "1" followed by RETURN starts the formatting process, and when
  324. it completes it starts a verify pass where all blocks on the disk are
  325. examined for errors.  This operation can take some time on a large
  326. drive, and idtools shows its progress with a message displayed every
  327. five cylinders formatted.
  328.  
  329. After the format and verify, idtools writes the "sanity track" with the
  330. "fixdisk" program.  The sanity track contains a special data pattern
  331. that validates the drive to the 3B2, and it takes just a moment and
  332. requires no input from you.
  333.  
  334. With the conclusion of the fixdisk operation the drive is formatted.
  335. You can remove the idtools floppy and power the machine down.
  336.  
  337.  Closing up the machine
  338.  ----------------------
  339.  
  340. The machine should now be put back together and the original drives
  341. reinstalled.  It is important that all drive selects and terminating
  342. resistors be installed properly, following the rules mentioned
  343. previously.
  344.  
  345. The first drive in the machine has the lowest drive select jumper
  346. (usually position zero) and connected to the zero data cable (usually
  347. the bottom drive).  The second drive in the machine has the next drive
  348. select (usually position one) and the other data cable, and the control
  349. cable connects them both.  The drive that is at the physical end of the
  350. control cable must have the terminating resistor.
  351.  
  352. Disk drives installed into an XM expansion module have special rules on
  353. termination, and these are documented and diagramed on pages 6-23 and
  354. 6-24 of the Maintenance Reference Manual.
  355.  
  356.  Partitioning the drive
  357.  ----------------------
  358.  
  359. The easiest case is adding a second drive to a machine that previously
  360. had only one.  After installing the new unit, boot /unix from the hard
  361. drive and enter single-user mode (this is much easier if you have
  362. edited /etc/inittab).
  363.  
  364. With the /usr partition mounted, run the "sysadm" command, and at each
  365. successive menu, enter "diskmgmt", "harddisk", and "partitioning" in
  366. turn.  This enters the partitioning operation and it should prompt you
  367. for the relevant information.  We do not discuss strategies for
  368. allocating filesystem resources, as this is covered in the AT&T system
  369. administrative documentation.
  370.  
  371. Once the drive is partitioned, the added filesystems (say, /usr2 and
  372. /usr3) may be used immediately.
  373.  
  374. All other cases involve replacing existing drives, and it most
  375. expedient to use the full restore procedure for this.  A full backup is
  376. absolutely required here for this operation, and it should be verified
  377. once it is made.
  378.  
  379. Boot the "Essential Utilities - Disk 1" floppy and select the "Full
  380. Restore" operation.  This procedure includes a partitioning step that
  381. allows you to allocate your new disk resources.  Follow the
  382. instructions shown on the screen.
  383.  
  384. After the core set of floppies -- five or six disks -- you can
  385. interrupt this process, boot /unix from the hard disk, and restore all
  386. of your backups.  You may have to install the Cartridge Tape Utilities
  387. if your backups are stored on that medium.
  388.  
  389. WARNING: This "full restore" operation destroys all data on all hard
  390. disks during the partitioning, and you _must_ have a full set of
  391. reliable, verified backups before considering this step, and two full
  392. sets of backups would not be a bad idea.  If these backups are not done
  393. properly, all data on the disks will be LOST.  Please be very careful
  394. when doing this, as mistakes can be costly.
  395.  
  396.  Compatibility note
  397.  ------------------
  398.  
  399. Some early models of the 3B2/300 do not permit a 72MB hard drive to be
  400. added to the system board.  The recognizing signs for this restriction
  401. are documented in the Maintenance Reference Manual on page 7-21, and
  402. 3B2/300 owners should consult this information before starting this
  403. project.
  404.  
  405. While the documentation does not mention the reason for this
  406. restriction, we speculate that any drive with more than eight heads
  407. cannot be used in these older machines.
  408.  
  409. ------------------------------------------------------------------------------
  410. Subject:  2 How do I create a second swap partition?
  411. ------------------------------------------------------------------------------
  412.  
  413. These are the steps I used to add a second swap partition to my
  414. 3B2/400.  Why add a second  swap area?   By default, the SVR3.1
  415. system disks (the version I use) make one swap area of 10196 blocks
  416. on the first hard disk (/dev/rdsk/c1d0s1).  While this 5Mb area
  417. seems plenty for most uses, I managed to exhaust it.  It was time to
  418. RTFM.  While the manual gives you the confidence to say that you *can*
  419. increase the number of swap partitions, it doesn't clearly tell you
  420. exactly how to go about doing that.  What follows are the steps you
  421. can follow to add another swap partition to your system.
  422.  
  423. Are you adding this swap space "just to balance the load"?  If so,
  424. forget it.  The effect is negligible and clearly not worth the effort.
  425. I have been unsuccessful in conclusively proving whether or not SVR3.1
  426. does perform balanced allocation of the swap space.  It seems to knock
  427. a huge chunk off the first partition before it even touches the second
  428. one.  I would not think of doing this unless you have SVR3.1 or
  429. SVR3.2.  Earlier versions do not have the advanced swap handling
  430. functions, and may not even allow you to do this.  Upgrade time.
  431. The only reason to add another swap partition is if you have a valid
  432. reason to do so (i.e. you have exhausted your present swap space).
  433. Remember that swap cannot be used for anything else, you take space
  434. away from your mountable filesystems when you add swap space.
  435.  
  436. Please keep in mind that this is *your* system, and these steps can
  437. easily wipe out all your data files.  Take adequate care to back
  438. up your data.  Make sure your backups work before you start any of this.
  439.  
  440. IT IS STRONGLY RECOMMENDED THAT YOU HAVE A PAPER COPY OF THESE
  441. DIRECTIONS IN FRONT OF YOU AS YOU PERFORM THIS TASK.
  442.  
  443. Step 0: BACK UP THE SYSTEM!  I cannot stress this enough.
  444.         If you have a tape drive, use that in preference over the
  445.     floppy drive.  Back up the /, /usr, and /usr2 partitions.
  446.     While it is not mandatory, it's also a good idea to back up
  447.     everything else just in case catastrophe strikes.  Expect the
  448.     worst and hope for the best.
  449.  
  450. Step 1: Reload the Foundation floppies and select a custom partition
  451.         setup.  Pick the sizes you want for the new swap partitions.
  452.     Since you are adding a second swap partition, it is up to you
  453.     if you wish to add to (or keep) the original 5Mb swap
  454.     partition.  It is mandatory that you keep *some* swap space on
  455.     the first disk.  There is no rule that says the 2 partitions must
  456.     be equal in size.  Finish the full restore.
  457.  
  458.     For Your Information: the sizes of the partitions are
  459.     dependent on the number of blocks per cylinder group.  That
  460.     means, you can specify size in units of (18 * number of
  461.     heads).  If you specify a number that is not a round figure,
  462.     the machine will round it for you.  RECORD THIS NUMBER!!!
  463.     This new partition will be named /usrX (where X is a positive
  464.     integer) and there will be a filesystem made upon it.  Do not worry.
  465.  
  466. Step 2: Bring up unix, log in as root, and bring the machine to runlevel 1.
  467.         When the machine is in single-user mode, make sure that all
  468.     disk partitions are unmounted (except for the root partition!)
  469.  
  470. Step 3: Make a temporary file with the existing partition data:
  471.  
  472.         # prtvtoc /dev/rdsk/c1d1s6 > /tmp/disk.data
  473.  
  474. Step 4: Edit the disk.data file.  Make the following changes:
  475.         change the tag field from 0 to 3 (from 'user' to 'swap')
  476.         change the flags from 00 to 01 (unmountable partition)
  477.         delete all the initial comments (lines with initial *'s)
  478.     Double check this file to make sure you got it right
  479.  
  480. Step 5: Save this data back to the hard disk.  If you choose to chicken
  481.         out, do it BEFORE THIS STEP:
  482.  
  483.         # fmthard -s /tmp/disk.data /dev/rdsk/c1d1s6
  484.  
  485. Step 6: Edit /etc/fstab to remove the reference to the now defunct
  486.         filesystem.  You don't have to do anything else to the actual
  487.     partition to remove the filesystem - the system will page over
  488.     the superblock and inode lists by itself.
  489.  
  490. Step 7: Use /etc/swap to tell the system that the partition is ready
  491.         for paging/swapping.  The best way to do this is to make the
  492.     system add this partition each time it boots.  Create a file
  493.     called /etc/rc2.d/S00SETSWAP.  Link it to the file
  494.     /etc/init.d/S00SETSWAP.  In this file, add the following line:
  495.  
  496.     /etc/swap -a /dev/dsk/c1d1sYY 0 XXXXX
  497.  
  498.     In this case, the Y's in the disk name should be set to the
  499.     disk partition that the new swap space is to be located on.
  500.     Usually, this is partition 8 (if you specified the swap space
  501.     as the first partition on the disk before /usr).  The 0 (zero)
  502.     signifies that swap activity is to start at the 0th block of
  503.     the partition - the start.  Replace the XXXXX with the number
  504.     of blocks available in the partition.  This is the number you
  505.     recorded in Step 1 above.
  506.  
  507. Step 8: Reboot and pray.  If it all went well, the machine will come
  508.         up in multi-user mode.  Once again, log in as root and bring
  509.     the machine down to single-user state.  Make sure that the
  510.     system is actually using the new partition with the 
  511.  
  512.     # /etc/swap -l
  513.  
  514.     command.  You should see the original swap partition
  515.     (/dev/dsk/c1d0s1) as well as your new partition listed.
  516.  
  517.     If your machine did not boot for some bizarre reason, reload
  518.     the system again (go to step 1), making sure that you do
  519.     everything correctly.
  520.  
  521. Step 9: Restore your data.  If you backed up on floppy, just restore
  522.         them in order and reboot.  If you backed up on a CTC tape drive,
  523.         you must install the Cartridge Tape Utilities disk, reboot,
  524.         recover your data, and reboot one last time.  IF you didn't back
  525.         up your data, then you're SOL.
  526.  
  527.         A note to those with XDC and SCSI drives - the maneuvers you
  528.         have just completed only messed up the data on the 2 internal
  529.         disk drives.  Any data on your 3rd (and higher) drives should
  530.         remain untouched.  
  531.  
  532. There is another way to do this whole thing without reloading the
  533. entire OS.  It involves having a boot floppy with prtvtoc, fmthard,
  534. swap, and a few other files on it.  You would have to make this before
  535. hand (explained in a different question).  In this instance, you would
  536. only alter the partitions on the disk you added the new partition to.
  537. This, however, would force you to re-create and restore filesystems on the
  538. partition(s) you borrowed space from.  For my time and money, it was
  539. easier (and less error-prone) to add the swap partition by reloading
  540. the Foundation disks.  True Blue Gurus (TM) can experiment with the
  541. second method.
  542.  
  543. Comments and criticisms welcome.
  544.  
  545. Jeffrey L. Bromberger ------- System Manager ------- Tramway Unix Systems
  546. jeffrey@squid.tram.com      Anywhere!{van-bc,limbic,icus}!tram!jeffrey
  547.  
  548. ------------------------------------------------------------------------------
  549. Subject:  3 How can I get X11 for the 3B2?
  550. ------------------------------------------------------------------------------
  551.  
  552. From: aj4640@dean1.usma.edu  Robertson John MAJ at US Military Academy, West
  553. Point, N
  554.  
  555. [Read the P.S. at the end of this message before attempting to
  556.  ftp these files.]
  557.  
  558. The X11 R4 distribution tape contains sources to run clients on a 3b1.
  559. Several of us have hacked those sources to enable clients to run on a
  560. 3b2.
  561.  
  562. I wish I could offer the source patches directly but for various
  563. reasons, I can't.  However, 3b2 users are more than welcome to have the
  564. clients, the libraries, the include files, and the pre-processor.  This
  565. will get X-windows up on your 3b2 without the xdaemon stuff (as long as
  566. you have the Wollongong networking stuff.)  With this stuff, you'll
  567. have a pile of ready-to-run clients as well as the tools needed to
  568. compile your own X11 applications.
  569.  
  570. In addition to the default X11 R4 clients, bin.tar.Z also has a running
  571. copy of tgif, xdvi, xmahjongg [you'll need to do the fonts for your
  572. server.  UTSL!], and lots of other neat stuff.
  573.  
  574. The lib.tar.Z contains libX11.a, libXt.a, etc.  In addition, the
  575. app-defaults for all the clients in bin.tar.Z are also here.
  576.  
  577. include.tar.Z has all the include files.  You'll need these if you want
  578. to compile your own stuff.
  579.  
  580. cpp.tar.Z is a compiled version of the X11 distribution preprocessor.
  581. In this version, you'll need to define the symbol 3b2 before
  582. invocation.  It will not gag on the big header files that many X
  583. applications use.
  584.  
  585. The files can be obtained via anonymous ftp from euler.math.usma.edu.
  586. They are in pub/3b2.  Other than unpaccking and installing the clients
  587. and lib stuff in the usual places, no other special work should be
  588. needed.
  589.  
  590. I cannot offer any support for this stuff.  Take it, hack it, and have
  591. fun.  Even more, give the clients away to other suffering 3b2 users.
  592. It has made our 3b2's substantially easier to use.
  593.  
  594. Jack
  595.  
  596. P.S.  The X11R4 clients for the 3B2 have been moved to Bradley University
  597.       on erratic.bradley.edu in pub/3B2_X.  If that system is down, you
  598.       may want to also try ds3.bradley.edu, also in pub/3B2_X.
  599.  
  600. ------------------------------------------------------------------------------
  601. Subject:  4 How do I install a non AT&T SCSI drive on my 3B2?
  602. ------------------------------------------------------------------------------
  603.  
  604. From: geoff@ugc.uucp (Geoff Coleman)
  605.  
  606. Installation of Third Party SCSI drive on AT&T 3B2
  607.  
  608. 1.  Hardware Addition
  609. The hardware installation is relatively simple. The SCSI address of the
  610. disk must be set via jumpers. If the disk being added is the first
  611. outside disk for the 3B2 then the you must use an "AT&T SCSI Connect
  612. Kit".
  613.  
  614. 2.  Telling the system about the disk
  615. After the disk has been physically attached the machine should be
  616. restarted.  If the disk is one that is unknown to the 3B2 a message
  617. will appear on the console that there is an unknown scsi device "make"
  618. "model". The make and model information is important.
  619.  
  620. Once the 3b2 is rebooted login as root and cd to /etc/scsi.  At this
  621. point you should run ./edittbl -l to list all of the SCSI devices known
  622. to the system. Then run device table. The first entry is the make and
  623. must be padded with spaces to 8 characters.  The second entry is the
  624. model and must be padded to 16 characters with spaces.  The number of
  625. lu's is one unless it is a bridge controller.
  626.  
  627. At this point you should reboot the machine and there should be no
  628. unknown device error message on bootup.
  629.  
  630. 3.  Formatting the disk
  631. Once the system has been rebooted login as root and change the run
  632. level to single user mode and remount /usr if need be.
  633.  
  634. At this point you need to cd to /usr/lib/scsi and edit the file
  635. tc.index.  Add an entry for the new disk in the same manner as the
  636. other entries in this file. Make sure that the model number starts in
  637. column 9 and is padded out to 16 characters, if you receive an unable
  638. to open script file message on formatting the problem is most likely in
  639. this entry.
  640.  
  641. At this point you can run the format program from either sysadm or the
  642. command line. After the format has finished reboot the system and the
  643. disk should be listed as a formatted disk.
  644.  
  645. ------------------------------------------------------------------------------
  646. Subject:  5 How do I prevent data overrun errors when using a high
  647.             speed modem on an EPORTS card at 19.2K baud or higher?
  648. ------------------------------------------------------------------------------
  649.  
  650. The EPORTS board can easily handle 38.4K baud on an otherwise
  651. unloaded system, provided Hardware Flow Control is enabled.  The
  652. hard part is keeping HFC enabled.  Several solutions to this problem
  653. exist, but one that seems to work (and I use personally) is to have
  654. a daemon set HFC on open lines periodically, and have uugetty enable
  655. HFC on all logins.
  656.  
  657. The second part is the trickier part.  Elliot Dierksen suggests
  658. the following, which I have verified to work:
  659.  
  660. From: ebd@fang.att.com (Elliot B Dierksen)
  661.  
  662. Step 1: copy uugetty to some new name (I used epuugetty). Use some
  663. sort of binary editor to change the exec of '/bin/login' to '/bin/ephfc'.
  664.  
  665. Step 2: compile ephfc. Here it is!
  666.  
  667. I have had no problems with this at all, but your mileage may vary.
  668. No promises implied or intended. Even with cron entries to set HFC,
  669. I still have problems on occasion with dial outs. Inbound calls
  670. work great.
  671.  
  672. I hope you all find this useful!
  673.  
  674. ----------------cut here--------------------------------------
  675. /* ephfc.c
  676.  
  677. handle hardware flow control on EPORTS and then exec login
  678.  
  679. This program sets hardware flow control on an EPORTS card in an
  680. AT&T 3B2 computer. Patch getty (or uugetty) to exec ephfc instead of login.
  681.  
  682. 04/18/1992 - Elliot Dierksen (e.dierksen@att.com, elliot@alfred.oau.org)
  683.  
  684. */
  685.  
  686. /* standard header files */
  687. #include <stdio.h>
  688. #include <fcntl.h>
  689. #include <errno.h>
  690. #include <sys/ct_dep.h>
  691. #include <termio.h>
  692.  
  693. /* EPORTS header files */
  694. #include <sys/queue.h>
  695. /*#include <sys/ep_dep.h>*/
  696. #include <sys/eppc.h>
  697. #include <sys/ep_lla.h>
  698.  
  699. #define IN_FD    0
  700. #define OUT_FD    1
  701.  
  702. main(argc,argv,envp)
  703. int argc;
  704. char **argv,**envp;
  705. {
  706. char *login_prog = "/bin/login";
  707. struct etty ettyp;
  708. struct termio termiop;
  709.  
  710.     /* abort if ioctl read fails. this might happen this is not an EPORT */
  711.     if (ioctl(IN_FD,EP_GETA,&ettyp) == -1)
  712.     {
  713.         fprintf(stderr,"%s: ioctl(EP_GETA) failed(%d)\n",argv[0],errno);
  714.         fflush(stderr);
  715.         exit(6);
  716.     }
  717.  
  718.     /* abort if ioctl read fails. No clue what might have gone wrong! */
  719.     if (ioctl(IN_FD,TCGETA,&termiop) == -1)
  720.     {
  721.         fprintf(stderr,"%s: ioctl(TCGETA) failed(%d)\n",argv[0],errno);
  722.         fflush(stderr);
  723.         exit(7);
  724.     }
  725.  
  726.     /* turn off XON/XOFF */
  727.     termiop.c_iflag &= ~(IXON|IXOFF|IXANY);
  728.  
  729.     /* set regular ioctl values */
  730.     ioctl(OUT_FD,TCSETA,&termiop);
  731.  
  732.     /* set EPORTS values */
  733.     ioctl(OUT_FD,EP_HFC,0);
  734.  
  735.     /* reset arg[0] for login */
  736.     argv[0] = login_prog;
  737.  
  738.     /* exec login and hope for the best! */
  739.     execv(login_prog,argv);
  740. }
  741.  
  742. ------------------------------------------------------------------------------
  743. Subject:  6 What does the 'NOTICE: File Table Overflow' error mean?
  744. ------------------------------------------------------------------------------
  745.  
  746. From: v.hoang@att.com
  747.  
  748. It means more files being opened than the limit you've set for the
  749. system.  Edit /etc/master.d/kernel and bump up the values of NFILE,
  750. NINODE & NS5INODE (or something close to that), then cd /boot,
  751. mkboot -k KERNEL, touch /etc/system then reboot the system.
  752.  
  753. ------------------------------------------------------------------------------
  754. Subject:  7 How do I set up anonymous ftp?
  755. ------------------------------------------------------------------------------
  756.  
  757. From: rdc30@nmrdc1.nmrdc.nnmc.navy.mil (LCDR Michael E. Dobson)
  758. Subject: Anonymous ftp with WIN/TCP 3.0.x YES!!
  759.  
  760. Contrary to the documentation for WIN/TCP 3.0.{0,1}, it is possible to
  761. set up anonymous ftp.  The Bugs: note in the documentation about it not
  762. being fully implemented in this release seems to be just a
  763. documentation ommision.  I saw the method to use on a US military 3B2
  764. Users Group mailing list.  The missing parts are the creation of a dev
  765. directory in the root of the ftp account directory with null and tcp
  766. devices created with mknod, and the inclusion of the services file in
  767. the etc subdir along with group and passwd files.  You of course need
  768. ls & pwd in bin and a pub tree.  Below is the output of ls -lR in my
  769. ftp root as well as the passwd in ~ftp/etc/passwd.  Try it out and
  770. see.
  771.  
  772. total 5
  773. drwxr-xr-x   2 root     other         64 Jan 23 11:12 bin
  774. drwxr-xr-x   2 root     other         64 Jan 23 11:09 dev
  775. drwxr-xr-x   2 root     other         80 Jan 23 11:13 etc
  776. drwxr-xr-x   2 ftp      sys          240 Jan 23 11:16 pub
  777. drwxr-xr-x   2 root     other         64 Aug 28 20:01 shlib
  778.  
  779. /usr3/ftp/bin:
  780. total 111
  781. ---x--x--x   1 root     other      35678 Jan 23 11:11 ls
  782. ---x--x--x   1 root     other      19551 Jan 23 11:11 pwd
  783.  
  784. /usr3/ftp/dev:
  785. total 0
  786. crw-rw-rw-   1 root     sys       63, 43 Aug 28 19:57 circ
  787. crw-rw-rw-   1 root     sys       49,  2 Jan 23 11:09 null
  788. crw-rw-rw-   1 root     sys       63, 38 Jan 23 11:09 tcp
  789. crw-rw-rw-   1 root     sys       63, 36 Aug 28 19:56 udp
  790.  
  791. /usr3/ftp/etc:
  792. total 4
  793. -r--r--r--   1 root     other        336 Jan 23 11:12 group
  794. -r--r--r--   1 root     other         56 Jan 23 11:13 passwd
  795. -r--r--r--   1 root     other        884 Jan 23 11:12 services
  796.  
  797. /usr3/ftp/pub:
  798. total 0
  799.  
  800. /usr2/ftp/shlib:
  801. total 211
  802. -r-xr-xr-x   1 root     other      66626 Aug 28 20:01 libc_s
  803. -r-xr-xr-x   1 root     other      39859 Aug 28 20:01 libnsl_s
  804.  
  805. Contents of ~/ftp/etc/passwd:
  806.  
  807. ftp:x:13:1:Anonymous FTP Account:/usr3/ftp:/usr/bin/ftp
  808.  
  809. -- 
  810. Mike Dobson, Sys Admin for      | Internet: rdc30@nmrdc1.nmrdc.nnmc.navy.mil
  811. nmrdc1.nmrdc.nnmc.navy.mil      | UUCP:   ...uunet!mimsy!nmrdc1!rdc30
  812. AT&T 3B2/600G Sys V R 3.2.2     | BITNET:   dobson@usuhsb or nrd0mxd@vmnmdsc
  813. WIN/TCP for 3B2                 | MCI-Mail: 377-2719 or 0003772719@mcimail.com
  814.  
  815. A special note from Steven M. Kilby <skilby@ucqais.cba.uc.edu>
  816.  
  817. Anonymous FTP for the 400:
  818.     Setting up an anonymous FTP login for the 3B2/400 differs slightly from
  819. the instructions in the FAQ.  The FAQ instructions will work on 600's or
  820. 1000's.  The only changes are in the directory setup.
  821.  
  822. [As other people found the original anonymous FTP setup did not
  823.  work at all without Steven M. Kilby's changes, I modified the
  824.  directory structure above to reflect Steve's changes.  -greg]
  825.  
  826. Also:
  827. From: Kevin Darcy <kevin@cfctech.cfc.com>
  828.  
  829. Also, you should probably make people aware that the exact minor
  830. numbers for all clone devices will vary from system to system, and
  831. to only use the ones displayed as a guide. For instance, my dev
  832. entries for circ, tcp & udp are
  833.  
  834. crw-rw-rw-   1 root     other     63, 66 Sep 10  1991 /dev/circ
  835. crw-rw-rw-   1 root     other     63, 56 Sep 10  1991 /dev/tcp
  836. crw-rw-rw-   1 root     other     63, 58 Sep 10  1991 /dev/udp
  837.  
  838. which is somewhat different than what's shown above (cfctech's
  839. major numbers are higher than most folks', because we have run
  840. StarLAN, Datakit & WIN/TCP all simultaneously on the machine, in
  841. addition to everything on the release tape, and, at one point, even
  842. loaded X Windows on the box (!)).
  843.  
  844. ------------------------------------------------------------------------------
  845. Subject:  8 Is there a reposity of ftp-able 3B2 programs?
  846. ------------------------------------------------------------------------------
  847.  
  848. The following are some 3B2 ftp sites that I know of and what they
  849. contain:
  850.  
  851. ames.arc.nasa.gov (128.102.18.3)
  852.     Kyoto-Lisp, Pascal, Sendmail, citadel-bbs
  853.  
  854. ds3.bradley.edu (136.176.5.79)
  855.     X11R4, old gcc
  856.  
  857. erratic.bradley.edu (136.176.5.253)
  858.     X11R4, old gcc
  859.  
  860. stasi.bradley.edu (136.176.5.121)
  861.     xarchie, lpr/lpd
  862.  
  863. And then there's...
  864.  
  865. From: Jeffrey A. Thompson <jeffrey@rigel.econ.uga.edu>
  866.  
  867. Here is a list of software I have compiled on my 3b2 (roscoe.msit.uga.edu)
  868. available via anonymous ftp. I have all the source too.
  869.  
  870. 287172 Nov 19 13:37 bash*          GNU's Bourne Again Shell
  871.  35137 Apr  5  1990 compress*      
  872.   5959 Aug 22 20:55 culimit*       Program to change the ulimit of a shell to
  873.                                    10 megabytes instead of 1 megabyte. 
  874.  48615 Jan 25 11:10 gab*           My own little talk program for up to 19 
  875.                        people ; uses shared memory and semaphores
  876. 174992 Aug 23  1990 kermit*        The standard kermit.
  877.  60393 May 19  1990 rb*            X/Y/Z modem
  878.  60393 May 19  1990 rx*
  879.  60393 May 19  1990 rz*
  880.  59254 May 19  1990 sb*
  881.  32546 Nov  6 08:17 ship*          Zip's ship 
  882.  59254 May 19  1990 sx*
  883.  59254 May 19  1990 sz*
  884.  35137 Apr  5  1990 uncompress*
  885.  61743 Nov  6 08:17 unzip*         Unzip ; I love zip. It works on everything.
  886.                    and better compression than compress 
  887.                                    (average 10 to 30 percent better 
  888.                                    compression)
  889.  38784 Jun 22  1991 uudecode*
  890.  23781 Jun 22  1991 uuencode*
  891.  20844 Sep  7 17:51 uvapc*         A standard pascal compiler
  892.  35137 Apr  5  1990 zcat*          
  893.  75420 Nov  6 08:15 zip*           Can produce pkzip compatible zips (-k opt)
  894.  35188 Nov  6 08:15 zipnote*
  895.  36904 Nov  6 08:15 zipsplit*      Splits up a zip file into smaller zip files
  896.                                    Great for copying stuff onto a floppy disk.
  897.  
  898. --jat
  899.  
  900. And then there's...
  901.  
  902. From: Steven M. Kilby <kilby@ucqais.cba.uc.edu>
  903.  
  904.     Starting October 1 ucqais.cba.uc.edu will offer an anonymous login service
  905. specifically for 3B2 users.  The anonymous login will contain software
  906. packages that have been ported to the 3B2, such as gcc, iscreen, lpr, X11,
  907. and many more!  Most of the offerings will be binary, although I will include
  908. as many sources as I can.  If there are any packages you would like to see
  909. available there, let me know!
  910.  
  911.  
  912. ------------------------------------------------------------------------------
  913. Subject:  9 How do I run Unix from floppy (for example, to repair a damage
  914.         hard drive file system)?
  915. ------------------------------------------------------------------------------
  916.  
  917.                Running a Standalone Shell on a 3B2
  918.  
  919.                         Stephen J. Friedl
  920.                     [Edited by Gregory Gulik]
  921.  
  922.                          April 25, 1988
  923.  
  924.           NB:  the   procedures   described   here
  925.           require  substantial  knowledge  of  UNIX and
  926.           entail a significant risk of causing loss  of
  927.           data.  The obvious disclaimers apply here, so
  928.           use at your own risk.  Please be careful.
  929.  
  930. Introduction
  931.  
  932.      This document is an introduction to operating your 3B from a
  933. standalone /unix.  Even with inoperable hard drives, it is possible to
  934. insert the boot floppy (Essential Utilities Disk 1), say some magic
  935. words, and receive a # prompt.  At this point you can do major surgery
  936. on the failing machine, often recovering a drive previously thought to
  937. be lost.
  938.  
  939.      Our style is informal and we'll use lots of examples to illustrate
  940. the points at hand.  We have been using standalone shells for quite
  941. some time and have learned a great deal; we hope to pass this
  942. information on to you.  Please read this document carefully before
  943. trying the methods described here, and if possible have a wizard around
  944. when giving it a go.  This can be dangerous business: as has been said
  945. before, it is a time where experience and informed courage count for
  946. much.
  947.  
  948. Conventions
  949.  
  950.      Throughout this document, sample usage sessions will be shown
  951. indented, with user input in bold.  To make it easier to distinguish
  952. between a multiuser UNIX shell and a standalone one, we will show
  953. multiuser UNIX's root prompt as ## and the standalone prompt as #.
  954.  
  955. >>> Back up your boot disks b->
  956.  
  957.      This cannot be emphasized enough.  Your boot floppies are the key
  958. to your machine, and without them the machine is down.
  959.  
  960. Why do you want a standalone /unix?
  961.  
  962.      The most compelling reason for a standalone shell is when the
  963. primary drive has gone down and must be recovered.  While working from
  964. a standalone /unix is slow and tedious, it can often save an entire
  965. hard disk with minimal data loss.
  966.  
  967.      We have also used this standalone shell to repair a corrupt
  968. /etc/inittab, to fix /etc/passwd, to restore a /bin/login that had been
  969. removed, and to install new bootstraps on the hard drive.  With a
  970. standalone boot disk in hand, a host of possibilities presents itself.
  971.  
  972. What is on your boot disk?
  973.  
  974.      Before booting this floppy, take some time to explore its
  975. contents, as the disk has a filesystem on it that can be mounted and
  976. perused.  To do this, insert a COPY of the Essential Utilities Floppy 1
  977. (from now on, "the boot floppy") into the drive with a write-protect
  978. tab.  Now,
  979.  
  980.           ## mount /dev/dsk/c0d0s5 /install -r
  981.  
  982.      Because boot floppies vary from release to release, it would be
  983. most helpful to simply get a listing of the contents of your particular
  984. boot floppy.
  985.  
  986.      Once finished, the floppy must be unmounted:
  987.  
  988.           ## cd /
  989.           ## umount /dev/dsk/c0d0s5
  990.  
  991. "Open Sesame"
  992.  
  993.      To give standalone a try, first shut the machine down to firmware
  994. mode.  Assuming the machine is now in firmware mode, put a copy of the
  995. boot disk into the drive.  Note that some versions of the operating
  996. system (Sys V Release 2, at least) require that the boot floppy be
  997. write-enabled (i.e., no write-protect tab); it is this requirement that
  998. mandates multiple backups of the boot floppy.  UNIX will be updating
  999. the disk while it runs -- the superblock, access times, etc. -- and if
  1000. the machine crashes at the wrong time it simply will not boot again
  1001. without an fsck.  Be careful.
  1002.  
  1003.      Type in your firmware password and boot /unix from the floppy
  1004. drive (Option 0, named `FD5') instead of the hard drive (Option 1,
  1005. named `HD30' or `HD72').  It can take several minutes for UNIX to boot,
  1006. but when it does, the familiar menu will be displayed:
  1007.  
  1008.                1) Full Restore
  1009.                2) Partial Restore
  1010.                3) Dual-Disk Upgrade
  1011.                4) Release Upgrade
  1012.                Selection? [1, 2, 3, 4, quit, help]
  1013.  
  1014.      At this point, type the phrase
  1015.  
  1016.                            magic mode
  1017.  
  1018.      The system recognizes this special option and responds:
  1019.  
  1020.           Poof!
  1021.  
  1022.           Selection? [1, 2, 3, 4, quit, help, shell, copy]
  1023.  
  1024.      Notice the new options?  Now type shell, then RETURN, and you will
  1025. be greeted with the familiar # prompt.  You are now running a
  1026. standalone shell on the floppy.
  1027.  
  1028.      A few reminders here: a floppy filesystem is not able to hold much
  1029. data, and many common utilities are unavailable.  When dealing with the
  1030. standalone shell, one must learn alternatives to these utilities.  For
  1031. example, echo * can replace ls(1), and cat > file can serve as a poor
  1032. replacement to ed(1).  One must become remarkably resourceful when
  1033. working in an environment as restricted as this.  We will see later how
  1034. we can enhance this confined environment with additional tools.
  1035.  
  1036. Standalone devices
  1037.  
  1038.      The floppy's /dev directory contains a host of entries, some of
  1039. them referring to partitions on the hard drive.  While a particular
  1040. partition may have several names, we generally use the following
  1041. devices to refer to the hard disk:
  1042.  
  1043.           Partition        What it is (on the hard disk)
  1044.           -----------      -----------------------------
  1045.           /dev/idsk00      / filesystem
  1046.           /dev/idsk01      swap area
  1047.           /dev/idsk02      /usr filesystem
  1048.           /dev/idsk06      the entire disk
  1049.           /dev/idsk07      boot partition
  1050.           /dev/idsk08      optional filesystem (/u or /usr2)
  1051.  
  1052. Mounting the hard drive
  1053.  
  1054.      To gain access to the primary hard drive, partitions of interest
  1055. are mounted onto directories on the floppy.  The device names are
  1056. selected from the table in the previous section.
  1057.  
  1058.      Before mounting a partition, we recommend running the filesystem
  1059. check fsck(1m) first.  The mount command will fail if the the
  1060. superblock is not in order -- this is often the case after a crash.  In
  1061. addition, it gives a convenient verification of the device status and
  1062. the the filesystem's name and volume.
  1063.  
  1064.           # /etc/fsck /dev/idsk00
  1065.  
  1066.      While some errors are to be expected while checking the root
  1067. partition, a total failure is a very serious error.  Our experience
  1068. defines "total failure" as an indication by fsck that it cannot find
  1069. any possible traces of a filesystem.  In particular, "CAN NOT READ: BLK
  1070. 1" is one of the more ominous messages we have seen.
  1071.  
  1072.      Once fsck grants the filesystem a clean bill of health, it is
  1073. ready to be mounted.  Rather than take up space for a handful of common
  1074. commands, AT&T has rolled several of them into one:  fsys.  It is
  1075. undocumented and appears to only be used on the boot floppy.  Some
  1076. versions of the boot disk do contain the mount and umount programs and
  1077. those can be used instead of fsys.
  1078.  
  1079.      Fsys takes a handful of options, not all of which are interesting
  1080. to us in standalone mode.  Used in the install scripts for a handful of
  1081. filesystem-related duties, we will use it simply as a replacement for
  1082. mount(1m) and umount(1m).  To mount the hard disk's root filesystem
  1083. onto the floppy's /install directory, do:
  1084.  
  1085.           # fsys -m /install /dev/idsk00
  1086.  
  1087.      Fsys will complain on an error, and this brings us to a serious
  1088. bug in this program: if either the mount directory or the partition's
  1089. device name are invalid for any reason, the error message will always
  1090. point to the partition device name.  This can be, to put it lightly,
  1091. "misleading".
  1092.  
  1093.      With the hard drive's root filesystem mounted on /install, it is
  1094. now fully part of the standard directory tree.  While the floppy has no
  1095. editor or many of the helpful tools, the root partition does, and these
  1096. can be exploited.  When beginning an extended standalone session on the
  1097. primary drive, we have found it helpful to extend the shell's search
  1098. path:
  1099.  
  1100.           # PATH=/install/bin:/install/etc:$PATH ; export PATH
  1101.  
  1102.      Now the familiar ls, ed, (but not vi) and many other commands are
  1103. available.  Since they will be loaded from the hard drive, execution is
  1104. much faster.
  1105.  
  1106.      As an example, assume that the root password has been forgotten
  1107. and the machine is basically closed.  The solution suggested by AT&T's
  1108. documentation (in the System Administration Utilities Guide) is to do a
  1109. partial restore.  The difficulty with this approach is that many
  1110. important system files -- /etc/passwd, /etc/inittab, /etc/gettydefs,
  1111. and others -- are overwritten in the process.  Even with a full backup,
  1112. this can be an unpleasant undertaking.
  1113.  
  1114.      An alternate approach will use the standalone shell.  The general
  1115. strategy is to mount the hard drive, edit the password file, and boot
  1116. multiuser UNIX.  The full procedure is:
  1117.  
  1118.           (boot standalone /unix)
  1119.           # fsck /dev/idsk00
  1120.           # fsys -m /install /dev/idsk00
  1121.           # /install/bin/ed /install/etc/passwd
  1122.           (edit the file in the standard way)
  1123.           w
  1124.           q
  1125.           # fsys -u /dev/idsk00
  1126.  
  1127.      At this point, the root drive is now unmounted and the system may
  1128. be rebooted.  Normally you can just type exit at the shell prompt and
  1129. you will be returned to the monitor and asked what program to boot.  If
  1130. that doesn't work on your version, try:
  1131.  
  1132.           # sync
  1133.           # sync
  1134.           # /etc/uadmin 2 2
  1135.  
  1136.      Uadmin(1m) is documented in the manual (you must also refer to the
  1137. uadmin(2) manual page) -- the above does a normal return to the monitor
  1138. (i.e., firmware).  WARNING: uadmin(1m) is available from full UNIX as
  1139. well but is very dangerous.  Use it with extreme caution and only if
  1140. you really know what uadmin does.
  1141.  
  1142. Making a standalone boot disk
  1143.  
  1144.  
  1145.           ================== WARNING ==================
  1146.           Only do this on backup copies of  the  disks,
  1147.           NEVER to the main Essential Utilities Disk.
  1148.           ================== WARNING ==================
  1149.  
  1150.  
  1151.      The Essential Utilities Disk 1 contains many files needed by the
  1152. automatic restore/upgrade procedures, but for standalone work, many are
  1153. not needed.  After working with these disk for some time, we were able
  1154. to narrow down what is helpful to have on the disk and what is not.
  1155. The following procedure (run from multiuser mode, signified by the ##
  1156. prompt) will convert an Essential Utilities disk to a standalone boot
  1157. disk.
  1158.  
  1159.           (from hard disk UNIX)
  1160.           ## fsck /dev/dsk/c0d0s5
  1161.           ## mount /dev/dsk/c0d0s5 /install
  1162.           ## cd /install/inst/bin
  1163.           ## mv fsys pdinfo swap ttyset ../../bin
  1164.           ## cd /install
  1165.           ## /bin/rm -rf inst
  1166.           ## cp /bin/ed /install/bin
  1167.           ## cp /etc/fsdb /install/etc
  1168.           ## cat > /install/inittab
  1169.           is:s:initdefault:
  1170.           sh:s:respawn:/bin/sh < /dev/console > /dev/console 2>&1
  1171.           ^D
  1172.           ## cd /
  1173.           ## umount /dev/dsk/c0d0s5
  1174.  
  1175.      While there may be other files on this floppy that are not needed,
  1176. we have operated on the principle of least customization.  It has been
  1177. our experience that keeping the procedure simple allows it to be done
  1178. on-the-fly (say, at a customer site) and minimizes the exploration
  1179. required when a new operating system disk is released.
  1180.  
  1181.      In addition, it is not wise to pack the disk too tightly.  The
  1182. editor requires adequate space under /tmp, so an almost-full disk
  1183. precludes editing all but the smallest files; this applies whether the
  1184. file being edited resides on the hard drive or the floppy.
  1185.  
  1186.      Once this is done, the new disk will come up in standalone mode
  1187. without the need for magic mode.  In addition ed(1) and fsdb(1m) are
  1188. available.  The other tools mentioned (pdinfo, swap, ttyset) are
  1189. helpful but not required by the basic procedures.
  1190.  
  1191.      It has been our experience that any version (SVR2, SVR3) of boot
  1192. disk can be used with any version of hard disk UNIX without difficulty
  1193. for doing simple operations such a performing filesystem checks or
  1194. editing /etc/passwd.  For more complex operations, such as
  1195. repartitioning the hard drive or restoring the bootstraps, higher
  1196. version compatibility is required.
  1197.  
  1198. Security Considerations
  1199.  
  1200.      It should be apparent that knowledge of these standalone methods
  1201. is tremendously powerful.  In addition to being able to rescue a
  1202. foundering machine, an unrestricted path to root has been provided as
  1203. well.  While all the standard rules about physical security of the
  1204. computer apply here, an additional step may be taken to thwart a
  1205. would-be interloper.
  1206.  
  1207.      The responsible system administrator of a machine in a hostile
  1208. environment will generally change the computer's firmware password.
  1209. This magic word is required before the monitor on the 3B2 motherboard
  1210. will boot from a floppy, and lack of this password prevents a malicious
  1211. user from simply pulling the power plug to enter firmware mode.
  1212.  
  1213.      In addition to changing the firmware password, the floppy key
  1214. floppy should itself be secured.  When the computer is restarted with
  1215. this disk in the drive, it will clear the non-volatile RAM (NVRAM) and
  1216. restore the default parameters.  Because the firmware password is
  1217. included in these "default parameters", this disk should be kept out of
  1218. non-trusted hands.
  1219.  
  1220. Conclusion
  1221.  
  1222.      We solicit bug reports, comments, and suggestions on this
  1223. document.  Please direct them to:
  1224.  
  1225.     Stephen J. Friedl
  1226.     Software Consultant
  1227.     1891 Running Branch Way
  1228.     Tustin, CA 92680
  1229.     +1 714 544-6561 voice
  1230.     +1 714 838-0099 fax
  1231.  
  1232.     Internet:    friedl@mtndew.Tustin.CA.US
  1233.     Usenet:        {backbones}!uunet!mtndew!friedl
  1234.  
  1235. ------------------------------------------------------------------------------
  1236. Subject: 10 What is/was the 3B Journal?
  1237. ------------------------------------------------------------------------------
  1238.  
  1239.     The _3B Journal_ was put out sporadically by Owens-Laing
  1240.     Publications for several years in the late 1980s, and I used to be
  1241.     the technical editor.  The magazine dealt with the 3B1 and 3B2
  1242.     platforms, and the content varied from very markety-oriented to
  1243.     quite technical (the latter usually written by me).
  1244.  
  1245.     The publisher never seemed to get a handle on the business end of
  1246.     running a magazine, and I've heard nothing past the fourth quarter,
  1247.     1989 issue.  The current phones are disconnected, and I have NO
  1248.     information on subscriptions or anything like that.
  1249.  
  1250.          -- Stephen Friedl  friedl@mtndew.Tustin.CA.US   3/12/1992
  1251.  
  1252. ------------------------------------------------------------------------------
  1253. Subject: 11 What are the various models of 3B2s and their differences?
  1254. ------------------------------------------------------------------------------
  1255.  
  1256. [I'm putting this together mostly from memory and from discussions
  1257.  with other people.  Please feel free to make corrections.]
  1258.  
  1259. Some corrections/aditions provided by Andrew D. Hay <adh@petrel.att.com>,
  1260. Paul S. Sawyer <paul@unhtel.unh.edu> and Mike Crom <crom@vogon.att.com>
  1261.  
  1262. The 3B2 family of consists of the following models:
  1263.  
  1264. 3B2/300
  1265.  
  1266.     Processor:
  1267.         WE32000, 8 MHz
  1268.         almost 1 MIPS
  1269.  
  1270.     Memory:        
  1271.         Supports a maximum of 4 MB of RAM using two half height
  1272.         2 MB memory cards.
  1273.  
  1274.     Slots:
  1275.         4 standard slots.
  1276.  
  1277.     Features:
  1278.         MFM disk controller on motherboard
  1279.         1 internal full-height drive bay
  1280.         1 720 K floppy drive
  1281.  
  1282. 3B2/310
  1283.  
  1284.     Processor:
  1285.         WE32100, 10MHz (supports optional MAU)
  1286.         1.5 MIPS
  1287.  
  1288.     Memory:
  1289.         Supports a maximum of 4 MB of RAM using two half height
  1290.         2 MB memory cards.
  1291.  
  1292.     Slots:
  1293.         4 standard slots.
  1294.  
  1295.     Features:
  1296.         MFM disk controller on motherboard
  1297.         1 internal full-height drive bay
  1298.         1 720 K floppy drive
  1299.  
  1300. 3B2/400
  1301.  
  1302.     Processor:
  1303.         WE32100, 10MHz (supports optional MAU)
  1304.         1.5 MIPS
  1305.  
  1306.     Memory:
  1307.         Supports a maximum of 4 MB of RAM using either two half
  1308.         height or full height 2 MB memory cards.
  1309.  
  1310.     Slots:
  1311.         12 standard slots.
  1312.  
  1313.     Features:
  1314.         MFM disk controller on motherboard
  1315.         2 internal full-height drive bays
  1316.         1 720 K floppy drive
  1317.         1 23 MB cartridge tape drive
  1318.  
  1319. 3B2/500
  1320.  
  1321.     Processor:
  1322.         WE32100, 18MHz
  1323.  
  1324.     Memory:
  1325.         2 - 4MB cards max
  1326.  
  1327.     Slots:
  1328.         4 I/O + 4 system
  1329.  
  1330.     Features:
  1331.         SCSI disks
  1332.         Up to 1 additional MPE
  1333.  
  1334. 3B2/522
  1335.  
  1336.     Processor:
  1337.         WE32200, 22MHz
  1338.  
  1339.     Memory:
  1340.         2 - 16MB cards max
  1341.  
  1342.     Slots:
  1343.         4 I/O + 4 system
  1344.  
  1345.     Features:
  1346.         SCSI disks
  1347.         Field upgraded 3B2/500 to same processor as 3B2/700
  1348.         Up to 1 additional MPE
  1349.  
  1350. 3B2/600 (aka 3B2/1000-60)
  1351.  
  1352.     Processor:
  1353.         WE32100, 18MHz
  1354.  
  1355.     Memory:
  1356.         4 - 4MB cards max
  1357.  
  1358.     Slots:
  1359.         12 I/O + 12 system
  1360.  
  1361.     Features:
  1362.         SCSI disks
  1363.         Up to 3 additional MPEs
  1364.  
  1365. 3B2/700, 3B2/622 (aka 3B2/1000-70)
  1366.  
  1367.     Processor:
  1368.         WE32200, 22MHz
  1369.  
  1370.     Memory:
  1371.         4 - 16MB cards max
  1372.  
  1373.     Slots:
  1374.         12 I/O + 12 system
  1375.  
  1376.     Features:
  1377.         SCSI disks
  1378.         Up to 3 additional MPEs
  1379.         The 3B2/622 is a field upgrade for the 3B2/600
  1380.  
  1381. 3B2/1000, 3B2/600G (aka 3B2/1000-80)
  1382.  
  1383.     Processor:
  1384.         WE32200, 24MHz
  1385.  
  1386.     Memory:
  1387.         4 - 16MB cards max
  1388.  
  1389.     Slots:
  1390.         12 I/O + 12 system
  1391.  
  1392.     Features:
  1393.         SCSI disks
  1394.         Up to 3 additional 22 MHz PEs
  1395.         Up to 3 additional 18 MHz MPEs
  1396.  
  1397. 3B15
  1398.  
  1399.     Processor:
  1400.         WE32100 (standard MAU) (?)
  1401.         2 MIPS (?)
  1402.  
  1403.     Memory:
  1404.         16 MB (8 - 2MB cards max)
  1405.  
  1406.     Slots:
  1407.  
  1408.     Features:
  1409.         Standard 9-Track tape drive
  1410.         Uses 8 inch SCSI drives
  1411.  
  1412.         NOTE: Not all 3B15s have SCSI.  Some models were
  1413.         converted from 3B5s and have 8 inch FSD drives (maximum
  1414.         8, 160 MB or 340 MB).  Then there are the Lark II
  1415.         drives.  The non-SCSI tape bus can take 1-4 drives.
  1416.         The 3B5 becomes a 3B15 by a change of 2 (??) boards,
  1417.         and most importantly, a new name sticker!
  1418.  
  1419. 3B4000
  1420.  
  1421.     Processor:
  1422.         WE32100 from 3B15 as control processor
  1423.         1 or more 3B2/600's as attached processors
  1424.  
  1425.     Memory:
  1426.  
  1427.     Slots:
  1428.  
  1429.     Features:
  1430.         Supports tons of SCSI disk
  1431.  
  1432.  
  1433. 3B2 PERIPHERALS
  1434.  
  1435. Name    Device Code     Description
  1436. ----    -----------     -----------
  1437. SBD     0x0001          System motherboard
  1438. NI      0x0002          10base5 ethernet card
  1439. PORTS   0x0003          Ports card.  4 serial, 1 parallel. (includes HPP)
  1440. CTC     0x0005          Cartridge tape controller.  23 MB
  1441. NAU     0x0006          Network access unit.  1 MB STARLAN
  1442. SCSI    0x0100          SCSI host adapter
  1443. AIC     0x0101          Alarm interface circuit
  1444. EPORTS  0x0102          Extended ports.  8 serial ports
  1445. ISC     0x0201          Intelligent serial controller.  Bisync of X.25
  1446. XDC     0x0204          External disk controller for 2 more MFM drives
  1447. MAU     0xFD00          Math accelerator unit
  1448. VCACHE  0xFE00          Extended memory chache (3B2/600 and higher)
  1449. MPB     0xFF00          Multiprocessor board (3B2/600 and higher)
  1450.  
  1451. ------------------------------------------------------------------------------
  1452. Subject: 12 How do I build GCC on the 3B2?
  1453. ------------------------------------------------------------------------------
  1454.  
  1455. John L. Wehle ported GCC to the WE32000 series processor, and it
  1456. first appeared in release 2.2 of GCC.
  1457.  
  1458. To build the GCC release on the 3B2, download the latest GCC
  1459. distribution and allocate at least 35 MB of disk space to do the
  1460. build.  Follow the directions in the INSTALL file.  The following
  1461. are some notes that will make the install go smoother.
  1462.  
  1463. First of all, older versions of /lib/cpp are not capable of
  1464. processing one of the source files.  I recommend building the
  1465. distribution until the GNU cpp is done.  Then, temporarily replace
  1466. your /lib/cpp with the GNU version, and add the following flag to
  1467. CFLAGS:
  1468.  
  1469. CFLAGS = -U__STDC__
  1470.  
  1471. When stage1 is complete, you could remove the -U__STDC__ flag
  1472. and restore your original cpp.
  1473.  
  1474. Basically, the steps are as follows:
  1475.  
  1476.     $ configure --target=we32k-att-sysv3
  1477.     $ make LANGUAGES=c
  1478.     $ make stage1
  1479.     $ make LANGUAGES=c CC=stage1/gcc CFLAGS="-Bstage1/ -g"
  1480.  
  1481. [It is imporant to note that due to a bug in the AT&T compiler,
  1482.  the optimizer doesn't get compiled correctly at this point.]
  1483.  
  1484.     $ make stage2
  1485.     $ make CC=stage2/gcc CFLAGS="-Bstage2/ -g -O"
  1486.  
  1487. [Some people still have problems with the optimizer at this point.
  1488.  If you do, just do not use the -O flag when compiling GCC.  The
  1489.  symptom you will experience that tells you the -O flag should be
  1490.  removed is the compilation of cccp.c will take a VERY long time.
  1491.  Kill the compile and restart without the -O.]
  1492.  
  1493.     $ make stage3
  1494.     $ make CC=stage3/gcc CFLAGS="-Bstage3/ -g -O"
  1495.  
  1496. To verify everything built correctly:
  1497.  
  1498.     $ for file in *.o; do
  1499.     > tail +10c $file > foo1
  1500.     > tail +10c stage3/$file > foo2
  1501.     > cmp foo1 foo2 || echo $file
  1502.     > done
  1503.  
  1504. Then, to install the distribution:
  1505.  
  1506.     $ make CC=stage3/gcc CFLAGS="-Bstage3/ -g -O" install
  1507.  
  1508. Good luck!
  1509.  
  1510. [These notes are a combination of my own experiences with building the
  1511.  GCC compiler on a 3B2/400 and discussions with John Wehle, the author
  1512.  of the port.]
  1513.  
  1514. NOTES:
  1515.  
  1516. The GCC binaries available on several anonymous FTP sites will not
  1517. work with certain versions of the standard C compiler.  It appears to
  1518. be some sort of linker problem.  I may have a fix for it.  Contact me
  1519. via E-mail if you fall into this category.
  1520.  
  1521. Speaking of linker problems, GCC will not work all that well with
  1522. the standard C shared library -lc_s.  The workaround for this is
  1523. to compile your program with GCC, but the link will fail.  When it
  1524. does, use something like the following to do the link stage:
  1525.  
  1526. $ cc -O -L/usr/local/lib/gcc-lib/we32k-att-sysv/2.2.2 program.o \
  1527.     -o program -lgcc -lc_s
  1528.  
  1529. This way, you will not only get fast binaries, but small ones as
  1530. well.
  1531.  
  1532. You may need to raise your ULIMIT to compile the g++ compiler as
  1533. the executable is larger than 1 MB.
  1534.  
  1535. ------------------------------------------------------------------------------
  1536. Subject: 13 What is the NVRAM SANITY FAILURE?
  1537. ------------------------------------------------------------------------------
  1538.  
  1539. The full error message resembles the following:
  1540.  
  1541. FW ERROR 1-01: NVRAM SANITY FAILURE
  1542.                DEFAULT VALUES ASSUMED
  1543.                IF REPEATED, CHECK THE BATTERY
  1544.  
  1545. The 3B2 stores information such as the time of day clock and machine
  1546. name in non-volatile memory.  The memory is backed up by a Lithium
  1547. battery, that does die after a few years.  The battery is normally
  1548. located in the right side of the case, near the cards, and connected to
  1549. the motherboard under the card in slot 2.  Replacing the battery almost
  1550. always requires the complete removal of the card cage.  Replacement
  1551. batteries can be found at some electronics stores.  I won't list exact
  1552. specifications because I have seen 3 different types of batteries so
  1553. far, and there may be more.  Your best bet is to just buy another
  1554. batter with the exact same voltage and modify the connector to fit.
  1555.  
  1556. ------------------------------------------------------------------------------
  1557. Subject: 14 Is there an implementation of SLIP for the 3B2?
  1558. ------------------------------------------------------------------------------
  1559.  
  1560. Rumor has it that there was one written by Wollongong, but AT&T
  1561. purchased exclusive marketing rights to WIN TCP/IP for the 3B2, but
  1562. chose NOT to include SLIP.  There is the NOS (KA9Q) package that
  1563. supposedly provides SLIP capabilities, but I have not tried it and
  1564. don't know if it'll run on a 3B2.
  1565.  
  1566. ------------------------------------------------------------------------------
  1567. Subject: 15 What are the known bugs in the Wollongong WIN TCP software?
  1568. ------------------------------------------------------------------------------
  1569.  
  1570. From: Steven M. Kilby <skilby@ucqais.cba.uc.edu>
  1571.  
  1572. rexecd:
  1573.     The rexecd released with WIN TCP for the 3B2 has the following bug.
  1574. This bug has been verified on a 400 with TCP 3.0.1 and 3.2.  When executing
  1575. a command using the rexecd daemon, the gid of the user is set and left at
  1576. root.  This is very apparent when executing a command that creates a shell,
  1577. such as XTerm.  The only available solutions at present are to rewrite the
  1578. daemon yourself, or.... not run it.  The problem has been reported to CERT.
  1579.  
  1580. ------------------------------------------------------------------------------
  1581. Subject: 16 Is there an implementation of NFS for the 3B2?
  1582. ------------------------------------------------------------------------------
  1583.  
  1584. The person to contact about 3B2 software is Kristine Schneider
  1585. [708-979-1017].  I called her and obtained the following information
  1586. about NFS:
  1587.  
  1588. Latest Versions:    1.3
  1589. Requires:        System V Rel 3.2.1 or 3.2.3, WIN/TCP 3.2 or higher
  1590. Product Code:        C274-0NB3-000
  1591. List Price:        $1295.00
  1592.  
  1593. This package is for the WE versions of the 3B2.  NFS comes bundled with
  1594. SVR4 for RISC-based 3B2's.  TCP/IP on the other hand, does not and has
  1595. to be purchased separately.
  1596.  
  1597. ==============================================================================
  1598. If you have any other questions, or better answers, please send
  1599. mail to 'greg@gagme.chi.il.us'
  1600. ==============================================================================
  1601. -- 
  1602. Gregory A. Gulik                                 Call Gagme, a public access
  1603.        greg@serveme.chi.il.us                    UNIX system at 312-282-8606
  1604.    ||  gulik@rtsg.mot.com                        For information, drop a note
  1605.                          to info@gagme.chi.il.us
  1606.