Metro Quick Start Tutorial - Revision history

Oleg: /* Step 0: Optional Quick Copy of Portage Tree */

2013-05-10T04:08:11Z

‎Step 0: Optional Quick Copy of Portage Tree

Oleg: /* Installing Metro */

2013-05-10T04:06:59Z

‎Installing Metro

Oleg: /* Installing Metro */

2013-05-10T04:06:08Z

‎Installing Metro

Oleg: /* How Metro Works */

2013-02-01T10:24:48Z

‎How Metro Works

Drobbins: /* Step 3: The next build */

2012-11-26T02:55:57Z

‎Step 3: The next build

Oleg: /* Installing Metro */

2012-10-14T05:32:20Z

‎Installing Metro

216.31.88.193: /* Building for another binary compatible architecture (remote build) */

2012-06-04T06:15:19Z

‎Building for another binary compatible architecture (remote build)

67.177.185.151: /* Configuring Metro */

2012-05-15T08:08:14Z

‎Configuring Metro

67.177.185.151: /* Installing Metro */

2012-05-15T08:06:14Z

‎Installing Metro

67.177.185.151: /* Local Build */

2012-05-15T08:03:29Z

‎Local Build

@@ Line 117: / Line 117: @@
 # cat /root/git/metro/etc/builds/funtoo-current/build.conf  | grep name
 name: portage-mini-2011
-# cp -a /usr/portage /var/tmp/metro/cache/cloned-repositories/portage-mini-2011
+# cp -a /usr/portage /var/tmp/metro/cache/cloned-repositories/ports-2012
 # cd /usr/portage; git checkout funtoo.org
 </pre>

@@ Line 43: / Line 43: @@
 </pre>
-Then ensure that <tt>dev-vcs/git</tt> is installed on your system:
+Then ensure that <tt>dev-vcs/git</tt> and <tt>dev-python/boto</tt> installed on your system:
 <pre>

@@ Line 47: / Line 47: @@
 <pre>
 (~) # emerge dev-vcs/git
 </pre>

← Older revision		Revision as of 10:24, 1 February 2013
Line 10:		Line 10:

	[[Metro]] can use two kinds of seed stages. Traditionally, [[Metro]] has used a stage3 as a seed stage. This stage3 is then used to build a new stage1, which in turn is used to build a new stage2, and then a new stage3. This is generally the most reliable way to build [[Gentoo Linux]] or [[Funtoo Linux]], so it's the recommended approach.		[[Metro]] can use two kinds of seed stages. Traditionally, [[Metro]] has used a stage3 as a seed stage. This stage3 is then used to build a new stage1, which in turn is used to build a new stage2, and then a new stage3. This is generally the most reliable way to build [[Gentoo Linux]] or [[Funtoo Linux]], so it's the recommended approach.
		+	{{fancyimportant\|'''After switching metro builds to Funtoo profile, Gentoo stages are no longer provided'''!}}

	== Seeds and Build Isolation ==		== Seeds and Build Isolation ==

@@ Line 156: / Line 156: @@
 == Step 3: The next build ==
-At this point, you now have a new pentium4 stage3. If you'd like, you can reconfigure Metro to use the most recently-built pentium stage3 as a seed for any pentium4 builds. To do this, simply type:
+At this point, you now have a new pentium4 stage3. If you'd like, you can reconfigure Metro to use the most recently-built pentium4 stage3 as a seed for any pentium4 builds. To do this, simply type:
 <pre>(~) # echo &quot;local&quot; &gt; /home/mirror/linux/funtoo-current/x86-32bit/pentium4/.control/strategy/build</pre>

@@ Line 53: / Line 53: @@
 (~) # install -d /root/git
 (~) # cd /root/git
-(~/git) # git clone https://github.com/funtoo/metro.git
+(~/git) # git clone git://github.com/funtoo/metro.git
 (~/git) # ln -s /root/git/metro /usr/lib/metro
 (~/git) # ln -s /root/git/metro/metro /usr/bin/metro

@@ Line 166: / Line 166: @@
 In the Metro terminology this is called a '''remote build''' (a stage 3 of a different, but binary compatible, architecture is used as a seed).
