[PC-BSD Commits] r5123 - pcbsd/trunk/pc-sysinstall/examples

svn at pcbsd.org svn at pcbsd.org
Mon Nov 23 10:49:44 PST 2009


Author: kris
Date: 2009-11-23 10:49:44 -0800 (Mon, 23 Nov 2009)
New Revision: 5123

Modified:
   pcbsd/trunk/pc-sysinstall/examples/README
Log:

Updated the pc-sysinstall README, very detailed now, with lots of instructions on creating
install cfg files



Modified: pcbsd/trunk/pc-sysinstall/examples/README
===================================================================
--- pcbsd/trunk/pc-sysinstall/examples/README	2009-11-23 18:05:14 UTC (rev 5122)
+++ pcbsd/trunk/pc-sysinstall/examples/README	2009-11-23 18:49:44 UTC (rev 5123)
@@ -4,94 +4,307 @@
 # config scripts
 #################################################################
 
-hostname=pcbsd8
+# hostname=
+#
+# Using hostname= will set the specified hostname on the
+# installed system
+#
+# When hostname= is not present, pc-sysinstall will auto-generate
+# a hostname such as freebsd-XXXX or pcbsd-XXXX
 
-installMode=fresh
-#installMode=upgrade
-#installMode=restore
+# installMode=(fresh or upgrade)
+# 
+# Set the type of install we are doing, fresh or upgrade.
+#
+# Fresh installs will format and mount the target disks before
+# extracting the install images to the system. Using this mode
+# it is also possible to do a system restore, by specifying a
+# full system backup as the install source.
+#
+# Upgrades will mount the target disk, and extract the system
+# archive to the disk, overwriting files on the disk. 
+# The conf/exclude-from-upgrade file can be used to specify
+# additional files to exclude from overwriting during the
+# install process.
 
-installInteractive=yes
-#installInteractive=no
 
-#netDev=AUTO-DHCP
-#netDev=ed0
-#nameserver=4.2.2.2
-#defaultrouter=192.168.0.1
-#netIP=192.168.0.49
-#netMask=255.255.255.0
+# installInteractive=(yes or no)
+#
+# Set if the installer is running in interactive mode, and
+# is able to prompt for input from the user, defaults to no
 
 
-#  Set the disk parameters
-disk0=ad0
-partition=all
-bootManager=none
-#bootManager=bsd
-# Do it now!
-commitDiskPart
+########################################################################
+# NETWORK SETTINGS
+########################################################################
 
-#  Set the disk parameters
-disk1=ad1
-partition=s1
-#partition=free
-# Do it now!
-commitDiskPart
+# netDev=(AUTO-DHCP or <nic>)
+#
+# netDev specifies what type of networking to enable for the installer
+# Can be set to AUTO-DHCP or to a network interface, such as et0
+#
+# When set to AUTO-DHCP, pc-sysinstall will probe for all network devices
+# and attempt to set DHCP mode on each, until a working network connection
+# is established
+#
+# If netDev= is set to a network interface such as et0, the following options
+# will need to be set in order to enable the interface
 
-# Setup the disk label
-# All sizes are expressed in MB
-# Avail FS Types, UFS, UFS+S, UFS+J, ZFS
-# UFS.eli, UFS+S.eli, UFS+J.eli, ZFS.eli, SWAP.eli
-disk0-part=UFS+S 500 / 
-disk0-part=SWAP 2000 none
-disk0-part=UFS+J 500 /var
-disk0-part=UFS+J 500 /tmp
-# Size 0 means use the rest of the slice size
-disk0-part=ZFS 0 /usr
-# Do it now!
-commitDiskLabel
+# netIP=(IP address such as 192.168.0.100)
+#
+# Set netIP to an address that you wish to have the interface specified in
+# netDev set to
+# Only used when netDev is not set to AUTO-DHCP
 
+# netMask=(Netmask such as 255.255.255.0)
+#
+# Set netMask to the address you with to have the interface specified in
+# netDev set to
+# Only used when netDev is not set to AUTO-DHCP
 
-# Set if we are installing via dvd, USB, or FTP
-installMedium=dvd
-#installMedium=usb
-#installMedium=ftp
-#installMedium=rsync
-#ftpPath=ftp://ftp.pcbsd.org/test
-#rsyncPath=kris at 192.168.0.50
+ 
+# netNameServer=(DNS Server such as 192.168.0.1)
+#
+# Set netNameServer to the DNS address you want to use during the install
+# Only used when netDev is not set to AUTO-DHCP
 
