Keep standard 30MHzDF and adds the lite configuration
[debian6500.git] / simple-cdd / readme
CommitLineData
9c7f26be
OL
1** Introduction
2
3This uses the simple-cdd package (available on the official Debian repository) to create a custom install CD for the master blade of the TRC6500 system's computing cluster. A number of components are installed automatically (either during install or on first boot) ; the CD also includes useful files for subsequent configuration.
4
e043b5aa 5
9c7f26be
OL
6** What the built CD includes
7
8- a selection of useful/required packages
9- a selection of custom packages scarcely available elsewhere
10- unpacking of config files and scripts during install
11- automatic execution of some configuration options
12
b3f3562f 13This CD does NOT create an usable operating system. All included systems should be reviewed, but particularly the network configuration (/etc/hosts, DHCP config, TFTP config..), which is partly automated thanks to scripts provided by the TRC6500 exploitation software, which is NOT bundled with this CD.
9c7f26be 14
e043b5aa 15
9c7f26be
OL
16** What files we'll be using
17
18- simple-cdd.conf (name is clear enough) should be passed to the build-simple-cdd program
19- the entire profiles/ directory is used by build-simple-cdd
20- myrc.local is the script executed on first boot
21- the local_packages/ directory contains packages not available on the regular repository, or more recent versions of packages available there.
e043b5aa
OL
22- the additional_scripts/ directory contains useful scripts included in the trc6500-master-files deb archive, in the /opt/trc6500/script/ folder.
23- the deb_build/ folder contains the necessary stuff to build the trc6500-master-files deb package which contains a collection of scripts, config files and config instructions
9c7f26be
OL
24- TRC6500.pub is a GPG public key added to the OS's keyring during install, corresponding to a makeshift Debian repo from T. PĂ©rennou
25- splash-thales.png is a 640*480 image used for the splashscreen
26
9c7f26be
OL
27
28** How build-simple-cdd works
29
30The build-simple-cdd program is to be called like this :
31build-simple-cdd --dist wheezy --conf ./simple-cdd.conf
32
33Most options described in the documentation are included in the simple-cdd.conf file. The program will use those (in addition to the default settings) to build a list of what is to be included on the CD. Primarily, it includes itself, profile(s) scripts, and pulls packages (from the <profile>.packages list) from whatever repositories are in /etc/apt/sources.list, or from the ./tmp folder if the packages have already been fetched.
34
b3f3562f 35Additional packages are to be put in the local_packages directory (which is specified in our own simple_cdd.conf). It should be noted that packages placed there simply join the pool of available packages : to actually include them on the CD, they should be added in an itself included profile's packages list (say, profiles/trc6500.packages). The list of packages added this way is :
9c7f26be
OL
36cpumon dce firmware-bnx2 libcalloc1 libcycle1 libdebug1 libmcore1 raf swb webconfig xcfe
37
38Additional files are included with the all_extras="<path>,<path>" option in our simple-cdd.conf file.
39
40You should look into the provided simple-cdd.conf file ! It is tailored to a quite specific use case, and making your own should be easy enough since the simple-cdd package contains a detailed config file.
41
e043b5aa
OL
42
43** Building the trc6500-master-files deb packages
44
45This package has been put together in replacement of an earlier tarball ; the main benefit to using a deb being easier upgrade of existing systems.
46
47Check out the deb_build/ folder to learn more ; most of it is done by the Makefile.
48
49
9c7f26be
OL
50** Regarding install vectors
51
52To set up a bootable USB key :
53cp <iso file> /dev/<key> && sync
54<key> should be the device, not a partition of it. The key will get partitioned like the CD (and how the CD is partitioned is a whole other topic).
55
56To burn your ISO to a CD :
57xorriso -as cdrecord -v dev=/dev/sr0 blank=as_needed <iso file>
58
59
60** Additional documentation
61/usr/share/simple-cdd
62/usr/share/doc/simple-cdd
63/usr/share/doc/installation-guide-amd64 (talks about preseeds)
64