-What's not compatible? You can't use a <tt>Sparc</tt> architecture to generate an <tt>x86</tt> or <tt>ARM</tt> based stage and vice-verse. If you use a 32bit stage then you don't want to seed a 64bit build from it. Be sure that you are using a stage from the same architecture that you are trying to seed. Check [http://ftp.osuosl.org/pub/funtoo/funtoo-current/ Funtoo-current FTP Mirror] for a stage that is from the same Architecture that you will be building.
+What's not compatible? You can't use a <tt>Sparc</tt> architecture to generate an <tt>x86</tt> or <tt>ARM</tt> based stage and vice-versa. If you use a 32bit stage then you don't want to seed a 64bit build from it. Be sure that you are using a stage from the same architecture that you are trying to seed. Check [http://ftp.osuosl.org/pub/funtoo/funtoo-current/ Funtoo-current FTP Mirror] for a stage that is from the same Architecture that you will be building.
 == Step 1: Set up Core_2 32bit repository ==

@@ Line 63: / Line 63: @@
 = Configuring Metro =
-[[User:Drobbins|Daniel Robbins]] maintains [[Metro]], so it comes pre-configured to successfully build both [[Gentoo Linux]] and [[Funtoo Linux]] releases. Before reading farther, you might want to customize some basic settings like the number of concurrent jobs to fits your hardware capabilities or the directory to use for produced stage archives. This is accomplished by editing <tt>/root/git/metro/etc/metro.conf</tt> which is the [[Metro]]'s master configuration file. The <tt>[path/mirror]</tt> section defines where [[Metro]] will look for things it needs and also dump things it creates. As initially configured, [[Metro]] is set up to build [[Funtoo Linux]] and [[Gentoo Linux]] stage tarballs and place them in the <tt>/home/mirror/linux</tt> directory:
+[[User:Drobbins|Daniel Robbins]] maintains [[Metro]], so it comes pre-configured to successfully build both [[Gentoo Linux]] and [[Funtoo Linux]] releases. Before reading farther, you might want to customize some basic settings like the number of concurrent jobs to fit your hardware's capabilities or the directory to use for produced stage archives. This is accomplished by editing <tt>/root/git/metro/etc/metro.conf</tt> which is the [[Metro]]'s master configuration file. The <tt>[path/mirror]</tt> section defines where [[Metro]] will look for things it needs and also dump things it creates. As initially configured, [[Metro]] is set up to build [[Funtoo Linux]] and [[Gentoo Linux]] stage tarballs and place them in the <tt>/home/mirror/linux</tt> directory:
 <pre>
@@ Line 100: / Line 100: @@
 </pre>
 For an example list of Architectures, take a look at the directory listing on the [http://ftp.osuosl.org/pub/funtoo/funtoo-current/ Funtoo-Current Mirror].
 = First stages build (local build) =

@@ Line 36: / Line 36: @@
 = Installing Metro =
-Today the '''recommended and supported method''' is to use the Git repository of [[Metro]].  First ensure remove the <tt>dev-util/metro</tt> package if you had installed it:
+Today the '''recommended and supported method''' is to use the Git repository of [[Metro]].  First ensure you remove the <tt>dev-util/metro</tt> package if you had installed it:
 <pre>

@@ Line 19: / Line 19: @@
 Say you wanted to build a new <tt>pentium4</tt> stage3 tarball. The recommended method of doing this would be to grab an existing <tt>pentium4</tt> stage3 tarball to use as your seed stage. [[Metro]] will be told to use this existing <tt>pentium4</tt> stage3 to build a new stage1 for the same <tt>pentium4</tt>. For this process, the generic <tt>pentium4</tt> stage3 would provide the ''build environment'' for creating our new stage1. Then, the new stage1 would serve as the build environment for creating the new <tt>pentium4</tt> stage2. And the new <tt>pentium4</tt> stage2 would serve as the build environment for creating the new <tt>pentium4</tt> stage3.
-In the [[Metro]] terminology this is called a '''local build''', which means a stage3 of a a given architecture is used to seed a brand new build of the same architecture. Incidentally this will be the first exercise we are going to perform in this tutorial.
+In the [[Metro]] terminology this is called a '''local build''', which means a stage3 of a given architecture is used to seed a brand new build of the same architecture. Incidentally this will be the first exercise we are going to perform in this tutorial.
 A week later, you may want to build a brand new <tt>pentium4</tt> stage3 tarball. Rather than starting from the original <tt>pentium4</tt> stage3 again, you'd probably configure [[Metro]] to use the most-recently-built <tt>pentium4</tt> stage3 as the seed. [[Metro]] has built-in functionality to make this easy, allowing it to easily find and track the most recent stage3 seed available.
 == Remote Build ==