From owner-freebsd-doc Thu Oct 17 15:35: 5 2002 Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 4218837B404 for ; Thu, 17 Oct 2002 15:35:01 -0700 (PDT) Received: from Kain.sumuk.de (Kain.sumuk.de [213.221.86.114]) by mx1.FreeBSD.org (Postfix) with ESMTP id A52B043E88 for ; Thu, 17 Oct 2002 15:34:59 -0700 (PDT) (envelope-from vincent@sumuk.de) Received: from Moses.earth.sol (Moses.earth.sol [192.168.1.1]) by Kain.sumuk.de (8.12.5/8.12.5) with ESMTP id g9HMYvjv095301; Fri, 18 Oct 2002 00:34:58 +0200 (CEST) (envelope-from vincent@sumuk.de) Received: from Moses.earth.sol (localhost.earth.sol [127.0.0.1]) by Moses.earth.sol (8.12.5/8.12.5) with ESMTP id g9HMYuLS021984; Fri, 18 Oct 2002 00:34:56 +0200 (CEST) (envelope-from vincent@Moses.earth.sol) Received: (from vincent@localhost) by Moses.earth.sol (8.12.5/8.12.5/Submit) id g9HMYtBn021983; Fri, 18 Oct 2002 00:34:55 +0200 (CEST) Date: Fri, 18 Oct 2002 00:34:54 +0200 From: Martin Heinen To: Udo Erdelhoff Cc: freebsd-doc@FreeBSD.ORG Subject: Re: Please review: new handbook chapter on serial install Message-ID: <20021018003454.A20983@sumuk.de> References: <20021015195849.GA76747@nathan.internal> <20021017210306.GA74874@nathan.internal> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20021017210306.GA74874@nathan.internal>; from ue@nathan.ruhr.de on Thu, Oct 17, 2002 at 11:03:06PM +0200 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org On Thu, Oct 17, 2002 at 11:03:06PM +0200, Udo Erdelhoff wrote: > Here's version two: > - correct the typos noticed by various people > - cut down on the use of 'you' > - generally tried to chat less and include more information excellent work, comments inline > Index: chapter.sgml > =================================================================== > RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml,v > retrieving revision 1.66 > diff -u -r1.66 chapter.sgml [ ... ] > + In other words, the only requirements for using a serial > + console to install &os; are a suitably configured system > + (as described in ) > + and a boot medium that contains the right version of > + boot.config. > + > + In theory, this could be a remotely mounted root file ^^^^ What could be a remotely mounted file system? In the first version 'this' was the boot medium, but the reference to the boot medium is lost in this version. In fact, the boot medium could be remotely mounted (not just in theory), thus: The boot medium could be a remotely mounted root ... > + system for a diskless installation, a modified installation > + CD/DVD, or a modified boot floppy. The easiest solution (and > + the only one described in this chapter) is to create a > + modified boot floppy. This is the only variant that can be > + produced with the GENERIC kernel and tools available on a &os; GENERIC? > + box after a standard installation. Please note that this does > + NOT mean that all files have to be not emphasizes 'not' already > + installed from floppy, it is still possible to use a CD-ROM, > + DVD-ROM, or an internet connection to get the files for the > + distributions and packages. shorter: ... to get the distributions and packages. > + The official way of creating a modified boot floppy is to > + modify the scripts and Makefile used by > + make release. This is not required if the It sounds strange to use modify twice (at least to me). How about: The official way of creating a customized boot floppy is to modify the scripts and the Makefile used by ... > + only change is the addition of a > + boot.config file on the boot floppy. The It's common handbook style, but why tell the reader that boot.config is file if we already markup boot.config? > + boot floppy consists of two parts, the boot sector/loader and > + the installation kernel. The latter is stored in a small UFS > + file system that can be modified and manipulated with all the UFS file system doubles 'file system'. UFS partition might be a better choice. What's the difference between modified and manipulated? Manipulated is sufficient here. [ ... ] > + > + Connect your serial console to the new FreeBSD system, > + just as explained above. Above might be far away, it should be link to the appropriate section or completely left out (the link already appeared above). > + > + > + > + Insert the modified kern.flp into > + the disk drive of the new FreeBSD system and reboot it. > + > + > + > + After a while, you should see activity on your serial > + console, probably the spiner, followed by the s!spiner!spinner! as noted by Giorgos :-) [ ... ] > + /stand/sysinstall running as init on serial console > + > +These are the predefined terminal types available to > +sysinstall when running stand-alone. Please choose the > +closest match for your particular terminal. > + > +1 ...................... Standard ANSI terminal. > +2 ...................... VT100 or compatible terminal. > +3 ...................... FreeBSD system console (color). > +4 ...................... FreeBSD system console (monochrome). > + ^^^^^^^^ Is there really a blank line? [ ... ] > + In order to allow log-ins over the serial console, a > + &man.getty.8; must be running on the > + ttyd0. To do this, select > + Configuration, then > + TTYs, and change the settings for We could markup Configuration and TTYs with or . > + ttyd0. The > + status must be set to on, the terminal > + type must match your particular serial > + console. > + > + > + > + Check the boot.config and > + /boot/loader.conf of the newly > + installed &os; system to make sure that it will use a > + serial console during startup. To do this, select > + Fixit from the main menu, then > + shell. or ? Again, excellent work, thanks for writing this. -- Marxpitn To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message