INSTALL.md

___
## INSTALACIÓN
___

Prerrequisitos
--------------

La siguiente instalación y configuración realizado en Sistema Operativo
Debian Jessie

**Creacion de Usuario en Sistema Operativo**

``` {.sourceCode .sh}
$ sudo adduser usuario_proyecto
```

**Agregar Usuario al grupo sudo del Sistema Operativo**

``` {.sourceCode .sh}
$ sudo adduser usuario_proyecto sudo
```

**Instalando GIT**

Git (pronunciado “guit” ) es un software de control de versiones
diseñado por Linus Torvalds, pensando en la eficiencia y la
confiabilidad del mantenimiento de versiones de aplicaciones cuando
éstas tienen un gran número de archivos de código fuente.

Para la instalación realizar:

``` {.sourceCode .sh}
$ sudo apt-get install git
```

**Instalando nodejs y npm**

Node.js es un entorno de desarrollo basado en JavaScript que permite la
ejecución de servicios y eventos del lado del servidor. Existen
múltiples librerías que podríamos incorporar a Node,js, esto lo haremos
a través de su administrador **NPM**.

**Instalar Curl**

Durante el proceso de instalación necesitaremos este binario.

``` {.sourceCode .sh}
$ sudo apt-get install curl
```

**Añadiendo los repositorios de NodeSource**

Para añadir los repositorios de node.js version 4.x debemos de ejecutar:

``` {.sourceCode .sh}
$ sudo curl -sL https://deb.nodesource.com/setup_4.x | sudo -E bash -
```

**Instalando Node.js**

Ahora realizaremos la instalación de node v4.4.0

``` {.sourceCode .sh}
$ sudo apt-get install -y nodejs
```

**Instalando NPM**

npm(node package manager) es el gestor de paquetes de Node.js, nos
permitira descargar librerias y enlazarlas.

Antes debemos de hacer la instalación de paquetes necesarios para un
copilado correcto.

``` {.sourceCode .sh}
$ sudo apt-get install build-essential
```

Debemos de seguir de la siguiente manera:

``` {.sourceCode .sh}
$ git clone http://github.com/isaacs/npm.git
$ cd npm
$ sudo make install
```

Para verificar si esta instalado correctamente:

``` {.sourceCode .sh}
$ npm info
```

**Instalando Gruntjs**

Un manejador de tareas, permite minimización, compilación, pruebas
unitarias, y mucho más.

``` {.sourceCode .sh}
$ sudo npm install -g grunt-cli
```
Backend-End
===========

**Instalando SASS**

``` {.sourceCode .sh}
$ sudo gem install sass
```

**Instalando PostgreSQL**

PostgreSQL es un potente sistema de base de datos objeto-relacional de
código abierto.

-   Instalación

``` {.sourceCode .sh}
$ sudo apt-get install postgresql postgresql-client postgresql-contrib
```

-   Configuración

Para poder realizar operaciones relacionadas con

``` {.sourceCode .sql}
PostgreSQL: >
$ sudo su - postgres
```

Creando usuario para el sistema:

``` {.sourceCode .sql}
postgres=# CREATE USER usuarioPersonal PASSWORD 'password';
```

Cambiando privilegios de usuario:

``` {.sourceCode .sql}
postgres=# ALTER ROLE usuarioPersonal WITH SUPERUSER;
```

Creando la Base de Datos para el sistema

``` {.sourceCode .sql}
postgres=# CREATE DATABASE moduloPersonalDb WITH OWNER usuarioPersonal;
```

**Clonar repositorio**

``` {.sourceCode .sh}
$ sudo su - usuario_proyecto
$ cd ~
$ git clone git@gitlab.geo.gob.bo:SistemaGestionAdministrativa/ModuloPersonal.git
$ cd ModuloPersonal
```

Para instalar las dependencias del servidor

``` {.sourceCode .sh}
$ npm install
```

Para iniciar el servidor de desarrollo en el puerto 9000

``` {.sourceCode .sh}
$ grunt serve
```

Front-End
=========

**Instalando BOWER**

Bower te permite administrar los componentes que contienen HTML, CSS,
JavaScript, fuentes e incluso archivos de imagen. Bower no concatenar o
minify código o hacer cualquier otra cosa - sólo instala las versiones
correctas de los paquetes que necesita y sus dependencias.

``` {.sourceCode .sh}
$ npm install -g bower
```

**Instalando Ruby**

Un lenguaje de programación dinámico y de código abierto.

``` {.sourceCode .sh}
$ sudo apt-get install ruby-full
```

**Clonar repositorio**

``` {.sourceCode .sh}
$ sudo su - usuarioPersonal
$ cd ~
$ git clone git@gitlab.geo.gob.bo:SistemaGestionAdministrativa/ModuloPersonalCliente.git
$ cd ModuloPersonal
```

Para instalar las dependencias del servidor

``` {.sourceCode .sh}
$ npm install
```

Para ara instalar las dependecias del cliente

``` {.sourceCode .sh}
$ bower install
```

Para iniciar el servidor de desarrollo en el puerto 9000

``` {.sourceCode .sh}
$ grunt serve
```

Servidor NGinx
==============

Servidor nginx (pronunciado en inglés “engine X”) es un servidor
web/proxy inverso ligero de alto rendimiento, optimizado para
aplicaciones Node.js.

A continuación, instalar Nginx

``` {.sourceCode .sh}
$ sudo apt-get install nginx
```

Ahora abre el archivo de configuración del bloque servidor por defecto
para la edición:

``` {.sourceCode .sh}
$ sudo nano /etc/nginx/sites-available/default
```

Insertar la siguiente configuración. Asegúrese de sustituir su propio
nombre de dominio para el server (o la dirección IP si usted no tiene un
dominio configurado), y la aplicación dirección IP-Privada del servidor
para el APP\_PRIVATE\_IP\_ADDRESS . Además, cambiar el puerto ( 9000 )
si la aplicación está configurado para escuchar en un puerto diferente:

``` {.sourceCode .sh}
server {
    listen 80;

    server_name sitio-de-prueba.gob.bo;

    location / {
        proxy_pass http://APP_PRIVATE_IP_ADDRESS:9000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}
```

Una vez que haya terminado de añadir los bloques de localización para
sus aplicaciones, guardar y salir. En el servidor, reiniciar Nginx:

``` {.sourceCode .sh}
$ sudo /et c/init.d/nginx restart
```

Esto configura la web del servidor para responder a las solicitudes en
su raíz. Suponiendo que nuestro servidor está disponible en example.com,
el acceso a <http://sitio-de-prueba.gob.bo/> a través de un navegador
web que enviar la solicitud a la dirección IP privada del servidor de
aplicaciones en el puerto 9000 , que se recibió y respondió a la Node.js
solicitud.