Difference between revisions of "ManjaroISO"
no edit summary
imported>Handy |
imported>Excalibur1234 |
||
| (13 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
=What is ManjaroISO?= | =What is ManjaroISO?= | ||
| Line 6: | Line 7: | ||
to install disks, to special interest live CD systems, and who knows what | to install disks, to special interest live CD systems, and who knows what | ||
else. Simply put, if it involves Manjaro on a shiny coaster, it can do it. | else. Simply put, if it involves Manjaro on a shiny coaster, it can do it. | ||
=How to get started?= | =How to get started?= | ||
| Line 15: | Line 17: | ||
mkdir -p ~/work/manjaroiso | mkdir -p ~/work/manjaroiso | ||
==Update your system== | |||
To update your system | |||
sudo pacman -Syu | |||
==Install ManjaroISO== | ==Install ManjaroISO== | ||
Next, install manjaroiso and its profiles. | Next, install manjaroiso and its profiles. If you do not need the community profiles, do not install their package. | ||
sudo pacman -S manjaroiso manjaroiso-profiles | sudo pacman -S manjaroiso manjaroiso-profiles manjaroiso-community-profiles | ||
Copy ManjaroISOs profiles to your work directory: | Copy ManjaroISOs profiles to your work directory: | ||
cp -a /usr/share/manjaroiso/configs ~/work/manjaroiso | cp -a /usr/share/manjaroiso/configs/ ~/work/manjaroiso/configs/ | ||
There is an [[Alternative way to install ManjaroISO]] available. | |||
==Understanding ManjaroISO Profiles== | ==Understanding ManjaroISO Profiles== | ||
Depending on your ManjaroISO version you find followed directories: | Depending on your ManjaroISO version you find followed directories in ~/work/manjaroiso: | ||
build cinnamon e17 kde lxde mate net openbox shared sysmenu xfce | build cinnamon e17 kde lxde mate net openbox shared sysmenu xfce | ||
In this example we work with the '''e17''' folder. Change to it and take a look at the files and folders in it: | In this example we work with the '''e17''' folder. This folder is not available anymore and got replaced by the '''enlightenment''' folder, but it serves well for demonstration purposes. All profile folders look very similar. Change to it and take a look at the files and folders in it: | ||
Packages isolinux overlay pacman-x86_64.conf | Packages isolinux overlay pacman-x86_64.conf | ||
Packages-E17 isomounts overlay-livecd syslinux | Packages-E17 isomounts overlay-livecd syslinux | ||
Packages-Xorg mkinitcpio.conf pacman-gfx.conf | Packages-Xorg mkinitcpio.conf pacman-gfx.conf efiboot | ||
e17-overlay options.conf pacman-i686.conf | e17-overlay options.conf pacman-i686.conf | ||
| Line 44: | Line 54: | ||
* e17-overlay includes files and folders modified to get E17 Edition working | * e17-overlay includes files and folders modified to get E17 Edition working | ||
* isolinux includes isolinux.cfg file to start syslinux bootloader | * isolinux includes isolinux.cfg file to start syslinux bootloader | ||
* isomounts holds the information of all overlay-images and their bootorder | * isomounts holds the information of all overlay-images and their bootorder: It tells the kernel in which order (from top to bottom) to load all overlay images | ||
* mkinitcpio.conf holds the information of all needed modules need to be added to the live-media kernel | * mkinitcpio.conf holds the information of all needed modules need to be added to the live-media kernel | ||
* options.conf defines basic settings for the live-media | * options.conf defines basic settings for the live-media | ||
| Line 53: | Line 63: | ||
* pacman-x86_64.conf includes the common pacman.conf for all 64bit Manjaro Editions | * pacman-x86_64.conf includes the common pacman.conf for all 64bit Manjaro Editions | ||
* syslinux includes the bootloader for all Manjaro Editions | * syslinux includes the bootloader for all Manjaro Editions | ||
* efiboot includes UEFI bootloader stuff for all Manjaro Editions | |||
==Modifying | ==Modifying a ManjaroISO Profile== | ||
Following files and folders are important for the E17 Profile | In this example we work with the '''e17''' folder. Following files and folders are most important for the E17 Profile: | ||
* Packages-E17 | * Packages-E17 | ||
* e17-overlay | * e17-overlay | ||
Current Packages-E17 file looks like this: | Current Packages-E17 file looks like this: | ||
| Line 97: | Line 106: | ||
pacman-gui | pacman-gui | ||
You can add any missing package like '''connman''', the E17 network manager, to this file and save it. | You can add any missing package like '''connman''', the E17 network manager, to this file and save it. Please keep in mind that you can only add packages from the manjaro repositories and '''not''' from the AUR. [[How to install AUR packages in ManjaroISO]] | ||
The '''e17-overlay''' folder looks like this atm: | The '''e17-overlay''' folder looks like this atm: | ||
| Line 118: | Line 127: | ||
|-------default | |-------default | ||
It includes configuration files like etc/systemd/system/display-manager.service to define the used bootloader. You can change or add any files to that folder to get included to the installed Manjaro system and also added to the live-session if not overwritten by the same file in overlay-livecd. | It includes configuration files like </code>etc/systemd/system/display-manager.service</code> to define the used bootloader. You can change or add any files to that folder to get included to the installed Manjaro system and also added to the live-session if not overwritten by the same file in overlay-livecd. | ||
The '''overlay-livecd''' folder looks like this atm: | The '''overlay-livecd''' folder looks like this atm: | ||
| Line 151: | Line 160: | ||
|-----icons | |-----icons | ||
Any file added to this folder gets only added to the live-session. | Any file added to this folder gets '''only''' added to the '''live-session'''. In some cases, this can be important. | ||
== Building 32 bit and 64 bit install-medias == | |||
''' | The '''options.conf''' file found in the ''shared'' subfolder or the subfolder of the desktop environment you are trying to build (in our example: <code>~/work/manjaroiso/configs/e17/</code> ) contains the following code: | ||
arch=`uname -m` | |||
#arch=i686 | |||
# arch | |||
This will build a 32bit install-media, if you are on a 32bit Manjaro system and a 64bit install-media, if you are on a 64bit Manjaro system. | |||
If you are on a 64bit Manjaro system and want to build a 32bit install-media, please change the code to this: | |||
#arch=`uname -m` | |||
# | arch=i686 | ||
=Building an install-media= | =Building an install-media= | ||
Please change into the profile folder you want to build, if you have not already done this. In our example this is: | |||
cd ~/work/manjaroiso/configs/e17/ | |||
Now, use buildiso to build your install-media: | |||
sudo buildiso | sudo buildiso | ||
buildiso will create a new folder <code>work-x86_64</code> or <code>work-i686</code> depending on install-media you want to build. buildiso will work in that folder exclusively. When buildiso is finished, the .iso file with your install-media will appear in your profile folder (in our example: <code>~/work/manjaroiso/configs/e17/</code> ). | |||
== Troubleshooting == | |||
In case anything goes wrong buildiso will display an error. Try to fix this error and restart buildiso. | |||
If there is a severe error in buildiso or if you want to build a completely new install-media, it might be necessary to delete buildiso's work folder. In our example this is: | |||
sudo rm -rfv ~/work/manjaroiso/configs/e17/work-x86_64 | |||
'''Attention:''' The <code>work-x86_64</code> folder will '''not''' be completely deleted, because parts of it are mounted. | |||
In severe cases, please reboot your system before and after you try to remove the <code>work-x86_64</code> folder. | |||
= Links = | |||
* [https://www.youtube.com/watch?v=89TsITpY3h0 Basic Video Tutorial] | |||
* [http://vimeo.com/63063954 Video tutorial] | |||
* [https://forum.manjaro.org/index.php?topic=4295.0 ManjaroISO Tutorial] | |||
* [https://forum.manjaro.org/index.php?board=27.0 Manjaro subforum dedicated to ManjaroISO] | |||
= Further reading= | |||
* [[Alternative way to install ManjaroISO]] | |||
* [[How to install AUR packages in ManjaroISO]] | |||