Meego Wiki
Views

Image Creation For Beginners

From MeeGo wiki
(Difference between revisions)
Jump to: navigation, search
(Created page with '= Creating My 1st Meego Image = Steps on how to create a Meego Image. = Moblin Image Creator configuration = Steps on how to configure your MIC.')
Line 1: Line 1:
-
= Creating My 1st Meego Image =
+
= My First Meego Image =
-
Steps on how to create a Meego Image.
+
Here are the simple steps on how to create a Meego image.
-
= Moblin Image Creator configuration =
+
'''Step 1 - Download Moblin Image Creator (MIC)'''
-
Steps on how to configure your MIC.
+
Moblin Image Creator is the tool we use to create Meego images.  To get it you can:
 +
 
 +
- Download the MIC binary rpm for your distro: http://build.moblin.org/repos/devel:/tools:/building/
 +
 
 +
More options on downloading MIC are in the 'Installation' section here: [[Image_Creation]]
 +
 
 +
'''Step 2 - Get Meego .ks File'''
 +
 
 +
KickStart (.ks) configuration files are passed to MIC to create images. KickStart files specify what repos to pull from, what packages to include, what post-scripts to run and what type of images to create.
 +
 
 +
The official Meego .ks files are here: http://repo.meego.com/trunk/repo/ia32/os/image-config/
 +
 
 +
You can download and use them as a base for the Meego images you create. Modify these .ks files as you wish to create tailored images.
 +
 
 +
We will use 'default.ks' to create a typical Meego image: http://repo.meego.com/trunk/repo/ia32/os/image-config/default.ks
 +
 
 +
'''Step 3 - Create Meego Livecd Image'''
 +
 
 +
MIC has to be run with root privileges using 'sudo'.
 +
 
 +
Here is the command to create a Meego livecd image you can burn onto a CD.
 +
 
 +
<pre>
 +
sudo moblin-image-creator --config=default.ks --format=livecd --cache=mycache
 +
</pre>
 +
 
 +
A file named meego-1.0-default-XX.iso is created.  This ISO image is a hybrid image and can be either written to a disk device or burned onto a cd.
 +
 
 +
'''Step 4 - Create Meego LiveUSB Image'''
 +
 
 +
To create a Meego liveusb image that you can transfer to a USB stick.
 +
 
 +
<pre>
 +
sudo moblin-image-creator --config=default.ks --format=liveusb --cache=mycache
 +
</pre>
 +
 
 +
A file named meego-1.0-default-XX.usbimg will be created. To burn it onto a USB stick, run the following command:
 +
 
 +
sudo moblin-image-writer meego-1.0-default-XX.usbimg
 +
 
 +
This image has a FAT file system and can be mounted easily on Windows and other OSes.
 +
 
 +
'''---FOR ADDITIONAL INFORMATION ON MIC, PLEASE VISIT THE MIC DEVELOPER'S GUIDE HERE: [[Image_Creation]]---'''
 +
 
 +
= Configure Proxy and Other Variables =
 +
 
 +
~/.mic2_site.conf is a configuration file that can make your life easier by specifying proxy settings, cache directories, and other variables that you normally would have to re-type in your command-line.
 +
 
 +
Copy and paste this into a file called:  /~.mic2_site.conf
 +
 
 +
Replace with your own relevant values.
 +
 
 +
<pre>
 +
[main]
 +
cachedir=/home/user1/mycache
 +
tmpdir=/home/user1/mystorage/tmp
 +
outdir=/home/user1/mystorage
 +
proxy=http://my.proxy.com:911/
 +
no_proxy=localhost,127.0.0.0/8,.mysite.com,172.16.0.0/16
 +
</pre>
 +
 
 +
''cachedir'' = directory where the cached repo(s) will reside.  With this variable set, you do not need to pass the --cache flag in the command-line.
 +
 
 +
''tmpdir'' = temporary directory used by mic2 when creating images.  With this variable set, you do not need to pass the --tmpdir flag in the command-line.
 +
 
 +
