WebSVN – livecd – Diff – /trunk/README


--------------------------------------------------------------------
Build Live CD/DVD for Scientific Linux 4/5
--------------------------------------------------------------------
 
--------------------------------------------------------------------
The build script can be found at
ftp://ftp.psi.ch/psi/livecd/build
--------------------------------------------------------------------
                      !!!!!!  WARNING !!!!!! 
              Do not run the build script on your PC ! 
Only run it on a special build system or in the chroot environment ! 
             The build scripts will change the system 
              and will/can make your system unusable.
--------------------------------------------------------------------
More documentation about building the LiveCD can be found at
http://linux.web.psi.ch/livecd/build.html
--------------------------------------------------------------------
 
 
Please run ./build-livecd.sh to build the LiveCD ISO images
--------------------------------------------------------------------
 
Scripts:
--------------------------------------------------------------------
- build-livecd.sh:          Main build script run it on the SL4/SL5 system
- customize-livecd.sh:      Prepares the system for a LiveCD
- linux-live.sl/runme.sh:   Based on build scripts 
                            of http://www.linux-live.org
- restore-system.sh:        Restores the system to a bootable installation
- mini-livecd.sh:           Prepares the system to create Mini Livecd
                            (save diskspace, etc.)
                            Will use icewm as Windows manager
 
Config:
--------------------------------------------------------------------
- livecd.conf:              Configuration file for the build scripts
 
 
Examples:
--------------------------------------------------------------------
to build SL LiveCD
# ./build-livecd.sh -sl
to build SL Mini LiveCD 
# ./build-livecd.sh -mini -sl
 
 
Requirements:
--------------------------------------------------------------------
- SL4/SL5 installation on build system or in chroot environment
 
- unionfs and squashfs kernel modules
  SRPMS and RPMS can be found here:
  ftp://ftp.psi.ch/psi/livecd/SRPMS
  ftp://ftp.psi.ch/psi/livecd/RPMS
 
- static linked unionctl
  SRPMS and RPMS can be found here:
  ftp://ftp.psi.ch/psi/livecd/SRPMS
  ftp://ftp.psi.ch/psi/livecd/RPMS
 
 
Links:
--------------------------------------------------------------------
- ftp://ftp.psi.ch/psi/livecd
- http://linux.web.psi.ch/livecd
- http://linux.web.psi.ch/livecd/build.html
 
 
Changelog:
--------------------------------------------------------------------
- 2.5.x: first release which should also work on SL5
- 2.0.x: no special livecd kernel is need any more, 
         just unionfs and squashfs kernel modules are needed
         update to squashfs 3.1-r2
	 SMP kernel will also be included, if found
- 1.3.x: update to SL44 and kernel 42.0.3.EL
- 1.2.x: switch to unionfs version 1.1.5 
         (patched for RHEL4 kernel >= 2.6.9-42.EL)
- 1.1.x: kernel updated to 2.6.9-42.0.2.EL
- 1.0.x: add config file "livecd.conf"
- 0.9.x: kernel updated to 2.6.9-34.EL
- 0.8.x: improved diskless client
- 0.7.x: update to SL42
- 0.6.x: kernel updated to 2.6.9-22.0.1.EL
- 0.5.x: use a patched version of unionfs 1.0.14
- 0.4.x: nvidia driver
- 0.3.x: add x86_64 support
 
see also 
http://linux.web.psi.ch/livecd/changelog.html
 
--------------------------------------------------------------------
 Urs Beyerle, PSI

Subversion Repositories livecd

(root)/trunk/README @ 14 – Rev 1 → 14

