Differences

This shows you the differences between two versions of the page.

--- doc:appunti:linux:sa:grml [2023/11/30 11:05] – [Customize the environment and save the config.tbz] niccolo
+++ doc:appunti:linux:sa:grml [2024/12/16 15:50] (current) – [Create a new partition into the USB stick] niccolo
@@ Line 15: / Line 15: @@
   - Create the USB boot stick from the **GRML ISO image**.
   - Create a **new GRMLCFG partition** into the USB stick.
-  - Customize the GRML environment at your will and create a **config.tbz**; copy the file into the new partition.
+  - Customize the GRML environment at your will and create a **config.tbz**. Copy the file into the new partition.
-  - Create a **scrits/** directory into the partition containing scripts to be run at boot.
+  - Create a **scripts/** directory into the partition containing the scripts to be run at boot.
 ==== Create the USB stick from the ISO image ====
@@ Line 38: / Line 38: @@
 The option **%%--wipe never%%** is required because the device contains an **iso9660 signature** that otherwise will be removed by the write command.
-Using the **n** key to **add a new partition** it is possible to create the ''/dev/sdc3'' partition, which I decided to size at 5 Gb. Select **p** (//print the partition table//) and **w** (//write table to disk and exit//) to finalize the partitioning, using the following schema as a reference:
+Using the **n** key to **add a new partition** it is possible to create the ''/dev/sdc3'' partition, which I decided to size at 5 Gb.
+<code>
+Command (m for help): n
+Partition type
+Select (default p): p
+Partition number (3,4, default 3):
+First sector (1751040-122879999, default 1751040):
+Last sector, +/-sectors or +/-size{K,M,G,T,P} (1751040-122879999, default 122879999): +5G
+</code>
+Select **p** (//print the partition table//) and **w** (//write table to disk and exit//) to finalize the partitioning, using the following schema as a reference:
 <code>
@@ Line 57: / Line 68: @@
 ==== Customize the environment and save the config.tbz ====
-Now it is time to customize your environment; you can for example:
+Now it is time to customize your environment; check the **[[https://grml.org/config/grml-autoconfig.1.html|grml-autoconfig]]** man page about the options to automatically install **Debs**, **Configuration** and **Scripts** into a freshly booted GRML environment.
+You can for example:
   * Generate an SSH RSA key running the **ssh-keygen** utility. The key will be saved into ''$HOME/.ssh/''.
   * Customize the shell by editing the **$HOME/.zsrc** file, e.g. by adding alias commands, customizing the **PATH** or other environment variables. etc.
   * Run and configure some programs that will save preferences into the **$HOME/**, e.g. the Midnight Commander **mc** will save its files into ''$HOME/.config/mc/''.
+  * Create an ''$HOME/config/'' directory and place what you want in it. You will find that directory again at the next boot.
-At the end of the customization run the GRML command:
+At the end of the customization, run the GRML command:
 <code>
@@ Line 69: / Line 83: @@
 </code>
-A file named **config.tbz** will be saved into the current directory. Mount the custom partition and copy the file into the root directory:
+A file named **config.tbz** will be saved into the current directory. The file is a //grml configuration archive//, which may contains several components: hidden files from the ''$HOME'' directory, modified files from the ''/etc/'' directory, etc.
+Mount the custom partition and copy the file into its root directory:
 <code>
-mount /dev/sdc /mnt
+mkdir /mnt/grmlcfg
-cp -p config.tbz /mnt
+mount /dev/sdc3 /mnt/grmlcfg
+cp -p config.tbz /mnt/grmlcfg
 </code>
+If you want to modify the **config.tbz** archive without re-creating it via the ''save-config'' command, you can extract the archive and then re-create it:
+<code bash>
+mkdir config
+cd config
+tar jxvf ../config.tbz
+# Do whatever you need to the extracted files...
+mv ../config.tbz ../config.bak.tbz
+tar jcvf ../config.tbz *
+</code>
+==== Add scripts and other files to the USB ====
+If you want to have some scripts run at bootstrap by GRML, create a **script/** directory into the root of the custom USB partition, and place the scripts into it. During the execution of the script the partition will be mounted under **/mnt/grmlcfg/**.
+You can place also files into the partition, so e.g. you can install additional deb packages on-the-fly.
+====== Obsolete ======
+:!: **WARNING**: The following notes were taken in 2018 and may be out of date.
 ===== Boot via PXE =====
@@ Line 83: / Line 121: @@
 Vedere [[install]].
 ===== Personalizzazione =====
 La partizione VFAT quando il sistema live è avviato, risulta accessibile sotto **''/lib/live/mount/medium/''**.
-FIXME (Verificare se funziona davvero) Se nella chiavetta USB contenente GRML si crea un archivio **''config.tbz''**, questo verrà scompattato subito dopo l'avvio a partire dalla directory radice. L'archivio deve essere un **//grml configuration archive//**, abbreviato GCA.
-FIXME (Verificare se funziona davvero) dopo l'autoconfigurazione viene eventualmente eseguito lo script **''DCSDIR/scrips/grml.sh''**. Vedere il paragrafo [[http://grml.org/config/grml-autoconfig.1.html|Determination of DCS directory]], dovrebbe trattarsi comunque della directory radice della partizione VFAT.
 La via più comoda di avere una GRML personalizzata è passare il parametro **''netconfig=server/archivio.tar.bz2''** al boot prompt. L'archivio viene scompattato subito dopo l'avvio a partire dalla directory radice, ovviamente è necessario che la macchina abbia accesso alla rete.
@@ Line 127: / Line 162: @@
 </file>
-===== Web References =====
+====== Web References ======
-  * [[http://grml.org/config/grml-autoconfig.1.html|grml-autoconfig]]
+  * [[https://grml.org/online-docs/grml-config.html|grml-config]]
+  * [[https://grml.org/config/grml-autoconfig.1.html|grml-autoconfig]]
   * [[http://grml.org/cheatcodes/|CHEATCODES AND HINTS FOR GRML]]