EVIDENCIAS DE DESPLIEGUE

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE –

Página: 1 de 29
SISEN

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE

Versión:
 Módulo Administrador v 1.2.0
 Módulo Ciudadano v 1.4.0
 Módulo Registro v 1.0.0

4.1. Despliegue de la aplicación

4.1.1 Conectar en modo consola con el terminal donde se realizará el despliegue

4.1.2. Realizar los pasos indicados en el documento “1. HOMOLOGAR LAS URL DE LOS
MÓDULOS ADMIN Y CIUDADANO EN QA COMO ESTA EN PRODUCCIÓN.docx” ubicado en
la carpeta ANEXOS.
Realizar todos los pasos mencionados en el presente documento con permisos root
4.1.2.1. Ingresar a la ruta /etc/nginx/conf.d

4.1.2.2. Listamos los registros con el comando: ls -la

 EVIDENCIAS DE DESPLIEGUE

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE –

Página: 2 de 29
SISEN

4.1.2.3. Actualizamos las url del módulo Administrador, realizando los siguientes pasos
(Nota: Para la edición de los archivos en desarrollo usamos el editor vi):

 Ingresamos al archivo casilla-admin-api.onpe.gob.pe.conf (Ejemplo en desarrollo)

y actualizamos la línea enmarcada a continuación con el contenido
casillaelectronica-admin-api.onpe.gob.pe (realizar el cambio sólo si el valor del
server_name es diferente)

 Ingresamos al archivo casillaelectronica-admin.onpe.gob.pe.conf (Ejemplo en

desarrollo) y actualizamos la línea enmarcada a continuación con el contenido
casillaelectronica-admin.onpe.gob.pe (realizar el cambio sólo si el valor del
server_name es diferente)

4.1.2.4 Actualizamos las url del módulo Ciudadano, realizando los siguientes pasos (Nota:
Para la edición de los archivos en desarrollo usamos el editor vi):

 Ingresamos al archivo casilla-api.onpe.gob.pe.conf (Ejemplo en desarrollo) y

actualizamos la línea enmarcada a continuación con el contenido
casillaelectronica-api.onpe.gob.pe (realizar el cambio sólo si el valor del
server_name es diferente).
 EVIDENCIAS DE DESPLIEGUE

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE –

Página: 3 de 29
SISEN

 Ingresamos al archivo casillaelectronica.onpe.gob.pe.conf (Ejemplo en desarrollo)

y actualizamos la línea enmarcada a continuación con el contenido
casillaelectronica.onpe.gob.pe (realizar el cambio sólo si el valor del server_name
es diferente).

4.1.2.5 Reiniciamos el nginx con los siguientes comandos:

sudo nginx -t
sudo systemctl restart nginx

4.1.2.6 Actualizamos el contenido de los archivos ubicados en la carpeta config ubicado

en la carpeta home del usuario del servidor.
/home/admqa/config

4.1.2.7 Ingresamos al archivo casilla_frontend_admin.js (Ejemplo en desarrollo) y

actualizamos las variables URL_SERVICES y baseUrl con el valor
https://casillaelectronica-admin-api.onpe.gob.pe y https://casillaelectronica-
admin.onpe.gob.pe respectivamente (realizar el cambio sólo si los valores son
diferentes).
 EVIDENCIAS DE DESPLIEGUE

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE –

Página: 4 de 29
SISEN

4.1.2.8 Ingresamos al archivo casilla_frontend_citizen.js (ejemplo en desarrollo) y

actualizamos las variables URL_SERVICES y baseUrl con el valor
https://casillaelectronica-api.onpe.gob.pe y
https://casillaelectronica.onpe.gob.pe respectivamente (realizar el cambio sólo si
los valores son diferentes).

4.1.2.9 Ingresamos al archivo casilla_webservice_admin.js (ejemplo en desarrollo) y

