WebSVN – livecd – Diff – /trunk/README


--------------------------------------------------------------------
Build Live CD/DVD for Scientific Linux 4/5
--------------------------------------------------------------------
 
--------------------------------------------------------------------
Build script can be found at
- ftp://ftp.psi.ch/psi/livecd/build  (tarballs)
- https://svn.psi.ch/linux/livecd    (subversion repository)
--------------------------------------------------------------------
                      !!!!!!  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 disk space, etc.) Will use icewm 
                            as Windows manager (only working on SL4)
 
Config:
--------------------------------------------------------------------
- livecd.conf:              Configuration file for the build scripts
 
 
Examples:
--------------------------------------------------------------------
to build SL4 LiveCD
# ./build-livecd.sh -sl4
to build SL5 LiveDVD
# ./build-livecd.sh -sl5 -dvd
to build SL4 Mini LiveCD 
# ./build-livecd.sh -mini -sl4
 
 
Requirements:
--------------------------------------------------------------------
- SL4/SL5 installation on build system or in chroot environment
 
- installed unionfs or aufs kernel module and tools
- static linked unionctl
- installed squashfs kernel module and tools
  (squashfs is included in the SL5 kernel)
 
  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.6.x: aufs used for SL5 LiveCD
- 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 @ 87 – Rev 48 → 69

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