''outdir'' = where your images will reside once they are created.  With this variable set, you do not need to pass the --outdir flag in the command-line.
 +
 
 +
''proxy'' = specify your proxy if you're behind a behind a firewall.
 +
 
 +
''no_proxy'' = specify what domains should not sure the proxy setting.
 +
 
 +
'''Note:''' When specifying proxy and no_proxy, you do not need to use the --proxy flag in your .ks files when referring to repos.
 +
 
 +
'''---FOR ADDITIONAL INFORMATION ON MIC, PLEASE VISIT THE MIC DEVELOPER'S GUIDE HERE: [[Image_Creation]]---'''

Revision as of 06:36, 18 February 2010

My First Meego Image

Here are the simple steps on how to create a Meego image.

Step 1 - Download Moblin Image Creator (MIC)

Moblin Image Creator is the tool we use to create Meego images. To get it you can:

- Download the MIC binary rpm for your distro: http://build.moblin.org/repos/devel:/tools:/building/

More options on downloading MIC are in the 'Installation' section here: Image_Creation

Step 2 - Get Meego .ks File

KickStart (.ks) configuration files are passed to MIC to create images. KickStart files specify what repos to pull from, what packages to include, what post-scripts to run and what type of images to create.

The official Meego .ks files are here: http://repo.meego.com/trunk/repo/ia32/os/image-config/

You can download and use them as a base for the Meego images you create. Modify these .ks files as you wish to create tailored images.

We will use 'default.ks' to create a typical Meego image: http://repo.meego.com/trunk/repo/ia32/os/image-config/default.ks

Step 3 - Create Meego Livecd Image

MIC has to be run with root privileges using 'sudo'.

Here is the command to create a Meego livecd image you can burn onto a CD.

sudo moblin-image-creator --config=default.ks --format=livecd --cache=mycache

A file named meego-1.0-default-XX.iso is created. This ISO image is a hybrid image and can be either written to a disk device or burned onto a cd.

Step 4 - Create Meego LiveUSB Image

To create a Meego liveusb image that you can transfer to a USB stick.

sudo moblin-image-creator --config=default.ks --format=liveusb --cache=mycache

A file named meego-1.0-default-XX.usbimg will be created. To burn it onto a USB stick, run the following command:

sudo moblin-image-writer meego-1.0-default-XX.usbimg

This image has a FAT file system and can be mounted easily on Windows and other OSes.

---FOR ADDITIONAL INFORMATION ON MIC, PLEASE VISIT THE MIC DEVELOPER'S GUIDE HERE: Image_Creation---

Configure Proxy and Other Variables

~/.mic2_site.conf is a configuration file that can make your life easier by specifying proxy settings, cache directories, and other variables that you normally would have to re-type in your command-line.

Copy and paste this into a file called: /~.mic2_site.conf

Replace with your own relevant values.

[main]
cachedir=/home/user1/mycache
tmpdir=/home/user1/mystorage/tmp
outdir=/home/user1/mystorage
proxy=http://my.proxy.com:911/
no_proxy=localhost,127.0.0.0/8,.mysite.com,172.16.0.0/16

cachedir = directory where the cached repo(s) will reside. With this variable set, you do not need to pass the --cache flag in the command-line.

tmpdir = temporary directory used by mic2 when creating images. With this variable set, you do not need to pass the --tmpdir flag in the command-line.

outdir = where your images will reside once they are created. With this variable set, you do not need to pass the --outdir flag in the command-line.

proxy = specify your proxy if you're behind a behind a firewall.

no_proxy = specify what domains should not sure the proxy setting.

Note: When specifying proxy and no_proxy, you do not need to use the --proxy flag in your .ks files when referring to repos.

---FOR ADDITIONAL INFORMATION ON MIC, PLEASE VISIT THE MIC DEVELOPER'S GUIDE HERE: Image_Creation---

Personal tools