Meego Wiki
Views

Image Creation For Beginners

From MeeGo wiki
(Difference between revisions)
Jump to: navigation, search
(Creating a MeeGo Image)
(STEP 4 - Create MeeGo LiveUSB Image)
 
(14 intermediate revisions not shown)
Line 1: Line 1:
 +
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__
__TOC__
-
 
== Creating a MeeGo Image ==
== Creating a MeeGo Image ==
-
Here are the simple steps on how to create a MeeGo image.
+
===STEP 1 - Install Meego Image Creator (MIC)===
-
 
+
-
For more in-depth information, go to the main Image Creator developer's guide: [[Image Creation]]
+
-
 
+
-
'''STEP 1 - Download Meego Image Creator (MIC)'''
+
-
 
+
-
MeeGo Image Creator is the tool we use to create MeeGo images.  To get it you can:
+
 +
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:
* Download MIC source from Gitorious:
http://meego.gitorious.org/meego-developer-tools/image-creator
http://meego.gitorious.org/meego-developer-tools/image-creator
-
* Or, for Debian Squeeze, add the following line to /etc/apt/sources.list and install (using apt-get) ''mic2'':
 
-
deb <nowiki>http://repo.meego.com/tools/repo/Debian_5.0/</nowiki> /
 
 +
More on installation dependencies and options on downloading MIC, go to the 'Installation' section here: [[Image_Creation#Installation_Requirements]]
-
More on installation dependencies and options on downloading MIC, go to the 'Installation' section here: [[Image_Creation#Requirements]]
+
===STEP 2 - Get MeeGo .ks File===
-
 
+
-
'''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.
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 for ARM based Nokia N900 are here: http://repo.meego.com/MeeGo/devel/n900/images/
+
The official MeeGo .ks files are here:
-
*The official MeeGo .ks files for Intel Atom based netbook and handset (Moorestown) are here:  http://repo.meego.com/MeeGo/devel/trunk/images/
+
 
 +
Formal release: http://repo.meego.com/MeeGo/releases/1.2.0/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.  
+
Weekly build: http://repo.meego.com/MeeGo/builds/trunk/latest/builddata/image-configs/
-
We will use the netbook kickstart file to create a MeeGo netbook image: http://repo.meego.com/MeeGo/devel/trunk/images/meego-preview-netbook-core.ks
+
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.
-
It seems that the "@Core" and "@Base" have been renamed to "@Meego Core" and "@Meego Base" so i suggest you to edit the .ks file to rename the package with the good name.
+
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 42: Line 67:
</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.
Line 52: Line 77:
</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 mic-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_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.  
+
~/.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_site.conf
+
Copy and paste this into a file called:  ~/.mic2.conf
Replace with your own relevant values.
Replace with your own relevant values.
Line 92: 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