actualizamos las variables BASE_URL, BASE_URL_FRONT y
BASE_URL_FRONT_CITIZEN con los valores https://casillaelectronica-admin-
api.onpe.gob.pe, https://casillaelectronica-admin.onpe.gob.pe y
https://casillaelectronica.onpe.gob.pe respectivamente (realizar el cambio sólo si
los valores son diferentes).

4.1.2.10 Ingresamos al archivo casilla_webservice_citizen.js (ejemplo en desarrollo) y

actualizamos las variables BASE_URL y BASE_URL_FRONT con los valores
https://casillaelectronica-api.onpe.gob.pe y
https://casillaelectronica.onpe.gob.pe respectivamente (realizar el cambio sólo si
los valores son diferentes).
 EVIDENCIAS DE DESPLIEGUE

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE –

Página: 5 de 29
SISEN

4.1.2.11 Realizar el despliegue de las fuentes (ubicadas en la carpeta FUENTES del

presente pase) y ejecutar el comando install_casilla.sh (ubicado en la carpeta
DESPLIGUE del IC-010-897_08062022) para reiniciar ambos módulos con las
nuevas URL’S. 
 Deberá sacarse una copia de seguridad a las siguientes aplicaciones
desplegadas en la ruta /var/www
 frontend_admin
 webservice_admin
 frontend_citizen

Para ello, realizar los siguientes pasos:

 Crear si no existe la carpeta backup_año_mes_dia en la carpeta home del
usuario ingresado por terminal (ejemplo en desarrollo:
/home/admsgpel/), reemplazar año_mes_dia por la fecha cuando se
realice el despliegue.

 Mover hacia la carpeta backup_año_mes_dia las aplicaciones

desplegadas frontend_ciziten, frontend_admin y webservice_admin
ubicadas en la ruta /var/www/
 EVIDENCIAS DE DESPLIEGUE

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE –

Página: 6 de 29
SISEN

 Ubicarse en la carpeta home del usuario ingresado por terminal (ejemplo en

desarrollo: /home/admsgpel/).

 Copiar los entregables ubicado en la carpeta FUENTES a la carpeta projects

(ejemplo en desarrollo: /home/admsgpel/projects).
Nota: La carpeta projects deberá estar vacía antes de realizar la copia de los
entregables.

 Copiar el archivo install_casilla.sh (ubicado en la carpeta DESPLIEGUE) en la

carpeta home del usuario ingresado por terminal (ejemplo en desarrollo:
/home/admsgpel/).

 Dar permisos de ejecución y ejecutar el archivo install_casilla.sh con los

comandos:
 chmod +x install_casilla.sh
 sudo sh install_casilla.sh
 EVIDENCIAS DE DESPLIEGUE

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE –

Página: 7 de 29
SISEN

4.1.2.12 Actualizar las urls registradas en la ruta

de las PC’s que utilizar SISEN para pruebas:

 casillaelectronica-admin-api.onpe.gob.pe
 casillaelectronica-admin.onpe.gob.pe
 casillaelectronica-api.onpe.gob.pe
 casillaelectronica.onpe.gob.pe

4.1.3. Previo a realizar los pasos para el presente pase, validar y brindar si es necesario
los permisos de lectura, escritura y otros a los archivos de configuración, como se
muestra en el ejemplo.

4.1.4. Realizar la modificación con los datos del entorno al desplegar, en las siguientes
variables:
 EVIDENCIAS DE DESPLIEGUE

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE –

Página: 8 de 29
SISEN

Asimismo, cambiar el dato del campo “RECAPTCHA_SECRET” ubicada en el

archivo registro_casilla_backend.js y la variable “KeycodeCaptcha” en el archivo
registro_casilla_frontend.js de la carpeta CONFIG, con los valores
correspondientes a su ambiente de pruebas, los mismos que se pueden obtener
siguiendo los pasos del documento “2. Instructivo de generación de llaves del
reCaptcha v3.docx” ubicado en la carpeta ANEXOS.
 EVIDENCIAS DE DESPLIEGUE

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE –

Página: 9 de 29
SISEN

4.1.5. Realizar los pasos indicados en el documento “Procedimiento.docx” ubicado en la

raíz del presente pase.
4.
4.1.3.
4.1.4.
4.1.4.1. Conectar en modo consola con el terminal donde se realizará el despliegue.

4.1.4.2. Deberá sacarse una copia de seguridad a las siguientes aplicaciones

desplegadas en la ruta /var/www
 frontend_admin
 EVIDENCIAS DE DESPLIEGUE

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE –

Página: 10 de 29
SISEN

 webservice_admin
 frontend_ciziten

Para ello, realizar los siguientes pasos:

 Crear si no existe la carpeta backup_año_mes_dia en la carpeta home
del usuario ingresado por terminal (ejemplo en desarrollo:
/home/admsgpel/), reemplazar año_mes_dia por la fecha cuando se
realice el despliegue.

 Mover hacia la carpeta backup_año_mes_dia las aplicaciones

desplegadas frontend_ciziten, frontend_admin y webservice_admin
ubicadas en la ruta /var/www/
Ejemplo en desarrollo:
sudo mv /var/www/frontend_admin/ /home/admsgpel/backup_2022_06_26
sudo mv /var/www/webservice_admin/ /home/admsgpel/backup_2022_06_26
sudo mv /var/www/frontend_citizen/ /home/admsgpel/backup_2022_06_26

4.1.4.3. Ubicarse en la carpeta home del usuario ingresado por terminal (ejemplo en
desarrollo: /home/admsgpel/).

4.1.4.4. Copiar los entregables ubicado en la carpeta FUENTES a la carpeta projects

(ejemplo en desarrollo: /home/admsgpel/projects).
 EVIDENCIAS DE DESPLIEGUE

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE –

Página: 11 de 29
SISEN

Nota: La carpeta projects deberá estar vacía antes de realizar la copia de los
entregables

4.1.4.5. Copiar el archivo install_modulos_ciudadano_admin.sh (ubicado en la carpeta

DESPLIEGUE) en la carpeta home del usuario ingresado por terminal (ejemplo
en desarrollo: /home/admsgpel/).

Nota: Antes de proceder con el numeral 6 verificar las versiones de Angular 9 y

Node 12.
 EVIDENCIAS DE DESPLIEGUE

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE –

Página: 12 de 29
SISEN

 Validamos la versión del Node, con el comando:

 sudo node --version

Si sale una versión superior a la 12, ejecutar los siguientes pasos:

 Eliminamos los enlaces simbólicos a node y npm, con los comandos
sudo rm /usr/bin/node
sudo rm /usr/bin/npm

 Creamos los enlaces simbólicos, con los comandos:

sudo ln -s /usr/local/nvm/versions/node/v12.18.3/bin/node /usr/bin/node
sudo ln -s /usr/local/nvm/versions/node/v12.18.3/bin/npm /usr/bin/npm

 Validamos la versión del Angular, con el comando:

sudo ng v

Si sale una versión superior a la 9, ejecutar los siguientes pasos:

 EVIDENCIAS DE DESPLIEGUE

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE –

Página: 13 de 29
SISEN

 Eliminamos el enlace simbólico a ng, con el comando

sudo rm /usr/bin/ng

 Creamos el enlace simbólico, con el comando:

sudo ln -s /usr/local/nvm/versions/node/v12.18.3/bin/ng /usr/bin/ng

4.1.4.6. Dar permisos de ejecución y ejecutar el archivo

install_modulos_ciudadano_admin.sh con los comandos:
 chmod +x install_modulos_ciudadano_admin.sh
 sudo sh install_modulos_ciudadano_admin.sh
 EVIDENCIAS DE DESPLIEGUE

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE –

Página: 14 de 29
SISEN

4.1.4.7. Realizar los pasos indicados (en orden) de los instructivos ubicados en la
carpeta DESPLIEGUE.

4.1.4.7.1. Actualizar NODESJS

Realizar los pasos 1 y 2 en el presente documento con usuario root.
1. Ejecutar el siguiente comando para obtener la versión instalada de Nodejs:
node --version
Ejemplo en desarrollo:
v12.18.1

2. Ejecutar las siguientes líneas para instalar la versión 16.15.1:

nvm install 16.15.1

nvm use 16.15.1
nvm alias default node

Realizar los siguientes pasos sin usuario root.

3. Para crear los enlaces simbólicos realizar los siguientes pasos:

- Eliminamos (si existen) los enlaces simbólicos a node y npm, con los
comandos:

sudo rm /usr/bin/node
sudo rm /usr/bin/npm

- Creamos los enlaces simbólicos, con los comandos:

sudo ln -s /usr/local/nvm/versions/node/v16.15.1/bin/node /usr/bin/node

sudo ln -s /usr/local/nvm/versions/node/v16.15.1/bin/npm /usr/bin/npm
 EVIDENCIAS DE DESPLIEGUE

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE –

Página: 15 de 29
SISEN

4. Para validar que la instalación se realizó correctamente, ejecutar el

comando del punto 1.

4.1.4.7.2. Actualizar Angular Y PM2

ACTUALIZAR LA VERSION DE ANGULAR A LA VERSION 14

1. Ejecutar el siguiente comando para instalar Angular:

sudo npm install -g @angular/cli

2. Para crear el enlace simbólico realizar los siguientes pasos:

- Eliminamos (si existe) el enlace simbólico a Angular, con el comando:

sudo rm /usr/bin/ng

- Creamos el enlace simbólico, con el comando:

sudo ln -s /usr/local/nvm/versions/node/v16.15.1/bin/ng /usr/bin/ng

3. Para validar que la instalación se realizó correctamente, ejecutar el

siguiente comando para validar la versión instalada de Angular:

sudo ng v

Ejemplo en desarrollo:
Angular CLI: 14.0.3
 EVIDENCIAS DE DESPLIEGUE

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE –

Página: 16 de 29
SISEN

ACTUALIZAR LA VERSION DE PM2 A LA VERSION 5.2.0

1. Ejecutar el siguiente comando para instalar Angular:

sudo npm install -g pm2

2. Para crear el enlace simbólico realizar los siguientes pasos:

- Eliminamos (si existe) el enlace simbólico a pm2, con el comando:

sudo rm /usr/bin/pm2

- Creamos el enlace simbólico, con el comando:

sudo ln -s /usr/local/nvm/versions/node/v16.15.1/bin/pm2 /usr/bin/pm2

3. Para validar que la instalación se realizó correctamente, ejecutar el

siguiente comando para validar la versión instalada de pm2:
 EVIDENCIAS DE DESPLIEGUE

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE –

Página: 17 de 29
SISEN

sudo pm2 --version

Ejemplo en desarrollo:
5.2.0

4. Actualizamos la lista de procesos desplegados en el servidor con el

comando:

sudo pm2 update

5. Validamos la lista de procesos desplegados con el comando:

sudo pm2 list

Se debería mostrar los siguientes procesos:

- webservice_admin
- webservice_citizen
 EVIDENCIAS DE DESPLIEGUE

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE –

Página: 18 de 29
SISEN

4.1.4.7.3. Instalación de NESTJS

1. Ejecutar el siguiente comando para instalar nestjs:

sudo npm i -g @nestjs/cli

2. Para crear el enlace simbólico realizar los siguientes pasos:

- Eliminamos (si existe) el enlace simbólico a nestjs, con el comando:

sudo rm /usr/bin/nest

- Creamos el enlace simbólico, con el comando:

sudo ln -s /usr/local/nvm/versions/node/v16.15.1/bin/nest /usr/bin/nest

3. Para validar que la instalación se realizó correctamente, ejecutar el

siguiente comando para validar la versión instalada de nestjs:

nest --version

Ejemplo en desarrollo:
8.2.8

4.1.4.7.4. Actualizar el CSP del Servidor NGINX

Realizar todos los pasos mencionados en el presente documento con

permisos root.

Actualizamos el contenido del archivo nginx.conf ubicado en la ruta

/etc/nginx (Nota: Para la edición de los archivos en desarrollo usamos el
editor vi):

1. Reemplazamos la línea add_header Content-Security-Policy con el

contenido del archivo csp.txt (ubicado en la carpeta CONFIG), para ello
realizamos los siguientes pasos:
 EVIDENCIAS DE DESPLIEGUE

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE –

Página: 19 de 29
SISEN

- Nos ubicamos en la línea add_header Content-Security-Policy e

ingresamos el comando dd (este comando eliminará la línea)

- Realizamos un salto de línea y copiamos el contenido del archivo csp.txt

(ubicado en la carpeta CONFIG)

2. Guardamos los cambios, y reiniciamos el servidor nginx, con los

comandos:

sudo nginx -t
sudo systemctl restart nginx
 EVIDENCIAS DE DESPLIEGUE

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE –

Página: 20 de 29
SISEN
 EVIDENCIAS DE DESPLIEGUE

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE –

Página: 21 de 29
SISEN

4.1.4.7.5. Agregar las URL de Registro de Casilla

Realizar todos los pasos mencionados en el presente documento con

permisos root.

1. Agregar los archivos casillaregistro-api.onpe.gob.pe.conf y

registrocasillaelectronica.onpe.gob.pe.conf (ubicado en la carpeta
CONFIG/nginx) en la ruta /etc/nginx/conf.d

2. Asignarle cambio de usuario y grupo, y permisos a nginx con los

comandos:
- sudo chown nginx:nginx casillaregistro-api.onpe.gob.pe.conf
- sudo chown nginx:nginx registrocasillaelectronica.onpe.gob.pe.conf
- sudo chmod 755 casillaregistro-api.onpe.gob.pe.conf
- sudo chmod 755 registrocasillaelectronica.onpe.gob.pe.conf
 EVIDENCIAS DE DESPLIEGUE

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE –

Página: 22 de 29
SISEN

3. Validamos que los comandos se ejecutaron correctamente, para ello

listamos los archivos con el comando ls -ls

4. Actualizar los siguientes parámetros en los archivos casillaregistro-

api.onpe.gob.pe.conf y registrocasillaelectronica.onpe.gob.pe.conf

- ssl_certificate /etc/ssl/certs/server.pem;
- ssl_certificate_key /etc/ssl/certs/server.key;

5. Reiniciar nginx, con los comandos:

sudo nginx -t
sudo systemctl restart nginx

6. Copiar los archivos registro_casilla_backend.js y

registro_casilla_frontend.js (ubicados en la carpeta CONFIG) en la carpeta
config ubicado en la carpeta home del usuario del servidor.

Ejemplo en desarrollo: /home/admsgpel/config

 EVIDENCIAS DE DESPLIEGUE

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE –

Página: 23 de 29
SISEN

7. Validamos que fueron copiados los archivos ejecutando el comando ls -ls

8. Agregar las urls registradas en la ruta C:\Windows\System32\drivers\

etc\hosts de las PC’s que utilizar SISEN para pruebas:

casillaregistro-api.onpe.gob.pe
registrocasillaelectronica.onpe.gob.pe
 EVIDENCIAS DE DESPLIEGUE

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE –

Página: 24 de 29
SISEN

4.1.4.8. Copiar el archivo install_registro_casilla.sh (ubicado en la carpeta

DESPLIEGUE) en la carpeta home del usuario ingresado por terminal (ejemplo
en desarrollo: /home/admsgpel/).