Rev 1		Rev 14
1	`--------------------------------------------------------------------`	1	`--------------------------------------------------------------------`
2	`Build Live CD/DVD for Scientific Linux 4`	2	`Build Live CD/DVD for Scientific Linux 4/5`
3	`--------------------------------------------------------------------`	3	`--------------------------------------------------------------------`
4		4
5	`--------------------------------------------------------------------`	5	`--------------------------------------------------------------------`
6	`The build script can be found at`	6	`The build script can be found at`
7	`ftp://ftp.psi.ch/psi/livecd/build`	7	`ftp://ftp.psi.ch/psi/livecd/build`
8	`--------------------------------------------------------------------`	8	`--------------------------------------------------------------------`
9	`!!!!!! WARNING !!!!!!`	9	`!!!!!! WARNING !!!!!!`
10	`Do not run the build script on your PC !`	10	`Do not run the build script on your PC !`
11	`Only run it on a special build system or in the chroot environment !`	11	`Only run it on a special build system or in the chroot environment !`
12	`The build scripts will change the system`	12	`The build scripts will change the system`
13	`and will/can make your system unusable.`	13	`and will/can make your system unusable.`
14	`--------------------------------------------------------------------`	14	`--------------------------------------------------------------------`
15	`More documentation about building the LiveCD can be found at`	15	`More documentation about building the LiveCD can be found at`
16	`http://linux.web.psi.ch/livecd/build.html`	16	`http://linux.web.psi.ch/livecd/build.html`
17	`--------------------------------------------------------------------`	17	`--------------------------------------------------------------------`
18		18
19		19
20	`Please run ./build-livecd.sh to build the LiveCD ISO images`	20	`Please run ./build-livecd.sh to build the LiveCD ISO images`
21	`--------------------------------------------------------------------`	21	`--------------------------------------------------------------------`
22		22
23	`Scripts:`	23	`Scripts:`
24	`--------------------------------------------------------------------`	24	`--------------------------------------------------------------------`
25	`- build-livecd.sh: Main build script run it on the SL4/SL5 system`	25	`- build-livecd.sh: Main build script run it on the SL4/SL5 system`
26	`- customize-livecd.sh: Prepares the system for a LiveCD`	26	`- customize-livecd.sh: Prepares the system for a LiveCD`
27	`- linux-live.sl/runme.sh: Based on build scripts`	27	`- linux-live.sl/runme.sh: Based on build scripts`
28	`of http://www.linux-live.org`	28	`of http://www.linux-live.org`
29	`- restore-system.sh: Restores the system to a bootable installation`	29	`- restore-system.sh: Restores the system to a bootable installation`
30	`- mini-livecd.sh: Prepares the system to create Mini Livecd`	30	`- mini-livecd.sh: Prepares the system to create Mini Livecd`
31	`(save diskspace, etc.)`	31	`(save diskspace, etc.)`
32	`Will use icewm as Windows manager`	32	`Will use icewm as Windows manager`
33		33
34	`Config:`	34	`Config:`
35	`--------------------------------------------------------------------`	35	`--------------------------------------------------------------------`
36	`- livecd.conf: Configuration file for the build scripts`	36	`- livecd.conf: Configuration file for the build scripts`
37		37
38		38
39	`Examples:`	39	`Examples:`
40	`--------------------------------------------------------------------`	40	`--------------------------------------------------------------------`
41	`to build SL LiveCD`	41	`to build SL LiveCD`
42	`# ./build-livecd.sh -sl`	42	`# ./build-livecd.sh -sl`
43	`to build SL Mini LiveCD`	43	`to build SL Mini LiveCD`
44	`# ./build-livecd.sh -mini -sl`	44	`# ./build-livecd.sh -mini -sl`
45		45
46		46
47	`Requirements:`	47	`Requirements:`
48	`--------------------------------------------------------------------`	48	`--------------------------------------------------------------------`
49	`- SL4/SL5 installation on build system or in chroot environment`	49	`- SL4/SL5 installation on build system or in chroot environment`
50		50
51	`- unionfs and squashfs kernel modules`	51	`- unionfs and squashfs kernel modules`
52	`SRPMS and RPMS can be found here:`	52	`SRPMS and RPMS can be found here:`
53	`ftp://ftp.psi.ch/psi/livecd/SRPMS`	53	`ftp://ftp.psi.ch/psi/livecd/SRPMS`
54	`ftp://ftp.psi.ch/psi/livecd/RPMS`	54	`ftp://ftp.psi.ch/psi/livecd/RPMS`
55		55
56	`- static linked unionctl`	56	`- static linked unionctl`
57	`SRPMS and RPMS can be found here:`	57	`SRPMS and RPMS can be found here:`
58	`ftp://ftp.psi.ch/psi/livecd/SRPMS`	58	`ftp://ftp.psi.ch/psi/livecd/SRPMS`
59	`ftp://ftp.psi.ch/psi/livecd/RPMS`	59	`ftp://ftp.psi.ch/psi/livecd/RPMS`
60		60
61		61
62	`Links:`	62	`Links:`
63	`--------------------------------------------------------------------`	63	`--------------------------------------------------------------------`
64	`- ftp://ftp.psi.ch/psi/livecd`	64	`- ftp://ftp.psi.ch/psi/livecd`
65	`- http://linux.web.psi.ch/livecd`	65	`- http://linux.web.psi.ch/livecd`
66	`- http://linux.web.psi.ch/livecd/build.html`	66	`- http://linux.web.psi.ch/livecd/build.html`
67		67
68		68
69	`Changelog:`	69	`Changelog:`
70	`--------------------------------------------------------------------`	70	`--------------------------------------------------------------------`
-		71	`- 2.5.x: first release which should also work on SL5`
71	`- 2.0.x: no special livecd kernel is need any more,`	72	`- 2.0.x: no special livecd kernel is need any more,`
72	`just unionfs and squashfs kernel modules are needed`	73	`just unionfs and squashfs kernel modules are needed`
73	`update to squashfs 3.1-r2`	74	`update to squashfs 3.1-r2`
74	`SMP kernel will also be included, if found`	75	`SMP kernel will also be included, if found`
75	`- 1.3.x: update to SL44 and kernel 42.0.3.EL`	76	`- 1.3.x: update to SL44 and kernel 42.0.3.EL`
76	`- 1.2.x: switch to unionfs version 1.1.5`	77	`- 1.2.x: switch to unionfs version 1.1.5`
77	`(patched for RHEL4 kernel >= 2.6.9-42.EL)`	78	`(patched for RHEL4 kernel >= 2.6.9-42.EL)`
78	`- 1.1.x: kernel updated to 2.6.9-42.0.2.EL`	79	`- 1.1.x: kernel updated to 2.6.9-42.0.2.EL`
79	`- 1.0.x: add config file "livecd.conf"`	80	`- 1.0.x: add config file "livecd.conf"`
80	`- 0.9.x: kernel updated to 2.6.9-34.EL`	81	`- 0.9.x: kernel updated to 2.6.9-34.EL`
81	`- 0.8.x: improved diskless client`	82	`- 0.8.x: improved diskless client`
82	`- 0.7.x: update to SL42`	83	`- 0.7.x: update to SL42`
83	`- 0.6.x: kernel updated to 2.6.9-22.0.1.EL`	84	`- 0.6.x: kernel updated to 2.6.9-22.0.1.EL`
84	`- 0.5.x: use a patched version of unionfs 1.0.14`	85	`- 0.5.x: use a patched version of unionfs 1.0.14`
85	`- 0.4.x: nvidia driver`	86	`- 0.4.x: nvidia driver`
86	`- 0.3.x: add x86_64 support`	87	`- 0.3.x: add x86_64 support`
87		88
88	`see also`	89	`see also`
89	`http://linux.web.psi.ch/livecd/changelog.html`	90	`http://linux.web.psi.ch/livecd/changelog.html`
90		91
91	`--------------------------------------------------------------------`	92	`--------------------------------------------------------------------`
92	`Urs Beyerle, PSI`	93	`Urs Beyerle, PSI`