Difference between revisions of "Install a New Overlay"

From NAS-Central Buffalo - The Linkstation Wiki
Jump to: navigation, search
Line 2: Line 2:
  
  
The first thing we need to do is decide where we are going to install our overlay. The standard gentoo location is /usr/
+
The first thing we need to do is decide where we are going to install our overlay. The standard gentoo location is /usr/portage/overlay/ The standard location for portage is /usr/portage/tree/
+
It is important that the overlay not be in the same directory as the portage tree. Placing the overlay in the same directory as the portage tree will cause the overlay to be overwritten the first time you emerge sync. This how-to is based on the standard directories for overlays and the portage tree. For an example of an alternate location please see the gentoo installation guide.
 +
 
 +
The first thing we need to do is define the overlay directory in /etc/make.conf. It can be useful to keep your previous overlay so we place the new overlay in a unique directory that is at the same level as the previous overlay. In this case it is /usr/portage/overlays/20060122. The 20060122 happens to be the date of the new overlay.
  
 
  KURO-BOX-EM #cd /etc  
 
  KURO-BOX-EM #cd /etc  
 
  KURO-BOX-EM etc #nano make.conf  
 
  KURO-BOX-EM etc #nano make.conf  
  
+
Edit the PORTDIR_OVERLAY line to point to the new overlay directory.
CFLAGS="-O2 -mcpu=603e -fno-strict-aliasing -pipe -fsigned-char"
+
CXXFLAGS="${CFLAGS}"
+
+
PORTDIR=/var/portage
+
DISTDIR=/var/distfiles
+
PKGDIR=/var/packages
+
RPMDIR=/var/rpm
+
 
   
 
   
 
  PORTDIR_OVERLAY="/var/overlays/20060122"  
 
  PORTDIR_OVERLAY="/var/overlays/20060122"  
 
   
 
   
RSYNC_EXCLUDEFROM=/etc/portage/rsync_excludes
+
Next we set up the portage profile The file /etc/make.profile is a symbolic link from /etc to the profile in the overlay. You will need to remove the old link.
+
GENTOO_MIRRORS="http://www.gatech.edu/pub/gentoo/ http://ftp.ucsb.edu/pub/mirro..."
+
+
SYNC="rsync://rsync.namerica.gentoo.org/gentoo-portage"
+
  
Next we set up the portage profile
 
 
  KURO-BOX-EM etc #rm make.profile
 
  KURO-BOX-EM etc #rm make.profile
  
Notice the 20060122 in the following line. Change it to the date of your overlay in order to point to the correct directory. The link is the relative diretory from /etc. Notice we have to go up 1 level (../) before going back down the /var part of the tree.  
+
We must replace the link with a new link that points to the overlay. The link is the relative diretory from /etc. Notice we have to go up 1 level (../) from /etc before going back down the /usr part of the directory tree.
  KURO-BOX-EM etc #ln -s ../var/overlays/20060122/profiles/kurobox make.profile  
+
  KURO-BOX-EM kurobox #cd /var/overlays  
+
  KURO-BOX-EM etc #ln -s ../usr/portage/overlays/20060122/profiles/kurobox make.profile  
 +
 
 +
Next we need to let portage know where the overlay is located. we do this with another symbolic link that points from the profile in the overlay to the profile in the official portage tree.
 +
 
 +
  KURO-BOX-EM kurobox #cd /usr/portage/overlays  
  
 
Notice the 20060122 in the following lines. Change it to the date of your overlay in order to point to the correct directory. It is the relative path from the profile in the overlay to the profile in the official portage tree. Each ../ indicates a directory up in the tree. Just count the directories up and then add the path back down.  
 
Notice the 20060122 in the following lines. Change it to the date of your overlay in order to point to the correct directory. It is the relative path from the profile in the overlay to the profile in the official portage tree. Each ../ indicates a directory up in the tree. Just count the directories up and then add the path back down.  
 +
 
  KURO-BOX-EM overlays # echo "../../../../portage/profiles/default-linux/ppc/2005.1/ppc" > 20060122/profiles/kurobox/parent  
 
  KURO-BOX-EM overlays # echo "../../../../portage/profiles/default-linux/ppc/2005.1/ppc" > 20060122/profiles/kurobox/parent  
 
  KURO-BOX-EM overlays #cd /etc  
 
  KURO-BOX-EM overlays #cd /etc  

Revision as of 03:00, 31 March 2006

This article is in progress.


The first thing we need to do is decide where we are going to install our overlay. The standard gentoo location is /usr/portage/overlay/ The standard location for portage is /usr/portage/tree/ It is important that the overlay not be in the same directory as the portage tree. Placing the overlay in the same directory as the portage tree will cause the overlay to be overwritten the first time you emerge sync. This how-to is based on the standard directories for overlays and the portage tree. For an example of an alternate location please see the gentoo installation guide.

The first thing we need to do is define the overlay directory in /etc/make.conf. It can be useful to keep your previous overlay so we place the new overlay in a unique directory that is at the same level as the previous overlay. In this case it is /usr/portage/overlays/20060122. The 20060122 happens to be the date of the new overlay.

KURO-BOX-EM #cd /etc 
KURO-BOX-EM etc #nano make.conf 

Edit the PORTDIR_OVERLAY line to point to the new overlay directory.

PORTDIR_OVERLAY="/var/overlays/20060122" 

Next we set up the portage profile The file /etc/make.profile is a symbolic link from /etc to the profile in the overlay. You will need to remove the old link.

KURO-BOX-EM etc #rm make.profile

We must replace the link with a new link that points to the overlay. The link is the relative diretory from /etc. Notice we have to go up 1 level (../) from /etc before going back down the /usr part of the directory tree.

KURO-BOX-EM etc #ln -s ../usr/portage/overlays/20060122/profiles/kurobox make.profile 

Next we need to let portage know where the overlay is located. we do this with another symbolic link that points from the profile in the overlay to the profile in the official portage tree.

KURO-BOX-EM kurobox #cd /usr/portage/overlays 

Notice the 20060122 in the following lines. Change it to the date of your overlay in order to point to the correct directory. It is the relative path from the profile in the overlay to the profile in the official portage tree. Each ../ indicates a directory up in the tree. Just count the directories up and then add the path back down.

KURO-BOX-EM overlays # echo "../../../../portage/profiles/default-linux/ppc/2005.1/ppc" > 20060122/profiles/kurobox/parent 
KURO-BOX-EM overlays #cd /etc 

Now lets regenerate the portage cache. This would be a good time for a bathroom break or a quick run to the store for a snack.

KURO-BOX-EM etc #emerge metadata 
Updating Portage cache: 100% 
KURO-BOX-EM etc # 

Now we'll check if the system is up to date while at the same time testing portage.

KURO-BOX-EM etc #emerge -puD system