Herramienta Páginas amarillas Manual de Instalación Mayo 2013
Herramienta Páginas amarillas - Manual de Instalación Índice 1.Introducción... 3 2.Instalación... 4 2.1.Sistema Operativo... 4 2.2.Componentes base... 4 2.3.Paquetes debian... 4 2.4.Gemas Ruby... 5 2.5.Instalación de la aplicación Páginas amarillas...6 3.Configuración... 7 3.1.Configuración del servidor web Apache...7 4.Anexo 1: Gestión de gemas ruby...8 4.1.rvm (Ruby Version Manager)...8 4.2.Ruby... 8 4.3.Gemsets... 8 2
Herramienta Páginas amarillas - Manual de Instalación 1. Introducción Este documento describe la instalación de la herramienta Páginas amarillas, en lo referente a la parte de servidor. En relación a la parte cliente, el único requisito es disponer de un navegador web. Algunas convenciones empleadas a lo largo del documento son: Una línea que empieza por "$" indica el prompt en consola bash (o semejante) de usuario no root. Una línea que empieza por "#" indica el prompt en consola bash (o semejante) de usuario root. Otra posibilidad sería lanzar los comandos correspondientes mediante sudo. Una línea que empieza por "sql>" indica el prompt en la consola de SQLite. 3
Herramienta Páginas amarillas - Manual de Instalación 2. Instalación 2.1. Sistema Operativo Se parte de que está instalado alguno de los siguientes: Debian 7.0 (Wheezy) Ubuntu 13.04 (Raring) Preferentemente se estará usando la versión de 64 bits. 2.2. Componentes base Los distintos componentes software se instalan mediante estas dos herramientas de gestión de software, con los formatos respectivos de paquetización: a) Gestor dpkg y paquetes Debian (o, en su caso, Ubuntu). En los distintos pasos donde se solicite la instalación de paquetes debian, el comando correspondiente es: # apt-get install paquete1 paquete2... b) Gestor Ruby Gems de gemas Ruby. En algunos casos, una gema puede estar también disponible como paquete Debian. Ej. al instalar libapache2-mod-passenger se instala la gema rack. Ambos sistemas parten de la existencia de repositorios de paquetes en internet, los cuales son accedidos para hacer instalaciones locales. Cabría hablar de un tercer modo de instalación mediante plugins de Rails, pero la instalación es obvia ya que simplemente es copiar ficheros, y no hay ningún tipo de dependencias como en el caso de las gemas. 2.3. Paquetes debian Instalar los paquetes debian necesarios mediante el comando: # apt-get install sqlite3 apache2 \ ruby ruby-dev rubygems \ rake ri \ libruby \ libapache2-mod-passenger 4
Herramienta Páginas amarillas - Manual de Instalación 2.4. Gemas Ruby Para instalar el entorno rails, basta con instalar la gema correspondiente. Como el desarrollo específico se ha hecho para la versión 3.2.13, el comando es: # gem install rails -v=3.2.13 En cualquier caso, otra posibilidad es hacer desde la carpeta donde está la aplicación y el fichero Gemfile: # gem install bundle # bundle install Automáticamente se instalan otras gemas asociadas al entorno, concretamente: rails: entorno global. rake: utilidad semejante al make clásico, que mediante ficheros con extensión.rake y ficheros Rakefile lleva a cabo tareas. actionmailer: envío de correos electrónicos mediante modelos y vistas. actionpack, activerecord: para MVC y ORM activeresource: servicios web activesupport: extensiones de librerías estándar y clases para Rails. 5
2.5. Instalación de la aplicación Páginas amarillas Herramienta Páginas amarillas - Manual de Instalación 1. Copiar los ficheros desde el CD a una carpeta cualquiera, ej. /var/www/paginas_amarillas/ 2. Instalar las gemas necesarias: $ cd /var/www/paginas_amarillas/ $ gem install bundle $ bundle install 3. Crear, migrar y seed de la base de datos de producción y precompilar assets (imágenes, css, sass, coffeescript, javascript) $ cd /var/www/ejemplo.com/ $ RAILS_ENV=production rake db:create $ RAILS_ENV=production rake db:migrate $ RAILS_ENV=production rake db:seed $ RAILS_ENV=production rake assets:precompile 6
3. Configuración 3.1. Configuración del servidor web Apache Herramienta Páginas amarillas - Manual de Instalación Para el acceso web a la aplicación, es necesario crear un host virtual para la aplicación. Según sea desarrollo o producción se usará RackEnv development o RackEnv production, y siendo ej. /etc/apache2/sites-available/paginas_amarillas <VirtualHost *:80> ServerAdmin admin@paginasamarillas.com ServerName paginasamarillas.com ServerAlias www.paginasamarillas.com DocumentRoot /var/www/paginas_amarillas/public/ ErrorLog /var/www/paginas_amarillas/logs/error.log CustomLog /var/www/paginas_amarillas/logs/access.log combined RackEnv production </VirtualHost> Después para habilitar el virtualhost: # a2ensite paginas_amarillas # service apache2 reload 7
4. Anexo 1: Gestión de gemas ruby 4.1. rvm (Ruby Version Manager) Herramienta Páginas amarillas - Manual de Instalación Seguir las instrucciones de https://rvm.io/rvm/install/ (detalle importante: instalar rvm como usuario y no como root, ya que todo resulta más sencillo). En monousuario (en $HOME/.rvm) curl -L get.rvm.io bash -s stable source ~/.rvm/scripts/rvm En multiusuario (en /usr/local/rvm): Común curl -L get.rvm.io sudo bash -s stable ## Añadir a los usuarios al grupo rvm y hacer logout, login source /etc/profile.d/rvm.sh rvm requirements Ver http://cheat.errtheblog.com/s/rvm 4.2. Ruby 4.3. Gemsets rvm install 1.9.3 # Versión 1.9.3 de Ruby rvm gemset create nombreentorno rvm reload source rvm gemset use nombreentorno 8