+
+# netDefaultRouter=(192.168.0.1)
+#
+# Set netDefaultRouter to the gateway you wish to have the installer use
+# Only used when netDev is not set to AUTO-DHCP
+
+
+
+# netSaveDev=(AUTO-DHCP or network interface)
+#
+# netSaveDev specifies what networking to enable on the installed system
+#
+# When set to AUTO-DHCP, pc-sysinstall will probe all network interfaces, and
+# set them all to DHCP in the systems /etc/rc.conf file. Wireless devices will also
+# have the corresponding wlan[0-9] device created. 
+#
+# When set to a network interface, pc-sysinstall will set the target device with
+# the settings specified by the variables below.
+# 
+# netSaveIP=192.168.0.49
+# netSaveMask=255.255.255.0
+# netSaveNameServer=208.67.222.222
+# netSaveDefaultRouter=192.168.0.1
+
+
+
+
+########################################################################
+# DISK SLICE SETTINGS
+########################################################################
+#
+# The following section specifies the target disk(s) to be used in the
+# install or upgrade. 
+
+# disk0=(disk device, such as ad0)
+# 
+# The diskX= variable should be set to the target device for this drive, such
+# as ad0, da0
+# The first should begin with disk0=, and additional drives to disk1=, disk2
+# if additional disks are to be setup. 
+#
+
+# partition=(all, free, s1, s1, s3, s4)
+#
+# After setting disk[0-9], the partition= variable is used to specify which target
+# partition we will be working with for this device.
+# 
+# Setting this to "all" will setup the disk with a single FreeBSD slice as "s1"
+#
+# Setting this to "free" will allow pc-sysinstall to search for the first available
+# primary slice with free space, and create the slice. 
+#
+# Setting this to "s1, s2, s3 or s4" will use the specified slice
+#
+
+# mirror=(disk device such as ad1)
+#
+# Setting the mirror= variable will setup the target device as a gmirror
+# of the diskX= device. The mirror device must be the same size or larger
+# than the drive being mirrored. 
+# 
+
+# mirrorbal=(load, prefer, round-robin, split)
+#
+# Allows the setting of the mirror balance method to be used, if not
+# specified this defaults to "round-robin"
+
+# bootManager=(none, bsd)
+#
+# Setting this option will instruct pc-sysinstall to install the BSD boot Manager,
+# or leave it empty
+
+# commitDiskPart
+#
+# This command must be placed at the end of the diskX= section, before starting
+# the listing of any additional diskX= directives. 
+
+
+########################################################################
+# DISK PARTITION / MOUNT SETTINGS
+########################################################################
+#
+# The following settings specify the partitioning / mount points to setup
+# on the target partition
+
+# disk0-part=UFS+S 500 / 
+# disk0-part=SWAP 2000 none
+# disk0-part=UFS+J 500 /var
+# disk0-part=UFS+J 500 /tmp
+# disk0-part=ZFS 0 /usr
+# commitDiskLabel
+#
+# The above values instructs pc-sysinstall which partitions / mounts
+# to create on the target drive / slice, specified by "disk0".
+# (disk0 will resolve to the drive / slice specified in the previous section)
+#
+# The notation is as follows:
+# <File System Type> <Size> <Mountpoint>
+#
+# Available FileSystems: 
+#   UFS - Standard UFS2 FileSystem
+# UFS+S - UFS2 + Softupdates enabled
+# UFS+J - UFS2 + Journaling through gjournal
+#   ZFS - Z File System, pools / mounts created automatically
+#  SWAP - BSD Swap space partition, mountpoint should be set to "none"
+#
+# Adding the ".eli" extension to any of the above file systems
+# will enable disk encryption via geli
+# (UFS.eli, UFS+S.eli, UFS+J.eli, ZFS.eli, SWAP.eli)
+#
+# All sizes are expressed in MegaBytes
+# Specifying a size 0 instructs pc-sysinstall to use the rest of the 
+# available slice size, and should only be used for the last partition / mount
+
+
+########################################################################
+# INSTALL OPTIONS / SOURCES
+########################################################################
+#
+# The following settings specify the type, locations and sources
+# for this installation
+
+# installMedium=(dvd, usb, ftp, rsync)
+#
+# Set installMedium= to the source type we will be using for this install.
+#
+# Available Types:
+#   dvd - Search for and mount the DVD which contains the install archive
+#   usb - Search for and mount the USB drive which contains the install archive
+#   ftp - The install archive will be fetched from a FTP / HTTP server before install
+# rsync - Pull the system data from a ssh + rsync server, specified with variables below
+
+# installType=(PCBSD, FreeBSD)
+#
 # Set the type of system we are installing, PCBSD or FreeBSD
