1pc-sysinstall README 2 3This file documents many of the variables used in pc-sysinstall 4config scripts 5################################################################# 6 7# hostname= 8 9Using hostname= will set the specified hostname on the 10installed system 11 12When hostname= is not present, pc-sysinstall will auto-generate 13a hostname such as freebsd-XXXX or pcbsd-XXXX 14 15# installMode=(fresh/upgrade/extract) 16 17Set the type of install we are doing. 18 19Fresh installs will format and mount the target disks before 20extracting the install images to the system. Using this mode 21it is also possible to do a system restore, by specifying a 22full system backup as the install source. 23 24Upgrades will mount the target disk, and extract the system 25archive to the disk, overwriting files on the disk. 26The conf/exclude-from-upgrade file can be used to specify 27additional files to exclude from overwriting during the 28install process. 29 30Extract will skip any disk setup, and perform an installation 31to the directory specified by "installLocation=". This location 32should be a directory with your pre-mounted file-systems ready 33for file extraction. When using the "extract" option, /etc/fstab 34on the installed system will *not* be automatically configured. 35 36# installLocation= 37 38Used only when installMode is set to extract. 39 40This is set to the location you want to extract your system to, 41and should already be mounted properly. 42 43# installInteractive=(yes or no) 44 45Set if the installer is running in interactive mode, and 46is able to prompt for input from the user, defaults to no 47 48 49######################################################################## 50# NETWORK SETTINGS 51######################################################################## 52 53# netDev=(AUTO-DHCP or <nic>) 54 55netDev specifies what type of networking to enable for the installer 56Can be set to AUTO-DHCP or to a network interface, such as et0 57 58When set to AUTO-DHCP, pc-sysinstall will probe for all network devices 59and attempt to set DHCP mode on each, until a working network connection 60is established 61 62If netDev= is set to a network interface such as et0, the following options 63will need to be set in order to enable the interface 64 65# netIP=(IP address such as 192.168.0.100) 66 67 Set netIP to an address that you wish to have the interface specified in 68 netDev set to 69 Only used when netDev is not set to AUTO-DHCP 70 71# netMask=(Netmask such as 255.255.255.0) 72 73Set netMask to the address you with to have the interface specified in 74netDev set to 75Only used when netDev is not set to AUTO-DHCP 76 77 78# netNameServer=(DNS Server such as 192.168.0.1) 79 80Set netNameServer to the DNS address you want to use during the install 81Only used when netDev is not set to AUTO-DHCP 82 83 84# netDefaultRouter=(192.168.0.1) 85 86Set netDefaultRouter to the gateway you wish to have the installer use 87Only used when netDev is not set to AUTO-DHCP 88 89 90 91# netSaveDev=(AUTO-DHCP or network interface) 92 93netSaveDev specifies what networking to enable on the installed system 94 95When set to AUTO-DHCP, pc-sysinstall will probe all network interfaces, and 96set them all to DHCP in the systems /etc/rc.conf file. Wireless devices will also 97have the corresponding wlan[0-9] device created. 98 99When set to a network interface, pc-sysinstall will set the target device with 100the settings specified by the variables below. 101 102# netSaveIP=192.168.0.49 103# netSaveMask=255.255.255.0 104# netSaveNameServer=208.67.222.222 105# netSaveDefaultRouter=192.168.0.1 106 107 108 109 110######################################################################## 111# DISK SLICE SETTINGS 112######################################################################## 113 114The following section specifies the target disk(s) to be used in the 115install or upgrade. 116 117# disk0=(disk device, such as ad0) 118 119The diskX= variable should be set to the target device for this drive, such 120as ad0, da0 121The first should begin with disk0=, and additional drives to disk1=, disk2 122if additional disks are to be setup. 123 124When doing an upgrade, the disk0= line should be set to the root device or 125root zpool of the target system to update. I.E: 126 # disk0=tank0 127 # disk0=ada0s1a 128 129 130# partition=(all, free, s1, s1, s3, s4, image) 131 132After setting disk[0-9], the partition= variable is used to specify which target 133partition we will be working with for this device. 134 135Setting this to "all" will setup the disk with a single FreeBSD slice as "s1" 136 137Setting this to "free" will allow pc-sysinstall to search for the first available 138primary slice with free space, and create the slice. 139 140Setting this to "s1, s2, s3 or s4" will use the specified MBR slice. 141 142Setting this to "image" will use an image to configure the disk. 143 144(This tag is unused for upgrades) 145 146# partscheme=(MBR/GPT) 147 148When performing a "full" disk (partition=all), the partscheme= variable is used 149to determine the partition scheme type gpart will be using on the disk. Valid 150choices are MBR or GPT. 151 152# mirror=(disk device such as ad1) 153 154Setting the mirror= variable will setup the target device as a gmirror 155of the diskX= device. The mirror device must be the same size or larger 156than the drive being mirrored. 157 158 159# mirrorbal=(load, prefer, round-robin, split) 160 161Allows the setting of the mirror balance method to be used, if not 162specified this defaults to "round-robin" 163 164# bootManager=(none, bsd) 165 166Setting this option will instruct pc-sysinstall to install the BSD boot Manager, 167or leave it empty 168 169# image=(/path/to/image/file) (/mountpoint) 170 171Setting this option will instruct pc-sysinstall to write the image file 172specified by the path to the disk. 173 174# commitDiskPart 175 176This command must be placed at the end of the diskX= section, before starting 177the listing of any additional diskX= directives. 178 179 180######################################################################## 181# DISK PARTITION / MOUNT SETTINGS 182######################################################################## 183 184The following settings specify the partitioning / mount points to setup 185on the target partition 186 187# disk0-part=UFS+S 500 / 188# disk0-part=SWAP 2000 none 189# disk0-part=UFS.eli 500 /usr 190# encpass=mypass 191# disk0-part=UFS+J 500 /tmp 192# disk0-part=ZFS 0 /data,/storage (mirror: ad1) 193# commitDiskLabel 194 195The above values instructs pc-sysinstall which partitions / mounts 196to create on the target drive / slice, specified by "disk0". 197(disk0 will resolve to the drive / slice specified in the previous section) 198 199The notation is as follows: 200<File System Type> <Size> <Mountpoint> 201 202Available FileSystems: 203 UFS - Standard UFS2 FileSystem 204UFS+S - UFS2 + Softupdates enabled 205UFS+SUJ - UFS2 + Soft Updates + Journaling enabled 206UFS+J - UFS2 + Journaling through gjournal 207 ZFS - Z File System, pools / mounts created automatically 208 SWAP - BSD Swap space partition, mountpoint should be set to "none" 209 210Adding the ".eli" extension to any of the above file systems 211will enable disk encryption via geli 212(UFS.eli, UFS+S.eli, UFS+SUJ.eli, UFS+J.eli, ZFS.eli, SWAP.eli) 213 214If you with to use a passphrase with this encrypted partition, on the next line 215the flag "encpass=" should be entered: 216encpass=mypass 217 218All sizes are expressed in MegaBytes 219Specifying a size 0 instructs pc-sysinstall to use the rest of the 220available slice size, and should only be used for the last partition / mount 221 222When using "ZFS" specifically, it is possible to specify additional disks / partitions 223to include in the zpool. By using the syntax: (mirror: ad1,ad2) or (raidz: ad1,ad2), it is possible 224to include the disk "ad1" into the zpool for this partition, using the raidz / mirror methods. 225If you with to just include the disk into the pool in "basic" mode, then use (ad1,ad2) with no flags 226 227######################################################################## 228# INSTALL OPTIONS / SOURCES 229######################################################################## 230 231The following settings specify the type, locations and sources 232for this installation 233 234# installMedium=(dvd, usb, ftp, rsync, image) 235 236Set installMedium= to the source type we will be using for this install. 237 238Available Types: 239 dvd - Search for and mount the DVD which contains the install archive 240 usb - Search for and mount the USB drive which contains the install archive 241 ftp - The install archive will be fetched from a FTP / HTTP server before install 242rsync - Pull the system data from a ssh + rsync server, specified with variables below 243image - Install system from an image 244 245# installType=(PCBSD, FreeBSD) 246 247Set the type of system we are installing, PCBSD or FreeBSD 248 249# installFile=fbsd-release.tbz 250 251The installer archive, if not using the defaults specified in conf/pc-sysinstall.conf 252 253# packageType=(tar, uzip, split) 254 255The archive type we are extracting from when using dvd, usb or ftp 256 257# ftpPath=ftp://ftp.pcbsd.org/pub/8.0/netinstall 258 259Location of the installer archive when using a installMedium=ftp 260 261# rsyncPath=life-preserver/back-2009-11-12T14_53_14 262 263The location of the rsync data on the remote server when using installMedium=rsync 264 265# rsyncUser=rsyncuser 266 267The username to use for the ssh server running rsync 268 269# rsyncHost=192.168.0.50 270 271The rsync / ssh server we wish to connect to 272 273# rsyncPort=22 274 275The port to use when connecting to a ssh + rsync server 276 277# installComponents=amarok,firefox,ports 278 279The specified components to install, view available with "./pc-sysinstall list-components" 280 281 282######################################################################## 283# UPGRADE OPTIONS 284######################################################################## 285 286Options specific to performing an upgrade 287 288# upgradeKeepDesktopProfile=(yes/no) 289 290This option allows you to specify if you wish to keep your existing users desktop 291profile data. The default is NO, and your existing profile will be moved to 292.kde4.preUpgrade automatically. 293 294######################################################################## 295# USER OPTIONS 296######################################################################## 297 298Options for setting up usernames and passwords on the installed system 299 300# rootPass=root 301 302Set the root password of the installed system to the specified plaintext string 303 304# rootEncPass=<encryptedstring> 305 306Set the root password of the installed system to the specified encrypted string 307 308The below variables are used to setup a user on the installed system 309Be sure to call commitUser after after adding these values, and before 310starting another user block 311 312# userName=kris 313# userComment=Kris Moore 314# userPass=mypass 315or 316# userEncPass=<encryptedstring> 317# userShell=/bin/csh 318# userHome=/home/kris 319# userGroups=wheel,operator 320# commitUser 321 322######################################################################## 323# RUN COMMANDS 324######################################################################## 325 326The following variables can be set to run commands post-installation, 327allowing the user to further tweak / modify the system 328 329# runCommand= 330 331Run the specified command within chroot of the installed system 332 333# runScript= 334 335runScript will copy the specified script into FSMNT, and run it in chroot of the system 336Useful when you have a 3rd party script on the DVD / USB, and you want to copy it into 337the installed system and run 338 339# runExtCommand= 340 341runExtCommand is used when you wish to run a command outside the chroot 342The variable $FSMNT is set to the mount-point of your installed system 343 344 345######################################################################## 346# PC-BSD SPECIFIC OPTIONS 347######################################################################## 348 349Options for time-zones and NTP on the installed system 350 351# timeZone= 352 353timeZone can be set to the zone file in /usr/share/zoneinfo/ that is to be used 354example: America/New_York 355 356# enableNTP= (yes / no) 357 358set enableNTP to yes or no to enable or disable the NTP service on the system 359 360 361######################################################################## 362# PC-BSD SPECIFC OPTIONS 363######################################################################## 364 365Options specific to installing PC-BSD, such as localization, and KDE settings 366 367# localizeLang=en 368 369localizeLang will set the system console and Desktop to the target language 370 371# localizeKeyLayout=en 372 373localizeKeyLayout updates the system's xorg config to set the keyboard layout 374 375# localizeKeyModel=pc104 376 377localizeKeyModel updates the system's xorg config to set the keyboard model 378 379# localizeKeyVariant=intl 380 381localizeKeyVariant is used to update the xorg config to set the keyboard variant 382 383# autoLoginUser=kris 384 385Setting autoLoginUser will enable the specified user to log into the desktop 386automatically without entering a password 387 388$FreeBSD$ 389