854
edits
Difference between revisions of "ManjaroISO"
Marked this version for translation
m (added languages and translate tags) |
(Marked this version for translation) |
||
| Line 3: | Line 3: | ||
<translate> | <translate> | ||
<!--T:1--> | |||
{{warning|As of March 2015 manjaroiso is deprecated, [[Manjaro-tools]] is the way! }} | {{warning|As of March 2015 manjaroiso is deprecated, [[Manjaro-tools]] is the way! }} | ||
=What is ManjaroISO?= | =What is ManjaroISO?= <!--T:2--> | ||
<!--T:3--> | |||
ManjaroISO is a small set of bash scripts that is capable of building fully | ManjaroISO is a small set of bash scripts that is capable of building fully | ||
functional Manjaro Linux based live medias. It is a very generic tool, so it | functional Manjaro Linux based live medias. It is a very generic tool, so it | ||
| Line 15: | Line 17: | ||
=How to get started?= | =How to get started?= <!--T:4--> | ||
==Create a work directory== | ==Create a work directory== <!--T:5--> | ||
<!--T:6--> | |||
The first thing you should probably do is create a directory to work | The first thing you should probably do is create a directory to work | ||
in, and cd to it. This'll help keep things organized. | in, and cd to it. This'll help keep things organized. | ||
mkdir -p ~/work/manjaroiso | <!--T:7--> | ||
mkdir -p ~/work/manjaroiso | |||
==Update your system== | ==Update your system== <!--T:8--> | ||
<!--T:9--> | |||
To update your system | To update your system | ||
sudo pacman -Syu | <!--T:10--> | ||
sudo pacman -Syu | |||
==Install ManjaroISO== | ==Install ManjaroISO== <!--T:11--> | ||
<!--T:12--> | |||
Next, install manjaroiso and its profiles. If you do not need the community profiles, do not install their package. | 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 manjaroiso-community-profiles | <!--T:13--> | ||
sudo pacman -S manjaroiso manjaroiso-profiles manjaroiso-community-profiles | |||
<!--T:14--> | |||
Copy ManjaroISOs profiles to your work directory: | Copy ManjaroISOs profiles to your work directory: | ||
cp -a /usr/share/manjaroiso/configs/ ~/work/manjaroiso/configs/ | <!--T:15--> | ||
cp -a /usr/share/manjaroiso/configs/ ~/work/manjaroiso/configs/ | |||
<!--T:16--> | |||
There is an [[Alternative way to install ManjaroISO]] available using <code>git clone</code> to download the latest ManjaroISO packages from Github. | There is an [[Alternative way to install ManjaroISO]] available using <code>git clone</code> to download the latest ManjaroISO packages from Github. | ||
==Understanding ManjaroISO Profiles== | ==Understanding ManjaroISO Profiles== <!--T:17--> | ||
<!--T:18--> | |||
Depending on your ManjaroISO version you find followed directories in ~/work/manjaroiso: | Depending on your ManjaroISO version you find followed directories in ~/work/manjaroiso: | ||
build cinnamon e17 kde lxde mate net openbox shared sysmenu xfce | <!--T:19--> | ||
build cinnamon e17 kde lxde mate net openbox shared sysmenu xfce | |||
<!--T:20--> | |||
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: | 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 | <!--T:21--> | ||
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 efiboot | Packages-Xorg mkinitcpio.conf pacman-gfx.conf efiboot | ||
e17-overlay options.conf pacman-i686.conf | e17-overlay options.conf pacman-i686.conf | ||
<!--T:22--> | |||
* Packages includes the common packages of all editions. | * Packages includes the common packages of all editions. | ||
* Packages-E17 includes all packages especially for the E17 Edition | * Packages-E17 includes all packages especially for the E17 Edition | ||
| Line 71: | Line 87: | ||
* efiboot includes UEFI bootloader stuff for all Manjaro Editions | * efiboot includes UEFI bootloader stuff for all Manjaro Editions | ||
==Modifying a ManjaroISO Profile== | ==Modifying a ManjaroISO Profile== <!--T:23--> | ||
<!--T:24--> | |||
In this example we work with the '''e17''' folder. Following files and folders are most 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: | ||
<!--T:25--> | |||
* Packages-E17 | * Packages-E17 | ||
* e17-overlay | * e17-overlay | ||
<!--T:26--> | |||
Current Packages-E17 file looks like this: | Current Packages-E17 file looks like this: | ||
### Manjaro Packages | <!--T:27--> | ||
### Manjaro Packages | |||
## E17 Main Packages | ## E17 Main Packages | ||
| Line 113: | Line 133: | ||
pacman-gui | pacman-gui | ||
<!--T:28--> | |||
You can add any missing package like ''connman'', the E17 network manager, to this file and save it. You do not need to worry about dependencies. | You can add any missing package like ''connman'', the E17 network manager, to this file and save it. You do not need to worry about dependencies. | ||
<!--T:29--> | |||
Please keep in mind that you can only add packages from the manjaro repositories and '''not''' from the '''AUR'''. Read this wiki page, if you want to add packages from the AUR: [[How to install AUR packages in ManjaroISO]] | Please keep in mind that you can only add packages from the manjaro repositories and '''not''' from the '''AUR'''. Read this wiki page, if you want to add packages from the AUR: [[How to install AUR packages in ManjaroISO]] | ||
<!--T:30--> | |||
The '''e17-overlay''' folder looks like this atm: | The '''e17-overlay''' folder looks like this atm: | ||
e17-overlay | <!--T:31--> | ||
e17-overlay | |||
|-etc | |-etc | ||
|---skel | |---skel | ||
| Line 137: | Line 161: | ||
|-------default | |-------default | ||
<!--T:32--> | |||
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. | 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. | ||
<!--T:33--> | |||
The '''overlay-livecd''' folder looks like this atm: | The '''overlay-livecd''' folder looks like this atm: | ||
overlay-livecd | <!--T:34--> | ||
overlay-livecd | |||
|-etc | |-etc | ||
|---gdm | |---gdm | ||
| Line 171: | Line 198: | ||
|-----icons | |-----icons | ||
<!--T:35--> | |||
Any file added to this folder gets '''only''' added to the '''live-session'''. In some cases, this can be important. | 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 == | == Building 32 bit and 64 bit install-medias == <!--T:36--> | ||
<!--T:37--> | |||
The '''options.conf''' file found in the ''shared'' subfolder (in our example: <code>~/work/manjaroiso/configs/shared/</code> ) 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: | The '''options.conf''' file found in the ''shared'' subfolder (in our example: <code>~/work/manjaroiso/configs/shared/</code> ) 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` | <!--T:38--> | ||
arch=`uname -m` | |||
#arch=i686 | #arch=i686 | ||
<!--T:39--> | |||
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. | 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. | ||
<!--T:40--> | |||
If you are on a 64bit Manjaro system and want to build a 32bit install-media, please change the code to this: | 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` | <!--T:41--> | ||
#arch=`uname -m` | |||
arch=i686 | arch=i686 | ||
=Building an install-media= | =Building an install-media= <!--T:42--> | ||
<!--T:43--> | |||
Please change into the profile folder you want to build, if you have not already done this. In our example this is: | 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/ | <!--T:44--> | ||
cd ~/work/manjaroiso/configs/e17/ | |||
<!--T:45--> | |||
Now, use buildiso to build your install-media: | Now, use buildiso to build your install-media: | ||
sudo buildiso | <!--T:46--> | ||
sudo buildiso | |||
<!--T:47--> | |||
buildiso will create a new folder <code>work-x86_64</code> or <code>work-i686</code> depending on the architecture of the 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> ). | buildiso will create a new folder <code>work-x86_64</code> or <code>work-i686</code> depending on the architecture of the 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 == | == Troubleshooting == <!--T:48--> | ||
<!--T:49--> | |||
In case anything goes wrong buildiso will display an error. Try to fix this error and restart buildiso. | 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 (for a 64bit architecture installation-media): | 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 (for a 64bit architecture installation-media): | ||
sudo rm -rfv ~/work/manjaroiso/configs/e17/work-x86_64 | <!--T:50--> | ||
sudo rm -rfv ~/work/manjaroiso/configs/e17/work-x86_64 | |||
<!--T:51--> | |||
'''Attention:''' The <code>work-x86_64</code> folder will '''not''' be completely deleted, because parts of it are mounted. | '''Attention:''' The <code>work-x86_64</code> folder will '''not''' be completely deleted, because parts of it are mounted. | ||
<!--T:52--> | |||
In severe cases, please reboot your system before and after you try to remove the <code>work-x86_64</code> folder. | In severe cases, please reboot your system before and after you try to remove the <code>work-x86_64</code> folder. | ||
= Links = | = Links = <!--T:53--> | ||
<!--T:54--> | |||
* [https://www.youtube.com/watch?v=89TsITpY3h0 Basic Video Tutorial] | * [https://www.youtube.com/watch?v=89TsITpY3h0 Basic Video Tutorial] | ||
* [http://vimeo.com/63063954 Video tutorial] | * [http://vimeo.com/63063954 Video tutorial] | ||
<!--T:55--> | |||
* [https://forum.manjaro.org/index.php?topic=4295.0 ManjaroISO Tutorial] | * [https://forum.manjaro.org/index.php?topic=4295.0 ManjaroISO Tutorial] | ||
<!--T:56--> | |||
* [https://forum.manjaro.org/index.php?board=27.0 Manjaro subforum dedicated to ManjaroISO] | * [https://forum.manjaro.org/index.php?board=27.0 Manjaro subforum dedicated to ManjaroISO] | ||
= Further reading= | = Further reading= <!--T:57--> | ||
<!--T:58--> | |||
* [[Alternative way to install ManjaroISO]] | * [[Alternative way to install ManjaroISO]] | ||
* [[How to install AUR packages in ManjaroISO]] | * [[How to install AUR packages in ManjaroISO]] | ||
= See also = | = See also = <!--T:59--> | ||
<!--T:60--> | |||
* [[manjaro-tools]] | * [[manjaro-tools]] | ||
</translate> | </translate> | ||
[[Category:Contents Page{{#translation:}}]] | [[Category:Contents Page{{#translation:}}]] | ||