Nota: Antes de proceder con el numeral 9, verificar las versiones de Node 16 y

Angular 14.

 Validamos la versión del Node, con el siguiente comando:

sudo node –versión
 EVIDENCIAS DE DESPLIEGUE

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE –

Página: 25 de 29
SISEN

Si sale una versión inferior a la 16, ejecutar los siguientes pasos:

 Eliminamos los enlaces simbólicos a node y npm, con los comandos:

sudo rm /usr/bin/node
sudo rm /usr/bin/npm

 Creamos los enlaces simbólicos, con los comandos:

sudo ln -s /usr/local/nvm/versions/node/v16.15.1/bin/node /usr/bin/node
sudo ln -s /usr/local/nvm/versions/node/v16.15.1/bin/npm /usr/bin/npm

 Validamos la versión del Angular, con el comando:

sudo ng v

Si sale una versión inferior a la 14, ejecutar los siguientes pasos:

 Eliminamos el enlace simbólico a ng, con el comando:

sudo rm /usr/bin/ng
 Creamos el enlace simbólico, con el comando:
sudo ln -s /usr/local/nvm/versions/node/v16.15.1/bin/ng /usr/bin/ng

4.1.4.9. Dar permisos de ejecución y ejecutar el archivo install_registro_casilla.sh con

los comandos:
 chmod +x install_registro_casilla.sh
 sudo sh install_registro_casilla.sh
 EVIDENCIAS DE DESPLIEGUE

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE –

Página: 26 de 29
SISEN

4.

4.1.5. Realizar los pasos indicados en el documento “INSERCION DEL ERM 2022 Y
UBIGEO.docx” ubicado en la carpeta DESPLIGUE.
Paso 1: Conectarse al servidor:

Paso 2: Crear una carpeta sisenubigeo/ dentro de /admqa (verificar si existe)

(en el ejemplo de desarrollo: /home/admsgpel/sisenubigeo//)

 EVIDENCIAS DE DESPLIEGUE

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE –

Página: 27 de 29
SISEN

Pase 3: Copiar al servidor (en el ejemplo de desarrollo:

/home/admsgpel/sisenubigeo/) la carpeta /dump (para pruebas se encuentra en
SCRIPTS)

Paso 4: Ubicarse en la ruta Ejecutar /home/admsgpel/sisenubigeo/ y ejecutar el

siguiente comando: (ejemplo en desarrollo, actualizar los datos correspondientes
al ambiente previa a la ejecución)
mongorestore --uri mongodb://admin:admin@192.168.48.98:27017/?authSource=admin
 EVIDENCIAS DE DESPLIEGUE

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE –

Página: 28 de 29
SISEN

Insertar ERM2022
Paso 5: Ejecutar los siguientes 3 comandos: (ejemplo en desarrollo, actualizar
los datos correspondientes al ambiente previa a la ejecución)

mongo mongodb://admin:admin@192.168.48.97:27017/?authSource=admin

use casilla

db.catalog.insert([{"type":"procedure","code":"5","value":"ERM2022"}]);
 EVIDENCIAS DE DESPLIEGUE

SISTEMA DE NOTIFICACIÓN ELECTRÓNICA DE LA ONPE –

Página: 29 de 29
SISEN

4.1.6. Para realizar pruebas de notificaciones seguir los pasos de CONSIDERACIONES.

4.2. URL de Accesos

Las URL para pruebas son:
https://casillaelectronica.onpe.gob.pe
https://casillaelectronica-admin.onpe.gob.pe
https://casillaelectronica-api.onpe.gob.pe
https://casillaelectronica-admin-api.onpe.gob.pe
https://casillaregistro-api.onpe.gob.pe
https://registrocasillaelectronica.onpe.gob.pe

Deberá ingresarse a ambos enlaces en ese orden aceptando el certificado no seguro