home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 February / CHIP_2_98.iso / doc / README.ks
Text File  |  1997-11-07  |  11KB  |  278 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. # I N S T A L L A T I O N   M E T H O D (Required for upgrade)
  38. #
  39. # Kickstart installs can be performed using one of two methods:
  40. #
  41. # NFS -- Using an NFS server to obtain the distribution files.
  42. # CDROM -- Using a CDROM to obtain the distribution files.
  43. #
  44. # For NFS installs, use the --server option to specify the NFS server.
  45. # Note that it defaults to the server specified in the bootp response, or
  46. # to the bootp server itself, if the bootp response doesn't specify a
  47. # server.  The --dir option is used to point to the top-level directory
  48. # containing the distribution files.
  49. #
  50. # Example:
  51. #nfs --server porkchop.redhat.com --dir /mnt/test/i386
  52. #
  53. # For CDROM installs, just say, "cdrom".
  54. #
  55. # Example:
  56. #cdrom
  57. #
  58. # D E V I C E   S P E C I F I C A T I O N  (Required for upgrade)
  59. #
  60. # In this section, you can specify any device information required.
  61. # PCI cards can normally be autoprobed, so they don't need to be specified
  62. # here.
  63. #
  64. # To specify a device, start with the "device" keyword, followed by the
  65. # type of device:
  66. #
  67. # ethernet -- for ethernet cards.
  68. # 
  69. # scsi -- for scsi cards.
  70. # 
  71. # cdrom -- for non-scsi, non-ide cdrom cards (eg., sound cards with
  72. # proprietary CDROM interfaces).
  73. #
  74. # Optional parameters that are required by a device can also be specified
  75. # by using the --opts option.  Enclose the paratmeters in quotes after
  76. # --opts.
  77. #
  78. # Note that you can specify multiple types of devices.  For example, if you
  79. # know the machines you'll be kickstart-installing have either an Adaptec
  80. # 1542 or a Buslogic card, you can enter both in the kickstart file.  But
  81. # be aware that the install uses only the first card found, so order the
  82. # device entries appropriately...
  83. #
  84. # Example:
  85. #device ethernet 3c509 --opts "io=0x330, irq=7"
  86. #
  87. # K E Y M A P   S P E C I F I C A T I O N (Required for upgrade)
  88. # 
  89. # Next, specify the keymap to use with your keyboard.  The available keymap
  90. # types are listed in the kbdconfig program.
  91. #
  92. # Example:
  93. #keyboard us
  94. #
  95. # P A R T I T I O N   S P E C I F I C A T I O N
  96. # 
  97. # This is where you specify the partitions to be used in the install.
  98. # There are several sections that we'll cover in order.
  99. # 
  100. # If you are doing a kickstart install on a new drive, the partition table
  101. # will likely corrupt.  The zerombr command can be used to clear the
  102. # partition table if it is corrupt; otherwise it will take no action.  In
  103. # order to clear the partition table, follow the zerombr command with
  104. # "yes"; if followed by "no", no action will be taken.
  105. #
  106. # Example:
  107. #zerombr yes
  108. #
  109. # The clearpart command is used to control which partitions are to be wiped
  110. # from all drives.  Follow the clearpart command with "--all" to remove all
  111. # partitions from all drives, or "--linux" to remove all Linux-related
  112. # partitions (ie., partitions of type "Linux native" and "Linux swap") from
  113. # all drives.
  114. #
  115. # Example:
  116. #clearpart --linux
  117. # 
  118. # Next, specify the partitions that you'd like to create.  Partitions are
  119. # only created from free space available on the system.  Enter one
  120. # partition per line using the following format:
  121. #
  122. # part <mntpt> --size <size in megs> [--grow] [--maxsize <size in megs>]
  123. #
  124. # Where <mntpt> is the desired mount point for the partition (or "swap" for
  125. # swap partitions).  Add "--grow" to create a partition that will grow to
  126. # fill all remaining space on the drive.  To limit the affect of --grow,
  127. # you can add "--maxsize" followed by a size specification.
  128. # 
  129. # Examples:
  130. #part / --size 250
  131. #part swap --size 32
  132. #part /usr --size 500 --grow --maxsize 800
  133. #part /tmp --size 100 --grow
  134. # 
  135. # 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)
  136. # 
  137. # Here we specify whether an install or an upgrade is to be performed.
  138. # Enter "install" for a fresh install, and "upgrade" for an upgrade.
  139. # 
  140. # Note: If you are doing an upgrade, you only need to specify the following
  141. # items in the kickstart file:
  142. # 
  143. # Installation method
  144. # Device specification (if necessary)
  145. # Keymap specification
  146. # Install/upgrade specification (of course!)
  147. # LILO configuration
  148. #
  149. # Example:
  150. #install
  151. #
  152. # M O U S E   S P E C I F I C A T I O N
  153. #
  154. # Enter the type of mouse here.  Valid mouse types are:
  155. # 
  156. # ps/2
  157. # mousesystems
  158. # microsoft
  159. # logitech
  160. # atibm
  161. # logibm
  162. # msbm
  163. # 
  164. # The default device is correctly set for busmice.  /dev/cua0 is the
  165. # default for serial mice, but can be overridden with the "--device"
  166. # option.  Follow it with the device name; for example, "cua2".  If three
  167. # button emulation is needed, specify "--emulthree"
  168. #
  169. # Example:
  170. #mouse ps/2
  171. #
  172. # T I M E Z O N E   S P E C I F I C A T I O N
  173. #
  174. # To specify the desired timezone, use the "timezone" command.  Run
  175. # /usr/sbin/timeconfig to see all the valid timezone names.  If you
  176. # computer's clock is set to GMT/UTC, add the --utc option.
  177. #
  178. # Example:
  179. #timezone --utc US/Eastern
  180. #
  181. # 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
  182. # 
  183. # Next, it's necessary to enter information related to X.  In order to
  184. # properly configure X, the installation program will need to know about
  185. # your video card (or at least the X server it should use), and your
  186. # monitor (or at least your monitor's specifications).
  187. #
  188. # Video card selection:
  189. # 
  190. # The installation program will normally find PCI video cards
  191. # automatically.  However, you can specify the video card by adding the
  192. # --card option, followed by the card type.  If you run Xconfigurator on a
  193. # Red Hat Linux system, and use the --help option, you'll get a list of all
  194. # valid card types.
  195. # 
  196. # Alternatively, you can enter the name of the X server to be used by
  197. # adding the --server option, followed by the server type.  Again, run
  198. # Xconfigurator --help to obtain a listing of all valid X servers.
  199. #
  200. # Monitor selection:
  201. # 
  202. # Next, you'll need to specify your monitor.  If no monitor information is
  203. # specified, the installation program assumes it it capable of operation at
  204. # 640x480@60hz.  Otherwise, use the --monitor option, followed by the
  205. # monitor type.  Xconfigurator --help lists all valid monitor types.
  206. #
  207. # Alternatively, you can enter the monitor's horizontal and vertical synch
  208. # rates using the --hsync and --vsync options.  Each is followed by the
  209. # appropriate synch rate.  The rates may be single numbers (representing
  210. # kilohertz and megahertz, as appropriate), groups of numbers separated by
  211. # commas, or two numbers separated by a dash (signifying a range).  For
  212. # example: --hsync "31.5,35.5,50-65" --vsync "50-70"
  213. #
  214. # Example:
  215. #xconfig --server "Mach64" --monitor "tatung cm14uhe"
  216. # 
  217. # R O O T   P A S S W O R D
  218. #
  219. # This is where the root password for the freshly-installed system is
  220. # specified.  Note that, for NFS kickstarts, this password goes over the
  221. # network in the clear.  In that case, you can enter a pre-crypted password
  222. # (ie, one suitable for inclusion in /etc/passwd without further editing)
  223. # by using the --iscrypted option, followed by the crypted password.
  224. #
  225. #Example:
  226. #rootpw RHkickedme
  227. #
  228. # L I L O   C O N F I G U R A T I O N (Required for upgrade)
  229. #
  230. # In this section you specify how LILO is to be configured.  By default,
  231. # LILO will be installed in the master boot record, and will have no append
  232. # line for kernel boot-time options.  You can modify this by using the
  233. # --location option to specify where LILO should be installed, and by using
  234. # the --append option to add an append line to /etc/lilo.conf.
  235. #
  236. # The --location option takes the following parameters:
  237. #
  238. # mbr -- Install LILO in the master boot record.
  239. # 
  240. # partition -- Install LILO in the first sector of the root partition.
  241. # 
  242. # none -- Do not install LILO (meaning you'd better have another way of
  243. # booting this system!
  244. #
  245. # (Note: There is no equivalent to this command on the Alpha.)
  246. # Example:
  247. #lilo --append "mem=128M" --location mbr
  248. #
  249. # P A C K A G E   S P E C I F I C A T I O N
  250. #
  251. # In this section you can select the components and packages that are to be
  252. # installed.  This section must be started with a line containing
  253. # "%packages".  Component and/or package names then follow.  Components are
  254. # preceded by "@ " (NOTE THE SPACE!), and packages appear as-is.
  255. #
  256. # To get a list of components and packages, refer to the file
  257. # RedHat/base/comps on the CD.  The components in the file are preceded by
  258. # a number and a space, while the packages have no preceding characters.
  259. # 
  260. # Example:
  261. #%packages
  262. #@ Networked Workstation
  263. #@ C Development
  264. #@ Web Server
  265. #@ X Window System
  266. #bsd-games
  267. #
  268. # P O S T - I N S T A L L A T I O N   C O M M A N D S
  269. #
  270. # This section must be the last in the kickstart file.  It can contain
  271. # commands to be executed when the installation has completed.  This
  272. # section must be started with a line containing "%post".  Any lines after
  273. # this one will be executed as commands.
  274. #
  275. # Example:
  276. #%post
  277. #echo "Kickstart-installed Red Hat Linux `/bin/date`" > /etc/motd
  278.