Variables: Difference between revisions

From FAIWiki
Jump to navigation Jump to search
(FAI_CONFIGDIR moved to m-f-n.conf)
(linked several commands to topics, made comments in used_by italics)
Line 40: Line 40:
|DEBIAN_FRONTEND||int||noninteractive||||dpkg -i||
|DEBIAN_FRONTEND||int||noninteractive||||dpkg -i||
|-
|-
|do_init_tasks||int|| boolean ||||fai, task_confdir(), prcopyleft()||1 if doing net or CD installations
|do_init_tasks||int|| boolean ||||[[fai]], task_confdir(), prcopyleft()||1 if doing net or CD installations


|-
|-
Line 46: Line 46:
|-
|-


|FAI||||/var/lib/fai/config||fai.conf||almost every function||
|FAI||||/var/lib/fai/config||[[fai.conf]]||''almost every function''||
|-
|-
|FAI_ETC_DIR ||||/etc/fai||fai -c|| make-fai-nfsroot, fai-mirror, fai-cd, task_prepareapt, fai_init()||
|FAI_ETC_DIR ||||/etc/fai||fai -c|| [[make-fai-nfsroot]], [[fai-mirror]], [[fai-cd]], task_prepareapt, fai_init()||
|-
|-
|FAI_ACTION||||install, sysinfo, softupdate || fai-chboot via kernel command line||save_log_local() save_log_remote_shell() save_log_remote() get_bootp_info() task_action(), fai-savelog-ftp, updatebase||  
|FAI_ACTION||||install, sysinfo, softupdate || fai-chboot via kernel command line||save_log_local() save_log_remote_shell() save_log_remote() get_bootp_info() task_action(), fai-savelog-ftp, updatebase||  
Line 54: Line 54:
|FAI_FLAGS||||'createvt sshd'|| kernel command line, fai-chboot ||define_fai_flags()|| rename flags, e.g $flag_sshd
|FAI_FLAGS||||'createvt sshd'|| kernel command line, fai-chboot ||define_fai_flags()|| rename flags, e.g $flag_sshd
|-
|-
|FAI_CONFIG_SRC||||nfs://faiserver/srv/fai/config||make-fai-nfsroot||get-config-dir|| m-f-n writes its value to $NFSROOT/etc/fai/fai.conf
|FAI_CONFIG_SRC||||nfs://faiserver/srv/fai/config||[[make-fai-nfsroot]]||get-config-dir|| m-f-n writes its value to $NFSROOT/etc/fai/fai.conf
|-
|-
|FAI_LOCATION||||faiserver:/srv/fai/config||make-fai-nfsroot||get_bootp_info() get_fai_dir() get_fai_cvs()|| replaced by FAI_CONFIG_SRC
|FAI_LOCATION||||faiserver:/srv/fai/config||[[make-fai-nfsroot]]||get_bootp_info() get_fai_dir() get_fai_cvs()|| replaced by FAI_CONFIG_SRC
|-
|-
|FAI_LOGPROTO|| || ftp||fai.conf||fai-setup, save_log_remote()||replaces FAI_REMOVECP and FAI_REMOTESH, may be removed from fai.conf, should be defined in class/*.var, but fai-setup needs this too, maybe add option to fai-setup that determines if ssh/rsh should be set up
|FAI_LOGPROTO|| || ftp||[[fai.conf]]||[[fai-setup]], save_log_remote()||replaces FAI_REMOVECP and FAI_REMOTESH, may be removed from fai.conf, should be defined in class/*.var, but fai-setup needs this too, maybe add option to fai-setup that determines if ssh/rsh should be set up
|-
|-
|FAI_ROOT||const||/target||bin/fai|| almost every script|| $target has the same value
|FAI_ROOT||const||/target||bin/fai||''almost every script''|| $target has the same value
|-
|-
|fai_rundate||int||20060123_163824||task_setup()||fai-savelog||
|fai_rundate||int||20060123_163824||task_setup()||fai-savelog||
|-
|-
|FAI_VERSION||const||FAI 3.2||||fai, prcopyleft()||
|FAI_VERSION||const||FAI 3.2||||[[fai]], prcopyleft()||


|-
|-
|FAI_CONFIGDIR||int||/srv/fai/config||make-fai-nfsroot.conf||*.postinst, fai-setup, fai-cd, fai-mirror, make-fai-nfsroot ||
|FAI_CONFIGDIR||int||/srv/fai/config||[[make-fai-nfsroot.conf]]||*.postinst, [[fai-setup]], [[fai-cd]], [[fai-mirror]], [[make-fai-nfsroot]] ||
|-
|-
|HOSTNAME||||demohost||||very often|| may the hostname change during installtion? Is the hostname FQDN in some cases? numeric hostname if host-decl-name off in dhcpd.conf
|HOSTNAME||||demohost||||''very often''|| may the hostname change during installtion? Is the hostname FQDN in some cases? numeric hostname if host-decl-name off in dhcpd.conf
|-
|-
|HOSTTYPE||int||x86_64||bash variable|| prcopyleft ||
|HOSTTYPE||int||x86_64||bash variable|| prcopyleft ||
Line 76: Line 76:


|-
|-
|LOGDIR||||/tmp/fai|| fai ||very often||
|LOGDIR||||/tmp/fai|| fai ||''very often''||
|-
|-
|LOGPASSWD||CS|| || *.var ||fai-savelog-ftp|| moved from fai.conf to CS
|LOGPASSWD||CS|| || *.var ||fai-savelog-ftp|| moved from fai.conf to CS
Line 84: Line 84:
|LOGSERVER||CS|| || *.var || fai-savelog, fai-savelog-ftp|| default: LOGSERVER=$SERVER, moved from fai.conf to CS
|LOGSERVER||CS|| || *.var || fai-savelog, fai-savelog-ftp|| default: LOGSERVER=$SERVER, moved from fai.conf to CS
|-
|-
|LOGUSER|||| fai ||fai.conf ||fai-setup, fai-savelog, fai-savelog-ftp,task_chboot()||default: LOGUSER= will disable logging
|LOGUSER|||| fai ||[[fai.conf]] ||[[fai-setup]], fai-savelog, fai-savelog-ftp,task_chboot()||default: LOGUSER= will disable logging
|-
|-
|MNTPOINT||||/media/mirror||||make-fai-nfsroot, fai-mirror, task_mirror()|| influences entries in sources.list, may become a fixed path
|MNTPOINT||||/media/mirror||||[[make-fai-nfsroot]], [[fai-mirror]], task_mirror()|| influences entries in sources.list, may become a fixed path
|-
|-
|NFSROOT||||/srv/fai/nfsroot/||make-fai-nfsroot.conf || fai-setup, make-fai-nfsroot, fai-cd, fai-mirror, make-fai-bootfloppy || not needed in $NFSROOT, only needed on the install server
|NFSROOT||||/srv/fai/nfsroot/||[[make-fai-nfsroot.conf]] || [[fai-setup]], [[make-fai-nfsroot]], [[fai-cd]], [[fai-mirror]], [[make-fai-bootfloppy]] || not needed in $NFSROOT, only needed on the install server
|-
|-
|STOP_ON_ERROR||int|| 99999 || *.var || task_error() || errors greater STOP_ON_ERROR will cause fai to stop the installation  ||
|STOP_ON_ERROR||int|| 99999 || *.var || task_error() || errors greater STOP_ON_ERROR will cause fai to stop the installation  ||
|-
|-
|TFTPROOT||||/srv/tftp/fai||make-fai-nfsroot.conf || make-fai-nfsroot, fai-chboot || not needed in $NFSROOT, only needed on the install server
|TFTPROOT||||/srv/tftp/fai||[[make-fai-nfsroot.conf]] || [[make-fai-nfsroot]], [[fai-chboot]] || not needed in $NFSROOT, only needed on the install server
|-
|-
|PATH||int||/usr/local/sbin:...|| fai || ||
|PATH||int||/usr/local/sbin:...|| fai || ||
|-
|-
|SERVERINTERFACE||||eth0|| make-fai-nfsroot.conf|| fai-setup|| used to specify interface when building exportfs line, only needed when install server has multiple interfaces
|SERVERINTERFACE||||eth0|| [[make-fai-nfsroot.conf]]|| [[fai-setup]]|| used to specify interface when building exportfs line, only needed when install server has multiple interfaces


|-
|-
|FAI_DEBMIRROR|||| $mirrorhost:/srv/debmirror||fai.conf|| || move to make-fai-nfsroot.conf, but needed in $NFSROOT/../fai.conf
|FAI_DEBMIRROR|||| $mirrorhost:/srv/debmirror||[[fai.conf]]|| || move to make-fai-nfsroot.conf, but needed in $NFSROOT/../fai.conf
|-
|-


Line 109: Line 109:
|cfclasses||int||DEFAULT.LINUX.LAST||task_defclass()||cfagent scripts||  
|cfclasses||int||DEFAULT.LINUX.LAST||task_defclass()||cfagent scripts||  
|-
|-
|classes||int||DEFAULT LINUX LAST||task_defclass()||almost every script||
|classes||int||DEFAULT LINUX LAST||task_defclass()||''almost every script''||
|-
|-
|device_size||int||'sda 71687372'||||set_disk_info()|| all disks and their sizes; may become local variable
|device_size||int||'sda 71687372'||||set_disk_info()|| all disks and their sizes; may become local variable
|-
|-
|disklist||int||sda||set_disk_info() ||setup_harddisks, fai-mount-disk||
|disklist||int||sda||set_disk_info() ||setup_harddisks, [[fai-mount-disk]]||
|-
|-
|faimond||int ||0|| || ||determines if faimond is running, merge $faimond and $monserver
|faimond||int ||0|| || ||determines if faimond is running, merge $faimond and $monserver
Line 143: Line 143:
|flag_createvt||int||boolean||define_fai_flags()||||
|flag_createvt||int||boolean||define_fai_flags()||||
|-
|-
|task_error||int||integer|| ||every task can set it || formerly $terror
|task_error||int||integer|| ||''every task can set it''|| formerly $terror
|-
|-


|target||||/tmp/target|| || || same as $FAI_ROOT
|target||||/tmp/target|| || || same as $FAI_ROOT
|-
|-
|ROOTCMD||||'chroot /tmp/target'||||almost every script||
|ROOTCMD||||'chroot /tmp/target'||||''almost every script''||


|-
|-
Line 176: Line 176:
|USE_SETUP_STORAGE||CS||1||*.var |||| when set to 1, FAI will use the new partition tool setup-storage
|USE_SETUP_STORAGE||CS||1||*.var |||| when set to 1, FAI will use the new partition tool setup-storage
|-
|-
|FAI_BACKUPDIR||CS||||*.var ||fcopy|| directory used bu fcopy for backup files
|FAI_BACKUPDIR||CS||||*.var ||[[fcopy]]|| directory used bu fcopy for backup files
|-
|-
|}
|}
Line 186: Line 186:
!name!!type!!example value!!created by!!used by !!comments
!name!!type!!example value!!created by!!used by !!comments
|-
|-
|FAI_REMOTECP||||scp||fai.conf || fai-savelog|| replaced by FAI_LOGPROTO
|FAI_REMOTECP||||scp||[[fai.conf]] || fai-savelog|| replaced by FAI_LOGPROTO
|-
|-
|FAI_REMOTESH||||ssh||fai.conf || fai-savelog, task_chboot()|| replaced by FAI_LOGPROTO
|FAI_REMOTESH||||ssh||[[fai.conf]] || fai-savelog, task_chboot()|| replaced by FAI_LOGPROTO
|-
|-
|diskvar||int||$LOGDIR/disk_var.sh|||||| removed, replace with "$LOGDIR/diskvar"
|diskvar||int||$LOGDIR/disk_var.sh|||||| removed, replace with "$LOGDIR/diskvar"
Line 195: Line 195:
|lpipe||int ||/tmp/fai/logfifo|||||| variable removed, try to remove the ugly hack using it
|lpipe||int ||/tmp/fai/logfifo|||||| variable removed, try to remove the ugly hack using it
|-
|-
|FAI_BOOT||||dhcp bootp||||make-fai-nfsroot||removed from fai.conf, now using default value, BOOTP is not supported any more
|FAI_BOOT||||dhcp bootp||||[[make-fai-nfsroot]]||removed from fai.conf, now using default value, BOOTP is not supported any more
|-
|-


|DNSDOMAIN||||workgroup.de||task_setup()|| || removed
|DNSDOMAIN||||workgroup.de||task_setup()|| || removed
|-
|-
|installserver||||kueppers||| fai.conf|| only for building FAI_LOCATION|| removed
|installserver||||kueppers|||[[fai.conf]]|| only for building FAI_LOCATION|| removed
|-
|-
|mirrorhost||||192.168.0.8||fai.conf || make-fai-nfsroot.conf,$FAI_DEBOOTSTRAP, $FAI_DEBMIRROR, NFSROOT_ETC_HOSTS || removed
|mirrorhost||||192.168.0.8||[[fai.conf]]|| [[make-fai-nfsroot.conf]], $FAI_DEBOOTSTRAP, $FAI_DEBMIRROR, NFSROOT_ETC_HOSTS || removed
|-
|-
|fstab||int||fstab|| || was used for solaris, fstab -> vfstab|| removed
|fstab||int||fstab|| || was used for solaris, fstab -> vfstab|| removed

Revision as of 11:27, 30 July 2009

The following Variables do exist in FAI (example values included):

Please do not edit that much, without contacting Mrfai. Currently it's my private list of variable and comments.

type: int = internal use only; CS used in config space (often defined by *.var)

Which variables are needed inside the nfsroot, so the install clients can use them? (maybe write them into fai-client.var or nfsroot.var). Then do not copy fai.conf into the nfsroot any more.

name type example value created by used by comments
BROADCAST 192.168.0.127 get-boot-info scripts/FAIBASE/30-interface
DNSSRVS 192.168.1.16 get-boot-info create_resolv_conf
DNSSRVS_1 192.168.1.16 get-boot-info first element of DNSSRV
DOMAIN workgroup.de get-boot-info task_setup() task_prepareapt()
NETMASK 255.255.255.128 get-boot-info
NETWORK 192.168.0.0 get-boot-info
IPADDR 192.168.0.14 get-boot-info
GATEWAYS 192.168.0.1 get-boot-info
GATEWAYS_1 192.168.0.1 get-boot-info
SERVER kueppers get-boot-info
--
DEBIAN_FRONTEND int noninteractive dpkg -i
do_init_tasks int boolean fai, task_confdir(), prcopyleft() 1 if doing net or CD installations
--
FAI /var/lib/fai/config fai.conf almost every function
FAI_ETC_DIR /etc/fai fai -c make-fai-nfsroot, fai-mirror, fai-cd, task_prepareapt, fai_init()
FAI_ACTION install, sysinfo, softupdate fai-chboot via kernel command line save_log_local() save_log_remote_shell() save_log_remote() get_bootp_info() task_action(), fai-savelog-ftp, updatebase
FAI_FLAGS 'createvt sshd' kernel command line, fai-chboot define_fai_flags() rename flags, e.g $flag_sshd
FAI_CONFIG_SRC nfs://faiserver/srv/fai/config make-fai-nfsroot get-config-dir m-f-n writes its value to $NFSROOT/etc/fai/fai.conf
FAI_LOCATION faiserver:/srv/fai/config make-fai-nfsroot get_bootp_info() get_fai_dir() get_fai_cvs() replaced by FAI_CONFIG_SRC
FAI_LOGPROTO ftp fai.conf fai-setup, save_log_remote() replaces FAI_REMOVECP and FAI_REMOTESH, may be removed from fai.conf, should be defined in class/*.var, but fai-setup needs this too, maybe add option to fai-setup that determines if ssh/rsh should be set up
FAI_ROOT const /target bin/fai almost every script $target has the same value
fai_rundate int 20060123_163824 task_setup() fai-savelog
FAI_VERSION const FAI 3.2 fai, prcopyleft()
FAI_CONFIGDIR int /srv/fai/config make-fai-nfsroot.conf *.postinst, fai-setup, fai-cd, fai-mirror, make-fai-nfsroot
HOSTNAME demohost very often may the hostname change during installtion? Is the hostname FQDN in some cases? numeric hostname if host-decl-name off in dhcpd.conf
HOSTTYPE int x86_64 bash variable prcopyleft
FAI_ALLOW_UNSIGNED *.var prepareapt allow installation of packages from unsigned repositories
LOGDIR /tmp/fai fai very often
LOGPASSWD CS *.var fai-savelog-ftp moved from fai.conf to CS
LOGREMOTEDIR CS upload *.var fai-savelog-ftp moved from fai.conf to CS
LOGSERVER CS *.var fai-savelog, fai-savelog-ftp default: LOGSERVER=$SERVER, moved from fai.conf to CS
LOGUSER fai fai.conf fai-setup, fai-savelog, fai-savelog-ftp,task_chboot() default: LOGUSER= will disable logging
MNTPOINT /media/mirror make-fai-nfsroot, fai-mirror, task_mirror() influences entries in sources.list, may become a fixed path
NFSROOT /srv/fai/nfsroot/ make-fai-nfsroot.conf fai-setup, make-fai-nfsroot, fai-cd, fai-mirror, make-fai-bootfloppy not needed in $NFSROOT, only needed on the install server
STOP_ON_ERROR int 99999 *.var task_error() errors greater STOP_ON_ERROR will cause fai to stop the installation
TFTPROOT /srv/tftp/fai make-fai-nfsroot.conf make-fai-nfsroot, fai-chboot not needed in $NFSROOT, only needed on the install server
PATH int /usr/local/sbin:... fai
SERVERINTERFACE eth0 make-fai-nfsroot.conf fai-setup used to specify interface when building exportfs line, only needed when install server has multiple interfaces
FAI_DEBMIRROR $mirrorhost:/srv/debmirror fai.conf move to make-fai-nfsroot.conf, but needed in $NFSROOT/../fai.conf
--
HOST demohost given on kernel command line can redefine host name
cfclasses int DEFAULT.LINUX.LAST task_defclass() cfagent scripts
classes int DEFAULT LINUX LAST task_defclass() almost every script
device_size int 'sda 71687372' set_disk_info() all disks and their sizes; may become local variable
disklist int sda set_disk_info() setup_harddisks, fai-mount-disk
faimond int 0 determines if faimond is running, merge $faimond and $monserver
monserver kueppers task_confdir sndmon() default: monserver=$SERVER, may be removed, but must be set very early (e.g in fai.conf)
ip int dhcp fai-chboot via kernel append parameter get-boot-info
--
netdevices int eth0 get-boot-info get-boot-info, task_sysinfo, dhclient-fai-script
netdevices_all int eth0 eth1 get-boot-info get-boot-info, task_sysinfo
netdevices_up eth0 get-boot-info get-boot-info, task_sysinfo
nfsroot int /srv/fai/nfsroot/ fai-chboot via kernel append parameter kernel may contain server's IP address, may contain nfs parameters like: v2,rsize=32768,wsize=32768
renewclass int boolean task_defclass() on softupdate recalculate the list of classes, unset after use
romountopt int -o async,noatime,ro unset after use
sndhostname task_confdir() sndmon() sndhostname=$HOSTNAME; client's hostname, do not replace with $HOSTNAME, since HOSTNAME may change during installation
flag_sshd int boolean define_fai_flags()
flag_createvt int boolean define_fai_flags()
task_error int integer every task can set it formerly $terror
target /tmp/target same as $FAI_ROOT
ROOTCMD 'chroot /tmp/target' almost every script
stamp int ..._IN_PROGRESS


CONSOLEFONT CS class/*.var
KEYMAP CS de class/*.var
BOOT_PARTITION CS /dev/sda1 setup_harddisks grub/menu.lst/postinst
ROOT_PARTITION CS /dev/sda1 setup_harddisks LILO/20-create-liloconf
UTC CS yes class/*.var example/simple/scripts
TIMEZONE CS Europe/Berlin class/*.var example/simple/scripts
liloappend CS class/*.var 20-create-liloconf
MODULESLIST CS psmouse class/*.var scripts/FAIBASE/10-misc
MAXPACKAGES CS 300 install_packages limit the number of packages install added to apt-get or aptitude
USE_SETUP_STORAGE CS 1 *.var when set to 1, FAI will use the new partition tool setup-storage
FAI_BACKUPDIR CS *.var fcopy directory used bu fcopy for backup files


Variables that are unused since 3.x versions of FAI:

name type example value created by used by comments
FAI_REMOTECP scp fai.conf fai-savelog replaced by FAI_LOGPROTO
FAI_REMOTESH ssh fai.conf fai-savelog, task_chboot() replaced by FAI_LOGPROTO
diskvar int $LOGDIR/disk_var.sh removed, replace with "$LOGDIR/diskvar"
lpipe int /tmp/fai/logfifo variable removed, try to remove the ugly hack using it
FAI_BOOT dhcp bootp make-fai-nfsroot removed from fai.conf, now using default value, BOOTP is not supported any more
DNSDOMAIN workgroup.de task_setup() removed
installserver kueppers fai.conf only for building FAI_LOCATION removed
mirrorhost 192.168.0.8 fai.conf make-fai-nfsroot.conf, $FAI_DEBOOTSTRAP, $FAI_DEBMIRROR, NFSROOT_ETC_HOSTS removed
fstab int fstab was used for solaris, fstab -> vfstab removed
VIDEODRIVER CS mga 20-hwdetect.source scripts/DEMO/10-misc removed with Xorg

useful oneliners

find all files not under a ".svn" directory and replace the string '$diskvar' with '$LOGDIR/diskvar'

Test:

find -name '.svn' -prune -o -type f -exec perl -n -e 's/\$diskvar/\$LOGDIR\/diskvar/g && print' {} \;

find -name '.svn' -prune -o -type f -exec perl -p -e 's/\$diskvar/\$LOGDIR\/diskvar/g' {} \; | less

Really replace: ( same, but "i" added )

find -name '.svn' -prune -o -type f -exec perl -pi -e 's/\$diskvar/\$LOGDIR\/diskvar/g' {} \;

More info:

perldoc perlrun

man find