Installation

Variables

• $prefix: root of minitage
• $ins: root of a project inside minitage

Buildout Configuration

To store all downloaded stuff in the same place, you ll need to set buildout to do so.

mkdir -p ~/.buildout/downloads
cat << EOF > ~/.buildout/default.cfg
[buildout]
download-directory = $HOME/.buildout/downloads
download-cache = $HOME/.buildout/downloads
EOF

System Requirements

Minitage requires a complete toolchain to build softwares from the c compiler to the autotools.

if you need something that must be compiled, you must have some requirements installed like :

• m4

• A c compiler (gcc ?)

• pkg-config

• autotools

  • automake
  • autoconf

• libtool if your platform supports it

• groff

• man-db, man utils, whatever your system core man packages are

Debian/Ubuntu

Prior to begin with the project, ensure those dependencies are installed on your system :

• m4

• build-essential

• pkg-config

• automake

• libtool

• autoconf

  apt-get install build-essential m4 libtool pkg-config autoconf gettext bzip2 groff man-db automake
  

FreeBSD

• gmake

• gsed

  cd /usr/ports/sysutils/portinstall
  make install clean
  for i in gsed gmake autotools autoconf;do portinstall $i;done
  

Gentoo

Gentoo is perfect by default, no requirement.

Suze

Prior to begin with the project, ensure those dependencies are installed on your system:

• toolchain (gcc, autotools, m4)

Fedora

Prior to begin with the project, ensure those dependencies are installed on your system:

This one liner can help you

yum install automake autoconf libtool wget gcc-c++ patch

MacOS X

Before starting with the project, be sure that these dependencies are installed via macports (http://macports.org) on your system :

• bzip2
• gnu tar (gtar)
• unzip
• binutils
• sed (gsed)
• gnu make (gmake)
• autoconf
• automake
• m4

Do not forget to update your bash profile to take your installed ports into account

# put this line into ~/.bashrc and ~/.bash_profile
export PATH=/opt/local/bin:/opt/local/sbin:$PATH

Python

Existing python

You need a python with distribute, zlib, bz2 and ssl support.

Try that in your interpretery

>>> import tarfile
>>> import zipfile
>>> import bz2
>>> import _ssl
>>> import zlib
>>> import setuptools
>>>

Tip: If you do not want to use a custom compiled python, be sure to have installed python with it’s “dev” packages and with distribute and virtualenv. On Debian systems, for example, you can use the following snippet:

apt-get install python-dev python

PyBootstrapper

Goal

This utility deploys for you a nicely python with all its dependencies in a prefix of your choice.

This script will install for you:

• Python-2.5.2 (default) or Python-2.4.5

• openssl 0.9.7

• zlib-1.2.3

• bzip2-1.0.4

• ncurses-5.6

• readlines-5.2

• ez_setup.py which will install those python packages:

  • distribute
  • zc.buildout
  • PasteScripts
  • virtualenv

Variables

• We will use some variables to refer to well known places and scripts.

• Just adjust the following code to fit to your needs and type it in your current shell/

  export prefix=$HOME/minitage
  export python=$HOME/tools/python
  

Usage

• Please use a FULL path with this script!

  mkdir -p $python
  cd $python
  wget http://git.minitage.org/git/minitage/shell/plain/PyBootstrapper.sh
  bash ./PyBootstrapper.sh $python
  

offline mode

• Please use a FULL path with this script!

• You can use it in offline mode but put the archives in your $python/downloads eg:

  ln -s /prod/1.0/downloads  $python/downloads
  bash ./PyBootstrapper.sh  -o $python
  

Using virtualenv

You have to use virtualenv, minitage fits well with it and requires now distribute to run.

virtualenv is a tool that allow you to create isolated Python environments.

Here is how to set up an environment with it:

• Only if you do not have used the bootstrap script, you must install virtualenv:

  # maybe sudo ?
  wget  http://python-distribute.org/distribute_setup.py
  python distribute_setup.py
  easy_install -U virtualenv # remove also any other virtualenv installation

• Install the minitage prefix, this is just a new virtualenv creation:

  $python/bin/virtualenv --no-site-packages --distribute $prefix
  # maybe that if you do not used the bootstrapper
  # virtualenv --no-site-packages --distribute $prefix

• activate it:

  source $prefix/bin/activate

KEEP IN MIND THAT YOU MUST ACTIVATE VIRTUALENV AT ANY TIME YOU USE IT.

Installing minitage

A stable version

Minitage is a classical python egg, you can get it throught easy_install (DISTRIBUTE).

To install minitage in a stable version, follow those steps:

• Install minitage

  source $prefix/bin/activate
  easy_install -U minitage.core
  

• Sync its packages (all its minilays in minitage terminology).

  This will initiate also all the minitage directories for the first run.

  source $prefix/bin/activate
  minimerge -s
  

Using minitage

Those are usage samples... You have not to run that if you do not need to ;)

Install python-xxx

source $prefix/bin/activate
minimerge python-xxx

Install a custom minilay

# get the project minilay
# minitage is aware of the MINILAYS environnment variable, you can use it to specify space separated minlays
scm CHECKOUT  https://subversion.foo.net/YOURPROJECT/minilay/trunk $prefix/minilays/YOURPROJECTMINILAY

Deploy a project with minitage

# get the project minilay
# minitage is aware of the MINILAYS environnment variable, you can use it to specify space separated minlays
scm CHECKOUT  https://subversion.foo.net/YOURPROJECT/minilay/trunk $prefix/minilays/YOURPROJECTMINILAY
# minimerging it
source $prefix/bin/activate
minimerge project

Extra options and usage

source $prefix/bin/activate
minimerge  --help