-installType=PCBSD
-#installType=FreeBSD
 
-# The installer archive, if not using the defaults in conf
-#installFile=fbsd-release.tbz
+# installFile=fbsd-release.tbz
+#
+# The installer archive, if not using the defaults specified in conf/pc-sysinstall.conf
 
-# Set the optional components to install
-# The specified names need to match directory in components/
-installComponents=amarok,firefox,ports
+# packageType=(tar, uzip)
+#
+# The archive type we are extracting from when using dvd, usb or ftp
 
-# The types of files we can install
-#packageType=tar
-#packageType=uzip
+# ftpPath=ftp://ftp.pcbsd.org/pub/8.0/netinstall
+#
+# Location of the installer archive when using a installMedium=ftp
 
+# rsyncPath=life-preserver/back-2009-11-12T14_53_14
+#
+# The location of the rsync data on the remote server when using installMedium=rsync
 
-# Set if we are restoring via dvd, USB or FTP
-restoreMedium=dvd
-#restoreMedium=usb
-#restoreMedium=ftp
-commitRestore
+# rsyncUser=rsyncuser
+#
+# The username to use for the ssh server running rsync
 
+# rsyncHost=192.168.0.50
+#
+# The rsync / ssh server we wish to connect to
 
-# Run any commands post-install
-# runCommand & runScript are run within chroot of FSMNT
-runCommand=
-# runScript will copy the specified script into FSMNT, and run it in chroot
-runScript=
-# runExtCommand is run on the liveFS
-runExtCommand=
+# rsyncPort=22
+#
+# The port to use when connecting to a ssh + rsync server
 
-# Options for localizing an install
-localizeLang="ru"
-localizeKeyLayout="ru"
-localizeKeyModel="pc104"
-localizeKeyVariant="intl"
+# installComponents=amarok,firefox,ports
+# 
+# The specified components to install, view available with "./pc-sysinstall list-components"
 
+
+########################################################################
+# USER OPTIONS
+########################################################################
+#
+# Options for setting up usernames and passwords on the installed system
+
+# rootPass=root
+#
+# Set the root password of the installed system to the specified string
+
+# The below variables are used to setup a user on the installed system
+# Be sure to call commitUser after after adding these values, and before
+# starting another user block
+
+# userName=kris
+# userComment=Kris Moore
+# userPass=mypass
+# userShell=/bin/csh
+# userHome=/home/kris
+# userGroups=wheel,operator
+# commitUser
+
+########################################################################
+# RUN COMMANDS
+########################################################################
+#
+# The following variables can be set to run commands post-installation,
+# allowing the user to further tweak / modify the system
+
+# runCommand=
+# 
+# Run the specified command within chroot of the installed system
+
+# runScript=
+#
+# runScript will copy the specified script into FSMNT, and run it in chroot of the system
+# Usefull when you have a 3rd party script on the DVD / USB, and you want to copy it into
+# the installed system and run
+
+# runExtCommand=
+#
+# runExtCommand is used when you wish to run a command outside the chroot
+# The variable $FSMNT is set to the mount-point of your installed system
+
+
+########################################################################
+# PC-BSD SPECIFC OPTIONS
+########################################################################
+#
+# Options specific to installing PC-BSD, such as localization, and KDE settings
+
+# localizeLang=en
+#
+# localizeLang will set the system console and Desktop to the target language
+
+# localizeKeyLayout=en
+#
+# localizeKeyLayout updates the system's xorg config to set the keyboard layout
+
+# localizeKeyModel=pc104
+#
+# localizeKeyModel updates the system's xorg config to set the keyboard model
+
+# localizeKeyVariant=intl
+#
+# localizeKeyVariant is used to update the xorg config to set the keyboard variant
+
+# autoLoginUser=kris
+#
+# Setting autoLoginUser will enable the specified user to log into the desktop 
+# automatically without entering a password



More information about the Commits mailing list