# Manual de Instalacion del "Sistema Seguimiento Proyectos FDI".
## Instalacion en Windows (backend)
### 1. Paquetes requeridos:
| Paquetes | Descripción |
| ---------- | ---------- |
| Node.js | Node.js javascript del lado de servidor, versión LTS 10.24.1
| Postgresql | Base de datos PostgreSQL v10.20 o superior (https://www.enterprisedb.com/downloads/postgres-postgresql-downloads) la version mas estable https://www.youtube.com/watch?v=cHGaDfzJyY4 |
| git | Software para control de versiones (https://git-scm.com/downloads) |
| npm | Manejador de paquetes por defecto para Node.js, versión 3.10.5 ==(viene incluido con instalacion de Nodejs)== |
| nvm | Manejador de versiones de Node.js https://github.com/coreybutler/nvm-windows ==(instalar solo nvm o nodejs)==|
### 2. Instalación de utilitarios y herramientas:
1. _wkhtmltopdf :_ es una herramienta de línea de comandos de código abierto (LGPLv3) para convertir HTML en PDF
- Descargar el programa [wkhtmltopdf](https://wkhtmltopdf.org/downloads.html).
- Luego ir _Configuración en variables de entorno :_
Poner el directorio path de "_wkhtmltopdf_" en las variables entorno del sistema:
```sh
C:\Program Files\wkhtmltopdf\bin
```
1. _postgis :_ es una extensión que convierte el sistema de base de datos PostgreSQL en una base de datos espacial
- Abrir stack Builder y seleccionar la opcion PostgreSQL en la ventana posterior
- Luego seleccionar la opcion postGIS 2.4 Bundle for PostgreSQL 10 y luego siguiente
- luego seleccionar siguiente
- luego aceptar la licencia
- luego seleccionar PostGIS y darle siguiente
- luego darle todo si, y despues finalizar
### 3. Clonación del proyecto
Clonar el proyecto con git clone del repositorio:
```sh
git clone https://gitlab.com/miguelcond/backend_fdi.git
```
### 4. Instalacion de dependencias npm
Instalar dependencias de manera global en cmd(administrador):
C:\Users\ASUS\Desktop\seguimiento-proyectos-backend>
```sh
$ npm install --global sequelize sequelize-cli pg
```
Instalar las dependencias npm en el directorio del proyecto en: C:\Users\ASUS\Desktop\seguimiento-proyectos-backend>
```cmd
$ npm install
```
### 5. Creación de la base de datos
Crear la extension postgis:
+ Ejecutar como administrador ==C:\Program Files\PostgreSQL\10\scripts\runpsql.bat==
```cmd
Server [localhost]:
Database [postgres]:
Port [5432]:
Username [postgres]:
Contraseña para usuario postgres:
psql (10.20)
ADVERTENCIA: El código de página de la consola (850) difiere del código
de página de Windows (1252).
Los caracteres de 8 bits pueden funcionar incorrectamente.
Vea la página de referencia de psql «Notes for Windows users»
para obtener más detalles.
Digite «help» para obtener ayuda.
postgres=#
```
+ Crear un usuario con contraseña para la base de datos :
``` cmd
postgres=# CREATE USER developer WITH PASSWORD '12345';
```
+ Crear la base de datos para developer con todos los privilegios :
``` cmd
postgres=# CREATE DATABASE seguimiento_fdi_test OWNER developer;
```
+ Crear la extension postgis para datos espaciales :
``` cmd
postgres=# CREATE EXTENSION IF NOT EXISTS postgis;
```
+ (opcional) Crear rol de superusuario para usuario :
``` cmd
postgres=# ALTER USER developer WITH SUPERUSER;
```
+ mas comandos psql :
``` sql
postgres=# \l --listar base de datos
postgres=# \du --listar usuarios,roles
postgres=# \c nombrebasedatos --cambiar base de datos
postgres=# \dt --listar tablas
postgres=# \q --salir de psql
```
::: info
>***NOTA*** Si muestra el error :
'No se pudo cargar la biblioteca "C:/Archivos de programa/PostgreSQL/11/lib/rtpostgis-2.5.dll": no se pudo encontrar el módulo especificado'
Simplemente copie estos dos .dlls (" libeay32.dll" y " ssleay32.dll") de bin/postgisgui carpeta y péguelos en la carpeta /bin.
Fuente: https://trac.osgeo.org/postgis/ticket/4482
:::
## Interoperabilidad y configuraciones generales
Replicar archivo de configuración para la conexión a la base de datos.
```sh
cd seguimiento-proyectos-backend
cp src/config/config-example.json src/config/config.json
```
### 1. Conexion con la base de datos
Editar el archivo `src/config/config.json`, modificar las siguientes configuraciones:
``` json
{
"development": {
"username": "nombre de usuario de la base de datos",
"password": "contraseña del usuario de la base de datos",
"database": "nombre de la base de datos",
"host": "127.0.0.1",
"port": 5432,
"dialect": "postgres",
"pool": {
"max": 15,
"min": 0,
"idle": 10000
}
}
}
```
::: info
>**NOTA.-** En caso de poner un host distinto a localhost o 127.0.0.1, tomar en cuenta que debe [configurar postgreSQL para habilitar el acceso a conexiones remotas](http://www.evaristogz.com/instalacion-postgresql-acceso-remoto-externo/).
:::
### 2. Configuración de parámetros del sistema
La configuración se define en el archivo : `src/config/config.js`, debe realizar una copia del archivo de configuración de ejemplo `src/config/config-example.js`.
```sh
cp src/config/config-example.js src/config/config.js
```
Configuracion para localhost:
``` jso
sistema: {
urlBase: 'http://localhost',
apiBase: 'http://localhost:4000',
urlLogin: 'http://localhost:4000/#!/login',
urlLogo: 'http://localhost:4000/imagen/logo-fdi.jpg',
origen: 'SSP <ssp@dominio.gob.bo>',
soporte: ['user@dominio.gob.bo'],
idInstitucion: 2,
},
```
* *urlBase*: Url base del frontend seguimiento de proyectos
* *urlLogin*: Url de la vista de login del sistema de seguimiento de proyectos
* *urlLogo*: Url donde está ubicado el logo de la institución
* *origen*: Nombre del origen de los correos ej. SSP
* *soporte*: Nombre del correo remitente para los correos enviados desde el sistema
### 3. Segip
En el archivo de configuración editar los valores de la siguiente sección.
``` jso
segip: {
url: 'https://interoperabilidad.agetic.gob.bo',
path: '/fake/segip/v2/',
credenciales: {
apikey: '383a0f19857f4dde885271725bdc1f20'
},
tokenKong: 'Bearer <-- solicitar el token a interoperabilidad -->'
},
```
### 4. Envío de Correos
Configuración para envío de correos desde el sistema.
``` jso
correo: {
host: "smtp.dominio.gob.bo",
port: 587,
secure: false,
ignoreTLS: false,
tls: { rejectUnauthorized: false },
auth: {
user: "ejemplo@dominio.gob.bo",
pass: "contraseña-secreta-de-ejemplo"
}
},
```
## Ejecución de aplicación
### Iniciar la aplicación
Las opciones de ejecución son las siguientes:
+ Genera o regenera las tablas necesarias en la base de datos y ejecuta los seeders y migrations para el entorno.
C:\Users\fdi_dj\Desktop\degittt\seguimiento-proyectos-backendev>
```sh
$ npm run winsetup # para desarrollo
$ npm run winsetupwu # para desarrollo
```
+ ejecutar la aplicacion en modo desarrollo
``` sh
$ npm run startdev
```
## Instalacion en Windows (Frontend)
Para una correcta instalación, el servidor backend debe tener las configuraciones previas mencionandos anteriormente. Después recién llevar a cabo los siguientes pasos, que son necesarios para instalar la aplicación.
### 1. Clonación
Ejecutar como administrador ***git bash*** en un directorio vacio
Clonarlo:
**Opción 1:** Si se generó llave SSH: (En los pasos del archivo _SERVER.md d)
```sh
$ git clone git@gitlab.com:miguelcond/frontend_fdi.git
```
**Opción 2:** Si se quiere clonar el proyecto por HTTPS:
```sh
$ git clone https://gitlab.com/miguelcond/frontend_fdi.git
```
Si al descargar el proyecto con HTTPs, nos lance el siguiente error:
```sh
Cloning into 'nombre-del-proyecto'...
fatal: unable to access 'https://url-del-proyecto.git/': server certificate verification failed. CAfile: /etc/ssl/certs/ca-certificates.crt CRLfile: none
```
hacer esto:
```sh
$ git config --global http.sslverify false
$ git clone https://gitlab.com/miguelcond/frontend_fdi.git
```
**Después de clonar con cualquiera de las opciones :**
Ingresar a la carpeta/direcorio de l proyceto:
```sh
$ cd seguimiento-proyectos-frontend
```
Para instalar la aplicación, se tienen las siguientes opciones:
### 2. Instalando dependencias npm (node package module)
escribir en el directorio del proyecto :
```sh
$ npm install
```
### 3. Configurar los datos de conexión a los servicios REST del backend
Toda la configuración para los archivos del frontend se encuentra en el archivo **`config.json.sample`**, su servidor de producción y su servidor de desarrollo con webpack, el mismo se encuentra en la raíz del proyecto.
Copiar dicho archivo y renombrarlo bajo el nombre **`config.json`** en la raiz del proyecto
A continuación se describe la configuración:
`**¡NO OLVIDE REVISAR EL CONTENIDO DEL ARCHIVO, EL SIGUIENTE CONTENIDO ESTÁ PARA MOTIVOS DE EJEMPLO!**`
```js
{
"server": "http://dominio.gob.bo/seguimiento-api",
"timeSessionExpired": 30,
"debug": false,
"onbeforeunload": true,
"port": 3100,
"subDomain": "/seguimiento/",
"portDev": 8880
};
```
- **server**: Servidor del backend donde apunta el frontend
- Ejemplos
- "server": "http://localhost:4000"
- "server": "http://192.168.15.15:4000"
- "server": "http://dominio.gob.bo/proyecto-api"
- **timeSessionExpired**: Tiempo en minutos para que la sesión se cierre automáticamente por inactividad
- **debug**: Habilita los console.log (this.$log.log) para su visualización para producción es necesario deshabilitarlo con: false
- **onbeforeunload**: abre un alerta de confirmación cuando se intente cerrar o actualizar la pestaña del navegador
- **port**: Puerto para el servidor de producción
- **portDev**: Puerto para el servidor de desarrollo con webpack
- **subDomain**: Sub dominio donde iniciará el frontend, por defecto inicia en la raíz de la carpeta dist
- Ejemplos:
- "subDomain": "/"
- "subDomain": "/proyecto/"
## Ejecucion de aplicacion (modo desarrollo)
Para ejecutar en modo desarrollo :
```sh
$ npm start
```
---
## Instalación del proyecto para Producción
Para asegurarse de que se instalen todas las librerías necesarias hay que configurar el ambiente en modo desarrollo.
#### Instalando dependencias npm
```sh
$ npm install
```
### Configurar entorno de producción
#### Crear los archivos minificados
```sh
$ npm run build
```
Verificar si se ha creado la carpeta `dist` y renombrarlo a `produccion`
```sh
$ mv dist produccion
```
#### Instalación de Nginx (Opcion 1)
```sh
$ sudo apt-get update
$ sudo apt-get install nginx
```
Crear un enlace simbólico hacia la carpeta `produccion` en la carpeta raiz del servidor nginx
```sh
sudo ln -s /home/usuario/seguimiento-proyecto-frontend/produccion /var/www/html/proyecto
```
Verificar el enlace
```sh
$ ls -la /var/www/html/
```
Editar el archivo de configuración de sitio por defecto
```
$ sudo nano /etc/nginx/sites-enabled/default
```
Ejemplo de cofiguración para reverse proxy hacia el backend `seguimiento-api` en el mismo servidor
```sh
# Default server configuration
#
server {
listen 80 default_server;
listen [::]:80 default_server;
root /var/www/html;
index index.html index.htm index.nginx-debian.html;
server_name _;
location /seguimiento-api/ {
proxy_pass http://localhost:4000/;
#proxy_redirect off;
#proxy_set_header Host $host;
#proxy_set_header X-Real-IP $remote_addr;
#proxy_set_header X-Forwarded-Proto https;
}
}
```
> Considerar que el nombre del usuario del equipo puede variar.
> Considerar que la ruta real en la que se encuentra la aplicación puede variar.
#### Instalación de Apache2 (Opcion 2)
```sh
$ sudo apt-get update
$ sudo apt-get install apache2
```
Crear un enlace simbólico hacia la carpeta `produccion` en la carpeta raiz del servidor apache2
```sh
sudo ln -s /home/usuario/seguimiento-proyecto-frontend/produccion /var/www/html/seguimiento
```
Verificar el enlace
```sh
$ ls -la /var/www/html/
```
Editar el archivo de configuración de sitio por defecto
```
$ sudo nano /etc/apache2/sites-enabled/default
```
Habilitar los modulos para reverse prosy hacia el backend `seguimiento-api`
```
$ sudo a2enmod proxy
$ sudo a2enmod proxy_http
```
Ejemplo de cofiguración para reverse proxy hacia el backend `seguimiento-api` en el mismo servidor
```sh
# Default server configuration
#
SSLProxyEngine On
SSLProxyCheckPeerCN Off
SSLProxyCheckPeerName Off
SSLProxyCheckPeerExpire Off
ProxyRequests Off
ProxyPreserveHost On
ProxyPass "/seguimiento-api/" "http://localhost:4000/"
ProxyPassReverse "/seguimiento-api/" "http://localhost:4000/"
```
```
$ sudo apache2ctl configtest
```
> Considerar que el nombre del usuario del equipo puede variar.
> Considerar que la ruta real en la que se encuentra la aplicación puede variar.
##### Reconfigurar TimeZone
```
$ sudo dpkg-reconfigure tzdata
```
Seleccionar America/La_Paz
#### Verificar frontend
Para verificar el funcionamiento se debe abrir en el navegador web una de las siguientes URLs
- http://[ip_servidor]/seguimiento/
- http://[dominio.gob.bo]/seguimiento/
Debe mostrar la página de inicio de sesión del sistema
# Instalacion en linux (backend)
Manual de instalación - Sistema de Seguimiento a Proyectos Productivos (backend) para Debian Jessie|Stretch
## Paquetes requeridos
| Paquete | Descripción |
| ---------- | ---------- |
| Node.js | Node.js javascript del lado de servidor, versión LTS 10.24.1
| Postgresql | Base de datos PostgreSQL v9.4 o superior |
| git | Software para control de versiones |
| npm | Manejador de paquetes por defecto para Node.js, versión 3.10.5 |
| nvm | Manejador de versiones de Node.js |
## Instalación de utilitarios y herramientas
```sh
sudo apt-get install build-essential
sudo apt-get install curl wget git make
```
## Instalación de programas externos.
### wkhtmltopdf (ubuntu,linuxlite)
```
sudo apt install wkhtmltopdf
```
### wkhtmltopdf (Jessie)
Instalar paquetes requeridos para `wkhtmltopdf`.
```sh
sudo apt-get install libxfont1 xfonts-75dpi \
xfonts-base xfonts-encodings xfonts-utils fontconfig \
libfontconfig1 libjpeg62-turbo libx11-6 libxext6 libxrender1
```
Descargar el programa [wkhtmltopdf](https://wkhtmltopdf.org/downloads.html). O descargar con wget.
```sh
wget https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.2.1/wkhtmltox-0.12.2.1_linux-jessie-amd64.deb
```
Luego de tener el paquete descargado, instalar con:
```
sudo dpkg -i wkhtmltox-0.12.2.1_linux-jessie-amd64.deb
```
### wkhtmltopdf (Stretch)
Instalar paquetes requeridos para `wkhtmltopdf`.
```sh
sudo apt-get install -y openssl build-essential libssl-dev libxrender-dev git-core libx11-dev libxext-dev libfontconfig1-dev libfreetype6-dev fontconfig
wget -c https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.3/wkhtmltox-0.12.3_linux-generic-amd64.tar.xz
tar xvf wkhtmltox*.tar.xz
sudo mv wkhtmltox/bin/wkhtmlto* /usr/bin
```
## Instalación de nvm (node version manager)
Instalación de [nvm](https://github.com/creationix/nvm)
```sh
curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.11/install.sh | bash
```
Actualizar variables de entorno.
```
. /home/nodejs/.bashrc
```
Instalación de node.js LTS versión 6.9.5 utilizando `nvm`.
```sh
nvm install 10.24.1
```
Verificamos con:
```sh
node -v
```
## Paquetes NPM
Instalar de manera global:
```
npm install --global sequelize sequelize-cli pg
```
## Instalación del proyecto
Clonar el código fuente desde el repositorio
```sh
git clone https://gitlab.com/miguelcond/backend_fdi.git
```
Es posible que al descargar el proyecto con HTTPs, nos lance el siguiente error:
```sh
Cloning into 'nombre-del-proyecto'...
fatal: unable to access 'https://url-del-proyecto.git/': server certificate verification failed. CAfile: /etc/ssl/certs/ca-certificates.crt CRLfile: none
```
Configurar lo siguiente e intentar nuevamente la clonación:
```sh
git config --global http.sslverify false
git clone -b FDI-master https://gitlab.com/miguelcond/backend_fdi.git
```
Ingresar a la carpeta:
```sh
cd seguimiento-proyectos-backend
```
Verificar que se encuentra en la rama `master` ó en el último tag correspondiente por ejemplo `FDI-v1.0.0`
```sh
git branch
```
Si se encuentra en otra rama, para cambiar a la rama `master` ejecutar:
```sh
git checkout master
```
Instalar las dependencias npm
```sh
npm install
```
## Instalación de la base de datos
Instalación de postgres
```sh
sudo apt-get install postgresql postgresql-contrib
```
> Nota. Puede ser necesario cambiar el estilo de formato de fechas a dd/mm/yyyy
> Ver el archivo de configuración de postgres `postgresql.conf`.
> datestyle = 'iso, dmy'
## Instalación de postgis (Ubuntu)
```sh
sudo apt-get install postgis postgresql-9.4-postgis-2.1
sudo /etc/init.d/postgresql restart
```
## Configuración de la base de datos
+ Crear un usuario con contraseña para la base de datos :
``` sql
postgres=# CREATE USER developer WITH PASSWORD '12345';
```
+ Crear la base de datos para developer con todos los privilegios :
``` sql
postgres=# CREATE DATABASE seguimiento_fdi_test OWNER developer;
postgres=# \c seguimiento_fdi_test
```
+ Crear la extension postgis para datos espaciales :
``` sql
postgres=# CREATE EXTENSION IF NOT EXISTS postgis;
```
## Configuraciones
### Conexión a la base de datos
Replicar archivo de configuración para la conexión a la base de datos.
```sh
cd seguimiento-proyectos-backend
cp src/config/config-example.json src/config/config.json
cp src/config/config-example.js src/config/config.js
```
Editar el archivo `src/config/config.json`, modificar las siguientes configuraciones:
* username - nombre de usuario de la base de datos
* password - contraseña del usuario de la base de datos
* database - nombre de la base de datos
* host - servidor donde se encuentra la base de datos
* demás variables
>**NOTA.-** En caso de poner un host distinto a localhost o 127.0.0.1, tomar en cuenta que debe [configurar postgreSQL para habilitar el acceso a conexiones remotas](http://www.evaristogz.com/instalacion-postgresql-acceso-remoto-externo/).
### Interoperabilidad y configuraciones generales
La configuración se define en el archivo : `src/config/config.js`, debe realizar una copia del archivo de configuración de ejemplo `src/config/config-example.js`.
```sh
cp src/config/config-example.js src/config/config.js
```
#### Segip
En el archivo de configuración editar los valores de la siguiente sección.
```
...
segip: {
url: 'https://interoperabilidad.agetic.gob.bo',
path: '/fake/segip/v2/',
credenciales: {
apikey: 'key'
},
tokenKong: 'Bearer <-- solicitar el token a interoperabilidad -->'
}
...
```
#### Envío de Correos
Configuración para envío de correos desde el sistema.
```
...
correo: {
host: "smtp.dominio.gob.bo",
port: 587,
secure: false,
ignoreTLS: false,
tls: { rejectUnauthorized: false },
auth: {
user: "ejemplo@dominio.gob.bo",
pass: "contraseña-secreta-de-ejemplo"
}
},
...
```
#### Configuración de parámetros del sistema
```
...
sistema: {
urlBase: 'https://dominio.gob.bo/fdi/#!',
urlLogin: 'https://dominio.gob.bo/fdi/#!/login',
urlLogo: 'https://dominio.gob.bo/fdi-api/imagen/logo-fdi.jpg',
origen: 'SSP <ssp@dominio.gob.bo>',
soporte: ['user@dominio.gob.bo']
}
...
```
* *urlBase*: Url base del frontend seguimiento de proyectos
* *urlLogin*: Url de la vista de login del sistema de seguimiento de proyectos
* *urlLogo*: Url donde está ubicado el logo de la institución
* *origen*: Nombre del origen de los correos ej. SSP
* *soporte*: Nombre del correo remitente para los correos enviados desde el sistema
## Ejecución de aplicación
### Iniciar la aplicación (modo desarrollo)
Las opciones de ejecución son las siguientes:
+ Genera o regenera las tablas necesarias en la base de datos y ejecuta los seeders y migrations para el entorno de producción.
```sh
npm run setup # desarrollo
```
### Iniciar aplicacion (modo produccion)
#### Configuración con PM2 (opcion 1)
Instalar el gestor de procesos PM2 con el siguiente comando
```sh
$ npm install pm2 -g
```
#### Iniciar y detener procesos
Instalar el interprete babel utilizado
```sh
$ npm install -g babel-cli
```
##### Iniciar en modo desarrollo
Iniciar la aplicación Backend con nombre `seguimiento-api` (En modo desarrollo no se debe iniciar con instancias)
```sh
$ pm2 start --interpreter babel-node index.js --name seguimiento-api
```
> Recuerda que estos comandos solo trabajan en modo `fork_mode`. Para ejecutar en modo cluster puedes utilizar la siguiente alternativa.
##### Iniciar utilizando Require (produccion)
Crear un archivo `server.js` con el siguiente contenido
```sh
// server.js
require('babel-register');
require('./index.js');
```
Ahora puedes ejecutar la aplicación con nombre `seguimiento-api`
```sh
$ env NODE_ENV=production pm2 start server.js --name seguimiento-api
```
ó Iniciar la aplicación Backend con 2 instancias, y nombre de la aplicación `seguimiento-api`
```sh
$ env NODE_ENV=production pm2 start server.js -i 2 --name seguimiento-api
```
##### Detener un procesos
Para detener el proceso se usa el comando `stop`
```sh
$ pm2 stop seguimiento-api
```
Para reiniciarlo el comando `restart`
```sh
$ pm2 restart seguimiento-api
```
#### Mantenimiento de los procesos
Para mostrar la información de los procesos se utiliza el comando `list`
```sh
$ pm2 list
```
Para mostrar los últimos logs se utiliza el comando `log`
```sh
$ pm2 log
```
#### Generación del script de reinicio automático cuando se enciende el servidor
Para generar los scripts de arranque se utiliza el siguiente comando. Y luego leer y ejecutar el comando que se genera
```sh
$ pm2 startup
```
Guardar la lista de procesos para reiniciar el servidor con el siguiente comando
```sh
$ pm2 save
```
Eliminar los scripts de inicio con e siguiente comando
```sh
$ pm2 unstartup systemd
```
### Configuración con supervisor (opcional)
Instalar supervisord
```
sudo apt-get install supervisor
```
Configuración de supervisor para servicio.
Creamos un archivo de configuración en el directorio: `/etc/supervisor/conf.d`. El archivo debe tener extensión `.conf`. Un ejemplo de configuración para el despliegue de la aplicación guardado en el archivo: `/etc/supervisor/conf.d/seguimiento-fdi-api.conf` es:
```
[program:seguimiento-fdi-api]
command=/home/nodejs/.nvm/versions/node/v6.9.5/bin/npm start --prod
directory=/home/nodejs/seguimiento-proyectos-backend/
process_name=seguimiento-fdi-api
autostart=true
autorestart=true
startsecs=1
stopwaitsecs=1
stdout_logfile=/home/nodejs/seguimiento-proyectos-backend/log/produccion.log
stderr_logfile=/home/nodejs/seguimiento-proyectos-backend/log/produccion.log
user=nodejs
```
Tomar encuenta que `/home/nodejs/...`, el valor de `usuario` debe ser reemplazado por el usuario en el que se inicio la instalación.
Los parámetros de configuración son:
* [program:seguimiento-fdi-api], define el nombre del programa("seguimiento-fdi-api").
* command, comando que se ejecuta. Este parámetro es configurado con una versión de node.js instalado con `n`.
* directory, directorio donde se ejecuta el comando anterior.
* process_name, nombre del proceso, en este caso "seguimiento-fdi-api", notar que tiene el mismo nombre del programa.
* autostart, se indica que el programa debe ser iniciado cuando se reinicia el sistema, true se inicia automaticamente y false para inicio manual.
* autorestart, define cómo supervisor debe gestionar en caso de que el programa haya dejado de funcionar. true, indica que se reinicia el programa cuando el mismo deje de funcionar, false no reinicia cuando programa no este funcionando.
* startsecs, Segundos que debe permanecer ejecutándose el servicio para que se considere que ha sido lanzado correctamente.
* stopwaitsecs, especifica cuánto tiempo supervisord debe esperar al programa, antes de darse por vencido y envió de una señal SIGKILL.
* stdout_logfile, dirección de archivo de logs del programa. Archivo debe estar creado antes de iniciar el programa.
* stderr_logfile, dirección de archivo de logs de error del programa. Archivo debe estar creado antes de iniciar el programa.
* user, usuario que ejecutará el programa.
Para más información sobre los parámetros de configuración ver [supervisor-configuración](http://supervisord.org/configuration.html).
Luego hacemos saber a supervisor del programa configurado
```sh
sudo supervisorctl reread
```
Activar modificaciones de configuración del programa. Ejecutar este comando cuando se realiza cualquier modificación sobre el archivo de configuración `.conf` en este caso `seguimiento-fdi-api`.
```sh
sudo supervisorctl update
```
Con esto ya se tiene desplegado el servicio, se puede revisar con `sudo supervisorctl`, o `tail -f seguimiento-proyectos-backend/log/produccion.log`(dependiendo del directorio donde se instaló).
Parar programa
```sh
sudo supervisorctl stop seguimiento-fdi-api
```
Iniciar programa
```sh
sudo supervisorctl start seguimiento-fdi-api
```
Parar programa
```sh
sudo supervisorctl stop seguimiento-fdi-api
```
Iniciar programa
```sh
sudo supervisorctl start seguimiento-fdi-api
```
Reiniciar "supervisor"
Cuando se hagan cambios y se requiere reiniciar el servicio "supervisor" para que se ejecute la aplicación:
```sh
sudo /etc/init.d/supervisor restart
```
Para verificar que la aplicación este efectivamente corriendo, se puede ejecutar el siguiente comando, y verificar que la aplicación este corriendo en el puerto configurado:
```sh
netstat -ltpn
Proto Recv-Q Send-Q Local Address Foreign Address State PID/Program name
tcp 0 0 0.0.0.0:80 0.0.0.0:* LISTEN -
tcp 0 0 0.0.0.0:22 0.0.0.0:* LISTEN -
tcp 0 0 0.0.0.0:5432 0.0.0.0:* LISTEN -
tcp6 0 0 :::4000 :::* LISTEN 32274/nodejs
```
O se puede revisar las tareas del `supervisor`, buscar el nombre de la tarea y su respectivo estado:
```sh
sudo supervisorctl
```
```sh
seguimiento-fdi-api RUNNING pid 4617, uptime 3 days, 21:41:05
```
#### Cosas que se deben tomar en cuenta
##### Reconfigurar TimeZone
Verificar TimeZone
```sh
date +"%Z %z"
```
Cambiar timezone
```sh
$ sudo timedatectl set-timezone "America/La_Paz"
$ sudo dpkg-reconfigure tzdata
```
Seleccionar America/La_Paz
##### Verificar TimeZone de PostgreSQL
Editar el archivo `/etc/postgresql/9.4/main/postgresql.conf` y revizar los siguientes valores
```
# - Locale and Formatting -
datestyle = 'iso, dmy'
timezone = 'localtime'
log_timezone = 'localtime'
```
Reiniciar el servicio de postgresql si se modificó algún dato
```
$ sudo service postgresql restart
```
Sign in with Wallet
Connect another wallet