Annotation of wikisrc/ports/luna68k.mdwn, revision 1.1

1.1     ! mspo        1: [[!template id=port
        !             2: port="luna68k"
        !             3: cur_rel="6.0"  
        !             4: future_rel="7.0"
        !             5: changes_cur="6.0"
        !             6: changes_future="7.0"
        !             7: thumbnail="http://www.netbsd.org/images/ports/luna68k/luna.gif"
        !             8: about="""
        !             9: NetBSD/luna68k is a port of NetBSD to the LUNA product line of OMRON Tateisi
        !            10: Electronics, Japan. The LUNA was a 20MHz/m68030 desktop computer at the age of
        !            11: then-booming UNIX workstations, roughly comparable to a sun3/60 and any
        !            12: m68020/m68030 unix boxes at that time. It is a descendent of the company's 6U
        !            13: VME deskside m68010 box nicknamed Supermate, and was succeeded by a m68040
        !            14: variant, LUNA-II. It has a rare cousin LUNA-88K which sports 4 88k processors
        !            15: geared by CMU Mach2.5.
        !            16: """
        !            17: supported_hardware="""
        !            18: ###Supported System Models
        !            19: 
        !            20: NetBSD/luna68k runs on the original LUNA and the successor LUNA-II, and supports
        !            21: the following devices:
        !            22: 
        !            23: * built-in serial port ('ttya')
        !            24: * network interface: AMD LANCE with AUI or BNC port (switch-selectable)
        !            25: * monochrome/color graphics video board
        !            26: * keyboard and mouse
        !            27: * SCSI devices; (including built-in TEAC cassette tape drive)
        !            28: * LCD on front panel; (/dev/lcd is under development)
        !            29: 
        !            30: """
        !            31: unsupported_hardware="""
        !            32:  NetBSD/luna68k doesn't yet support the following devices:
        !            33: 
        !            34: * any devices controlled by dedicated 8bit I/O processor; serial ports ('tty00,
        !            35:   tty01'), printer parallel port ('lp'), floppy port ('rfd') and YM2149 sound
        !            36:   generator
        !            37: * optional X.25/GP-IB multiple function board
        !            38: * NEC PC9801 C-Bus option slot
        !            39: 
        !            40: Support for the deskside predecessors is not planned at this moment.
        !            41: """
        !            42: additional="""
        !            43: ##How to install NetBSD/luna68k
        !            44: 
        !            45: There are two ways to boot a NetBSD kernel on your LUNA.
        !            46: 
        !            47: 1. network boot using "isiboot"
        !            48: 2. place NetBSD kernel on the root directory of the LUNA original disk
        !            49: 
        !            50: Because there is no provision of installation kernel tailored to run in
        !            51: standalone with the help of memory disk, either way requires to prepare an
        !            52: initial filesystem on an NFS server.
        !            53: 
        !            54: ###Preparing filesystem to NFS mount
        !            55: 
        !            56: NetBSD/luna68k is a cousin of various m68k port of NetBSD. Any set of m68k
        !            57: distribution is useful to run NetBSD/luna68k with minor adjustments as described
        !            58: below.
        !            59: 
        !            60: Inflate two files, base.tgz and etc.tgz, to the NFS server. Then replace two
        !            61: files, etc/ttys and dev/MAKEDEV, with ones found in the
        !            62: ftp://ftp.NetBSD.org/pub/NetBSD/arch/luna68k/ directory of NetBSD ftp servers.
        !            63: Make sure to run 'sh ./MAKEDEV' all in dev/ directory.
        !            64: 
        !            65: ###Preparing BOOTP/DHCP network service
        !            66: 
        !            67: NetBSD kernel requests its network parameters and NFS mount point. You need to
        !            68: know its station address (Ethernet MAC address), which can be found using ROM
        !            69: monitor (see how to do).
        !            70: 
        !            71: Here is the sample configuration of /etc/bootptab:
        !            72: 
        !            73: <pre>
        !            74:    dayan:\ 
        !            75:         ht=ethernet:ha=00000a02430f:ip=10.1.1.106:sm=255.255.255.0:\
        !            76:         gw=10.1.1.1:rp=/ccd/filesys/luna68k:
        !            77: </pre>
        !            78: 
        !            79: where rp= field tells NFS root directory for LUNA exported by NFS server.
        !            80: bf= field is unnecessary to have.
        !            81: 
        !            82: Another sample configuration for /etc/dhcpd.conf:
        !            83: 
        !            84: <pre>
        !            85:   group {
        !            86:     option subnet-mask 255.255.255.0;
        !            87:     option broadcast-address 10.1.1.255;
        !            88:     option routers 10.1.1.1;
        !            89:     host dayan {
        !            90:       hardware ethernet 00:00:0a:02:43:0f;
        !            91:       fixed-address 10.1.1.106;
        !            92:       next-server 10.1.1.101;
        !            93:       option root-path "/ccd/filesys/luna68k";
        !            94:     }
        !            95:   }
        !            96: </pre>
        !            97: 
        !            98: ###Network boot with 'isiboot'
        !            99: 
        !           100: LUNA ROM monitor can download kernel image via network. 'isiboot' serves this
        !           101: purpose. The server program requires BPF (Berkeley Packet Filter) in the
        !           102: servicing machine to work. The source code of isiboot can be found
        !           103: ftp://ftp.NetBSD.org/pub/NetBSD/arch/luna68k/ directory of NetBSD ftp servers.
        !           104: The description is here. 
        !           105: 
        !           106: <pre>
        !           107:  SYNOPSIS
        !           108:     isiboot [-i interface] [-s directory] [-d tracelevel]
        !           109: 
        !           110:   DESCRIPTION
        !           111:     isiboot is a server which supports LUNA network boot.  It listens
        !           112:     to ROM monitor download requests and serves for it.  The proprietary
        !           113:     protocol uses a special Ethernet type and works within a local wire.
        !           114: 
        !           115:     -i <interface> isiboot searches available network interfaces and
        !           116:     chooses one found first.  If the servicing machine has multiple
        !           117:     network interfaces in action, this option can be used to specify
        !           118:     which network interface to use.
        !           119: 
        !           120:     -s <directory> whose directory isiboot server makes chroot(2)
        !           121:     to after invocation.  Given no provision, isiboot searches the
        !           122:     downloading files in the current directory when started.
        !           123: 
        !           124:     -d <tracelevel> accepts value 1, 2 or 3.  Greater number provides
        !           125:     more detailed trace.
        !           126: 
        !           127:     The protocol uses server's hostname to start the downloading
        !           128:     dialogue.  isiboot makes the name using gethostname(3) trimmed
        !           129:     down by the first dot '.' if applicable.
        !           130: 
        !           131: [1] Invoke isiboot program on the root directory of NetBSD/luna68k
        !           132:     filesystem on NFS server.  Use -s option when necessary.
        !           133: 
        !           134: [2] Manipulate LUNA ROM monitor as follows;
        !           135: 
        !           136:     Given '> ' ROM monitor prompt;
        !           137: 
        !           138:     >[k]                       start to change boot parameters,
        !           139:     ctlr: dk [et]              specify network boot,
        !           140:     home: omron                        type a return, isiboot doesn't care this field, 
        !           141:     sver: servername           type another return,
        !           142:     fnam: server:/vmunix [pelican:netbsd]
        !           143:                                specify server hostname and the filename
        !           144:                                to download.  Leading / is not significant.
        !           145: 
        !           146:     Then type 'g' ROM monitor command to start downloading.  You will see
        !           147:     the progress like;
        !           148: 
        !           149:     >[g]
        !           150:     text(776872)+data(49788)+bss(131942)
        !           151: 
        !           152:     When completed, type 'x' ROM monitor command with '-s' string to
        !           153:     run NetBSD kernel.  -s specifies not to start multiuser mode.
        !           154: 
        !           155:     >[x -s]
        !           156: </pre>
        !           157: 
        !           158: The kernel starts to configure itself, and requests BOOTP/DHCP on wire to get
        !           159: network parameters and the name of filesystem to mount. After receiving a proper
        !           160: reply, NetBSD/luna68k kernel invokes single user mode shell eventually. 
        !           161: 
        !           162: ###Booting from disk
        !           163: NetBSD/luna68k kernel can be booted off from the vender supplied original
        !           164: operating system. Place kernel image on the root directory, then type to ROM
        !           165: monitor as follows: 
        !           166: 
        !           167: <pre>
        !           168:     >[k]
        !           169:     ctlr: dk           type just a return to make no change,
        !           170:     drv: 0             return,
        !           171:     par: c             and another return,
        !           172:     fnam: vmunix [netbsd]
        !           173:                        specify the name of NetBSD/luna68k kernel.
        !           174: 
        !           175:     >[g]               load the kernel image from disk.  Litting
        !           176:                        front panel LED tells activity.
        !           177: 
        !           178:     >[x -sa]           run the kernel, where -sa instructs to ask
        !           179:                        which filesystem to mount.
        !           180: </pre>
        !           181: 
        !           182: Now, tell the kernel to mount filesystem provided by NFS server; 
        !           183: 
        !           184: <pre>
        !           185:     boot device: sd0
        !           186:     root device (default on sd0a): [le0]       le0 to use NFS
        !           187:     dump device:                               return to choose default
        !           188:     filesystem (default generic):              another return to choose
        !           189: </pre>
        !           190: 
        !           191: Then kernel requests BOOTP/DHCP for network parameters and its root directory,
        !           192: and eventually invokes single user mode shell when successful. 
        !           193: 
        !           194: ### Installing NetBSD/luna68k on disk
        !           195: NetBSD sysinst utility is not prepared for NetBSD/luna68k. Here is the
        !           196: instruction for manual installation.
        !           197: 
        !           198: It's reasonable and preferred to make fresh filesystems from scratch. Vender
        !           199: supplied OS has such a rather obscure convention to keep its root filesystem on
        !           200: partition c that's not comfortable with NetBSD standard. Use disklabel(8)
        !           201: command to make the new filesystem layout.
        !           202: 
        !           203: LUNA ROM monitor can search and load kernel images on the root filesystem. To
        !           204: make this possible, the root filesystem must be created in the 'old FFS' format.
        !           205: Make sure to have -O (large letter oh) for newfs(8). Other filesystems do not
        !           206: require the option.
        !           207: 
        !           208: Then mount the root filesystem somewhere, say /mnt, and other filesystems for
        !           209: usr/ or var/ underneath it. If you have NetBSD distribution sets on a certain
        !           210: NFS mounted point, goto the directory and then issue a simple loop: 
        !           211: 
        !           212: <pre>
        !           213:        # for i in *.tgz
        !           214:        do
        !           215:        (cd /mnt && tar xvfp - ) < $i
        !           216:        done
        !           217: </pre>
        !           218: 
        !           219: When completed, make sure to place NetBSD/luna68k kernel image on /mnt directory
        !           220: and to replace two files, etc/ttys and dev/MAKEDEV. Run sh ./MAKEDEV all on
        !           221: /mnt/dev/ directory to have device nodes.
        !           222: 
        !           223: It's ok to halt the system now by typing halt for # prompt.
        !           224: 
        !           225: ### Arrange ROM boot parameters for daily use
        !           226: 
        !           227: <pre>
        !           228:     >[k]
        !           229:     ctlr: dk           type just a return to make no change,
        !           230:     drv: 0             another return,
        !           231:     par: c [a]         change to choose 'a' partition to load,
        !           232:     fnam: vmunix [netbsd]
        !           233:     >[k+]              store those into NVRAM
        !           234: </pre>
        !           235: """
        !           236: ]]
        !           237: [[!tag tier2port]]

CVSweb for NetBSD wikisrc <wikimaster@NetBSD.org> software: FreeBSD-CVSweb