Read this before you do anything...

pull/23/head
johndah4x0r 2017-07-25 14:06:38 +02:00 committed by GitHub
parent 7fdcf1bcd2
commit 1451c4ea42
2 changed files with 52 additions and 49 deletions

49
README
View File

@ -1,49 +0,0 @@
Linux Live Kit
==============
Use this set of scripts to turn your existing preinstalled Linux
distribution into a Live Kit (formely known as Live CD).
Make sure to extract and use it on a posix-compatible filesystem,
since it creates some (sym)links and such.
* Store Linux Live kit in a directory which is not going to be included
in your live distro, else it would be copied to it. Best practice is to
make a directory such as /a and put these scripts there.
* Before you start building your Kit, edit the file ./.config
Most importantly change the LIVEKITNAME variable.
* Make sure your kernel is in /boot/vmlinuz or change the path in ./.config
Your kernel must support squashfs and aufs. Debian Jessie's kernel does.
* You may also wish to replace boot graphics in ./bootfiles/bootlogo.png
and reorganize isolinux.cfg to fit your needs (when editing the file,
keep all paths in /boot/, it will be rellocated during LiveKit creation)
* Linux Live Kit comes with precompiled static binaries in ./initramfs
directory. Those may be outdated but will work. You may replace them
by your own statically linked binaries, if you know how to compile them.
* If you plan to boot your Live Kit from CD, you need to recompile
syslinux.bin else it won't be able to boot your Live Kit from directory
LIVEKITNAME. There is a script prepared for you which will handle all
of that. Simply go to directory ./tools/ and run isolinux.bin.update ...
it will update ./bootfiles/isolinux.bin automatically by downloading
isolinux sources, patching them using your actual LIVEKITNAME and
recompiling. This step is not needed if you plan to boot from USB only.
* If you have tmpfs mounted on /tmp, make sure you have enough RAM
since LiveKit will store lots of data there. If you are low on RAM,
make sure /tmp is a regular on-disk directory.
* When done, run the ./build script to create your Live Kit
- it will create ISO and TAR files for you in /tmp
- make sure you have enough free space in /tmp to handle it
* You will need the following packages to be installed:
- squashfs-tools
- genisoimage or mkisofs
- zip
Author: Tomas M. <http://www.linux-live.org>

52
README.MD 100644
View File

@ -0,0 +1,52 @@
# Linux Live Kit Improved.
## This set of scripts will help you to
## build your own Live Kit distro. This project is based on
## the original Linux Live Kit. <http://linux-live.org>
### Here's what you need to do:
### NOTE: Make sure to extract and use it on a POSIX-compatible filesystem,
since it creates some (sym)links and such.
### Here's you what you need to watch out before building:
+ Store Linux Live Kit in a directory which is not going to be included
in your live distro, else it would be copied to it. Best practice is to
make a directory such as /tmp/a and put all the files there.
+ Before you start building your Kit, edit the ./.config file
Most importantly change the LIVEKITNAME variable.
+ Make sure your kernel is in /boot/vmlinuz or change the path in ./.config
Your kernel must support squashfs and aufs.
Debian Jessie's kernel has both supported out-of-the-box.
+ You may also wish to replace boot background in ./bootfiles/bootlogo.png,
and reorganize syslinux.cfg to fit your needs.
### NOTE:
When editing the .cfg file, make sure to keep all paths pointing to /boot/, since
it will be replaced to /LIVEKITNAME/boot/ during the build session.
+ Linux Live Kit comes with precompiled static binaries in ./initramfs
directory. Those may be outdated but will work. You may replace them
by your own statically linked binaries, if you know how to compile them.
+ If you want to boot your Live Kit from a CD, you need to recompile
syslinux.bin/isolinux.bin else it won't be able to boot your Live Kit
from directory "/LIVEKITNAME". There is a script prepared for you which
will handle all of the building. Simply go to directory ./tools/ and run
update-isolinux.bin, it will rebuild ./bootfiles/isolinux.bin automatically
by downloading SysLinux sources, patching them using your actual LIVEKITNAME and
recompiling. This step is not needed if you plan only need the ZIP archive version.
+ If you have tmpfs mounted on /tmp, make sure you have enough (or maybe even
a lot of) RAM, since Live Kit will store lots of data to the target.
If you don't have enough (or even went out of) RAM, make sure
/tmp is a regular on-disk directory.
+ When done, run the ./build script to create your Live Kit
- it will create ISO and ZIP files for you in /tmp
- make sure you have enough free space in /tmp to handle it
+ You will need the following packages to be installed:
- squashfs-tools
- genisoimage or mkisofs
- zip