Meego Wiki
Views

Image Creation For Beginners

From MeeGo wiki
(Difference between revisions)
Jump to: navigation, search
(Typo in path.)
(STEP 4 - Create MeeGo LiveUSB Image)
 
(30 intermediate revisions not shown)
Line 1: Line 1:
-
= My First MeeGo Image =
+
MeeGo Image Creator is the tool we use to create MeeGo images. Here are the simple steps on how to create a MeeGo image.
 +
For more in-depth information, go to the main Image Creator developer's guide: [[Image Creation]]
 +
__TOC__
 +
== Creating a MeeGo Image ==
-
Here are the simple steps on how to create a MeeGo image.
+
===STEP 1 - Install Meego Image Creator (MIC)===
-
'''STEP 1 - Download Moblin Image Creator (MIC)'''
+
To install it:
 +
* on OpenSuse
 +
sudo zypper addrepo http://repo.meego.com/MeeGo/tools/repos/opensuse/11.4/ meego-tools
 +
sudo zypper refresh
 +
sudo zypper install mic2
 +
* on Fedora
 +
add repo like this:
 +
# cat <<REPO > /etc/yum.repos.d/meego-tools.repo
 +
[meego-tools]
 +
name=MeeGo Tools for Fedora
 +
baseurl=http://repo.meego.com/MeeGo/tools/repos/fedora/\$releasever
 +
enabled=1
 +
gpgcheck=1
 +
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-meego
 +
REPO
 +
add gpg key:
 +
# gpg2 --keyserver subkeys.pgp.net --recv 0BC7BEC479FC1F8A
 +
# gpg2 --export --armor 0BC7BEC479FC1F8A > /etc/pki/rpm-gpg/RPM-GPG-KEY-meego
 +
Install mic2:
 +
# yum install mic2
 +
* on MeeGo
 +
sudo zypper addrepo http://repo.meego.com/MeeGo/tools/repos/meego/1.1/ meego-tools
 +
sudo zypper refresh
 +
sudo zypper install mic2
 +
* on Ubuntu or Debian:
 +
For Ubuntu 10.10, add the below line to /etc/apt/sources.list
 +
deb http://repo.meego.com/MeeGo/tools/repos/ubuntu/10.10/ /
 +
For Debian 5.0, add the below line to /etc/apt/sources.list
 +
deb http://repo.meego.com/MeeGo/tools/repos/debian/5.0/ /
 +
Install mic2:
 +
$sudo apt-get update
 +
$sudo apt-get install mic2
 +
* Download MIC source from Gitorious:
 +
