Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision Last revision Both sides next revision | ||
|
en:handbook:genlivecd [2010/05/24 20:12] linea quick edit (nice job) |
en:handbook:genlivecd [2015/11/25 15:28] brianperry |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ====== Generating a Customised LiveCD ====== | + | ====== Generating a Customised LiveCD or LiveUSB====== |
| + | //Tazlito// can create your own, personalised version of SliTaz in very little time. It allows you to choose precisely the software packages that you want and make a flavor file (.flavor) with it. You can choose to make your own file starting from a general slitaz flavor (such as base, justx or core), or make it based on an already customised flavor supplied by the SliTaz community. | ||
| - | //Tazlito// can create your own, personalised SliTaz LiveCD in very little time. You can choose precisely the software packages that you want and the support of flavors permits you to generate a customized LiveCD amended by a list of packages or flavors created by the SliTaz community. Tazlito is a command line tool that is not too demanding, you can have your own ISO image in two commands or burned in one. | + | Once you've downloaded (and possibly -further- customized) the flavor you chose, you can make an iso-file with it using tazlito, and then burn it to a cd.\\ |
| - | + | ||
| - | \\ | + | |
| === Overview === | === Overview === | ||
| + | Tazlito automates the process of building a customized ISO, and the method is quite straight-forward: | ||
| - | Tazlito automates the process of building a LiveCD, although the method is quite straight-forward: | + | - find a template (flavor) to work on ($ tazlito list-flavors) |
| - | + | - download the template ($ tazlito get-flavor flavor_name) | |
| - | - download a template (flavor) to work on | + | - look at the flavor's packages ($ tazlito show-flavor flavor_name) |
| - | - customise its packages | + | - extract the flavor ($ tazlito extract-flavor flavor_name) |
| - | * //optional: include additional files, added after the packages// | + | - put in a rootfs folder (make one by copying in files from /etc/ to /home/slitaz/distro ) |
| - | - compress the generated pseudo-file-system | + | - add additional files using the folder /home/slitaz/distro/addfiles (optional) |
| - | - create an ISO image | + | - change options ($ tazlito configure) |
| - | + | - create the ISO image ($ tazlito gen-distro) | |
| - | \\ | + | - burn to CD or USB stick ($ tazusb gen-iso2usb) \\ |
| === Notes === | === Notes === | ||
| - | * Creating a LiveCD requires a minimum of 256MB of RAM. | + | * Note that you can't delete packages, but you can use a stripped-down flavor to build your customized slitaz version. |
| - | * Compressing the file-system with LZMA may take some time. GZip can also be used, though its compression ratio is not as effective. | + | * Note that you can modify the distro further by hacking the ISO once created, after which you can make it into a flavor again (see details below) |
| + | * Note that you can add some last changes (that require modification from inside slitaz; like changing appearance, modifying the taskbar, ...) by simply making an additional rootfs file with a usb stick made with the iso of the slitaz version you just made (using the # tazusb writefs lzma command), and then adding it to the extracted iso (using the [[en:handbook:hacklivecd|hacker account]]). You can probably also reinclude these changes finally into your flavor file by means of the # tazlito iso2flavor <your-ISO_image> <your-flavor> command. | ||
| + | * Creating a LiveCD requires a minimum of 256MB of RAM. | ||
| + | * Compressing the file-system with LZMA may take some time. GZip can also be used, though its compression ratio is not as effective. | ||
| * It's possible to create a distribution from the LiveCD or from an installed system. In LiveCD mode, it's advisable to use persistent media or an USB drive to store generated files and save space in RAM. | * It's possible to create a distribution from the LiveCD or from an installed system. In LiveCD mode, it's advisable to use persistent media or an USB drive to store generated files and save space in RAM. | ||
| + | * Tazlito is used by developers to generate the official LiveCD. Unlike the (now deprecated tazwok), it is installed by default on SliTaz. Note that you can also use it an a different distribution (non-slitaz) if that linux distro has the necessary packages (they can be downloaded if not). See [[#installing-tazlito-on-another-distribution|the instructions]] at the bottom of the page for more details.\\ | ||
| - | * Tazlito is used by developers to generate the official LiveCD. The only prerequisite is to have Tazlito installed. This is installed by default on SliTaz, but you can generate from another LiveCD distribution if they have the necessary packages (they can be downloaded if not). See the [[#installing-tazlito-on-another-distribution|instructions]] at the bottom of the page for more details. | + | ===== A customized ISO in three commands ===== |
| + | A good way of becoming familiar with Tazlito is to re-build the LiveCD. To do this, download the default //core// flavor (a //.flavor// file that contains all the necessary information to create a LiveCD) and build it with the default options. This takes only two commands and will help to demonstrate the process: | ||
| \\ | \\ | ||
| - | + | * Get the default (//core//) flavor (# tazlito get-flavor core) | |
| - | ===== A LiveCD in Two Commands ===== | + | * Extract the flavor (# tazlito extract-flavor core) |
| - | + | * Optional: Amend the list of packages or add additional files. | |
| - | A good way of becoming familiar with Tazlito is to re-build the LiveCD. To do this, download the default //core// flavor (a //.flavor// file that contains all the necessary information to create a LiveCD) and build it with the default options. This takes only two commands and will demonstrate the process: | + | * Create the LiveCD (# tazlito gen-distro) |
| \\ | \\ | ||
| - | * Get the default (//core//) flavor: | + | That's it! You will find the LiveCD ISO image in ///home/slitaz/<version>/distro//. |
| - | + | ||
| - | tazlito get-flavor core | + | |
| - | + | ||
| - | * //Optional: Amend the list of packages or add additional files.// | + | |
| - | + | ||
| - | * Create the LiveCD: | + | |
| - | + | ||
| - | tazlito gen-distro | + | |
| \\ | \\ | ||
| - | That's it! You will find the LiveCD ISO image in ///home/slitaz/distro//. | + | ===== The steps laid out in detail... ===== |
| \\ | \\ | ||
| - | ===== Part I: Downloading a Flavor ===== | + | ====== Part I: Downloading a Flavor ====== |
| - | + | Flavors can be used to build various styles of LiveCDs by containing the list of packages (//distro-packages.list//) and sometimes additional files. This saves you the effort of saving the configuration files and provides a quick way of switching between them. A list of flavors available on the SliTaz servers can be downloaded and updated with Tazlito: | |
| - | Flavors can be used to build various styles of LiveCDs by containing the list of packages (//distro-packages.list//) and sometimes additional files. This saves you the effort of saving the configuration files and provides a quick way of switching between them. of A list of flavors available on the SliTaz servers can be downloaded and updated with Tazlito: | + | |
| # tazlito list-flavors | # tazlito list-flavors | ||
| Line 58: | Line 52: | ||
| \\ | \\ | ||
| - | The list of flavors will automatically be displayed, showing the size of the LiveCD and a brief description. To use a flavor, use the get-flavor command to download the flavor file, automatically extract the package list and description in the current directory, and put additional files in the ///home/slitaz/distro/addfiles// directory: | + | The list of flavors will be automatically displayed, showing the size of the LiveCD and a brief description. To use a flavor, use the get-flavor command to download the flavor file, automatically extract the package list and description in the current directory, and put additional files in the ///home/slitaz/distro/addfiles// directory: |
| - | # tazlito get-flavor name | + | # tazlito get-flavor flavor_name |
| \\ | \\ | ||
| - | The description of the flavor can be displayed with the show-flavor command. Once the chosen flavor is downloaded, you can start to customise your distribution! | + | The description of the flavor can be displayed with the //show-flavor// command. Once your chosen flavor is downloaded, you can start to customise your distribution! |
| <note tip>To store flavors, we suggest that you use a specific directory such as ///home/slitaz/flavors//. You can create this yourself and proceed inside: | <note tip>To store flavors, we suggest that you use a specific directory such as ///home/slitaz/flavors//. You can create this yourself and proceed inside: | ||
| Line 75: | Line 69: | ||
| \\ | \\ | ||
| - | ===== Part II: Generating the Distribution ===== | + | ====== Part II: Generating the Distribution ====== |
| - | <note important>When generating a distro, there are essential base system packages. The dependency information in each package will take effect so the essential packages will be automatically included, even if they are not specified in the package list.</note> | + | <note important>When generating a distro, there are some essential //base-system// packages that must be included. The dependency information in each package will take effect so these will be automatically included, even if they are not specified in the package list.</note> |
| For your first ISO, we advise you re-build the default LiveCD without modifying the list. When you are comfortable with the process, you can start to delete or add packages as required. The gen-distro command generates an ISO image with all the packages on the list. All dependencies will be fulfilled automatically, just as with normal package installation. It must be run as root and be in the same directory as the list and the configuration file. | For your first ISO, we advise you re-build the default LiveCD without modifying the list. When you are comfortable with the process, you can start to delete or add packages as required. The gen-distro command generates an ISO image with all the packages on the list. All dependencies will be fulfilled automatically, just as with normal package installation. It must be run as root and be in the same directory as the list and the configuration file. | ||
| Line 91: | Line 85: | ||
| \\ | \\ | ||
| - | === Cleaning & Re-Generating === | + | ==== Cleaning & Re-Generating ==== |
| As you have generated a LiveCD, you need to clean-up so another can be generated. Removing the resulting ISO image, cleaning the generated distro tree (but not your additional files!) can be done through the //clean-distro// option: | As you have generated a LiveCD, you need to clean-up so another can be generated. Removing the resulting ISO image, cleaning the generated distro tree (but not your additional files!) can be done through the //clean-distro// option: | ||
| Line 107: | Line 100: | ||
| All the customisations applied so far should be effective on your new LiveCD ISO image. | All the customisations applied so far should be effective on your new LiveCD ISO image. | ||
| - | <note tip> Tazlito also offers several possibilities such as burning the ISO, copying additional files into the system or directly on to the CD-ROM. See the Tazlito [[http://slitaz.org/en/doc/manuals/tazlito.en.html|Manual]] for more information.</note> | + | <note tip> Tazlito also offers several possibilities such as burning the ISO, copying additional files into the system or directly on to the CD-ROM. See the Tazlito [[http://hg.slitaz.org/tazlito/raw-file/tip/doc/tazlito.en.html|Manual]] for more information.</note> |
| \\ | \\ | ||
| - | === The 'Hacker' User === | + | ==== Hacking your customized SliTaz ISO ==== |
| + | //See also [[en:handbook:hacklivecd]]// \\ | ||
| - | If you want to have a hacker user account, we must decompress the root file-system, add one and then re-create the compressed root file-system. The first two stages can be executed as one command, the last stage another: | + | If you want to modify the splash screen, boot loader, configuration files, GRUB itself, ... you need to "hack" the iso you made using your flavor file using a "hacker user account". Note that you can also update your flavor-file with these extra modifications you made at the boot loader, splash screen, ... by means of the "tazlito iso2flavor <your-ISO_image> <your_flavor>" command. |
| + | |||
| + | To make a hacker user account, we must decompress the root file-system, add the account, then re-compress the root file-system. The first two stages can be executed as one command, the last stage another: | ||
| # tazlito addhacker | # tazlito addhacker | ||
| Line 121: | Line 117: | ||
| \\ | \\ | ||
| + | |||
| + | ===== Adding the final changes ===== | ||
| + | //See also [[en:guides:persistence_splash]]// \\ | ||
| + | |||
| + | As mentioned above, you can add some last changes (that require modification from inside slitaz; like changing appearance, modifying the taskbar, ...) by simply making an additional rootfs file with a usb stick made with the iso of the slitaz version you just made (using the # tazusb writefs lzma command), and then adding it to the extracted iso (using the [[en:handbook:hacklivecd|hacker account]]). You can probably also reinclude these changes finally into your flavor file by means of the # tazlito extract-iso <your-ISO_image> <destination> command, combined with the tazlito pack-flavor <flavor_name> command. These 2 commands replace the old "tazlito iso2flavor" command (which can't be used any more). | ||
| + | |||
| + | It should be noted that using this technique, you can probably delete packages too (see [[http://doc.slitaz.org/en:guides:manyinone|the manual on making many-in-one flavors]]). However, you best avoid this method however since the files are then probably still in the flavor/iso and the flavor/iso is hence larger than what it needs to be. The files/applications will simply not be used. | ||
| ===== Including Additional Files ===== | ===== Including Additional Files ===== | ||
| Line 133: | Line 136: | ||
| ===== Packages Used ===== | ===== Packages Used ===== | ||
| - | To create your distro you need SliTaz packages. Tazlito and Tazpkg allow us to recreate packages from a SliTaz system in operation or to download packages directly depending on the flavor chosen. By default, SliTaz packages are located in the directory ///home/slitaz/packages//, but you can change this via the Tazlito configuration file (//tazlito.conf//). | + | To create your distro, you need SliTaz packages. You can easily create your own packages with Tazpkg, or recreate packages from a SliTaz system in operation with Tazlito. By default, SliTaz packages are located in the ///home/slitaz/packages// directory but you can change this in the Tazlito configuration file (see [[#configuration-file|the bottom of this page]] for more information). |
| - | If you want to retrieve packages manually, you can use FTP software such as gFTP (installed by default on SliTaz) or the command line and //wget//. The direct URL to package versions: ftp://download.tuxfamily.org/slitaz/packages/ | + | If you want to retrieve packages manually, you can use FTP software such as gFTP (installed by default on SliTaz) or the command line and //wget//. The direct URL to package versions is: ''ftp://download.tuxfamily.org/slitaz/packages/'' |
| - | You can also use your own packages by putting them in the packages directory. If you are looking for documentation about the creation of SliTaz packages, you can refer to the [[http://slitaz.org/en/doc/cookbook/index.html|Cookbook]]. | + | You can also use your own packages by putting them in the packages directory. For more information on creating your own SliTaz packages, see the [[en:cookbook:start|Cookbook]]. |
| \\ | \\ | ||