home *** CD-ROM | disk | FTP | other *** search
/ PC World 1999 August / PCWorld_1999-08_cd.bin / doc / sample.ks < prev   
Text File  |  1999-04-16  |  15KB  |  393 lines
  1. # This is a sample kickstart file.  The values here probably won't be what
  2. # you want them to be for your install, and besides, they're all commented
  3. # out, so use this as a *template* for your kickstart file.
  4. #
  5. # H O W   T O   S E T   U P   A   K I C K S T A R T   I N S T A L L
  6. # 
  7. # (Note: Kickstart installs are not available for Red Hat Linux/SPARC.)
  8. #
  9. # To begin a kickstart install, you must include the "ks" option on the Red
  10. # Hat Linux boot diskette's boot command.  You can read the kickstart file
  11. # from diskette by using the boot command "linux ks=floppy" (For Red Hat
  12. # Linux/Intel only).  In this case, the kickstart file will be read from
  13. # the diskette.  It must be called ks.cfg, and must reside in the
  14. # diskette's root directory.
  15. # 
  16. # If you want to do a kickstart'ed NFS install, you must have a bootp
  17. # server on your network, and it must have an entry for the machine you're
  18. # installing.  The bootp server will be used to give the installing machine
  19. # its network information.  It can also provide the location of the
  20. # machine's kickstart file.  If this is done, an NFS mount on the kickstart
  21. # file's path is attempted, and the file is copied from there.
  22. # 
  23. # The file, by default, is called <ip-addr>-kickstart, in which <ip-addr>
  24. # is the machine's IP address in "dotted decimal" notation.
  25. # 
  26. # If the filename obtained from bootp ends with "/", it is interpreted as a
  27. # path.  In this case, the default kickstart filename is used, relative to
  28. # the given path.
  29. #
  30. # If the filename obtained from bootp doesn't end with "/", then it is
  31. # interpreted as the name of the kickstart file, including the specified
  32. # path.
  33. # 
  34. # If no filename is given, the default filename is used, and /kickstart/ is
  35. # used as the path.
  36. # 
  37. # L A N G U A G E   S P E C I F I C A T I O N (Required for upgrade)
  38. #
  39. # You must specify a language to be used for every kickstart install.  To
  40. # specify a language, simply use the two-letter ISO language code, such as
  41. # "en" for English, "de" for German, "fr" for French, etc.
  42. #
  43. # Example:
  44. #lang en
  45. #
  46. # N E T W O R K   C O N F I G U R A T I O N
  47. #
  48. # You may specify network configuration via one of three different methods:
  49. #
  50. # DHCP -- Use a dhcp server to obtain network configuration information.
  51. # BOOTP -- Use a bootp server to obtain network configuration information.
  52. # STATIC -- Use the network configuration information contained in the
  53. # kickstart file itself.
  54. #
  55. # Example:
  56. #network --bootproto dhcp
  57. #
  58. # For static network configuration, the following options are used:
  59. #
  60. # --ip <ipaddr> -- Specify the desired IP address.
  61. # --netmask <mask> -- Specify the desired network mask.
  62. # --gateway <gwaddr> -- Specify the desired gateway address.
  63. # --nameserver <nsaddr> -- Specify the desired nameserver address.
  64. #
  65. # Example:
  66. #network --bootproto static --ip 10.0.2.15 --netmask 255.255.255.0 --gateway 10.0.2.254 --nameserver 10.0.2.1
  67. # (Obviously, you'll want to change the addresses and netmask...)
  68. # (Note that this line may *not* be wrapped using the ol' backslash; it
  69. # must be strung out as one long line.  And no, you can't specify more than
  70. # one nameserver...)
  71. #
  72. # I N S T A L L A T I O N   M E T H O D (Required for upgrade)
  73. #
  74. # Kickstart installs can be performed using one of two methods:
  75. #
  76. # NFS -- Using an NFS server to obtain the distribution files.
  77. # CDROM -- Using a CDROM to obtain the distribution files.
  78. #
  79. # For NFS installs, use the --server option to specify the NFS server.
  80. # Note that it defaults to the server specified in the bootp response, or
  81. # to the bootp server itself, if the bootp response doesn't specify a
  82. # server.  The --dir option is used to point to the top-level directory
  83. # containing the distribution files.
  84. #
  85. # Example:
  86. #nfs --server porkchop.redhat.com --dir /mnt/test/i386
  87. #
  88. # For CDROM installs, just say, "cdrom".
  89. #
  90. # Example:
  91. #cdrom
  92. #
  93. # For URL installs, give the url to the distribution files.  If
  94. # you need to use a proxy server, use --proxy to specify the server and
  95. # --proxyport to specify the port.
  96. #
  97. # Example:
  98. #url --url http://porkchop.redhat.com/mnt/test/i386
  99. #
  100. # For Hard Drive installs, give the partition and directory that contains
  101. # the distribution files.
  102. #
  103. # Example:
  104. #
  105. #harddrive --partition /dev/hda2 --dir /downloads/redhat
  106. #
  107. #
  108. # D E V I C E   S P E C I F I C A T I O N  (Required for upgrade)
  109. #
  110. # In this section, you can specify any device information required.
  111. # PCI cards can normally be autoprobed, so they don't need to be specified
  112. # here.
  113. #
  114. # To specify a device, start with the "device" keyword, followed by the
  115. # type of device:
  116. #
  117. # ethernet -- for ethernet cards.
  118. # 
  119. # scsi -- for scsi cards.
  120. # 
  121. # cdrom -- for non-scsi, non-ide cdrom cards (eg., sound cards with
  122. # proprietary CDROM interfaces).
  123. #
  124. # Optional parameters that are required by a device can also be specified
  125. # by using the --opts option.  Enclose the paratmeters in quotes after
  126. # --opts.
  127. #
  128. # Note that you can specify multiple types of devices.  For example, if you
  129. # know the machines you'll be kickstart-installing have either an Adaptec
  130. # 1542 or a Buslogic card, you can enter both in the kickstart file.  But
  131. # be aware that the install uses only the first card found, so order the
  132. # device entries appropriately...
  133. #
  134. # Example:
  135. #device ethernet 3c509 --opts "io=0x330, irq=7"
  136. #
  137. # K E Y M A P   S P E C I F I C A T I O N (Required for upgrade)
  138. # 
  139. # Next, specify the keymap to use with your keyboard.  The available keymap
  140. # types are listed in the kbdconfig program.
  141. #
  142. # Example:
  143. #keyboard us
  144. #
  145. # D E V I C E   C O N T R O L L E R S   -   N O P R O B E
  146. #
  147. # If you do not want your system device controllers to be automatically
  148. # probed then you can issue the command:
  149. #
  150. #noprobe
  151. #
  152. # By configuring this command, your system will not probe for any device
  153. # controllers, SCSI or otherwise. This is to be used only if you wish to
  154. # manually specify the devices that are on your system.
  155. #
  156. #
  157. # D E V I C E   C O N T R O L L E R S  -  --C O N T I N U E
  158. #
  159. # In order to load modules for more than 1 adapter
  160. # type, (for example, two different SCSI adapters) you will need to add
  161. # the command
  162. #
  163. #device --continue
  164. #
  165. # So, if you need to have modules for a Adaptec and a BusLogic adapter,
  166. # then you will need to have both of these specified in the configuration 
  167. # file and you will need to have --continue after the
  168. # first one in the configuration file:
  169. #
  170. #device scsi aic7xxx --continue
  171. #device scsi BusLogic
  172. #
  173. # However, if you have multiple adapters of the same type, then you
  174. # will not need to be concerned with this line, as the single module
  175. # insertion is enough to control all adapters of that type. For example,
  176. # if you have three Adaptec adapters, then the single line
  177. #
  178. #device scsi aic7xxx
  179. #
  180. # will load and allow all three adapters to function.
  181. #
  182. #
  183. # P A R T I T I O N   S P E C I F I C A T I O N
  184. # 
  185. # This is where you specify the partitions to be used in the install.
  186. # There are several sections that we'll cover in order.
  187. # 
  188. # If you are doing a kickstart install on a new drive, the partition table
  189. # will likely corrupt.  The zerombr command can be used to clear the
  190. # partition table if it is corrupt; otherwise it will take no action.  In
  191. # order to clear the partition table, follow the zerombr command with
  192. # "yes"; if followed by "no", no action will be taken.
  193. #
  194. # Example:
  195. #zerombr yes
  196. #
  197. # The clearpart command is used to control which partitions are to be wiped
  198. # from all drives.  Follow the clearpart command with "--all" to remove all
  199. # partitions from all drives, or "--linux" to remove all Linux-related
  200. # partitions (ie., partitions of type "Linux native" and "Linux swap") from
  201. # all drives.
  202. #
  203. # Example:
  204. #clearpart --linux
  205. # 
  206. # Next, specify the partitions that you'd like to create.  Partitions are
  207. # only created from free space available on the system.  Enter one
  208. # partition per line using the following format:
  209. #
  210. # part <mntpt> --size <size in megs> [--grow] [--maxsize <size in megs>]
  211. #
  212. # Where <mntpt> is the desired mount point for the partition (or "swap" for
  213. # swap partitions).  Add "--grow" to create a partition that will grow to
  214. # fill all remaining space on the drive.  To limit the affect of --grow,
  215. # you can add "--maxsize" followed by a size specification.
  216. # 
  217. # Examples:
  218. #part / --size 250
  219. #part swap --size 32
  220. #part /usr --size 500 --grow --maxsize 800
  221. #part /tmp --size 100 --grow
  222. # 
  223. # I N S T A L L / U P G R A D E   S P E C I F I C A T I O N (Required for upgrade)
  224. # 
  225. # Here we specify whether an install or an upgrade is to be performed.
  226. # Enter "install" for a fresh install, and "upgrade" for an upgrade.
  227. # 
  228. # Note: If you are doing an upgrade, you only need to specify the following
  229. # items in the kickstart file:
  230. # 
  231. # Installation method
  232. # Device specification (if necessary)
  233. # Keymap specification
  234. # Install/upgrade specification (of course!)
  235. # LILO configuration
  236. #
  237. # Example:
  238. #install
  239. #
  240. # M O U S E   S P E C I F I C A T I O N
  241. #
  242. # Enter the type of mouse here.  Valid mouse types can be found by 
  243. # running 'mouseconfig --help'.
  244. # 
  245. # The default device is correctly set for busmice.  /dev/cua0 is the
  246. # default for serial mice, but can be overridden with the "--device"
  247. # option.  Follow it with the device name; for example, "cua2".  If three
  248. # button emulation is needed, specify "--emulthree"
  249. #
  250. # Example:
  251. #mouse generic3ps/2
  252. #
  253. # T I M E Z O N E   S P E C I F I C A T I O N
  254. #
  255. # To specify the desired timezone, use the "timezone" command.  Run
  256. # /usr/sbin/timeconfig to see all the valid timezone names.  If you
  257. # computer's clock is set to GMT/UTC, add the --utc option.
  258. #
  259. # Example:
  260. #timezone --utc US/Eastern
  261. #
  262. # X   W I N D O W   S Y S T E M   S P E C I F I C A T I O N
  263. # 
  264. # Next, it's necessary to enter information related to X.  In order to
  265. # properly configure X, the installation program will need to know about
  266. # your video card (or at least the X server it should use), and your
  267. # monitor (or at least your monitor's specifications).
  268. #
  269. # Video card selection:
  270. # 
  271. # The installation program will normally find PCI video cards
  272. # automatically.  However, you can specify the video card by adding the
  273. # --card option, followed by the card type.  If you run Xconfigurator on a
  274. # Red Hat Linux system, and use the --help option, you'll get a list of all
  275. # valid card types.
  276. # 
  277. # Alternatively, you can enter the name of the X server to be used by
  278. # adding the --server option, followed by the server type.  Again, run
  279. # Xconfigurator --help to obtain a listing of all valid X servers.
  280. #
  281. # Monitor selection:
  282. # 
  283. # Next, you'll need to specify your monitor.  If no monitor information is
  284. # specified, the installation program assumes it it capable of operation at
  285. # 640x480@60hz.  Otherwise, use the --monitor option, followed by the
  286. # monitor type.  Xconfigurator --help lists all valid monitor types.
  287. #
  288. # Alternatively, you can enter the monitor's horizontal and vertical synch
  289. # rates using the --hsync and --vsync options.  Each is followed by the
  290. # appropriate synch rate.  The rates may be single numbers (representing
  291. # kilohertz and megahertz, as appropriate), groups of numbers separated by
  292. # commas, or two numbers separated by a dash (signifying a range).  For
  293. # example: --hsync "31.5,35.5,50-65" --vsync "50-70"
  294. #
  295. # Example:
  296. #xconfig --server "Mach64" --monitor "tatung cm14uhe"
  297. # 
  298. # R O O T   P A S S W O R D
  299. #
  300. # This is where the root password for the freshly-installed system is
  301. # specified.  Note that, for NFS kickstarts, this password goes over the
  302. # network in the clear.  In that case, you can enter a pre-crypted password
  303. # (ie, one suitable for inclusion in /etc/passwd without further editing)
  304. # by using the --iscrypted option, followed by the crypted password.
  305. #
  306. #Example:
  307. #rootpw RHkickedme
  308. #
  309. #
  310. # A U T H E N T I C A T I O N    C O N F I G U R A T I O N
  311. #
  312. # The authconfig format for kickstart looks similiar to:
  313. #
  314. # auth --enablenis --nisdomain foo.redhat.com --nisserver
  315. # server.foo.redhat.com [--useshadow] [--enablemd5]
  316. #
  317. # The commands in the square brackets are optional. If you choose
  318. # to set them up, you do not need to use the brackets.
  319. #
  320. # You are able to change authconfig using these commands to set up
  321. # the different password options:
  322. #
  323. #     --enablenis          enable nis by default
  324. #     --nisdomain <domain> default NIS domain
  325. #     --nisserver <server> default NIS server
  326. #     --useshadow          use shadow passwords
  327. #     --enablemd5          enable MD5 passwords
  328. #
  329. #
  330. # L I L O   C O N F I G U R A T I O N (Required for upgrade)
  331. #
  332. # In this section you specify how LILO is to be configured.  By default,
  333. # LILO will be installed in the master boot record, and will have no append
  334. # line for kernel boot-time options.  You can modify this by using the
  335. # --location option to specify where LILO should be installed, and by using
  336. # the --append option to add an append line to /etc/lilo.conf.
  337. #
  338. # The --location option takes the following parameters:
  339. #
  340. # mbr -- Install LILO in the master boot record.
  341. # 
  342. # partition -- Install LILO in the first sector of the root partition.
  343. # 
  344. # none -- Do not install LILO (meaning you'd better have another way of
  345. # booting this system!
  346. #
  347. # (Note: There is no equivalent to this command on the Alpha.)
  348. # Example:
  349. #lilo --append "mem=128M" --location mbr
  350. #
  351. # P A C K A G E   S P E C I F I C A T I O N
  352. #
  353. # In this section you can select the components and packages that are to be
  354. # installed.  This section must be started with a line containing
  355. # "%packages".  Component and/or package names then follow.  Components are
  356. # preceded by "@ " (NOTE THE SPACE!), and packages appear as-is.
  357. #
  358. # To get a list of components and packages, refer to the file
  359. # RedHat/base/comps on the CD.  The components in the file are preceded by
  360. # a number and a space, while the packages have no preceding characters.
  361. # 
  362. # Example:
  363. #%packages
  364. #@ Networked Workstation
  365. #@ C Development
  366. #@ Web Server
  367. #@ X Window System
  368. #bsd-games
  369. #
  370. # New for 5.2 and later releases is the option to specify "Server" 
  371. # or "Workstation".  This installs the same package set as the 
  372. # normal mode install for those two options. 
  373. # 
  374. # An example would be:
  375. # 
  376. # %packages
  377. # @ Workstation
  378. # 
  379. #
  380. # P O S T - I N S T A L L A T I O N   C O M M A N D S
  381. #
  382. # This section must be the last in the kickstart file.  It can contain
  383. # commands to be executed when the installation has completed.  This
  384. # section must be started with a line containing "%post".  Any lines after
  385. # this one will be executed as commands.
  386. #
  387. # You can access the network in a %post if it was previously configured,
  388. # but you don't have access to nameservice.  So use IP addresses only.
  389. #
  390. # Example:
  391. #%post
  392. #echo "Kickstart-installed Red Hat Linux `/bin/date`" > /etc/motd
  393.