Instal·lació¶
En aquest apartat s’indiquen totes les passes per tal de posar en marxa una instància de tota la pila de software i serveis necessaris per al funcionament d’una instància del servei MAX.
Requisits¶
Cal satisfer una sèrie de requisits previs que es detallen a continuació.
Sistema operatiu¶
Actualment, degut a limitacions tecnològiques, el entorn del projecte només pot executar-se sobre màquines *nix. En aquests documents suposarem una màquina basada en una distribució Ubuntu Linux 11.04 (Natty). Per la instal·lació per altres distribucions cal substituïr els noms dels paquets pels corresponents a la distribució d’instal·lació.
Software base i llibreries:
GCC i eines de compilació Python 2.7 (altres versions inferiors no són compatibles, mentre que superiors (>3) no han estat testades) Python Distribute (a.k.a setuptools) Git Erlang, xsltproc, zip (per la compilació del motor de cues)
Instal·lació de software base i llibreries¶
Presuposem que instal·lem el MAX i el software relacionat amb ell en la carpeta /var/pyramid:
$ mkdir /var/pyramid
$ cd /var/pyramid
Instal·lem els següents paquets base:
$ sudo apt-get install wget build-essential git-core
Instal·lació de Python 2.7 (compilat), es recomana compilar-lo per partir d’una copia neta i sense llibreries de sistema innecessàries. Seguirem aquestes comandes per instal·lar-lo:
$ sudo apt-get install libreadline5-dev libsqlite3-dev zlib1g-dev libbz2-dev
$ wget http://python.org/ftp/python/2.7.2/Python-2.7.2.tgz
$ tar xvfz Python-2.7.2.tgz
$ cd Python-2.7.2
$ ./configure --prefix=/var/pyramid/python2.7
$ make
$ make install
Instal·lació de Python Distribute:
$ wget http://python-distribute.org/distribute_setup.py
$ sudo python2.7 distribute_setup.py
Instal·lació de Erlang i llibreries:
$ sudo apt-get install erlang xsltproc zip
Instal·lació de llibreries accés LDAP¶
És necessari les últimes llibreries de OpenLDAP de les distribucions corresponents, en cas d’Ubuntu:
$ apt-get install libsasl2-dev libldap2-dev libssl-dev
Instal·lació de MAX¶
El MAX utilitza un sistema de montatge (descàrrega, compilació i configuració) automàtic anomenat zc.buildout.
Aquest sistema utilitza un fitxer (buildout.cfg) de configuració que conté tota la informació necessària per a construir un entorn de MAX complet i configurat.
Per començar ens baixarem de Github el codi executant la següent ordre:
$ git clone git://github.com/UPCnet/maxserver.git
Fet això, ens ha d’haver creat un nou directori maxserver. Accedim a ell:
$ cd maxserver
Executem el muntatge amb aquestes ordres:
$ /var/pyramid/python2.7/bin/python bootstrap.py
$ ./bin/buildout
Esperem fins a que finalitzi. Un cop finalitzat, tindrem tots els serveis llestos per ser arrencats.