diff options
Diffstat (limited to 'nl/appendix')
| -rw-r--r-- | nl/appendix/chroot-install.xml | 458 | ||||
| -rw-r--r-- | nl/appendix/example-preseed-etch.xml | 372 | ||||
| -rw-r--r-- | nl/appendix/example-preseed-sarge.xml | 366 | ||||
| -rw-r--r-- | nl/appendix/example-preseed.xml | 39 | ||||
| -rw-r--r-- | nl/appendix/files.xml | 298 | ||||
| -rw-r--r-- | nl/appendix/gpl.xml | 512 | ||||
| -rw-r--r-- | nl/appendix/plip.xml | 194 | ||||
| -rw-r--r-- | nl/appendix/random-bits.xml | 11 |
8 files changed, 2250 insertions, 0 deletions
diff --git a/nl/appendix/chroot-install.xml b/nl/appendix/chroot-install.xml new file mode 100644 index 000000000..cdd173363 --- /dev/null +++ b/nl/appendix/chroot-install.xml @@ -0,0 +1,458 @@ +<!-- retain these comments for translator revision tracking --> +<!-- original version: 31190 untranslated --> + + <sect1 id="linux-upgrade"> + <title>Installing &debian; from a Unix/Linux System</title> + +<para> + +This section explains how to install &debian; from an existing +Unix or Linux system, without using the menu-driven installer as +explained in the rest of the manual. This <quote>cross-install</quote> +HOWTO has been requested by users switching to &debian; from +Red Hat, Mandrake, and SUSE. In this section some familiarity with +entering *nix commands and navigating the file system is assumed. In +this section, <prompt>$</prompt> symbolizes a command to be entered in +the user's current system, while <prompt>#</prompt> refers to a +command entered in the Debian chroot. + +</para><para> + +Once you've got the new Debian system configured to your preference, +you can migrate your existing user data (if any) to it, and keep on +rolling. This is therefore a <quote>zero downtime</quote> &debian; +install. It's also a clever way for dealing with hardware that +otherwise doesn't play friendly with various boot or installation +media. + +</para> + + <sect2> + <title>Getting Started</title> +<para> + +With your current *nix partitioning tools, repartition the hard +drive as needed, creating at least one filesystem plus swap. You +need at least 150MB of space available for a console only install, +or at least 300MB if you plan to install X. + +</para><para> + +To create file systems on your partitions. For example, to create an +ext3 file system on partition <filename>/dev/hda6</filename> (that's +our example root partition): + +<informalexample><screen> +# mke2fs -j /dev/hda6 +</screen></informalexample> + +To create an ext2 file system instead, omit <userinput>-j</userinput>. + +</para><para> + +Initialize and activate swap (substitute the partition number for +your intended Debian swap partition): + +<informalexample><screen> +# mkswap /dev/hda5 +# sync; sync; sync +# swapon /dev/hda5 +</screen></informalexample> + +Mount one partition as <filename>/mnt/debinst</filename> (the +installation point, to be the root (<filename>/</filename>) filesystem +on your new system). The mount point name is strictly arbitrary, it is +referenced later below. + +<informalexample><screen> +# mkdir /mnt/debinst +# mount /dev/hda6 /mnt/debinst +</screen></informalexample> + +</para> +<note><para> + +If you want to have parts of the filesystem (e.g. /usr) mounted on +separate partitions, you will need to create and mount these directories +manually before proceding with the next stage. + +</para></note> + </sect2> + + <sect2> + <title>Install <command>debootstrap</command></title> +<para> + +The tool that the Debian installer uses, which is recognized as the +official way to install a Debian base system, is +<command>debootstrap</command>. It uses <command>wget</command> and +<command>ar</command>, but otherwise depends only on +<classname>/bin/sh</classname>. Install <command>wget</command> and +<command>ar</command> if they aren't already on your current system, +then download and install <command>debootstrap</command>. + +</para><para> + +If you have an rpm-based system, you can use alien to convert the +.deb into .rpm, or download an rpm-ized version at +<ulink url="http://people.debian.org/~blade/install/debootstrap"></ulink> + +</para><para> + +Or, you can use the following procedure to install it +manually. Make a work folder for extracting the .deb into: + +<informalexample><screen> +# mkdir work +# cd work +</screen></informalexample> + +The <command>debootstrap</command> binary is located in the Debian +archive (be sure to select the proper file for your +architecture). Download the <command>debootstrap</command> .deb from +the <ulink url="http://ftp.debian.org/debian/pool/main/d/debootstrap/"> +pool</ulink>, copy the package to the work folder, and extract the +binary files from it. You will need to have root privileges to install +the binaries. + +<informalexample><screen> +# ar -x debootstrap_0.X.X_arch.deb +# cd / +# zcat /full-path-to-work/work/data.tar.gz | tar xv +</screen></informalexample> + +</para><para> + +Note that running <command>debootstrap</command> may require you to have +a minimal version of <classname>glibc</classname> installed (currently +GLIBC_2.3). <command>debootstrap</command> itself is a shell script, but +it calls various utilities that require <classname>glibc</classname>. + +</para> + </sect2> + + <sect2> + <title>Run <command>debootstrap</command></title> +<para> + +<command>debootstrap</command> can download the needed files directly +from the archive when you run it. You can substitute any Debian +archive mirror for <userinput>http.us.debian.org/debian</userinput> in +the command example below, preferably a mirror close to you +network-wise. Mirrors are listed at +<ulink url="http://www.debian.org/misc/README.mirrors"></ulink>. + +</para><para> + +If you have a &releasename; &debian; CD mounted at +<filename>/cdrom</filename>, you could substitute a file URL instead +of the http URL: <userinput>file:/cdrom/debian/</userinput> + +</para><para> + +Substitute one of the following for <replaceable>ARCH</replaceable> +in the <command>debootstrap</command> command: + +<userinput>alpha</userinput>, +<userinput>arm</userinput>, +<userinput>hppa</userinput>, +<userinput>i386</userinput>, +<userinput>ia64</userinput>, +<userinput>m68k</userinput>, +<userinput>mips</userinput>, +<userinput>mipsel</userinput>, +<userinput>powerpc</userinput>, +<userinput>s390</userinput>, or +<userinput>sparc</userinput>. + +<informalexample><screen> +# /usr/sbin/debootstrap --arch ARCH &releasename; \ + /mnt/debinst http://http.us.debian.org/debian +</screen></informalexample> + +</para> + </sect2> + + <sect2> + <title>Configure The Base System</title> +<para> + +Now you've got a real Debian system, though rather lean, on disk. +<command>Chroot</command> into it: + +<informalexample><screen> +# LANG= chroot /mnt/debinst /bin/bash +</screen></informalexample> + +</para> + + <sect3> + <title>Mount Partitions</title> +<para> + +You need to create <filename>/etc/fstab</filename>. + +<informalexample><screen> +# editor /etc/fstab +</screen></informalexample> + +Here is a sample you can modify to suit: + +<informalexample><screen> +# /etc/fstab: static file system information. +# +# file system mount point type options dump pass +/dev/XXX / ext3 defaults 0 1 +/dev/XXX /boot ext3 ro,nosuid,nodev 0 2 + +/dev/XXX none swap sw 0 0 +proc /proc proc defaults 0 0 + +/dev/fd0 /mnt/floppy auto noauto,rw,sync,user,exec 0 0 +/dev/cdrom /mnt/cdrom iso9660 noauto,ro,user,exec 0 0 + +/dev/XXX /tmp ext3 rw,nosuid,nodev 0 2 +/dev/XXX /var ext3 rw,nosuid,nodev 0 2 +/dev/XXX /usr ext3 rw,nodev 0 2 +/dev/XXX /home ext3 rw,nosuid,nodev 0 2 +</screen></informalexample> + +Use <userinput>mount -a</userinput> to mount all the file systems you +have specified in your <filename>/etc/fstab</filename>, or to mount +file systems individually use: + +<informalexample><screen> +# mount /path # e.g.: mount /usr +</screen></informalexample> + +You can mount the proc file system multiple times and to arbitrary +locations, though <filename>/proc</filename> is customary. If you didn't use +<userinput>mount -a</userinput>, be sure to mount proc before continuing: + +<informalexample><screen> +# mount -t proc proc /proc +</screen></informalexample> + +</para><para> + +The command <userinput>ls /proc</userinput> should now show a non-empty +directory. Should this fail, you may be able to mount proc from outside +the chroot: + +<informalexample><screen> +# mount -t proc proc /mnt/debinst/proc +</screen></informalexample> + +</para> + </sect3> + + <sect3> + <title>Configure Keyboard</title> +<para> + +To configure your keyboard: + +<informalexample><screen> +# dpkg-reconfigure console-data +</screen></informalexample> + +</para><para> + +Note that the keyboard cannot be set while in the chroot, but will be +configured for the next reboot. + +</para> + </sect3> + + <sect3> + <title>Configure Networking</title> +<para> + +To configure networking, edit +<filename>/etc/network/interfaces</filename>, +<filename>/etc/resolv.conf</filename>, and +<filename>/etc/hostname</filename>. + +<informalexample><screen> +# editor /etc/network/interfaces +</screen></informalexample> + +Here are some simple examples from +<filename>/usr/share/doc/ifupdown/examples</filename>: + +<informalexample><screen> +###################################################################### +# /etc/network/interfaces -- configuration file for ifup(8), ifdown(8) +# See the interfaces(5) manpage for information on what options are +# available. +###################################################################### + +# We always want the loopback interface. +# +auto lo +iface lo inet loopback + +# To use dhcp: +# +# auto eth0 +# iface eth0 inet dhcp + +# An example static IP setup: (broadcast and gateway are optional) +# +# auto eth0 +# iface eth0 inet static +# address 192.168.0.42 +# network 192.168.0.0 +# netmask 255.255.255.0 +# broadcast 192.168.0.255 +# gateway 192.168.0.1 +</screen></informalexample> + +Enter your nameserver(s) and search directives in +<filename>/etc/resolv.conf</filename>: + +<informalexample><screen> +# editor /etc/resolv.conf +</screen></informalexample> + +A simple <filename>/etc/resolv.conf</filename>: + +<informalexample><screen> +search hqdom.local\000 +nameserver 10.1.1.36 +nameserver 192.168.9.100 +</screen></informalexample> + +Enter your system's host name (2 to 63 characters): + +<informalexample><screen> +# echo DebianHostName > /etc/hostname +</screen></informalexample> + +If you have multiple network cards, you should arrange the names of +driver modules in the <filename>/etc/modules</filename> file into the +desired order. Then during boot, each card will be associated with the +interface name (eth0, eth1, etc.) that you expect. + +</para> + </sect3> + + <sect3> + <title>Configure Timezone, Users, and APT</title> +<para> + +Set your timezone, add a normal user, and choose your <command>apt</command> +sources by running + +<informalexample><screen> +# /usr/sbin/base-config new +</screen></informalexample> + +</para> + </sect3> + + <sect3> + <title>Configure Locales</title> +<para> + +To configure your locale settings to use a language other than +English, install the locales support package and configure it: + +<informalexample><screen> +# apt-get install locales +# dpkg-reconfigure locales +</screen></informalexample> + +NOTE: Apt must be configured before, ie. during the base-config phase. +Before using locales with character sets other than ASCII or latin1, +please consult the appropriate localization HOWTO. + +</para> + </sect3> + </sect2> + + <sect2> + <title>Install a Kernel</title> +<para> + +If you intend to boot this system, you probably want a Linux kernel +and a boot loader. Identify available pre-packaged kernels with + +<informalexample><screen> +# apt-cache search kernel-image +</screen></informalexample> + +Then install your choice using its package name. + +<informalexample><screen> +# apt-get install kernel-image-<replaceable>2.X.X-arch-etc</replaceable> +</screen></informalexample> + +</para> + </sect2> + + <sect2> +<title>Set up the Boot Loader</title> +<para> + +To make your &debian; system bootable, set up your boot loader to load +the installed kernel with your new root partition. Note that debootstrap +does not install a boot loader, though you can use apt-get inside your +Debian chroot to do so. + +</para><para arch="i386"> + +Check <userinput>info grub</userinput> or <userinput>man +lilo.conf</userinput> for instructions on setting up the +bootloader. If you are keeping the system you used to install Debian, just +add an entry for the Debian install to your existing grub +<filename>menu.lst</filename> or <filename>lilo.conf</filename>. For +<filename>lilo.conf</filename>, you could also copy it to the new system and +edit it there. After you are done editing, call lilo (remember it will use +<filename>lilo.conf</filename> relative to the system you call it from). + +</para><para arch="i386"> + +Here is a basic <filename>/etc/lilo.conf</filename> as an example: + +<informalexample><screen> +boot=/dev/hda6 +root=/dev/hda6 +install=menu +delay=20 +lba32 +image=/vmlinuz +label=Debian +</screen></informalexample> + +</para><para arch="powerpc"> + +Check <userinput>man yaboot.conf</userinput> for instructions on +setting up the bootloader. If you are keeping the system you used to +install Debian, just add an entry for the Debian install to your +existing <filename>yaboot.conf</filename>. You could also copy it to +the new system and +edit it there. After you are done editing, call ybin (remember it will +use <filename>yaboot.conf</filename> relative to the system you call it from). + +</para><para arch="powerpc"> + +Here is a basic <filename>/etc/yaboot.conf</filename> as an example: + +<informalexample><screen> +boot=/dev/hda2 +device=hd: +partition=6 +root=/dev/hda6 +magicboot=/usr/lib/yaboot/ofboot +timeout=50 +image=/vmlinux +label=Debian +</screen></informalexample> + +On some machines, you may need to use <userinput>ide0:</userinput> +instead of <userinput>hd:</userinput>. + +</para> + </sect2> + </sect1> diff --git a/nl/appendix/example-preseed-etch.xml b/nl/appendix/example-preseed-etch.xml new file mode 100644 index 000000000..79d3e143f --- /dev/null +++ b/nl/appendix/example-preseed-etch.xml @@ -0,0 +1,372 @@ +<!-- retain these comments for translator revision tracking --> +<!-- original version: 30373 untranslated --> + +<informalexample condition="etch"><screen> +#### Startup. + +# To use a preseed file, you'll first need to boot the installer, +# and tell it what preseed file to use. This is done by passing the +# kernel a boot parameter, either manually at boot or by editing the +# syslinux.cfg (or similar) file and adding the parameter to the end +# of the append line(s) for the kernel. +# +# If you're netbooting, use this: +# preseed/url=http://host/path/to/preseed +# If you're remastering a CD, you could use this: +# preseed/file=/cdrom/preseed +# If you're installing from USB media, use this, and put the preseed file +# in the toplevel directory of the USB stick. +# preseed/file=/hd-media/preseed +# +# If you feel comfortable modifying the installer's initrd image, +# you can also place a preseed file in the root directory of the initrd's +# filesystem, named "preseed.cfg" -- the installer will always use this +# file if it is present. Otherwise, be sure to copy this file to the location +# you specify. +# +# To make sure the installer gets the right preseed file, you can specify +# a checksum for the file. Currently this needs to be a md5sum, and if +# specified it must match the file or the installer will refuse to use the +# file. +# preseed/url/checksum=5da499872becccfeda2c4872f9171c3d +# preseed/file/checksum=5da499872becccfeda2c4872f9171c3d +# +# Some parts of the installation process cannot be automated using +# some forms of preseeding, because the questions are asked before +# the preseed file is loaded. For example, if the preseed file is +# downloaded over the network, the network setup must be done first. +# One reason to use initrd preseeding is that it allows preseeding +# of even these early steps of the installation process. +# +# If a preseed file cannot be used to preseed some steps, the install can +# still be fully automated, since you can pass preseed values to the kernel +# on the command line. Just pass path/to/var=value for any of the preseed +# variables listed below. +# +# While you're at it, you may want to throw a debconf/priority=critical in +# there, to avoid most questions even if the preseeding below misses some. +# And you might set the timeout to 1 in syslinux.cfg to avoid needing to hit +# enter to boot the installer. +# +# Note that the 2.4 kernel accepts a maximum of 8 command line options and +# 8 environment options (including any options added by default for the +# installer). If these numbers are exceeded, 2.4 kernels will drop any +# excess options and 2.6 kernels will panic. With kernel 2.6.9 or newer, +# you can use 32 command line options and 32 environment options. +# +# Some of the default options, like 'vga=normal' may be safely removed +# for most installations, which may allow you to add more options for +# preseeding. + +# To select your language and country, use this setting, but remember +# that this will only work for initrd based preseeding, for other forms of +# preseeding you must convert it into a kernel parameter, +# such as debian-installer/locale=en_US +d-i debian-installer/locale string en_US + +# To select your keyboard, use this setting. Again it will need to be +# passed as a kernel parameter for most preseed setups. +d-i console-keymaps-at/keymap select us + +#### Network configuration. + +# Of course, this won't work if you're loading your preseed file from the +# network! But it's great if you're booting from CD or USB stick. You can +# also pass network config parameters in on the kernel params if you are +# loading preseed files from the network. + +# netcfg will choose an interface that has link if possible. This makes it +# skip displaying a list if there is more than one interface. +d-i netcfg/choose_interface select auto + +# If you have a slow dhcp server and the installer times out waiting for +# it, this might be useful. +#d-i netcfg/dhcp_timeout string 60 + +# If you prefer to configure the network manually, here's how: +#d-i netcfg/disable_dhcp boolean true +#d-i netcfg/get_nameservers string 192.168.1.1 +#d-i netcfg/get_ipaddress string 192.168.1.42 +#d-i netcfg/get_netmask string 255.255.255.0 +#d-i netcfg/get_gateway string 192.168.1.1 +#d-i netcfg/confirm_static boolean true + +# Note that any hostname and domain names assigned from dhcp take +# precedence over values set here. However, setting the values still +# prevents the questions from being shown even if values come from dhcp. +d-i netcfg/get_hostname string unassigned-hostname +d-i netcfg/get_domain string unassigned-domain + +# Disable that annoying WEP key dialog. +d-i netcfg/wireless_wep string +# The wacky dhcp hostname that some ISPs use as a password of sorts. +#d-i netcfg/dhcp_hostname string radish + +#### Mirror settings. + +d-i mirror/country string enter information manually +d-i mirror/http/hostname string http.us.debian.org +d-i mirror/http/directory string /debian +d-i mirror/http/proxy string + +# What suite of Debian to install. +#d-i mirror/suite string testing +# What suite of Debian to use for loading installer components. +# (Defaults to same as mirror/suite.) +#d-i mirror/udeb/suite string testing + +#### Partitioning. + +# If the system has free space you can choose to only partition that space. +#d-i partman-auto/init_automatically_partition \ +# select Use the largest continuous free space + +# Alternatively, you can specify a disk to partition. The device name can +# be given in either devfs or traditional non-devfs format. +# For example, to use the first disk devfs knows of: +d-i partman-auto/disk string /dev/discs/disc0/disc + +# You can choose from any of the predefined partitioning recipes: +d-i partman-auto/choose_recipe \ + select All files in one partition (recommended for new users) +#d-i partman-auto/choose_recipe select Desktop machine +#d-i partman-auto/choose_recipe select Multi-user workstation + +# Or provide a recipe of your own... +# The recipe format is documented in the file devel/partman-auto-recipe.txt. +# If you have a way to get a recipe file into the d-i environment, you can +# just point at it. +#d-i partman-auto/expert_recipe_file string /hd-media/recipe + +# If not, you can put an entire recipe the preseed file in one (logical) +# line. This example creates a small /boot partition, suitable swap, and +# uses the rest of the space for the root partition: +#d-i partman-auto/expert_recipe string \ +# boot-root :: \ +# 40 50 100 ext3 \ +# $primary{ } $bootable{ } \ +# method{ format } format{ } \ +# use_filesystem{ } filesystem{ ext3 } \ +# mountpoint{ /boot } \ +# . \ +# 500 10000 1000000000 ext3 \ +# method{ format } format{ } \ +# use_filesystem{ } filesystem{ ext3 } \ +# mountpoint{ / } \ +# . \ +# 64 512 300% linux-swap \ +# method{ swap } format{ } \ +# . + +# This makes partman automatically partition without confirmation. +d-i partman/confirm_write_new_label boolean true +d-i partman/choose_partition \ + select Finish partitioning and write changes to disk +d-i partman/confirm boolean true + +#### Boot loader installation. + +# Grub is the default boot loader (for x86). If you want lilo installed +# instead, uncomment this: +#d-i grub-installer/skip boolean true + +# This is fairly safe to set, it makes grub install automatically to the MBR +# if no other operating system is detected on the machine. +d-i grub-installer/only_debian boolean true + +# This one makes grub-installer install to the MBR if if finds some other OS +# too, which is less safe as it might not be able to boot that other OS. +d-i grub-installer/with_other_os boolean true + +# Alternatively, if you want to install to a location other than the mbr, +# uncomment and edit these lines: +#d-i grub-installer/bootdev string (hd0,0) +#d-i grub-installer/only_debian boolean false +#d-i grub-installer/with_other_os boolean false + +#### Finishing up the first stage install. + +# Avoid that last message about the install being complete. +d-i prebaseconfig/reboot_in_progress note + +# This will prevent the installer from ejecting the CD during the reboot, +# which is useful in some situations. +#d-i cdrom-detect/eject boolean false + +#### Shell commands. + +# d-i preseeding is inherently not secure. Nothing in the installer checks +# for attempts at buffer overflows or other exploits of the values of a +# preseed file like this one. Only use preseed files from trusted +# locations! To drive that home, and because it's generally useful, here's +# a way to run any shell command you'd like inside the installer, +# automatically. + +# This first command is run as early as possible, just after +# preseeding is read. +#d-i preseed/early_command string anna-install some-udeb + +# This command is run just before the install finishes, but when there is +# still a usable /target directory. +#d-i preseed/late_command string echo foo > /target/etc/bar + +# This command is run just as base-config is starting up. +#base-config base-config/early_command string echo hi mom + +# This command is run after base-config is done, just before the login: +# prompt. This is a good way to install a set of packages you want, or to +# tweak the configuration of the system. +#base-config base-config/late_command \ +# string apt-get install zsh; chsh -s /bin/zsh + +###### Preseeding the 2nd stage of the installation. + +#### Preseeding base-config. + +# Avoid the introductory message. +base-config base-config/intro note + +# Avoid the final message. +base-config base-config/login note + +# If you installed a display manager, but don't want to start it immediately +# after base-config finishes. +#base-config base-config/start-display-manager boolean false + +# Some versions of the installer can report back on what you've installed. +# The default is not to report back, but sending reports helps the project +# determine what software is most popular and include it on CDs. +#popularity-contest popularity-contest/participate boolean false + +#### Clock and time zone setup. + +# Controls whether or not the hardware clock is set to UTC. +d-i clock-setup/utc boolean true + +# You may set this to any valid setting for $TZ; see the contents of +# /usr/share/zoneinfo/ for options. +d-i time/zone string US/Eastern + +#### Account setup. + +# To preseed the root password, you have to put it in the clear in this +# file. That is not a very good idea, use caution! +#passwd passwd/root-password password r00tme +#passwd passwd/root-password-again password r00tme + +# If you want to skip creation of a normal user account. +#passwd passwd/make-user boolean false + +# Alternatively, you can preseed the user's name and login. +#passwd passwd/user-fullname string Debian User +#passwd passwd/username string debian +# And their password, but use caution! +#passwd passwd/user-password password insecure +#passwd passwd/user-password-again password insecure + +#### Apt setup. + +# This question controls what source the second stage installation uses +# for packages. Choices are cdrom, http, ftp, filesystem, edit sources list +# by hand +base-config apt-setup/uri_type select http + +# If you choose ftp or http, you'll be asked for a country and a mirror. +base-config apt-setup/country select enter information manually +base-config apt-setup/hostname string http.us.debian.org +base-config apt-setup/directory string /debian +# Stop after choosing one mirror. +base-config apt-setup/another boolean false + +# You can choose to install non-free and contrib software. +#base-config apt-setup/non-free boolean true +#base-config apt-setup/contrib boolean true + +# Do enable security updates. +base-config apt-setup/security-updates boolean true + +#### Package selection. + +# You can choose to install any combination of tasks that are available. +# Available tasks as of this writing include: Desktop environment, +# Web server, Print server, DNS server, File server, Mail server, +# SQL database, Laptop, Standard system, manual package selection. The +# last of those will run aptitude. You can also choose to install no +# tasks, and force the installation of a set of packages in some other +# way. We recommend always including the Standard system task. +tasksel tasksel/first multiselect Desktop environment, Standard system +#tasksel tasksel/first multiselect Web server, Standard system + +#### Mailer configuration. + +# During a normal install, exim asks only a few questions. Here's how to +# avoid even those. More complicated preseeding is possible. +exim4-config exim4/dc_eximconfig_configtype \ + select no configuration at this time +exim4-config exim4/no_config boolean true +exim4-config exim4/no_config boolean true + +# It's a good idea to set this to whatever user account you choose to +# create. Leaving the value blank results in postmaster mail going to +# /var/mail/mail. +exim4-config exim4/dc_postmaster string + +#### X Configuration. + +# Preseeding Debian's X config is possible, but you probably need to know +# some details about the video hardware of the machine, since Debian's X +# configurator does not do fully automatic configuration of everything. + +# X can detect the right driver for some cards, but if you're preseeding, +# you override whatever it chooses. Still, vesa will work most places. +#xserver-xfree86 xserver-xfree86/config/device/driver select vesa + +# A caveat with mouse autodetection is that if it fails, X will retry it +# over and over. So if it's preseeded to be done, there is a possibility of +# an infinite loop if the mouse is not autodetected. +#xserver-xfree86 xserver-xfree86/autodetect_mouse boolean true + +# Monitor autodetection is recommended. +xserver-xfree86 xserver-xfree86/autodetect_monitor boolean true +# Uncomment if you have an LCD display. +#xserver-xfree86 xserver-xfree86/config/monitor/lcd boolean true +# X has three configuration paths for the monitor. Here's how to preseed +# the "medium" path, which is always available. The "simple" path may not +# be available, and the "advanced" path asks too many questions. +xserver-xfree86 xserver-xfree86/config/monitor/selection-method \ + select medium +xserver-xfree86 xserver-xfree86/config/monitor/mode-list \ + select 1024x768 @ 60 Hz + +#### Everything else. + +# Depending on what software you choose to install, or if things go wrong +# during the installation process, it's possible that other questions may +# be asked. You can preseed those too, of course. To get a list of every +# possible question that could be asked during an install, do an +# installation, and then run these commands: +# debconf-get-selections --installer > file +# debconf-get-selections >> file + +# If you like, you can include other preseed files into this one. +# Any settings in those files will override pre-existing settings from this +# file. More that one file can be listed, separated by spaces; all will be +# loaded. The included files can have preseed/include directives of their +# own as well. Note that if the filenames are relative, they are taken from +# the same directory as the preseed file that includes them. +#d-i preseed/include string x.cfg + +# The installer can optionally verify checksums of preseed files before +# using them. Currently only md5sums are supported, list the md5sums +# in the same order as the list of files to include. +#d-i preseed/include/checksum string 5da499872becccfeda2c4872f9171c3d + +# More flexibly, this runs a shell command and if it outputs the names of +# preseed files, includes those files. +#d-i preseed/include_command \ +# string echo if [ "`hostname`" = bob ]; then echo bob.cfg; fi + +# To check the format of your preseed file before performing an install, +# you can use debconf-set-selections: +# debconf-set-selections -c preseed.cfg +</screen></informalexample> diff --git a/nl/appendix/example-preseed-sarge.xml b/nl/appendix/example-preseed-sarge.xml new file mode 100644 index 000000000..3d79dda57 --- /dev/null +++ b/nl/appendix/example-preseed-sarge.xml @@ -0,0 +1,366 @@ +<!-- retain these comments for translator revision tracking --> +<!-- original version: 30372 untranslated --> + +<informalexample condition="sarge"><screen> +#### Startup. + +# To use a preseed file, you'll first need to boot the installer, +# and tell it what preseed file to use. This is done by passing the +# kernel a boot parameter, either manually at boot or by editing the +# syslinux.cfg (or similar) file and adding the parameter to the end +# of the append line(s) for the kernel. +# +# If you're netbooting, use this: +# preseed/url=http://host/path/to/preseed +# If you're remastering a CD, you could use this: +# preseed/file=/cdrom/preseed +# If you're installing from USB media, use this, and put the preseed file +# in the toplevel directory of the USB stick. +# preseed/file=/hd-media/preseed +# Be sure to copy this file to the location you specify. +# +# Some parts of the installation process cannot be automated using +# some forms of preseeding, because the questions are asked before +# the preseed file is loaded. For example, if the preseed file is +# downloaded over the network, the network setup must be done first. +# One reason to use initrd preseeding is that it allows preseeding +# of even these early steps of the installation process. +# +# If a preseed file cannot be used to preseed some steps, the install can +# still be fully automated, since you can pass preseed values to the kernel +# on the command line. Just pass path/to/var=value for any of the preseed +# variables listed below. +# +# While you're at it, you may want to throw a debconf/priority=critical in +# there, to avoid most questions even if the preseeding below misses some. +# And you might set the timeout to 1 in syslinux.cfg to avoid needing to hit +# enter to boot the installer. +# +# Note that the kernel accepts a maximum of 8 command line options and +# 8 environment options (including any options added by default for the +# installer). If these numbers are exceeded, 2.4 kernels will drop any +# excess options and 2.6 kernels will panic. With kernel 2.6.9 or newer, +# you can use 32 command line options and 32 environment options. +# +# Some of the default options, like 'vga=normal' may be safely removed +# for most installations, which may allow you to add more options for +# preseeding. + +# It is not possible to use preseeding to set language, country, and +# keyboard. Instead you should use kernel parameters. Example: +# languagechooser/language-name=English +# countrychooser/shortlist=US +# console-keymaps-at/keymap=us + +#### Network configuration. + +# Of course, this won't work if you're loading your preseed file from the +# network! But it's great if you're booting from CD or USB stick. You can +# also pass network config parameters in on the kernel params if you are +# loading preseed files from the network. + +# netcfg will choose an interface that has link if possible. This makes it +# skip displaying a list if there is more than one interface. +d-i netcfg/choose_interface select auto + +# If you have a slow dhcp server and the installer times out waiting for +# it, this might be useful. +#d-i netcfg/dhcp_timeout string 60 + +# If you prefer to configure the network manually, here's how: +#d-i netcfg/disable_dhcp boolean true +#d-i netcfg/get_nameservers string 192.168.1.1 +#d-i netcfg/get_ipaddress string 192.168.1.42 +#d-i netcfg/get_netmask string 255.255.255.0 +#d-i netcfg/get_gateway string 192.168.1.1 +#d-i netcfg/confirm_static boolean true + +# Note that any hostname and domain names assigned from dhcp take +# precedence over values set here. However, setting the values still +# prevents the questions from being shown even if values come from dhcp. +d-i netcfg/get_hostname string unassigned-hostname +d-i netcfg/get_domain string unassigned-domain + +# Disable that annoying WEP key dialog. +d-i netcfg/wireless_wep string +# The wacky dhcp hostname that some ISPs use as a password of sorts. +#d-i netcfg/dhcp_hostname string radish + +#### Mirror settings. + +d-i mirror/country string enter information manually +d-i mirror/http/hostname string http.us.debian.org +d-i mirror/http/directory string /debian +d-i mirror/suite string testing +d-i mirror/http/proxy string + +#### Partitioning. + +# If the system has free space you can choose to only partition that space. +#d-i partman-auto/init_automatically_partition \ +# select Use the largest continuous free space + +# Alternatively, you can specify a disk to partition. The device name can +# be given in either devfs or traditional non-devfs format. +# For example, to use the first disk devfs knows of: +d-i partman-auto/disk string /dev/discs/disc0/disc + +# You can choose from any of the predefined partitioning recipes: +d-i partman-auto/choose_recipe select \ + All files in one partition (recommended for new users) +#d-i partman-auto/choose_recipe select Desktop machine +#d-i partman-auto/choose_recipe select Multi-user workstation + +# Or provide a recipe of your own... +# The recipe format is documented in the file devel/partman-auto-recipe.txt. +# If you have a way to get a recipe file into the d-i environment, you can +# just point at it. +#d-i partman-auto/expert_recipe_file string /hd-media/recipe + +# If not, you can put an entire recipe in one line. This example creates +# a small /boot partition, suitable swap, and uses the rest of the space +# for the root partition: +#d-i partman-auto/expert_recipe string boot-root :: \ +# 20 50 100 ext3 $primary{ } $bootable{ } method{ format } format{ } \ +# use_filesystem{ } filesystem{ ext3 } mountpoint{ /boot } . \ +# 500 10000 1000000000 ext3 method{ format } format{ } \ +# use_filesystem{ } filesystem{ ext3 } mountpoint{ / } . \ +# 64 512 300% linux-swap method{ swap } format{ } . +# For reference, here is that same recipe in a more readable form: +# boot-root :: +# 40 50 100 ext3 +# $primary{ } $bootable{ } +# method{ format } format{ } +# use_filesystem{ } filesystem{ ext3 } +# mountpoint{ /boot } +# . +# 500 10000 1000000000 ext3 +# method{ format } format{ } +# use_filesystem{ } filesystem{ ext3 } +# mountpoint{ / } +# . +# 64 512 300% linux-swap +# method{ swap } format{ } +# . + +# This makes partman automatically partition without confirmation. +d-i partman/confirm_write_new_label boolean true +d-i partman/choose_partition select \ + Finish partitioning and write changes to disk +d-i partman/confirm boolean true + +#### Boot loader installation. + +# Grub is the default boot loader (for x86). If you want lilo installed +# instead, uncomment this: +#d-i grub-installer/skip boolean true + +# This is fairly safe to set, it makes grub install automatically to the MBR +# if no other operating system is detected on the machine. +d-i grub-installer/only_debian boolean true + +# This one makes grub-installer install to the MBR if if finds some other OS +# too, which is less safe as it might not be able to boot that other OS. +d-i grub-installer/with_other_os boolean true + +# Alternatively, if you want to install to a location other than the mbr, +# uncomment and edit these lines: +#d-i grub-installer/bootdev string (hd0,0) +#d-i grub-installer/only_debian boolean false +#d-i grub-installer/with_other_os boolean false + +#### Finishing up the first stage install. + +# Avoid that last message about the install being complete. +d-i prebaseconfig/reboot_in_progress note + +#### Shell commands. + +# d-i preseeding is inherently not secure. Nothing in the installer checks +# for attempts at buffer overflows or other exploits of the values of a +# preseed file like this one. Only use preseed files from trusted +# locations! To drive that home, and because it's generally useful, here's +# a way to run any shell command you'd like inside the installer, +# automatically. + +# This first command is run as early as possible, just after +# preseeding is read. +#d-i preseed/early_command string anna-install some-udeb + +# This command is run just before the install finishes, but when there is +# still a usable /target directory. +#d-i preseed/late_command string echo foo > /target/etc/bar + +# This command is run just as base-config is starting up. +#base-config base-config/early_command string echo hi mom + +# This command is run after base-config is done, just before the login: +# prompt. This is a good way to install a set of packages you want, or to +# tweak the configuration of the system. +#base-config base-config/late_command string \ +# apt-get install zsh; chsh -s /bin/zsh + +###### Preseeding the 2nd stage of the installation. + +#### Preseeding base-config. + +# Avoid the introductory message. +base-config base-config/intro note + +# Avoid the final message. +base-config base-config/login note + +# If you installed a display manager, but don't want to start it immediately +# after base-config finishes. +#base-config base-config/start-display-manager boolean false + +# Some versions of the installer can report back on what you've installed. +# The default is not to report back, but sending reports helps the project +# determine what software is most popular and include it on CDs. +#popularity-contest popularity-contest/participate boolean false + +#### Clock and time zone setup. + +# Controls whether or not the hardware clock is set to UTC. +#base-config tzconfig/gmt boolean true +# If you told the installer that you're in the United States, then you +# can set the time zone using this variable. +# (Choices are: Eastern, Central, Mountain, Pacific, Alaska, Hawaii, +# Aleutian, Arizona East-Indiana, Indiana-Starke, Michigan, Samoa, other) +#base-config tzconfig/choose_country_zone/US select Eastern +# If you told it you're in Canada. +# (Choices are: Newfoundland, Atlantic, Eastern, Central, +# East-Saskatchewan, Saskatchewan, Mountain, Pacific, Yukon, other) +#base-config tzconfig/choose_country_zone/CA select Eastern +# If you told it you're in Brazil. (Choices are: East, West, Acre, +# DeNoronha, other) +#base-config tzconfig/choose_country_zone/BR select East +# Many countries have only one time zone. If you told the installer you're +# in one of those countries, you can choose its standard time zone via this +# question. +#base-config tzconfig/choose_country_zone_single boolean true +# This question is asked as a fallback for countries other than those +# listed above, which have more than one time zone. You can preseed one of +# the time zones, or "other". +#base-config tzconfig/choose_country_zone_multiple select + +#### Account setup. + +# To preseed the root password, you have to put it in the clear in this +# file. That is not a very good idea, use caution! +#passwd passwd/root-password password r00tme +#passwd passwd/root-password-again password r00tme + +# If you want to skip creation of a normal user account. +#passwd passwd/make-user boolean false + +# Alternatively, you can preseed the user's name and login. +#passwd passwd/user-fullname string Debian User +#passwd passwd/username string debian +# And their password, but use caution! +#passwd passwd/user-password password insecure +#passwd passwd/user-password-again password insecure + +#### Apt setup. + +# This question controls what source the second stage installation uses +# for packages. Choices are cdrom, http, ftp, filesystem, edit sources list +# by hand +base-config apt-setup/uri_type select http + +# If you choose ftp or http, you'll be asked for a country and a mirror. +base-config apt-setup/country select enter information manually +base-config apt-setup/hostname string http.us.debian.org +base-config apt-setup/directory string /debian +# Stop after choosing one mirror. +base-config apt-setup/another boolean false + +# You can choose to install non-free and contrib software. +#base-config apt-setup/non-free boolean true +#base-config apt-setup/contrib boolean true + +# Do enable security updates. +base-config apt-setup/security-updates boolean true + +#### Package selection. + +# You can choose to install any combination of tasks that are available. +# Available tasks as of this writing include: Desktop environment, +# Web server, Print server, DNS server, File server, Mail server, +# SQL database, Laptop, Standard system, manual package selection. The +# last of those will run aptitude. You can also choose to install no +# tasks, and force the installation of a set of packages in some other +# way. We recommend always including the Standard system task. +tasksel tasksel/first multiselect Desktop environment, Standard system +#tasksel tasksel/first multiselect Web server, Standard system + +#### Mailer configuration. + +# During a normal install, exim asks only a few questions. Here's how to +# avoid even those. More complicated preseeding is possible. +exim4-config exim4/dc_eximconfig_configtype \ + select no configuration at this time +exim4-config exim4/no_config boolean true +exim4-config exim4/no_config boolean true + +# It's a good idea to set this to whatever user account you choose to +# create. Leaving the value blank results in postmaster mail going to +# /var/mail/mail. +exim4-config exim4/dc_postmaster string + +#### X Configuration. + +# Preseeding Debian's X config is possible, but you probably need to know +# some details about the video hardware of the machine, since Debian's X +# configurator does not do fully automatic configuration of everything. + +# X can detect the right driver for some cards, but if you're preseeding, +# you override whatever it chooses. Still, vesa will work most places. +#xserver-xfree86 xserver-xfree86/config/device/driver select vesa + +# A caveat with mouse autodetection is that if it fails, X will retry it +# over and over. So if it's preseeded to be done, there is a possibility of +# an infinite loop if the mouse is not autodetected. +#xserver-xfree86 xserver-xfree86/autodetect_mouse boolean true + +# Monitor autodetection is recommended. +xserver-xfree86 xserver-xfree86/autodetect_monitor boolean true +# Uncomment if you have an LCD display. +#xserver-xfree86 xserver-xfree86/config/monitor/lcd boolean true +# X has three configuration paths for the monitor. Here's how to preseed +# the "medium" path, which is always available. The "simple" path may not +# be available, and the "advanced" path asks too many questions. +xserver-xfree86 xserver-xfree86/config/monitor/selection-method \ + select medium +xserver-xfree86 xserver-xfree86/config/monitor/mode-list \ + select 1024x768 @ 60 Hz + +#### Everything else. + +# Depending on what software you choose to install, or if things go wrong +# during the installation process, it's possible that other questions may +# be asked. You can preseed those too, of course. To get a list of every +# possible question that could be asked during an install, do an +# installation, and then run these commands: +# debconf-get-selections --installer > file +# debconf-get-selections >> file + +# If you like, you can include other preseed files into this one. +# Any settings in those files will override pre-existing settings from this +# file. More that one file can be listed, separated by spaces; all will be +# loaded. The included files can have preseed/include directives of their +# own as well. Note that if the filenames are relative, they are taken from +# the same directory as the preseed file that includes them. +#d-i preseed/include string x.cfg + +# More flexibly, this runs a shell command and if it outputs the names of +# preseed files, includes those files. For example, to switch configs based +# on a particular usb storage device (in this case, a built-in card reader): +#d-i preseed/include_command string \ +# if $(grep -q "GUID: 0aec3050aec305000001a003" /proc/scsi/usb-storage-*/*); \ +# then echo kraken.cfg; else echo otherusb.cfg; fi + +# To check the format of your preseed file before performing an install, +# you can use debconf-set-selections: +# debconf-set-selections -c preseed.cfg +</screen></informalexample> diff --git a/nl/appendix/example-preseed.xml b/nl/appendix/example-preseed.xml new file mode 100644 index 000000000..58339363d --- /dev/null +++ b/nl/appendix/example-preseed.xml @@ -0,0 +1,39 @@ +<!-- retain these comments for translator revision tracking --> +<!-- original version: 30379 untranslated --> + +<sect1 id="example-preseed"> +<title>Preconfiguration File Example</title> + +<para> + +This is a complete working example of a preconfiguration file for an automated +install. Its use is explained in <xref linkend="automatic-install"/>. You +may want to uncomment some of the lines before using the file. + +</para> + +<note condition="sarge"><para> + +In order to be able to properly present this example in the manual, we've had +to split some lines. This is indicated by the use of the line-continuation-character +<quote>\</quote> and extra indentation in the next line. In a real preconfiguration +file, these split lines have to be joined into <emphasis>one single line</emphasis>. +If you do not, preconfiguration will fail with unpredictable results. + +</para><para> + +A <quote>clean</quote> example file is available from &urlset-example-preseed;. + +</para></note> + +<para condition="etch"> + +The example file is also available from &urlset-example-preseed;. + +</para><para> + +&example-preseed-sarge.xml; +&example-preseed-etch.xml; + +</para> +</sect1> diff --git a/nl/appendix/files.xml b/nl/appendix/files.xml new file mode 100644 index 000000000..555a6395b --- /dev/null +++ b/nl/appendix/files.xml @@ -0,0 +1,298 @@ +<!-- retain these comments for translator revision tracking --> +<!-- original version: 28672 untranslated --> + + + <sect1 id="linuxdevices"><title>Linux Devices</title> +<para> + +In Linux you have various special files in +<filename>/dev</filename>. These files are called device files. In +the Unix world accessing hardware is different. There you have a +special file which actually runs a driver which in turn accesses the +hardware. The device file is an interface to the actual system +component. Files under <filename>/dev</filename> also behave +differently than ordinary files. Below are the most important device +files listed. + +</para><para> + +<informaltable><tgroup cols="2"><tbody> +<row> + <entry><filename>fd0</filename></entry> + <entry>First Floppy Drive</entry> +</row><row> + <entry><filename>fd1</filename></entry> + <entry>Second Floppy Drive</entry> +</row> +</tbody></tgroup></informaltable> + +<informaltable><tgroup cols="2"><tbody> +<row> + <entry><filename>hda</filename></entry> + <entry>IDE Hard disk / CD-ROM on the first IDE port (Master)</entry> +</row><row> + <entry><filename>hdb</filename></entry> + <entry>IDE Hard disk / CD-ROM on the first IDE port (Slave)</entry> +</row><row> + <entry><filename>hdc</filename></entry> + <entry>IDE Hard disk / CD-ROM on the second IDE port (Master)</entry> +</row><row> + <entry><filename>hdd</filename></entry> + <entry>IDE Hard disk / CD-ROM on the second IDE port (Slave)</entry> +</row><row> + <entry><filename>hda1</filename></entry> + <entry>First partition of the first IDE hard disk</entry> +</row><row> + <entry><filename>hdd15</filename></entry> + <entry>Fifteenth partition of the fourth IDE hard disk</entry> +</row> +</tbody></tgroup></informaltable> + +<informaltable><tgroup cols="2"><tbody> +<row> + <entry><filename>sda</filename></entry> + <entry>SCSI Hard disk with lowest SCSI ID (e.g. 0)</entry> +</row><row> + <entry><filename>sdb</filename></entry> + <entry>SCSI Hard disk with next higher SCSI ID (e.g. 1)</entry> +</row><row> + <entry><filename>sdc</filename></entry> + <entry>SCSI Hard disk with next higher SCSI ID (e.g. 2)</entry> +</row><row> + <entry><filename>sda1</filename></entry> + <entry>First partition of the first SCSI hard disk</entry> +</row><row> + <entry><filename>sdd10</filename></entry> + <entry>Tenth partition of the fourth SCSI hard disk</entry> +</row> +</tbody></tgroup></informaltable> + +<informaltable><tgroup cols="2"><tbody> +<row> + <entry><filename>sr0</filename></entry> + <entry>SCSI CD-ROM with the lowest SCSI ID</entry> +</row><row> + <entry><filename>sr1</filename></entry> + <entry>SCSI CD-ROM with the next higher SCSI ID</entry> +</row> +</tbody></tgroup></informaltable> + +<informaltable><tgroup cols="2"><tbody> +<row> + <entry><filename>ttyS0</filename></entry> + <entry>Serial port 0, COM1 under MS-DOS</entry> +</row><row> + <entry><filename>ttyS1</filename></entry> + <entry>Serial port 1, COM2 under MS-DOS</entry> +</row><row> + <entry><filename>psaux</filename></entry> + <entry>PS/2 mouse device</entry> +</row><row> + <entry><filename>gpmdata</filename></entry> + <entry>Pseudo device, repeater data from GPM (mouse) daemon</entry> +</row> +</tbody></tgroup></informaltable> + +<informaltable><tgroup cols="2"><tbody> +<row> + <entry><filename>cdrom</filename></entry> + <entry>Symbolic link to the CD-ROM drive</entry> +</row><row> + <entry><filename>mouse</filename></entry> + <entry>Symbolic link to the mouse device file</entry> +</row> +</tbody></tgroup></informaltable> + +<informaltable><tgroup cols="2"><tbody> +<row> + <entry><filename>null</filename></entry> + <entry>Everything pointed to this device will disappear</entry> +</row><row> + <entry><filename>zero</filename></entry> + <entry>One can endlessly read zeros out of this device</entry> +</row> +</tbody></tgroup></informaltable> + +</para> + + <sect2> +<title>Setting Up Your Mouse</title> + +<para> + +The mouse can be used in both the Linux console (with gpm) and the X window +environment. The two uses can be made compatible if the gpm repeater is used +to allow the signal to flow to the X server as shown: + +<informalexample><screen> +mouse => /dev/psaux => gpm => /dev/gpmdata -> /dev/mouse => X + /dev/ttyS0 (repeater) (symlink) + /dev/ttyS1 +</screen></informalexample> + +Set the repeater protocol to be raw (in <filename>/etc/gpm.conf</filename>) while +setting X to the original mouse protocol in <filename>/etc/X11/XF86Config</filename> +or <filename>/etc/X11/XF86Config-4</filename>. + +</para><para> + +This approach to use gpm even in X has advantages when the mouse is +unplugged inadvertently. Simply restarting gpm with + +<informalexample><screen> +# /etc/init.d/gpm restart +</screen></informalexample> + +will re-connect the mouse in software without restarting X. + +</para><para> + +If gpm is disabled or not installed with some reason, make sure to set X to +read directly from the mouse device such as /dev/psaux. For details, refer +to the 3-Button Mouse mini-Howto at +<filename>/usr/share/doc/HOWTO/en-txt/mini/3-Button-Mouse.gz</filename>, +<userinput>man gpm</userinput>, +<filename>/usr/share/doc/gpm/FAQ.gz</filename>, and +<ulink url="&url-xfree86;current/mouse.html">README.mouse</ulink>. + +</para><para arch="powerpc"> + +For PowerPC, in <filename>/etc/X11/XF86Config</filename> or +<filename>/etc/X11/XF86Config-4</filename>, set the mouse device to +<userinput>"/dev/input/mice"</userinput>. + +</para><para arch="powerpc"> + +Modern kernels give you the capability to emulate a three-button mouse +when your mouse only has one button. Just add the following lines to +<filename>/etc/sysctl.conf</filename> file. + +<informalexample><screen> +# 3-button mouse emulation +# turn on emulation +/dev/mac_hid/mouse_button_emulation = 1 +# Send middle mouse button signal with the F11 key +/dev/mac_hid/mouse_button2_keycode = 87 +# Send right mouse button signal with the F12 key +/dev/mac_hid/mouse_button3_keycode = 88 +# For different keys, use showkey to tell you what the code is. +</screen></informalexample> + +</para> + </sect2> + </sect1> + + <sect1 id="tasksel-size-list"> + <title>Disk Space Needed for Tasks</title> + +<!-- Note for d-i and manual maintainers + Sizes of tasks should be determined by running "tasksel new" on a system + that been fully installed without selecting any tasks. By selecting a + task together with the "manual selection" option, aptitude will be started + and show the sizes for the task. After deselecting the packages to be + installed, quit aptitude and repeat for other tasks. + Space requirements need to be determined from tasksel as tasksel will not + install recommended packages while selecting a task from aptitude will. +--> + +<para> + +The base installation for i386 using the default 2.4 kernel, +including all standard packages, requires 573MB of disk space. + +</para><para> + +The following table lists sizes reported by aptitude for the tasks listed +in tasksel. Note that some tasks have overlapping constituents, so the +total installed size for two tasks together may be less than the total +obtained by adding up the numbers. + +</para><para> + +Note that you will need to add the sizes listed in the table to the size +of the base installation when determining the size of partitions. +Most of the size listed as <quote>Installed size</quote> will end up in +<filename>/usr</filename>; the size listed as <quote>Download size</quote> +is (temporarily) required in <filename>/var</filename>. + +</para><para> + +<informaltable><tgroup cols="4"> +<thead> +<row> + <entry>Task</entry> + <entry>Installed size (MB)</entry> + <entry>Download size (MB)</entry> + <entry>Space needed to install (MB)</entry> +</row> +</thead> + +<tbody> +<row> + <entry>Desktop</entry> + <entry>1392</entry> + <entry>460</entry> + <entry>1852</entry> +</row> + +<row> + <entry>Web server</entry> + <entry>36</entry> + <entry>12</entry> + <entry>48</entry> +</row> + +<row> + <entry>Print server</entry> + <entry>168</entry> + <entry>58</entry> + <entry>226</entry> +</row> + +<row> + <entry>DNS server</entry> + <entry>2</entry> + <entry>1</entry> + <entry>3</entry> +</row> + +<row> + <entry>File server</entry> + <entry>47</entry> + <entry>24</entry> + <entry>71</entry> +</row> + +<row> + <entry>Mail server</entry> + <entry>10</entry> + <entry>3</entry> + <entry>13</entry> +</row> + +<row> + <entry>SQL database</entry> + <entry>66</entry> + <entry>21</entry> + <entry>87</entry> +</row> + +</tbody> +</tgroup></informaltable> + +<note><para> + +The <emphasis>Desktop</emphasis> task will install both the Gnome and KDE +desktop environments. + +</para></note> + +</para><para> + +If you install in a language other than English, <command>tasksel</command> +may automatically install a <firstterm>localization task</firstterm>, if one +is available for your language. Space requirements differ per language; +you should allow up to 200MB in total for download and installation. + +</para> + </sect1> diff --git a/nl/appendix/gpl.xml b/nl/appendix/gpl.xml new file mode 100644 index 000000000..ba5782af2 --- /dev/null +++ b/nl/appendix/gpl.xml @@ -0,0 +1,512 @@ +<!-- retain these comments for translator revision tracking --> +<!-- original version: 29618 untranslated --> + +<appendix id="appendix-gpl"><title>GNU General Public License</title> + +<para> + +Version 2, June 1991 + +</para><para> + +Copyright (C) 1989, 1991 Free Software Foundation, Inc. +— +51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA. +</para><para> + +Everyone is permitted to copy and distribute verbatim copies +of this license document, but changing it is not allowed. + +</para> + + <sect1><title>Preamble</title> +<para> + +The licenses for most software are designed to take away your freedom +to share and change it. By contrast, the gnu General Public License +is intended to guarantee your freedom to share and change free +software — to make sure the software is free for all its users. This +General Public License applies to most of the Free Software +Foundation's software and to any other program whose authors commit +to using it. (Some other Free Software Foundation software is covered +by the gnu Library General Public License instead.) You can apply it +to your programs, too. + +</para><para> + +When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge +for this service if you wish), that you receive source code or can +get it if you want it, that you can change the software or use pieces +of it in new free programs; and that you know you can do these +things. + +</para><para> + +To protect your rights, we need to make restrictions that forbid +anyone to deny you these rights or to ask you to surrender the +rights. These restrictions translate to certain responsibilities for +you if you distribute copies of the software, or if you modify it. + +</para><para> + +For example, if you distribute copies of such a program, whether +gratis or for a fee, you must give the recipients all the rights that +you have. You must make sure that they, too, receive or can get the +source code. And you must show them these terms so they know their +rights. + +</para><para> + +We protect your rights with two steps: (1) copyright the software, +and (2) offer you this license which gives you legal permission to +copy, distribute and/or modify the software. + +</para><para> + +Also, for each author's protection and ours, we want to make certain +that everyone understands that there is no warranty for this free +software. If the software is modified by someone else and passed on, +we want its recipients to know that what they have is not the +original, so that any problems introduced by others will not reflect +on the original authors' reputations. + +</para><para> + +Finally, any free program is threatened constantly by software +patents. We wish to avoid the danger that redistributors of a free +program will individually obtain patent licenses, in effect making +the program proprietary. To prevent this, we have made it clear that +any patent must be licensed for everyone's free use or not licensed +at all. + +</para><para> + +The precise terms and conditions for copying, distribution and +modification follow. + +</para> + </sect1> + + <sect1><title>GNU GENERAL PUBLIC LICENSE</title> +<para> + +TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + +</para> + +<itemizedlist><listitem><para> + +This License applies to any program or other work which contains a +notice placed by the copyright holder saying it may be distributed +under the terms of this General Public License. The "Program", below, +refers to any such program or work, and a "work based on the Program" +means either the Program or any derivative work under copyright law: +that is to say, a work containing the Program or a portion of it, +either verbatim or with modifications and/or translated into another +language. (Hereinafter, translation is included without limitation in +the term "modification".) Each licensee is addressed as "you". + +</para><para> + +Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running the Program is not restricted, and the output from the +Program is covered only if its contents constitute a work based on +the Program (independent of having been made by running the Program). +Whether that is true depends on what the Program does. + +</para></listitem> +<listitem><para> + +You may copy and distribute verbatim copies of the Program's +source code as you receive it, in any medium, provided that you +conspicuously and appropriately publish on each copy an appropriate +copyright notice and disclaimer of warranty; keep intact all the +notices that refer to this License and to the absence of any +warranty; and give any other recipients of the Program a copy of this +License along with the Program. + +</para><para> + +You may charge a fee for the physical act of transferring a copy, and +you may at your option offer warranty protection in exchange for a +fee. + +</para></listitem> +<listitem><para> + +You may modify your copy or copies of the Program or any portion +of it, thus forming a work based on the Program, and copy and +distribute such modifications or work under the terms of Section 1 +above, provided that you also meet all of these conditions: + +</para><para> + +a) You must cause the modified files to carry prominent notices +stating that you changed the files and the date of any change. + +</para><para> + +b) You must cause any work that you distribute or publish, that in +whole or in part contains or is derived from the Program or any part +thereof, to be licensed as a whole at no charge to all third parties +under the terms of this License. + +</para><para> + +c) If the modified program normally reads commands interactively when +run, you must cause it, when started running for such interactive use +in the most ordinary way, to print or display an announcement +including an appropriate copyright notice and a notice that there is +no warranty (or else, saying that you provide a warranty) and that +users may redistribute the program under these conditions, and +telling the user how to view a copy of this License. (Exception: if +the Program itself is interactive but does not normally print such an +announcement, your work based on the Program is not required to print +an announcement.) + +</para><para> + +These requirements apply to the modified work as a whole. If +identifiable sections of that work are not derived from the Program, +and can be reasonably considered independent and separate works in +themselves, then this License, and its terms, do not apply to those +sections when you distribute them as separate works. But when you +distribute the same sections as part of a whole which is a work based +on the Program, the distribution of the whole must be on the terms of +this License, whose permissions for other licensees extend to the +entire whole, and thus to each and every part regardless of who wrote +it. + +</para><para> + +Thus, it is not the intent of this section to claim rights or contest +your rights to work written entirely by you; rather, the intent is to +exercise the right to control the distribution of derivative or +collective works based on the Program. + +</para><para> + +In addition, mere aggregation of another work not based on the +Program with the Program (or with a work based on the Program) on a +volume of a storage or distribution medium does not bring the other +work under the scope of this License. + +</para></listitem> +<listitem><para> + +You may copy and distribute the Program (or a work based on it, +under Section 2) in object code or executable form under the terms of +Sections 1 and 2 above provided that you also do one of the +following: + +</para><para> + +a) Accompany it with the complete corresponding machine-readable +source code, which must be distributed under the terms of Sections 1 +and 2 above on a medium customarily used for software interchange; +or, + +</para><para> + +b) Accompany it with a written offer, valid for at least three years, +to give any third party, for a charge no more than your cost of +physically performing source distribution, a complete +machine-readable copy of the corresponding source code, to be +distributed under the terms of Sections 1 and 2 above on a medium +customarily used for software interchange; or, + +</para><para> + +c) Accompany it with the information you received as to the offer to +distribute corresponding source code. (This alternative is allowed +only for noncommercial distribution and only if you received the +program in object code or executable form with such an offer, in +accord with Subsection b above.) + +</para><para> + +The source code for a work means the preferred form of the work for +making modifications to it. For an executable work, complete source +code means all the source code for all modules it contains, plus any +associated interface definition files, plus the scripts used to +control compilation and installation of the executable. However, as a +special exception, the source code distributed need not include +anything that is normally distributed (in either source or binary +form) with the major components (compiler, kernel, and so on) of the +operating system on which the executable runs, unless that component +itself accompanies the executable. + +</para><para> + +If distribution of executable or object code is made by offering +access to copy from a designated place, then offering equivalent +access to copy the source code from the same place counts as +distribution of the source code, even though third parties are not +compelled to copy the source along with the object code. + +</para></listitem> +<listitem><para> + +You may not copy, modify, sublicense, or distribute the Program +except as expressly provided under this License. Any attempt +otherwise to copy, modify, sublicense or distribute the Program is +void, and will automatically terminate your rights under this +License. However, parties who have received copies, or rights, from +you under this License will not have their licenses terminated so +long as such parties remain in full compliance. + +</para></listitem> +<listitem><para> + +You are not required to accept this License, since you have not +signed it. However, nothing else grants you permission to modify or +distribute the Program or its derivative works. These actions are +prohibited by law if you do not accept this License. Therefore, by +modifying or distributing the Program (or any work based on the +Program), you indicate your acceptance of this License to do so, and +all its terms and conditions for copying, distributing or modifying +the Program or works based on it. + +</para></listitem> +<listitem><para> + +Each time you redistribute the Program (or any work based on the +Program), the recipient automatically receives a license from the +original licensor to copy, distribute or modify the Program subject +to these terms and conditions. You may not impose any further +restrictions on the recipients' exercise of the rights granted +herein. You are not responsible for enforcing compliance by third +parties to this License. + +</para></listitem> +<listitem><para> + +If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), +conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do +not excuse you from the conditions of this License. If you cannot +distribute so as to satisfy simultaneously your obligations under +this License and any other pertinent obligations, then as a +consequence you may not distribute the Program at all. For example, +if a patent license would not permit royalty-free redistribution of +the Program by all those who receive copies directly or indirectly +through you, then the only way you could satisfy both it and this +License would be to refrain entirely from distribution of the +Program. + +</para><para> + +If any portion of this section is held invalid or unenforceable under +any particular circumstance, the balance of the section is intended +to apply and the section as a whole is intended to apply in other +circumstances. + +</para><para> + +It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system, which is +implemented by public license practices. Many people have made +generous contributions to the wide range of software distributed +through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is +willing to distribute software through any other system and a +licensee cannot impose that choice. + +</para><para> + +This section is intended to make thoroughly clear what is believed to +be a consequence of the rest of this License. + +</para></listitem> +<listitem><para> + +If the distribution and/or use of the Program is restricted in +certain countries either by patents or by copyrighted interfaces, the +original copyright holder who places the Program under this License +may add an explicit geographical distribution limitation excluding +those countries, so that distribution is permitted only in or among +countries not thus excluded. In such case, this License incorporates +the limitation as if written in the body of this License. + +</para></listitem> +<listitem><para> + +The Free Software Foundation may publish revised and/or new +versions of the General Public License from time to time. Such new +versions will be similar in spirit to the present version, but may +differ in detail to address new problems or concerns. Each version is +given a distinguishing version number. If the Program specifies a +version number of this License which applies to it and "any later +version", you have the option of following the terms and conditions +either of that version or of any later version published by the Free +Software Foundation. If the Program does not specify a version number +of this License, you may choose any version ever published by the +Free Software Foundation. + +</para></listitem> +<listitem><para> + +If you wish to incorporate parts of the Program into other free +programs whose distribution conditions are different, write to the +author to ask for permission. For software which is copyrighted by +the Free Software Foundation, write to the Free Software Foundation; +we sometimes make exceptions for this. Our decision will be guided by +the two goals of preserving the free status of all derivatives of our +free software and of promoting the sharing and reuse of software +generally. + +</para><para> + +NO WARRANTY + +</para></listitem> +<listitem><para> + +because the program is licensed free of charge, there is no +warranty for the program, to the extent permitted by applicable law. +except when otherwise stated in writing the copyright holders and/or +other parties provide the program "as is" without warranty of any +kind, either expressed or implied, including, but not limited to, the +implied warranties of merchantability and fitness for a particular +purpose. the entire risk as to the quality and performance of the +program is with you. should the program prove defective, you assume +the cost of all necessary servicing, repair or correction. + +</para></listitem> +<listitem><para> + +in no event unless required by applicable law or agreed to in +writing will any copyright holder, or any other party who may modify +and/or redistribute the program as permitted above, be liable to you +for damages, including any general, special, incidental or +consequential damages arising out of the use or inability to use the +program (including but not limited to loss of data or data being +rendered inaccurate or losses sustained by you or third parties or a +failure of the program to operate with any other programs), even if +such holder or other party has been advised of the possibility of +such damages. + +</para></listitem> +</itemizedlist> +<para> + +END OF TERMS AND CONDITIONS + +</para> + </sect1> + + <sect1><title>How to Apply These Terms to Your New Programs</title> +<para> + +If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make +it free software which everyone can redistribute and change under +these terms. + +</para><para> + +To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +convey the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + +</para><para> + +one line to give the program's name and a brief idea of what it +does. + +</para><para> + +Copyright (C) year name of author + +</para><para> + +This program is free software; you can redistribute it and/or modify +it under the terms of the gnu General Public License as published by +the Free Software Foundation; either version 2 of the License, or (at +your option) any later version. + +</para><para> + +This program is distributed in the hope that it will be useful, but +without any warranty; without even the implied warranty of +merchantability or fitness for a particular purpose. See the gnu +General Public License for more details. + +</para><para> + +You should have received a copy of the gnu General Public License +along with this program; if not, write to the Free Software +Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, +MA 02110-1301, USA. + +</para><para> + +Also add information on how to contact you by electronic and paper +mail. + +</para><para> + +If the program is interactive, make it output a short notice like +this when it starts in an interactive mode: + +</para><para> + +Gnomovision version 69, Copyright (C) year name of author + +</para><para> + +Gnomovision comes with absolutely no warranty; for details type `show +w'. + +</para><para> + +This is free software, and you are welcome to redistribute it under +certain conditions; type `show c' for details. + +</para><para> + +The hypothetical commands `show w' and `show c' should show the +appropriate parts of the General Public License. Of course, the +commands you use may be called something other than `show w' and +`show c'; they could even be mouse-clicks or menu items — whatever +suits your program. + +</para><para> + +You should also get your employer (if you work as a programmer) or +your school, if any, to sign a "copyright disclaimer" for the +program, if necessary. Here is a sample; alter the names: + +</para><para> + +Yoyodyne, Inc., hereby disclaims all copyright interest in the +program `Gnomovision' (which makes passes at compilers) written by +James Hacker. + +</para><para> + +signature of Ty Coon, 1 April 1989 + +</para><para> + +Ty Coon, President of Vice + +</para><para> + +This General Public License does not permit incorporating your +program into proprietary programs. If your program is a subroutine +library, you may consider it more useful to permit linking +proprietary applications with the library. If this is what you want +to do, use the gnu Library General Public License instead of this +License. + +</para> + </sect1> +</appendix> diff --git a/nl/appendix/plip.xml b/nl/appendix/plip.xml new file mode 100644 index 000000000..74913ab34 --- /dev/null +++ b/nl/appendix/plip.xml @@ -0,0 +1,194 @@ +<!-- retain these comments for translator revision tracking --> +<!-- original version: 29687 untranslated --> + + <sect1 id="plip" arch="i386"> + <title>Installing &debian; over Parallel Line IP (PLIP)</title> + +<para> + +This section explains how to install &debian; on a computer without +Ethernet card, but with just a remote gateway computer attached via +a Null-Modem cable (also called Null-Printer cable). The gateway +computer should be connected to a network that has a Debian mirror +on it (e.g. to the Internet). + +</para><para> + +In the example in this appendix we will set up a PLIP connection using +a gateway connected to the Internet over a dial-up connection (ppp0). +We will use IP addresses 192.168.0.1 and 192.168.0.2 for the PLIP +interfaces on the target system and the source system respectively +(these addresses should be unused within your network address space). + +</para><para> + +The PLIP connection set up during the installation will also be available +after the reboot into the installed system (see <xref linkend="boot-new"/>). + +</para><para> + +Before you start, you will need to check the BIOS configuration (IO base +address and IRQ) for the parallel ports of both the source and target +systems. The most common values are <literal>io=0x378</literal>, +<literal>irq=7</literal>. + +</para> + + <sect2> + <title>Requirements</title> + +<itemizedlist> +<listitem><para> + +A target computer, called <emphasis>target</emphasis>, where Debian will be +installed. + +</para></listitem> +<listitem><para> + +System installation media; see <xref linkend="installation-media"/>. + +</para></listitem> +<listitem><para> + +Another computer connected to the Internet, called <emphasis>source</emphasis>, +that will function as the gateway. + +</para></listitem> +<listitem><para> + +A DB-25 Null-Modem cable. See the +<ulink url="&url-plip-install-howto;">PLIP-Install-HOWTO</ulink> for more +information on this cable and instructions how to make your own. + +</para></listitem> +</itemizedlist> + + </sect2> + + <sect2> + <title>Setting up source</title> +<para> + +The following shell script is a simple example of how to configure the +source computer as a gateway to the Internet using ppp0. + +<informalexample><screen> +#!/bin/sh + +# We remove running modules from kernel to avoid conflicts and to +# reconfigure them manually. +modprobe -r lp parport_pc +modprobe parport_pc io=<replaceable>0x378</replaceable> irq=<replaceable>7</replaceable> +modprobe plip + +# Configure the plip interface (plip0 for me, see dmesg | grep plip) +ifconfig <replaceable>plip0 192.168.0.2</replaceable> pointopoint <replaceable>192.168.0.1</replaceable> netmask 255.255.255.255 up + +# Configure gateway +modprobe iptable_nat +iptables -t nat -A POSTROUTING -o <replaceable>ppp0</replaceable> -j MASQUERADE +echo 1 > /proc/sys/net/ipv4/ip_forward +</screen></informalexample> + +</para> + </sect2> + + <sect2> + <title>Installing target</title> +<para> + +Boot the installation media. The installation needs to be run in +expert mode; enter <userinput>expert</userinput> at the boot prompt. +Below are the answers that should be given during various stages of +the installation. + +</para> + +<orderedlist> +<listitem><para> + +<guimenuitem>Load installer components</guimenuitem> + +</para><para> + +Select the <userinput>plip-modules</userinput> option from the list; this +will make the PLIP drivers available to the installation system. + +</para></listitem> +<listitem><para> + +<guimenuitem>Detect network hardware</guimenuitem> + +</para> + + <itemizedlist> + <listitem><para> + +If target <emphasis>does</emphasis> have a network card, a list of driver +modules for detected cards will be shown. If you want to force &d-i; to +use plip instead, you have to deselect all listed driver modules. +Obviously, if target doesn't have a network card, the installer will not +show this list. + + </para></listitem> + <listitem><para> + +Prompt for module parameters: Yes + + </para></listitem> + <listitem><para> + +Because no network card was detected/selected earlier, the installer will +ask you to select a network driver module from a list. +Select the <userinput>plip</userinput> module. + + </para></listitem> + <listitem><para> + +Additional parameters for module parport_pc: +<userinput><replaceable>io=0x378 irq=7</replaceable></userinput> + + </para></listitem> + <listitem><para> + +Additional parameters for module plip: leave empty + + </para></listitem> + </itemizedlist> + +</listitem> +<listitem><para> + +<guimenuitem>Configure the network</guimenuitem> + + <itemizedlist> + <listitem><para> + +Auto-configure network with DHCP: No + + </para></listitem> + <listitem><para> + +IP address: <userinput><replaceable>192.168.0.1</replaceable></userinput> + + </para></listitem> + <listitem><para> + +Point-to-point address: +<userinput><replaceable>192.168.0.2</replaceable></userinput> + + </para></listitem> + <listitem><para> + +Name server addresses: you can enter the same addresses used on +source (see <filename>/etc/resolv.conf</filename>) + + </para></listitem> + </itemizedlist> + +</para></listitem> +</orderedlist> + + </sect2> + </sect1> diff --git a/nl/appendix/random-bits.xml b/nl/appendix/random-bits.xml new file mode 100644 index 000000000..4d39d21cd --- /dev/null +++ b/nl/appendix/random-bits.xml @@ -0,0 +1,11 @@ +<!-- retain these comments for translator revision tracking --> +<!-- original version: 29687 untranslated --> + +<appendix id="random-bits"><title>Random Bits</title> + +&example-preseed.xml; +&files.xml; +&chroot-install.xml; +&plip.xml; + +</appendix> |