Update README.md
parent
a37a042816
commit
8537d93a1e
105
README.md
105
README.md
|
|
@ -1,72 +1,75 @@
|
||||||
## Linux Live Kit Improved.
|
## Linux Live Kit Improved.
|
||||||
This set of scripts will help you to
|
This set of scripts will help you to
|
||||||
build your own Live Kit distro. This project is based on
|
build your own Live Kit distro. This project is based on
|
||||||
the original Linux Live Kit. <http://linux-live.org>
|
the original Linux Live Kit. <http://linux-live.org>
|
||||||
|
|
||||||
## Some information you want to know:
|
|
||||||
+ 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.
|
|
||||||
The best practice is to make a directory such
|
|
||||||
as for example: '/tmp/a', and put all the files there.
|
|
||||||
|
|
||||||
NOTE:
|
## You will need to have the following packages installed:
|
||||||
Make sure to extract and use it on a POSIX-compatible
|
* squashfs-tools
|
||||||
filesystem, since it will create symlinks and such that might
|
* genisoimage and/or mkisofs
|
||||||
not be compatible in for example: FAT and such other filesystems.
|
* zip
|
||||||
|
|
||||||
+ Before you start building your Kit, please consider
|
## Before you build:
|
||||||
|
|
||||||
|
- 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.
|
||||||
|
The best practice is to make a directory such
|
||||||
|
as for example: '/tmp/a', and put all the files there.
|
||||||
|
### NOTE:
|
||||||
|
Make sure to extract and use it on a POSIX-compatible
|
||||||
|
filesystem (for ex: EXT4), since it will create symlinks
|
||||||
|
and such that might not be compatible in for example: FAT
|
||||||
|
and such other filesystems.
|
||||||
|
|
||||||
|
- Before you start building your Live Kit, please consider
|
||||||
editing the ./.config file, and tweak it to suit your needs.
|
editing the ./.config file, and tweak it to suit your needs.
|
||||||
Most importantly, change the LIVEKITNAME variable.
|
Most importantly, change the LIVEKITNAME variable.
|
||||||
|
|
||||||
+ Make sure you are pointing to the right kernel . If in doubt, change the path in ./.config
|
- Make sure you are pointing to the right kernel. If in doubt,
|
||||||
Your kernel must support squashfs and aufs, or else you will get an error
|
change the path in ./.config. Your kernel must support both
|
||||||
both while building, and when you actually boot the Live Kit.
|
SquashFS and AUFS, or else you will get an error both while
|
||||||
|
building, and when you actually boot your Live Kit.
|
||||||
PROTIP:
|
### PROTIP:
|
||||||
On most Linux distro-s, the kernel is in /vmlinuz, a
|
* On most Linux distro-s, the kernel is in /vmlinuz, a
|
||||||
symlink to /boot/vmlinuz-* or /boot/vmlinux-*
|
symlink to /boot/vmlinuz-* or even /boot/vmlinux-*
|
||||||
|
|
||||||
PROTIP #2:
|
|
||||||
Debian Jessie's kernel has both supported out-of-the-box.
|
|
||||||
You might consider using Debian Jessie as a base, but it's not required.
|
|
||||||
|
|
||||||
+ You may also consider to replace boot background in
|
* Debian Jessie's kernel supports both AUFS and SquashFS out-of-the-box.
|
||||||
bootfiles/bootpic.png and edit syslinux.cfg to suit your needs.
|
I'll recommned using Debian Jessie as the base OS, but the choice is yours.
|
||||||
|
|
||||||
NOTE:
|
|
||||||
When editing the configuration 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
|
- It's recommended to replace boot background in
|
||||||
|
bootfiles/bootpic.png and edit syslinux.cfg to fit your needs.
|
||||||
|
### NOTE:
|
||||||
|
When editing the configuration 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
|
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.
|
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
|
- If you want to boot your Live Kit from a CD, you'll need to recompile
|
||||||
syslinux.bin/isolinux.bin else it won't be able to boot your Live Kit
|
syslinux.bin and/or isolinux.bin else it won't be able to boot
|
||||||
from directory "/LIVEKITNAME". There is a script prepared for you which
|
your Live Kit from directory "/LIVEKITNAME".
|
||||||
will handle all of the building. Simply go to directory ./tools/ and run
|
|
||||||
isolinux.bin-update, it will rebuild ./bootfiles/isolinux.bin automatically
|
There is a script prepared for you which will do all of the building.
|
||||||
by downloading SysLinux sources, patching them using your actual LIVEKITNAME and
|
Simply go to directory ./tools/ and run isolinux.bin-update, it will rebuild
|
||||||
recompiling. This step is not needed if you only need the ZIP archive version.
|
isolinux.bin automatically by downloading SysLinux sources, patching them using
|
||||||
|
your actual LIVEKITNAME and recompiling. This step is not needed if you only need
|
||||||
|
the ZIP archive version.
|
||||||
|
|
||||||
+ If you have tmpfs mounted on /tmp, make sure you have enough (or maybe even
|
- 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.
|
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
|
If you don't have enough (or even went out of) RAM, make sure
|
||||||
that /tmp is a regular on-disk directory.
|
that /tmp is a regular on-disk directory.
|
||||||
|
|
||||||
+ If you want to include your own bundules, the 'include_bund/' directory
|
- If you want to include your own bundules, then the 'include\_bund/' directory
|
||||||
might come in handy! Just make sure that the file extension matches
|
might come in handy! Just make sure that the file extension matches
|
||||||
with your chosen .BEXT extension.
|
with your chosen .BEXT extension.
|
||||||
|
|
||||||
You will need to have the following packages installed:
|
|
||||||
- squashfs-tools
|
|
||||||
- genisoimage and/or mkisofs
|
|
||||||
- zip
|
|
||||||
|
|
||||||
When you're ready, run the ./build script to build your Live Kit Distro.
|
When you're ready, run the ./build script to build your Live Kit Distro.
|
||||||
The script will:
|
The script will:
|
||||||
- Build both ISO and ZIP files for you in /tmp
|
+ Build both ISO and ZIP files for you in /tmp
|
||||||
- Do all the hard work for you.
|
+ Do all the hard work for you.
|
||||||
- Will automatically check for errors.
|
+ Will automatically check for errors.
|
||||||
- Will warn you if you don't have the correct packages.
|
+ Will warn you if you don't have the correct packages.
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue