Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/akotov-dev/mgaremix-tools

MgaRemix Build Tools (Live flash drive based on Mageia Linux)
https://github.com/akotov-dev/mgaremix-tools

flashdrive live mageia-linux scripts-collection

Last synced: 2 days ago
JSON representation

MgaRemix Build Tools (Live flash drive based on Mageia Linux)

Awesome Lists containing this project

README 

        
EN - Instructions for assembling the MgaRemix flash drive

---

![](MgaRemix-Logo.png)



The entire procedure for assembling a bootable MgaRemix flash drive can be divided into 5 steps:



1. Creating an empty bootable USB flash drive

2. Installing and configuring Mageia Linux in VirtualBox

3. Creating special `vmlinuz` and `initrd.gz` inside the guest OS with using the `initrd-builder` script

4. Convert a VM file to a `distrib.sqfs` file in the main OS using the `vdi-to-sqfs-converter`

5. Copy the resulting file `distrib.sqfs` to the `/loopbacks` folder on the flash drive



**Actions on items:**



- Take a flash drive with a FAT32 file system (native FS for flash drives) with a size from 4GB or more

- Download the archive `MgaRemix-LiveUSB-Loader-xx.zip` and unzip it to the root of the flash drive. On the flash drive, you should get a directory structure:



>/boot  

>/EFI  

>/loopbacks



- Make the flash drive bootable. To do this, run the script `Flash_drive/boot/syslinux/BootInstall.bat` (su/password on Linux or as Administrator on Windows) and press Enter. After installing the bootloader, the label of the flash drive will change to `MGAREMIX`.

- Installing Mageia Linux in a VirtualBox is not considered in this manual, since starting to create a flash drive MgaRemix implies that the user knows how to do it. The settings of the virtual system depend only on the imagination of the collector. Disk layout = root + swap.

- While in the VM, download the package [initrd-builder-x.x-x.mrxX.noarch.rpm](https://github.com/AKotov-dev/MgaRemix-Tools/tree/main/initrd-builder) and install it. We give the command `initrd-builder`. At the end of the operation, the files `initrd.gz` and `vmlinuz` will be created in the `~/initrd-buider` directory. Connect the previously created bootable flash drive to the VM and copy these files to the `/boot` directory on it. Remove the flash drive (right mouse button – `Extract`) and disconnect it from the virtual machine via the VirtualBox menu. Turn off the VM and switch to the main OS.

- While in the main system, download the file [vdi-to-sqfs-converter.tar.gz](https://github.com/AKotov-dev/MgaRemix-Tools/tree/main/vdi-to-sqfs-converter). Go to the terminal (su/password). Unpack the downloaded converter archive and throw a virtual machine file with the extension `*.vdi` into its directory. Run the script `converter.sh` and convert the VM to the `*.sqfs` format. Those working in Windows should keep another virtual machine for converting.



- Transfer the resulting file `distrib.sqfs` to the flash drive in the directory `/loopbacks`. This completes the creation of the flash drive.



MgaRemix is able to work with saving. To do this, it is enough to unpack one of the archives containing the image of the "save disk" in the size of 1,2,3 or 4GB into the root of the flash drive. You can download it from the `persistence-images` directory.



Important! In the save mode, you should use fast flash drives with a write speed from 8MB/Sec. The quality of the flash drive in Linux can be checked by the program f3 or KDiskMark.



**Additional recommendations:**



After the installation and final configuration of the guest OS, you can optimize and clean up the system: clean up unnecessary packages and cores using the program [SnappyCleaner](https://github.com/AKotov-dev/SnappyCleaner), remove the packages `iptables, msec, shorewall-core, mgaonline, mageiawelcome` so as not to have problems with the connection and not load the system at the first start.



To reduce the size of the final `distrib.sqfs` in the guest OS, you need to run the command from root: `compact` (we ignore the message about the lack of disk space)



After that, you need to turn off the VM and compress `*.vdi` of the virtual machine. On Windows, you can use the `CloneVDI` graphical utility to compress VDI. Before compressing, the "Keep Old UUID" and "Compact drive while copying" checkboxes must be set. To compress `*.vdi` on Linux, use the [VDIComp](https://github.com/AKotov-dev/vdicomp) graphical utility.



After compressing the file `*.vdi` is sent to the `vdi-to-sqfs-converter`.



**Possible problems:**



If you previously installed GRUB on the flash drive, you will need to delete all the partitions on it and restore the MBR. On Linux, you can use [USBRestore](https://github.com/AKotov-dev/usbrestore) or Gparted. In Windows, you can delete flash drive partitions using ROSA ImageWriter or ImageTool. After deleting the partitions, you will need to reformat (FAT32).



The entire MgaRemix project: https://cloud.mail.ru/public/59BZ/3Nev2XbrV



RU - Инструкция по cборке флешки MgaRemix

---

![](MgaRemix-Logo.png)



Всю процедуру сборки загрузочной флешки MgaRemix можно разделить на 5 шагов:



1. Создание пустой загрузочной флешки

2. Установка и настройка Mageia Linux в VirtualBox

3. Создание внутри гостевой ОС специальных `vmlinuz` и `initrd.gz` с помощью скрипта `initrd-builder`

4. Конвертирование в основной ОС файла виртуальной машины в файл `distrib.sqfs` с помощью конвертера `vdi-to-sqfs-converter`

5. Копирование полученного файла `distrib.sqfs` в папку `/loopbacks` на флешке



**Действия по пунктам:**



- Возьмите флешку с файловой системой FAT32 (родная ФС для флешек) размером от 4ГБ

- Скачайте архив `MgaRemix-LiveUSB-Loader-xx.zip` и распакуйте его в корень флешки. На флешке должна получиться структура каталогов:



>/boot  

>/EFI  

>/loopbacks



- Сделайте флешку загрузочной. Для этого запустите скрипт `Флешка/boot/syslinux/BootInstall.bat` (su/password в Linux или под Администратором в Windows) и нажмите Enter. После установки загрузчика метка флешки изменится на `MGAREMIX`.

- Установка Mageia Linux в Virtual Box в этой инструкции не рассматривается, поскольку приступая к созданию флешки MgaRemix подразумевается, что пользователь умеет это делать. Настройки виртуальной системы зависят только от фантазии сборщика. Разметка диска = корень + своп.

- Находясь в виртуальной машине, скачиваем пакет [initrd-builder-х.х-х.mrxX.noarch.rpm](https://github.com/AKotov-dev/MgaRemix-Tools/tree/main/initrd-builder) и устанавливаем его. Даём команду: `initrd-builder`. По окончанию операции в каталоге `~/initrd-buider` будут созданы файлы `initrd.gz` и `vmlinuz`. Подключаем созданную ранее загрузочную флешку к виртуальной машине и копируем эти файлы в каталог `/boot` на ней. Извлекаем флешку (правая кнопка мыши – `Извлечь`) и отключаем её от виртуальной машины через меню VirtualBox. Выключаем виртуальную машину и переходим в основную ОС.

- Находясь в основной системе скачиваем файл [vdi-to-sqfs-converter.tar.gz](https://github.com/AKotov-dev/MgaRemix-Tools/tree/main/vdi-to-sqfs-converter). Заходим в терминал (su/пароль). Распаковываем скачанный архив конвертера и закидываем к нему в каталог файл виртуальной машины с расширением `*.vdi`. Запускаем скрипт `converter.sh` и конвертируем виртуальную машину в формат `*.sqfs`. Работающим в Windows следует держать ещё одну виртуалку для конвертирования.



- Переносим полученный файл `distrib.sqfs` на флешку в каталог `/loopbacks`. На этом создание флешки завершено.



МgaRemix умеет работать с сохранением. Для этого достаточно распаковать в корень флешки один из архивов, содержащий образ «диска сохранения» размером 1,2,3 или 4GB. Скачать можно из каталога `persistence-images`. 



Важно! В режиме с сохранением, следует использовать быстрые флешки со скоростью записи от 8МБ/Сек.  Качество флешки в Linux можно проверить программой f3 или KDiskMark.



**Дополнительные рекомендации:**



После установки и окончательной настройки гостевой ОС, можно оптимизировать и прибрать систему: очистить от ненужных пакетов и ядер с помощью программы `SCleaner`, удалить пакеты `iptables, msec, shorewall-core, mgaonline, mageiawelcome` чтобы не иметь проблем с коннектом и не нагружать систему при первом старте.



Для уменьшения размера финального `distrib.sqfs`  в гостевой ОС нужно выполнить от root команду: `compact` (сообщение о нехватке места на диске игнорируем)



После этого нужно выключить виртуальную машину и в основной ОС сжать `*.vdi` виртуальной машины. В Windows для сжатия VDI можно использовать графическую утилиту `CloneVDI`. Перед сжатием галки «Keep Old UUID» и «Compact drive while copying» должны быть установлены. Для сжатия `*.vdi` в Linux используйте графическую утилиту [VDIComp](https://github.com/AKotov-dev/vdicomp).



После сжатия файл `*.vdi` отправляется в конвертер `vdi-to-sqfs-converter`.



**Возможные проблемы:**



Если ранее на флешку ставился GRUB, потребуется удалить на ней все разделы и восстановить MBR. В Linux можно воспользоваться [USBRestore](https://github.com/AKotov-dev/usbrestore) или Gparted. В Windows можно удалить разделы флешки с помощью ROSA ImageWriter или ImageTool. После удаления разделов потребуется переформатирование (FAT32).



Весь проект MgaRemix: https://cloud.mail.ru/public/59BZ/3Nev2XbrV