--- doc/en/books/usersguide/installation/chapter.sgml 2004/05/17 19:15:29 1.1
+++ doc/en/books/usersguide/installation/chapter.sgml 2004/06/01 20:00:04 1.2
@@ -12,7 +12,6 @@ $DragonFly$
Justin
Sherrill
- Marked up by
@@ -28,6 +27,11 @@ $DragonFly$
by various protocols. The authorative list can be found at the
DragonFly website.
+ This document may be superseded by the /README file located on the live CD,
+ which may reflect changes made after this document was last updated. Check that
+ README for any last-minute changes and for an abbreviated version of this installation
+ process.
+
The DragonFly development team is working on an automatic installation
tool, which simplifies the partitioning and installation processes. Until this
tool is in place, the manual process here is required. Some experience with
@@ -42,6 +46,13 @@ $DragonFly$
When installing to an old machine, it may not be possible to boot from
a CD. Use a bootmanager on a floppy in those cases, such as
Smart Bootmanager.
+
+
+ Always be sure of the target disk for any command. Unless otherwise
+ specified, each command here assumes the first disk in the IDE chain is
+ the target. (ad0) Adjust commands as needed.
+
+
@@ -60,16 +71,21 @@ $DragonFly$
- &prompt.root; dd if=/dev/zero of=/dev/ad0 bs=32k count=16
+ &prompt.root; dd if=/dev/zero of=/dev/ad0 bs=32k count=16
- The now-empty disk must be formatted. While the following two commands can be issued
- as one,
+ The now-empty disk must be formatted.
+
+
+ This will destroy any existing data on a disk. Do this only if
+ you plan to dedicate this disk to DragonFly.
+
- &prompt.root; fdisk -I ad0
- &prompt.root; fdisk -B ad0
+ &prompt.root; fdisk -I ad0
+ &prompt.root; fdisk -B ad0
+
@@ -95,8 +111,8 @@ $DragonFly$
Create a new partition of at least 5-6 gigabytes. It is possible to
- install within a smaller amount of disk space, but this will create some
- problems that this document does not cover. The newly created partition
+ install within a smaller amount of disk space, but this will create
+ problems not covered by this document. The newly created partition
does not need to be formatted; the rest of the
installation process treats that new partiton as a new disk.
@@ -108,13 +124,8 @@ $DragonFly$
an existing operating system installation.
This type of installation is very similar to installing DragonFly
- as the only operating system. The only difference is the disk named
- in each command.
-
-
-
- Always be sure of the target disk for any command.
-
+ as the only operating system. The only difference is the disk named
+ in each command.
@@ -124,9 +135,8 @@ $DragonFly$
Disk formatting
- The newly created partition, whether part of an existing disk or on a
- completely new drive, needs to be formatted. The following command can
- interactively format your disk.
+ The slice layout on the newly formatted disk or partition needs
+ to be set up, using this command.
&prompt.root; fdisk -u
@@ -146,14 +156,20 @@ $DragonFly$
- &prompt.root; boot0cfg -B ad0
- &prompt.root; boot0cfg -v ad0
+ &prompt.root; boot0cfg -B ad0
+ &prompt.root; boot0cfg -v ad0
-s SLICE, where SLICE is a number, controls which
slice on disk is used by boot0cfg to start from. By default, this number is 1, and
will only need modification if a different slice contains DragonFly.
+ Use -o packet as an option to boot0cfg if the DragonFly
+ partition is located beyond cylinder 1023 on the disk. This location problem usually
+ only happens when another operating system is taking up more than the
+ first 8 gigabytes of disk space. This problem cannot happen if DragonFly is
+ installed to a dedicated disk
+
@@ -161,23 +177,23 @@ $DragonFly$
If DragonFly is installed anywhere but the first partition of the disk,
the device entry for that partition will have to be created. Otherwise, the
device entry is automatically created. Refer to this different partition
- instead of the 'ad0s1a' used in later examples.
+ instead of the 'ad0s1a' used in later examples.
- &prompt.root; cd /dev; ./MAKEDEV ad0s2
+ &prompt.root; cd /dev; ./MAKEDEV ad0s2
The partition needs to be created on the DragonFly disk.
- &prompt.root; disklabel -B -r -w ad0s1 auto
+ &prompt.root; disklabel -B -r -w ad0s1 auto
Using /etc/disklabel.ad0s1 as an example, issue the following command to
edit the disklabel for the just-created partition.
- &prompt.root; disklabel -e ad0s1
+ &prompt.root; disklabel -e ad0s1
@@ -246,246 +262,251 @@ $DragonFly$
newfs will format each individual partition.
- &prompt.root; newfs /dev/ad0s1a
- &prompt.root; newfs -U /dev/ad0s1d
- &prompt.root; newfs -U /dev/ad0s1e
- &prompt.root; newfs -U /dev/ad0s1f
- &prompt.root; newfs -U /dev/ad0s1g
+ &prompt.root; newfs /dev/ad0s1a
+ &prompt.root; newfs -U /dev/ad0s1d
+ &prompt.root; newfs -U /dev/ad0s1e
+ &prompt.root; newfs -U /dev/ad0s1f
+ &prompt.root; newfs -U /dev/ad0s1g
- The root partition does not need softupdates; the
- -U option is not used.
+ The -U option is not used for the root partition,
+ since / is usually relatively small. Softupdates can cause it to
+ run out of space while under a lot of disk activity, such as a buildworld.
-
+
The command listing skips directly from ad0s1a to ad0s1d. This is
because /dev/ad0s1b is used as swap and does not require formatting;
- ad0s1c refers to the entire disk and does not need to be formatted.
+ ad0s1c refers to the entire disk and should not be formatted.
-
-
-
-
+
+ inetd controls various small servers like telnet or ftp. By default,
+ all servers are off, and must be individually uncommented in /etc/inetd.conf
+ to start them. This is optional.
+
+ inetd_enable="YES" # Run the network daemon dispatcher (YES/NO).
+inetd_program="/usr/sbin/inetd" # path to inetd, if you want a different one.
+inetd_flags="-wW" # Optional flags to inetd
--->
+
+
+
+ Network Setup
+ For acquiring an IP address through DHCP, place this entry in /etc/rc.conf,
+ using the appropriate card name. (ep0 is used as an example here.)
+
+
+ ifconfig_ep0="DHCP"
+
+ For a fixed IP, /etc/rc.conf requires a few more lines of data.
+ (Again, ep0 is used as an example here.) Supply the correct local values
+ for IP, netmask, and default router. The hostname should reflect what is
+ entered in DNS for this computer.
+
+
+ ifconfig_ep0="inet 123.234.345.456 netmask 255.255.255.0"
+ hostname="myhostname"
+ defaultrouter="654.543.432.321"
+
+
+
\ No newline at end of file