[2024-feb-29] Sad news: Eric Layton aka Nocturnal Slacker aka vtel57 passed away on Feb 26th, shortly after hospitalization. He was one of our Wiki's most prominent admins. He will be missed.
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
slackware:liveslak [2018/02/21 21:20 (UTC)] – [Other Slackware based Live distros] SlackEX development has stopped. alienbob | slackware:liveslak [2020/10/05 15:51 (UTC)] – Synced the content with the README of liveslak-1.3.7. alienbob | ||
---|---|---|---|
Line 32: | Line 32: | ||
The " | The " | ||
- | - a complete 64bit Slackware-current Live Edition (in a 3.1 GB ISO); | + | - a complete 64bit Slackware-current Live Edition (in a 4.0 GB ISO); |
- a slimmed-down XFCE ISO (700 MB) with XDM as the graphical login manager. | - a slimmed-down XFCE ISO (700 MB) with XDM as the graphical login manager. | ||
- | - a ISO image (4.6 GB) of Slackware64-current containing Plasma 5 instead of KDE 4, with an addition of several other packages from the alienBOB repositories: | + | - a ISO image (4.3 GB) of Slackware64-current containing Plasma 5 instead of KDE 4. |
- | - a Mate variant (2.2 GB) where KDE 4 has been replaced by Mate (a Gnome 2 fork); | + | - a Digital Audio Workstation (DAW) based on a custom Slackware package set plus Plasma5, containing a rich software collection for musicians, producers and live performance artists. |
+ | - a Mate variant (3.2 GB) where KDE 4 has been replaced by Mate (a Gnome 2 fork); | ||
- a Cinnamon flavour (a fork of the Gnome 3 Shell replacing Slackware' | - a Cinnamon flavour (a fork of the Gnome 3 Shell replacing Slackware' | ||
- a [[https:// | - a [[https:// | ||
Line 47: | Line 48: | ||
Common download locations are: | Common download locations are: | ||
* Primary site: http:// | * Primary site: http:// | ||
+ | * DAW site: https:// | ||
* Darren' | * Darren' | ||
* Willy' | * Willy' | ||
- | * Ryan's https:// | ||
* Shasta' | * Shasta' | ||
Line 111: | Line 112: | ||
-c|--crypt size|perc | -c|--crypt size|perc | ||
| | ||
- | or as a percentage of free space. | + | or as a percentage of free space |
- | | + | |
+ | | ||
-d|--devices | -d|--devices | ||
-f|--force | -f|--force | ||
Line 129: | Line 131: | ||
Use a LUKS-encrypted ' | Use a LUKS-encrypted ' | ||
of a directory (for use on FAT filesystem). | of a directory (for use on FAT filesystem). | ||
+ | | ||
+ | as for the ' | ||
-P|--persistfile | -P|--persistfile | ||
of a directory (for use on FAT filesystem). | of a directory (for use on FAT filesystem). | ||
Line 146: | Line 150: | ||
You might have noticed that the " | You might have noticed that the " | ||
+ | |||
+ | |||
+ | ==== Using the Live OS to install Slackware to hard disk ==== | ||
+ | |||
+ | All variants of Slackware Live Edition contain a script " | ||
+ | The " | ||
+ | |||
==== Updating the kernel (and more) on a USB stick ==== | ==== Updating the kernel (and more) on a USB stick ==== | ||
Line 185: | Line 196: | ||
# ./upslak.sh -d | # ./upslak.sh -d | ||
* Updating kernel and modules, providing two packages as input and assuming the USB stick is known as /dev/sdX: | * Updating kernel and modules, providing two packages as input and assuming the USB stick is known as /dev/sdX: | ||
- | # ./upslak.sh -o /dev/sdX -m kernel-modules-4.9.50-x86_64-1.txz -k kernel-generic-4.9.50-x86_64-1.txz | + | # ./upslak.sh -o /dev/sdX -m kernel-modules-4.19.0-x86_64-1.txz -k kernel-generic-4.19.0-x86_64-1.txz |
* Restore the previous kernel and modules after a failed update, and let the script scan your computer for the insertion of your USB stick: | * Restore the previous kernel and modules after a failed update, and let the script scan your computer for the insertion of your USB stick: | ||
# ./upslak.sh -s -r | # ./upslak.sh -s -r | ||
Line 338: | Line 349: | ||
=== Media tweaks === | === Media tweaks === | ||
+ | |||
+ | cfg=[skip|write] => | ||
+ | Specify ' | ||
+ | OS parameters; or specify ' | ||
+ | to disk. | ||
+ | |||
+ | domain=your_custom_domain => | ||
+ | Specify a custom domain name. Defaults to ' | ||
hostname=your_custom_hostname[, | hostname=your_custom_hostname[, | ||
Line 382: | Line 401: | ||
toram => | toram => | ||
- | | + | |
You can remove the boot media after booting. | You can remove the boot media after booting. | ||
+ | |||
+ | toram=all => | ||
+ | Prevent writes to disk since we are supposed to run from RAM; | ||
+ | equivalent to parameter " | ||
+ | |||
+ | toram=os => | ||
+ | Load OS modules into RAM, but write persistent data to USB. | ||
=== Troubleshooting === | === Troubleshooting === | ||
Line 448: | Line 474: | ||
* The script reads a package sequence for the Live variant and installs all packages in this sequence to subdirectories of a temporary directory tree. | * The script reads a package sequence for the Live variant and installs all packages in this sequence to subdirectories of a temporary directory tree. | ||
- | * Every Slackware package set (a, ap, d, ... , y) or package list (min, xbase, xapbase, ...) is installed into a separate ' | + | * Every Slackware package set (a, ap, d, ... , y) or package list (min, noxbase, x_base, xapbase, ...) is installed into a separate ' |
* Each of those root directories is " | * Each of those root directories is " | ||
* These module files are subsequently loop-mounted and then combined together into a single read-only directory structure using an " | * These module files are subsequently loop-mounted and then combined together into a single read-only directory structure using an " | ||
Line 468: | Line 494: | ||
* the desktop environment is pre-configured for first use, | * the desktop environment is pre-configured for first use, | ||
* the liveslak scripts " | * the liveslak scripts " | ||
- | * if the Live system contains a huge kernel (all ISO variants except XFCE) then the " | + | * the " |
* slackpkg is configured, | * slackpkg is configured, | ||
* a locate database is created, | * a locate database is created, | ||
Line 503: | Line 529: | ||
This section explains how the script modifies the ISO for the enhanced USB functionality. | This section explains how the script modifies the ISO for the enhanced USB functionality. | ||
+ | |||
+ | == Layout of the USB stick == | ||
+ | |||
+ | The " | ||
+ | |||
+ | * First partition: a small (1 MB in size) FAT partition which is not used for Slackware Live Edition. | ||
+ | * Second partition: a 100 MB VFAT partition containing the kernel, initrd and all the other stuff required by syslinux and grub2 to boot Slackware Live Edition. | ||
+ | * Third partition: a Linux partition taking up all of the remaining space. It contains the actual liveslak modules, the persistent live storage and optionally your encrypted homedirectory. You can use the remainder of this Linux //ext4// filesystem' | ||
+ | |||
+ | Note that this script is the only supported method of transfering the liveslak ISO content to a USB stick and make that USB stick into a persistent live OS. Several 3rd party tools (like multibootusb, | ||
== Mounting a filesystem in an encrypted container == | == Mounting a filesystem in an encrypted container == | ||
Line 546: | Line 582: | ||
The fourth script: | The fourth script: | ||
- | The " | + | The " |
+ | * The Slackware network installation is identical to that of the official Slackware installation medium. | ||
+ | * If you chose to install the Live OS, then after you select the target partition(s), | ||
Line 635: | Line 673: | ||
* README.txt - this documentation. | * README.txt - this documentation. | ||
* addons/ - squashfs modules placed in this directory will be loaded into the Live filesystem when the OS boots. | * addons/ - squashfs modules placed in this directory will be loaded into the Live filesystem when the OS boots. | ||
+ | * contrib/ - contributed scripts that are not used directly for the creation and usage of a Live ISO. | ||
* graphics/ - squashfs modules for proprietary GPU support (Nvidia) can be placed here. The module(s) will be copied to addons/ by the " | * graphics/ - squashfs modules for proprietary GPU support (Nvidia) can be placed here. The module(s) will be copied to addons/ by the " | ||
* local64/ , local/ - these directories can contain Slackware packages considered ' | * local64/ , local/ - these directories can contain Slackware packages considered ' | ||
+ | * media/ - scripts and images that are specific to a Live variant. | ||
* optional/ - squashfs modules placed in this directory will not automatically be loaded into the Live filesystem when the OS boots. | * optional/ - squashfs modules placed in this directory will not automatically be loaded into the Live filesystem when the OS boots. | ||
+ | * patches/ - patches for Slackware scripts that need modifications to run inside a Live OS. | ||
* pkglists/ - definition files of 3rd party repositories (*.conf) and the package lists to be used from those repositories (*.lst) must be placed in this directory. | * pkglists/ - definition files of 3rd party repositories (*.conf) and the package lists to be used from those repositories (*.lst) must be placed in this directory. | ||
+ | * setup2hd/ - script templates used by the '' | ||
* skel/ - contains compressed tarballs (whose filenames must match wildcard " | * skel/ - contains compressed tarballs (whose filenames must match wildcard " | ||
* syslinux/ | * syslinux/ | ||
Line 661: | Line 703: | ||
* pxeserver.tpl - template to generate the script that starts a PXE server allowing other computers to boot Slackware Live over the network. | * pxeserver.tpl - template to generate the script that starts a PXE server allowing other computers to boot Slackware Live over the network. | ||
* setup2hd.tpl | * setup2hd.tpl | ||
- | * setup2hd.local - here a developer of a custom Live OS can override the default post-installation routine by (re-)defining the function " | + | * setup2hd.local.tpl - here a developer of a custom Live OS can override the default post-installation routine by (re-)defining the function " |
+ | * upslak.sh - a script which allows you to tweak the content of a USB Live stick. | ||
Line 672: | Line 715: | ||
-a arch Machine architecture (default: x86_64). | -a arch Machine architecture (default: x86_64). | ||
Use i586 for a 32bit ISO, x86_64 for 64bit. | Use i586 for a 32bit ISO, x86_64 for 64bit. | ||
+ | -c comp Squashfs compression (default: xz). | ||
+ | Can be any of 'gzip lzma lzo xz zstd'. | ||
-d desktoptype | -d desktoptype | ||
XFCE (basic XFCE), PLASMA5 (KDE Plasma5 replaces KDE4), | XFCE (basic XFCE), PLASMA5 (KDE Plasma5 replaces KDE4), | ||
Line 680: | Line 725: | ||
| | ||
custom configurations and new initrd.img. | custom configurations and new initrd.img. | ||
+ | -l < | ||
+ | (script-default is ' | ||
-m pkglst[, | -m pkglst[, | ||
-r series[, | -r series[, | ||
Line 710: | Line 757: | ||
- | ==== Using the Customization | + | ==== Using the Customization |
+ | |||
+ | === Master configuration file === | ||
You can create your own custom Live OS by changing its characteristics in the configuration file "'' | You can create your own custom Live OS by changing its characteristics in the configuration file "'' | ||
Among the things you can change are: | Among the things you can change are: | ||
- | * The name of the Desktop variant (the script itself knows "// | + | * The name of the Desktop variant (the script itself knows "// |
* The list(s) of packages used for your custom distribution, | * The list(s) of packages used for your custom distribution, | ||
* The name of the useraccount (by default that is "// | * The name of the useraccount (by default that is "// | ||
Line 731: | Line 780: | ||
# and " | # and " | ||
# respectively): | # respectively): | ||
- | # | + | # |
# OPTIONAL: | # OPTIONAL: | ||
Line 764: | Line 813: | ||
#} | #} | ||
</ | </ | ||
+ | |||
+ | === Custom background images === | ||
+ | |||
+ | The Plasma5 based Live variants allow customization of the background image used for the login greeter, the desktop wallpaper and the lock screen. The image you want to use for this purpose, must have a 16:9 aspect ratio and its dimensions should at least be 1920x1080 pixels. You must store the custom image inside the liveslak source tree: in the subdirectory '' | ||
+ | |||
+ | The " | ||
+ | |||
+ | |||
==== Internals of Slackware Live Edition ==== | ==== Internals of Slackware Live Edition ==== | ||
Line 825: | Line 882: | ||
0000 = contains the Slackware /boot directory | 0000 = contains the Slackware /boot directory | ||
0010-0019 = packages installed from a Slackware tagfile (a,ap,d, ... , y series) | 0010-0019 = packages installed from a Slackware tagfile (a,ap,d, ... , y series) | ||
- | 0020-0029 = packages installed from a package list as found in the ./pkglists subdirectory of the liveslak sources (min, xbase, xapbase, xfcebase etc) | + | 0020-0029 = packages installed from a package list as found in the ./pkglists subdirectory of the liveslak sources (min, noxbase, x_base, xapbase, xfcebase etc) |
0030-0039 = a ' | 0030-0039 = a ' | ||
0099 = liveslak configuration module (contaning all the customizations that change the installed packages into a usable Live OS) </ | 0099 = liveslak configuration module (contaning all the customizations that change the installed packages into a usable Live OS) </ | ||
Line 894: | Line 951: | ||
====== Sources ====== | ====== Sources ====== | ||
<!-- If you copy information from another source, then specify that source --> | <!-- If you copy information from another source, then specify that source --> | ||
- | * Original source: [[http://bear.alienbase.nl/cgit/ | + | * Original source: [[https://git.slackware.nl/ |
+ | * Project landing page: [[https:// | ||
<!-- Authors are allowed to give credit to themselves! --> | <!-- Authors are allowed to give credit to themselves! --> | ||
* Originally written by [[wiki: | * Originally written by [[wiki: | ||
- | <!-- * Contrbutions | + | <!-- * Contributions |
<!-- Please do not modify anything below, except adding new tags.--> | <!-- Please do not modify anything below, except adding new tags.--> | ||
<!-- You must also remove the tag-word " | <!-- You must also remove the tag-word " | ||
{{tag> | {{tag> |