http://meego.gitorious.org/meego-developer-tools/image-creator
-
Moblin Image Creator is the tool we use to create MeeGo images.  To get it you can:
+
More on installation dependencies and options on downloading MIC, go to the 'Installation' section here: [[Image_Creation#Installation_Requirements]]
-
- Download the MIC binary rpm for your distro: http://download.meego.com/tools
+
===STEP 2 - Get MeeGo .ks File===
-
More options on downloading MIC are in the 'Installation' section here: [[Image_Creation]]
+
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.
-
'''STEP 2 - Get MeeGo .ks File'''
+
The official MeeGo .ks files are here:
-
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.
+
Formal release: http://repo.meego.com/MeeGo/releases/1.2.0/builddata/image-configs/
-
The official MeeGo .ks files are here: http://repo.meego.com/trunk/repo/ia32/os/image-config/
+
Weekly build: http://repo.meego.com/MeeGo/builds/trunk/latest/builddata/image-configs/
-
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.  
+
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
+
For details about how to modify the ks file, please refer: http://wiki.meego.com/Image_Configurations_-_KickStart_Files
-
'''STEP 3 - Create MeeGo Livecd Image'''
+
===STEP 3 - Create MeeGo Livecd Image===
MIC has to be run with root privileges using 'sudo'.
MIC has to be run with root privileges using 'sudo'.
Line 28: Line 64:
<pre>
<pre>
-
sudo moblin-image-creator --config=default.ks --format=livecd --cache=mycache
+
sudo mic-image-creator --config=default.ks --format=livecd --cache=mycache
</pre>
</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.  
+
A file named meego-1.2-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'''
+
===STEP 4 - Create MeeGo LiveUSB Image===
To create a MeeGo liveusb image that you can transfer to a USB stick.
To create a MeeGo liveusb image that you can transfer to a USB stick.
<pre>
<pre>
-
sudo moblin-image-creator --config=default.ks --format=liveusb --cache=mycache
+
sudo mic-image-creator --config=default.ks --format=liveusb --cache=mycache
</pre>
</pre>
-
A file named meego-1.0-default-XX.usbimg will be created. To burn it onto a USB stick, run the following command:
+
A file named meego-1.2-default-XX.usbimg will be created. To burn it onto a USB stick, run the following command:
<pre>
<pre>
-
sudo moblin-image-writer meego-1.0-default-XX.usbimg
+
sudo mic-image-writer meego-1.2-default-XX.usbimg
</pre>
</pre>
-
This image has a FAT file system and can be mounted easily on Windows and other OSes.  
+
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 ==
-
= Configure Proxy and Other Variables =
+
~/.mic2.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.
-
~/.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.conf
-
 
+
-
Copy and paste this into a file called:  ~/.mic2_site.conf
+
Replace with your own relevant values.
Replace with your own relevant values.
Line 81: Line 115:
'''---FOR ADDITIONAL INFORMATION ON MIC, PLEASE VISIT THE MIC DEVELOPER'S GUIDE HERE: [[Image_Creation]]---'''
'''---FOR ADDITIONAL INFORMATION ON MIC, PLEASE VISIT THE MIC DEVELOPER'S GUIDE HERE: [[Image_Creation]]---'''
 +
 +
 +
Another language version of this page
 +
 +
* [[适合新手的镜像制作-_-简体中文]]

Latest revision as of 14:26, 8 July 2011

MeeGo Image Creator is the tool we use to create MeeGo images. Here are the simple steps on how to create a MeeGo image. For more in-depth information, go to the main Image Creator developer's guide: Image Creation

Contents

Creating a MeeGo Image

STEP 1 - Install Meego Image Creator (MIC)

To install it:

  • on OpenSuse
sudo zypper addrepo http://repo.meego.com/MeeGo/tools/repos/opensuse/11.4/ meego-tools
sudo zypper refresh
sudo zypper install mic2
  • on Fedora

add repo like this:

# cat <<REPO > /etc/yum.repos.d/meego-tools.repo
[meego-tools]
name=MeeGo Tools for Fedora
baseurl=http://repo.meego.com/MeeGo/tools/repos/fedora/\$releasever
enabled=1
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-meego
REPO

add gpg key:

# gpg2 --keyserver subkeys.pgp.net --recv 0BC7BEC479FC1F8A
# gpg2 --export --armor 0BC7BEC479FC1F8A > /etc/pki/rpm-gpg/RPM-GPG-KEY-meego

Install mic2:

# yum install mic2
  • on MeeGo
sudo zypper addrepo http://repo.meego.com/MeeGo/tools/repos/meego/1.1/ meego-tools
sudo zypper refresh
sudo zypper install mic2
  • on Ubuntu or Debian:

For Ubuntu 10.10, add the below line to /etc/apt/sources.list

deb http://repo.meego.com/MeeGo/tools/repos/ubuntu/10.10/ /

For Debian 5.0, add the below line to /etc/apt/sources.list

deb http://repo.meego.com/MeeGo/tools/repos/debian/5.0/ /

Install mic2:

$sudo apt-get update
$sudo apt-get install mic2
  • Download MIC source from Gitorious:

http://meego.gitorious.org/meego-developer-tools/image-creator

More on installation dependencies and options on downloading MIC, go to the 'Installation' section here: Image_Creation#Installation_Requirements

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:

Formal release: http://repo.meego.com/MeeGo/releases/1.2.0/builddata/image-configs/

Weekly build: http://repo.meego.com/MeeGo/builds/trunk/latest/builddata/image-configs/

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.

For details about how to modify the ks file, please refer: http://wiki.meego.com/Image_Configurations_-_KickStart_Files

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 mic-image-creator --config=default.ks --format=livecd --cache=mycache

A file named meego-1.2-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 mic-image-creator --config=default.ks --format=liveusb --cache=mycache

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

sudo mic-image-writer meego-1.2-default-XX.usbimg

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

Configure Proxy and Other Variables

~/.mic2.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.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---


Another language version of this page

Personal tools