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 !!!
 
--------------------------------------------------------------------
 
 
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(s)
- static linked unionctl (/usr/sbin/unionctl.static)
  unionctl is no longer needed if you use unionfs 2.x
- installed squashfs kernel module and tools (mksquashfs)
  (squashfs is included in the SL5 kernel)
 
  SRPMS and RPMS for unionfs, aufs and squashfs 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.7.0: works with unionfs 2.x
         new busybox fixes loop device problem 
         improved diskless client
- 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 @ 117 – Rev 100 → 102

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