Annotation of 43BSDReno/share/doc/smm/01.setup/vax/vaxhints.t, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1980, 1986, 1988 Regents of the University of California.
                      2: .\" All rights reserved.
                      3: .\"
                      4: .\" Redistribution and use in source and binary forms are permitted
                      5: .\" provided that the above copyright notice and this paragraph are
                      6: .\" duplicated in all such forms and that any documentation,
                      7: .\" advertising materials, and other materials related to such
                      8: .\" distribution and use acknowledge that the software was developed
                      9: .\" by the University of California, Berkeley.  The name of the
                     10: .\" University may not be used to endorse or promote products derived
                     11: .\" from this software without specific prior written permission.
                     12: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
                     13: .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
                     14: .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
                     15: .\"
                     16: .\"    @(#)vaxhints.t  1.3 (Berkeley) 3/7/89
                     17: .\"
                     18: .ds lq ``
                     19: .ds rq ''
                     20: .ds 4B 4.3BSD-tahoe
                     21: .nr Vx 1               \" VAX version
                     22: .ds Mc VAX
                     23: .ds mC vax
                     24: .ds Dk hp
                     25: .ds Dn RM80
                     26: .ds Pa g
                     27: .ds Ps 4.3BSD
                     28: .bd S B 3
                     29: .TL
                     30: Hints on Upgrading a 4.3BSD VAX System to 4.3BSD-Tahoe
                     31: .br
                     32: July 14, 1988
                     33: .AU
                     34: Michael J. Karels
                     35: .AI
                     36: Computer Systems Research Group
                     37: Department of Electrical Engineering and Computer Science
                     38: University of California, Berkeley
                     39: Berkeley, California  94720
                     40: (415) 642-7780
                     41: .de IR
                     42: \\fI\\$1\|\\fP\\$2
                     43: ..
                     44: .de UX
                     45: UNIX\\$1
                     46: ..
                     47: .PP
                     48: This set of notes is extracted from 
                     49: \fIInstalling and Operating \*(4B UNIX* on the VAX.\(dg\fP
                     50: .FS
                     51: *\s-2UNIX\s0 is a register trademark of AT&T in the USA and other countries.
                     52: .FE
                     53: .FS
                     54: \(dgDEC, VAX, IDC, SBI, UNIBUS and MASSBUS are trademarks of
                     55: Digital Equipment Corporation.
                     56: .FE
                     57: It is intended to highlight changes in \*(4B
                     58: that will affect installation on existing VAX systems,
                     59: and to point out areas of the documentation that should be examined
                     60: before installing this system.
                     61: It is \fInot\fP intended to substitute for the standard documentation,
                     62: but only to point out areas that have changed and that should be examined.
                     63: Not all of the documentation is provided in printed form,
                     64: but all of it is in the /usr/doc and /usr/src/man directories on
                     65: the distribution tape.
                     66: .PP
                     67: \fBNote that the \*(4B release contains only Tahoe filesystems and executable
                     68: images.\fP
                     69: The \*(4B distribution tape supplied by Berkeley
                     70: cannot be used to bootstrap a VAX without a running 4.2BSD or 4.3BSD system.
                     71: If you are not currently running 4.2BSD or 4.3BSD you will
                     72: have to do a full bootstrap using a 4.3BSD tape;
                     73: to install the \*(4B release, the new sources must then be loaded
                     74: and compiled.
                     75: It is possible to make a boot tape that can be used with additional machines
                     76: by extracting the sources in the distribution tape on a VAX, compiling,
                     77: and making a tape using the procedures described in Appendix A
                     78: of \fIInstalling and Operating \*(4B UNIX on the VAX.\fP
                     79: .PP
                     80: If you are running 4.2BSD or \*(Ps, upgrading your system
                     81: involves replacing your kernel and system utilities.
                     82: Binaries compiled under \*(Ps will work without recompilation
                     83: under \*(4B, though they may run faster if they are recompiled.
                     84: Binaries compiled under 4.2BSD will probably work without recompilation,
                     85: but it is a good idea to recompile and relink because of the many changes
                     86: in header files and libraries since 4.2BSD.
                     87: Conversion from 4.2BSD is probably done most easily by booting from a 4.3BSD
                     88: distribution tape, then using that system to load and compile the sources
                     89: from \*(4B.
                     90: Sites not running 4.3BSD should read
                     91: \fIInstalling and Operating 4.3BSD on the VAX\fP
                     92: as well as the \*(4B version of that document.
                     93: .PP
                     94: The easiest upgrade path from 4.2BSD or \*(Ps
                     95: (depending on your file system configuration)
                     96: is to build
                     97: new root and \fI/usr\fP file systems on unused partitions,
                     98: then copy or merge site specific files
                     99: into their corresponding files on the new system.
                    100: All user file systems can be retained unmodified,
                    101: except that the new \fIfsck\fP should be run
                    102: before they are mounted (see below).
                    103: If there is insufficient space to load the new root and \fI/usr\fP
                    104: filesystems before reusing the existing partitions,
                    105: it is \fBSTRONGLY\fP advised that you make full dumps of each filesystem
                    106: on magtape before beginning.
                    107: It is also desirable to run file system checks
                    108: of all filesystems to be converted to \*(4B before shutting down.
                    109: If you are running a system older than 4.2BSD, you will have to
                    110: dump and restore your file systems.
                    111: In either case, this is an excellent time to review your disk configuration
                    112: for possible tuning of the layout.
                    113: .PP
                    114: If converting from 4.2BSD or \*(Ps, your old
                    115: file systems must be converted.
                    116: The standard disk partitions in \*(4B are the same as those
                    117: in 4.2BSD and \*(Ps,
                    118: except for those on the DEC UDA50.
                    119: If you've modified the partition
                    120: sizes from the original BSD or CCI ones, and are not already using the
                    121: \*(4B disk labels, you will have to modify the default disk partion
                    122: tables in the kernel.  Make the necessary table changes and boot
                    123: your custom kernel \fBBEFORE\fP trying to access any of your old
                    124: file systems!  After doing this, if necessary, the remaining filesystems
                    125: may be converted in place by running the \*(4B version of
                    126: .IR fsck (8)
                    127: on each filesystem and allowing it to make the necessary corrections.
                    128: The new version of \fIfsck\fP is more
                    129: strict about the size of directories than the version supplied with 4.2BSD.
                    130: Thus the first time that it is run on a 4.2BSD file system,
                    131: it will produce messages of the form:
                    132: .DS
                    133: .if \n(Vx \{\
                    134: \fBDIRECTORY ...: LENGTH\fP xx \fBNOT MULTIPLE OF 512 (ADJUSTED)\fP
                    135: .\}
                    136: .if \n(Th \{\
                    137: \fBDIRECTORY ...: LENGTH\fP xx \fBNOT MULTIPLE OF 1024 (ADJUSTED)\fP
                    138: .\}
                    139: .DE
                    140: Length ``xx'' will be the size of the directory;
                    141: it will be expanded to the next multiple of
                    142: .if \n(Vx \{\
                    143: 512
                    144: .\}
                    145: .if \n(Th \{\
                    146: 1024
                    147: .\}
                    148: bytes.
                    149: The new \fIfsck\fP will also set default \fIinterleave\fP and
                    150: \fInpsect\fP (number of physical sectors per track) values on older
                    151: file systems, in which these fields were unused spares; this correction
                    152: will produce messages of the form:
                    153: .DS
                    154: \fBIMPOSSIBLE INTERLEAVE=0 IN SUPERBLOCK (SET TO DEFAULT)\fP*
                    155: \fBIMPOSSIBLE NPSECT=0 IN SUPERBLOCK (SET TO DEFAULT)\fP
                    156: .DE
                    157: .FS
                    158: * The defaults are to set \fIinterleave\fP to 1 and
                    159: \fInpsect\fP to \fInsect\fP;
                    160: .if \n(Vx \{\
                    161: this is correct on many drives.
                    162: Notable exceptions are the RM80 and RA81,
                    163: where npsect should be set to
                    164: one more than nsect.
                    165: This affects only performance (and in the case
                    166: of the RA81, at least, virtually unmeasurably).
                    167: .\}
                    168: .if \n(Th \{\
                    169: this is correct on all drives supported on the CCI.
                    170: .\}
                    171: .FE
                    172: File systems that have had their interleave and npsect values
                    173: set will be diagnosed by the old \fIfsck\fP as having a bad superblock;
                    174: the old \fIfsck\fP will run only if given an alternate superblock
                    175: .if \n(Vx \{\
                    176: (\fIfsck \-b32\fP),
                    177: .\}
                    178: .if \n(Th \{\
                    179: (\fIfsck \-b16\fP),
                    180: .\}
                    181: in which case it will re-zero these fields.
                    182: The \*(4B kernel will internally set these fields to their defaults
                    183: if fsck has not done so; again, the
                    184: .if \n(Vx \{\
                    185: \fI\-b32\fP
                    186: .\}
                    187: .if \n(Th \{\
                    188: \fI\-b16\fP
                    189: .\}
                    190: option may be
                    191: necessary for running the old \fIfsck\fP.
                    192: .PP
                    193: In addition, \*(4B removes several limits on file system sizes
                    194: that were present in both 4.2BSD and 4.3BSD.
                    195: The limited file systems
                    196: continue to work in \*(4B, but should be converted
                    197: as soon as it is convenient
                    198: by running \fIfsck\fP with the \fI\-c\fP option.
                    199: If no file systems have been so converted,
                    200: the sequence \fIfsck \-p \-c\fP will update all of them,
                    201: fix the interleave and npsect fields,
                    202: and fix any incorrect directory lengths
                    203: all at once.
                    204: The new unlimited file system formats are treated as read-only
                    205: by older systems.
                    206: A second \fIfsck \-c\fP, however, will
                    207: reconvert the new format to the old if none of the static limits
                    208: of the old file system format have been exceeded.
                    209: The new file systems are otherwise
                    210: compatible between 4.2BSD, \*(Ps, and \*(4B,
                    211: though running a \*(4B file system under older systems
                    212: may cause more of the above
                    213: messages to be generated the next time it is \fIfsck\fP'ed on \*(4B.
                    214: .NH 2
                    215: Hints on converting from 4.3BSD to \*(4B
                    216: .PP
                    217: The largest visible change between 4.3BSD to \*(4B
                    218: (other than the addition of support for the Tahoe processor)
                    219: is the addition of support for disk labels.
                    220: This facility allows each disk or disk pack to contain all geometry
                    221: information about the disk and the partition layout for the disk.
                    222: Disk labels are supported on all disk types on the Tahoe machines,
                    223: and on hp and ra/rd disks on the VAX.
                    224: See
                    225: .IR disklabel (8)
                    226: and
                    227: .IR disklabel (5).
                    228: Installation of this facility requires use of the new kernel and device
                    229: drivers, bootstraps and other standalone programs,
                    230: /etc/disktab,
                    231: .if \n(Vx \{\
                    232: .IR bad144 (8V),
                    233: .\}
                    234: .IR newfs (8),
                    235: and probably other programs.
                    236: .if \n(Vx \{\
                    237: .PP
                    238: \*(4B includes support for the VAX 8200 and 8250,
                    239: with support for the KDB-50 disk controller on the VAX BI bus,
                    240: contributed by Chris Torek.
                    241: .PP
                    242: The bootstrap programs have been fixed to work on MicroVAX IIs
                    243: and VAXstation II's with QVSS (VS II) or QDSS (GPX) displays;
                    244: the kernel includes support for these displays, courtesy of Digital
                    245: Equipment Corp.
                    246: In order to install the bootstrap on RD52/53/54 disks with
                    247: .IR disklabel (8),
                    248: the new /etc/disktab must be used,
                    249: or the block 0 bootstrap must be explictly listed as /usr/mdec/rdboot
                    250: (\fInot\fP raboot).
                    251: .\}
                    252: .PP
                    253: The order in which daemons are started by /etc/rc and /etc/rc.local
                    254: has changed, and network initialization has been split into /etc/netstart.
                    255: Look at the prototype files, and modify /etc/rc.local as necessary.
                    256: .PP
                    257: \*(4B includes the Olson
                    258: timezone implementation, which uses timezone and daylight-savings-time
                    259: rules loaded from files in /etc/zoneinfo; see
                    260: .IR ctime (3)
                    261: and
                    262: .IR tzfile (5).
                    263: .PP
                    264: The type of the
                    265: .IR sprintf (3S)
                    266: function has been changed from \fIchar *\fP in 4.2BSD and 4.3BSD
                    267: to \fIint\fP as in the proposed ANSI C standard and in System V.
                    268: Programers are discouraged from using the return value from
                    269: .I sprintf
                    270: until this change is ubiquitous.
                    271: Fortunately, the previous return value from
                    272: .I sprintf
                    273: was essentially useless.
                    274: .PP
                    275: The ownership and modes of some directories have changed.
                    276: The \fIat\fP programs now run set-user-id ``root'' instead of ``daemon.''
                    277: Also, the uucp directory no longer needs to be publicly writable,
                    278: as \fItip\fP reverts to privileged status to remove its lock files.
                    279: After copying your version of /usr/spool, you should do:
                    280: .DS
                    281: \fB#\fP \fIchown \-R root /usr/spool/at\fP
                    282: \fB#\fP \fIchown \-R uucp.daemon /usr/spool/uucp\fP
                    283: \fB#\fP \fIchmod \-R o\-w /usr/spool/uucp\fP
                    284: .DE
                    285: .PP
                    286: The MAKEHOSTS file has moved from /usr/hosts to /usr.
                    287: .PP
                    288: The source versions of the manual pages have been moved from
                    289: /usr/man/man[1-8] to /usr/src/man, /usr/src/new/man, and /usr/src/local/man.
                    290: Local manual pages should be moved into their respective source code
                    291: directories, or into /usr/src/local/man/man[1-8], and Makefiles changed to
                    292: install the formatted manual pages into /usr/local/man/cat[1-8].  The shell
                    293: script /usr/man/manroff calls nroff with the standard manual arguments.  An 
                    294: example of installing a manual page might be:
                    295: .DS
                    296: \fB#\fP \fI/usr/man/manroff example.2 > example.0\fP
                    297: \fB#\fP \fIinstall -o bin -g bin -m 444 example.0 /usr/local/man/cat2\fP
                    298: .DE
                    299: .PP
                    300: If you are using the name server, your \fIsendmail\fP configuration
                    301: file will need some minor updates to accommodate it.
                    302: See the ``Sendmail Installation and Operation Guide'' and the sample
                    303: \fIsendmail\fP configuration files in /usr/src/usr.lib/sendmail/cf.
                    304: The sendmail.cf's supplied with this release are alleged to be
                    305: ``generic'', but have only really seen use at Berkeley.  In particular
                    306: there are two points to watch out for.  First, all host names in the
                    307: sendmail.cf itself must be fully qualified names.  Second, the
                    308: sendmail.cf's assume you have a /usr/lib/sendmail that was compiled
                    309: with the resolver library (i.e., not hosttables). This is necessary
                    310: to canonicalize unqualified names into fully-qualified names (e.g.,
                    311: foo -> foo.bar.com).  Using these .cf files with a host table can
                    312: probably be done, but it will be difficult.
                    313: Be sure to regenerate your sendmail frozen configuration file after
                    314: installation of your updated configuration file with the command
                    315: \fI/usr/lib/sendmail -bz\fP.
                    316: The aliases file,
                    317: /usr/lib/aliases has also been changed to add certain well-known addresses.
                    318: 

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.