MANUAL DE INSTALACIÓN

LINUX - WINDOWS

2021
Requisitos de instalación
En la siguiente tabla se muestran las tecnologías implementadas en el aplicativo. Para
poder hacer un despliegue sin problemas se recomienda contar con las versiones
específicas para PHP y Mysql.

Tecnología Versión

PHP 7.2

Mysql 5.7

Laravel 5.6

Posibles entornos de trabajo

Se puede contar con diferentes tecnologías sobre la cual desplegar el aplicativo, pudiendo
nombrar algunas como lo son Windows Server, Ubuntu Server, Apache o Nginx, Hosting o
VPS, se recomienda y es mucho más práctico contar con un servidor propio o servicio
adquirido donde pueda gestionar las versiones de las tecnologías recomendadas para hacer
uso del aplicativo sin ningún problema.
Entorno LAMP (Linux, Apache, Mysql y PHP)
Si desea implementar sobre un servidor Linux “desde cero” debe:

● Contar con dominio activado en conjunto con el servidor (obligatorio)

● Contar con acceso SSH
● Contar con acceso root
● Instalar php 7.2 y todas las librerías requeridas por el aplicativo y Laravel
● Si no se instala Apache2 en conjunto con php 7.2, instalarlo individualmente
● Instalar Mysql, si lo desea PhpMyAdmin para hacer las primeras pruebas de base de
datos
● Instalar Git, Curl, Composer
● Configurar el VirtualHost

La manera de trabajar con el servidor Linux es mediante SSH, de manera que se acceda y
se pueda gestionar totalmente los requerimientos. Puede ser accedido con una herramienta
llamada Putty (multiplataforma) u otras con soporte SSH, desde una misma consola Linux o
si cuenta con ssh en windows también desde una terminal de comandos, cmd o cualquier
otra.

Suponiendo que ya ha accedido, procedemos con las instalaciones, en el siguiente

tomaremos como ejemplo Ubuntu 18.04.

Ubuntu no cuenta con la versión 7.2 de php de manera nativa por lo que se debe seguir un
par de pasos para agregar un repositorio y luego proceder con la instalación, ellos son

Para poder ejecutar los siguientes comando debe acceder a la terminal como usuario root.

● apt-get update

Para poder agregar un PPA, ejecute los siguientes:

● apt-get install software-properties-common

● apt-get install python-software-properties

Para agregar el PPA, en algunos casos solicitará confirmar con enter

● add-apt-repository ppa:ondrej/php
● apt-get update

Procedemos a Instalar PHP, aunque se instalar algunas librerías junto con PHP, se agregan
para asegurar la instalación

● apt-get -y install php7.2 php7.2-mbstring php7.2-soap php7.2-zip

php7.2-mysql php7.2-curl php7.2-gd php7.2-xml
Si no se instala Apache ejecutar

● apt-get -y install apache2

Instalamos Mysql, phpmyadmin opcional

● apt-get -y install mysql-server-5.7 mysql-client-5.7

A continuación cree un nuevo usuario de mysql, para ello ejecute:

● mysql -u root
● CREATE USER 'nombre_usuario'@'localhost' IDENTIFIED BY 'tu_contrasena';
● GRANT ALL PRIVILEGES ON * . * TO 'nombre_usuario'@'localhost';
● FLUSH PRIVILEGES;

Dentro de la misma sesión de mysql registre la base de datos

● create database nombre_de_bd;

Una vez registrado, salga con exit;

Instalamos Curl y Git

● apt-get install git

● apt-get install curl

Si todo avanza correctamente, accediendo la ip pública de su servidor debe mostrar una

pantalla parecida a la siguiente
 Figura 1. Interfaz inicial Apache

Antes de descargar el proyecto es necesario instalar Composer

● apt-get install composer

Ahora deberá ubicarse en la carpeta /var/www/html/ para descargar el proyecto en esa

ubicación, en este punto con el usuario Root puede dar permisos a esa misma ruta con el
comando chmod -R y continuar con el usuario normal, puede acceder a la ruta con

● cd /var/www/html/

Una vez ubicado allí con la herramienta git, si ya se le ha compartido acceso a repositorio
ejecute lo siguiente:

● git clone
https://gitlab.com/eriquegasparcarlos/multifacturaperunew.git

Esto creará una carpeta llamada multifacturaperunew, luego de la descarga puede entrar en
la carpeta con cd multifacturaperunew, dentro de ella puede ejecutar lo siguiente para
configurar el archivo .env
 ● cp .env.example .env

De esta manera creará el archivo .env a partir del ejemplo, donde deberá editar las líneas

● APP_URL_BASE=multifacturaperunew.oo
● DB_DATABASE=multifacturaperunew
● DB_USERNAME=root
● DB_PASSWORD=

Donde APP_URL_BASE corresponde a su dominio, DB_DATABASE será el nombre que le

de a la base de datos principal, DB_USERNAME y DB_PASSWORD equivalen al usuario
creado anteriormente en la instalación de mysql.

Seguidamente:

● php artisan key:generate

Si todo marcha bien es hora de agregar los paquetes faltante en el proyecto y ejecutar las
migraciones.

Ingrese a la carpeta del proyecto:

● cd /var/www/html/multifacturaperunew
● composer install
● php artisan migrate --seed

Puede verificar actualizando phpmyadmin, en la lista de la izquierda se mostrará la base de

datos creada y la derecha las tablas generadas.

Ahora es turno de configurar el VirtualHost para que el proyecto se ejecute directamente

sobre su dominio.

Como usuario root nuevamente dirigirse a la ruta de configuraciones de apache y crear un

nuevo archivo, ejecute lo siguiente

● cd /etc/apache2/sites-available/
● touch multifacturaperunew.conf
● nano multifacturaperunew.conf

Se abrirá un editor de textos en la consola donde deberá agregar lo siguiente:

<VirtualHost *:80>
ServerAdmin [email protected]
DocumentRoot /var/www/html/multifacturaperunew/public
ServerName sudominio.com
ServerAlias *.sudominio.com

<Directory /var/www/html/multifacturaperunew/public>
Options +FollowSymlinks
AllowOverride All
Require all granted
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

Donde sudominio.com equivale al dominio adquirido luego debera guardar, puede hacerlo
con las teclas ctrl+x donde se le pedirá confirmación, deberá presionar la tecla Y y enter, al
finalizar solo debe ejecutar los siguientes comandos.

● a2dissite 000-default.conf
● a2ensite multifacturaperunew.conf
● a2enmod rewrite
● service apache2 restart

Con estos pasos podrá observar el aplicativo en su dominio, en algunos casos si tiene
problemas para observar el aplicativo puede deberse a los permisos en las carpetas del
proyecto, principalmente storage y cache requieren el siguiente comando

● cd /var/www/html/multifacturaperunew
● chmod -R 777 storage
● chmod -R 777 bootstrap/cache

También es necesario ejecutar el siguiente comando para establecer la ruta de los archivos
cargados de la empresa

● php artisan storage:link

Entorno WAMP (Windows, Apache, Mysql y PHP)
En esta ocasión se hará uso de Laragon para realizar la instalación en windows. Laragon es
una suite de desarrollo para PHP que funciona sobre Windows diseñado especialmente
para trabajar con Laravel. Similar a otras herramientas como Xampp o Wamp, Laragon nos
permite crear un entorno de desarrollo con estas características:

● Cmder (Consola para Windows)

● Git
● Node.js
● npm
● SSH
● Putty
● PHP 7 / 5.6
● Extensiones de PHP
● xDebug
● Composer
● Apache
● MariaDB/MySQL
● phpMyAdmin
● Soporte para Laravel y Lumen
● Gestión automática de Virtualhosts.

Puede descargarlo a través del siguiente enlace: laragon.org/download

Instalación Laragon
Una vez descargado laragon, ejecute el programa, visualizará la siguiente ventana,

● Seleccione “Ejecutar”.
 Figura 2. Ejecutar laragon

● Elija el idioma del programa

Figura 3. Idioma

● Clic en el botón “Siguiente”

Figura 4. Asistente

● Elija la ubicación en la cual se instalará el programa

Figura 5. Ubicación
● Seleccione las opciones, de clic en “Siguiente”
 Figura 6. Opciones

● Seleccione “Instalar”

Figura 7. Instalar

● Espere a que culmine la instalación

Figura 8. Progreso instalación

● Clic en Finalizar para culminar la instalación
 Figura 9. Instalación finalizada

Configuración Laragon
Laragon crea un dominio por cada proyecto que se encuentre ubicado en la carpeta www, a
continuación se muestra la configuración para cambiar el dominio.

Diríjase al ícono con forma de engranaje, de clic, le mostrará la siguiente ventana, en la

parte inferior “Hostname”, podrá cambiarlo.
● Ejemplo: {name}.test - {name}.oo - {name}.pe

Figura 10. Configuración Hostname

Diríjase a la pestaña Servicios & Puertos, para cambiar el puerto de apache, mysql, o
cambiar de servidor, dependiendo de sus requerimientos.
 Figura 11. Configuración Apache - Mysql

A continuación deberá activar la extensión SOAP, diríjase a laragon y seleccione la opción

“Menú”, realice lo que visualiza en la imágen.

Figura 12. Habilitar SOAP

Configuración del proyecto
En la carpeta www de laragon encontrará todo sus proyectos, puede ubicarla en el directorio
que seleccionó al momento de la instalación o siguiendo los pasos de la imágen.
 Figura 13. Directorio

En este caso ahi se realizará la instalación del proyecto, use la terminal de laragon y
ubíquese en la carpeta “F:\laragon\www”, la ubicación cambiará dependiendo de donde
haya instalado el programa.

Cuando se encuentre en dicha ruta, ejecute el siguiente comando:

● git clone https://gitlab.com/eriquegasparcarlos/multifacturaperunew.git

Le solicitará su usuario y password de gitlab, debe escribirlos para que puede continuar el
proceso.

Figura 14. Clonar proyecto

Cuando termine de descargar el proyecto, ingrese a la carpeta del proyecto, use el siguiente
comando en la terminal.
● cd multifacturaperunew

Consecuentemente debe copiar el archivo .env ejecute:

● cp .env.example .env
Tenga en cuenta que la variable APP_URL_BASE de tener el valor que asignó
anteriormente en la configuración del Hostname, en este caso es
APP_URL_BASE=multifacturaperunew.oo, donde multifacturaperunew es el nombre de
la carpeta del proyecto.

Figura 15. Archivo .env

Instale las dependencias, ejecutando el siguiente comando.
● composer install

Figura 16. Instalar dependencias

Ahora debe crear la base de datos principal, en este caso se llamará multifacturaperunew,
y así debe estar configurada en el archivo .env.
 Figura 17. Crear base de datos

Después de ello, diríjase a la carpeta de su proyecto usando la terminal, y ejecute los

siguientes comandos.
● php artisan key:generate
● composer dump-autoload
● php artisan migrate --seed
● php artisan storage:link

Figura 18. Configuración BD

Si todo se realizó correctamente, ya tendrá las tablas del usuario principal creadas, y podrá
acceder mediante la web, al proyecto.
Accesos:
● usuario: [email protected]
● contraseña: 123456

Figura 19. Login Principal

Cuando acceda a la aplicación podrá crear los clientes, en este caso crearemos uno de
prueba con los parámetros que se muestran en la imágen.

Más información, puede consultar el Manual de Usuario.

Figura 20. Registrar cliente

Al crear el cliente, se generará automáticamente su base de datos, por lo tanto, cada cliente
tendrá su base de datos, ahora hay que configurar los hosts en laragon.

Para realizar la configuración de los hosts diríjase a laragon y en la esquina superior

derecha, de clic en la letra “h”.
 Figura 21. Ubicar hosts

Se le abrirá el archivo de hosts, en el cual debe escribir lo siguiente.

● 127.0.0.1 miprueba.multifacturaperunew.oo

Donde miprueba es el subdominio que se registró al momento de crear el cliente, por lo

tanto cada vez que registre un cliente debe registrar su subdominio en el archivo hosts.

Figura 22. Archivo hosts

Guarde los cambios y reinicie laragon. Ahora podrá acceder al aplicativo y realizar sus
operaciones.

● Url prueba: http://miprueba.multifacturaperunew.oo:8084/login

Figura 23. Login cliente

Soporte y mantenimiento

Actualizaciones

Existe una vía práctica de actualización, utilizando la herramienta git, se puede utilizar si el
sistema ha sido descargado en el servidor de producción mediante la misma, de no ser así,
las actualizaciones se realizarán de manera manual sobre el proyecto, como la primera
entrega, será entregado un archivo comprimido el cual vendrá con la lista de archivos
actualizados de manera que tendrá que reemplazar dichos archivos, o bien podrá
reemplazar el proyecto completo.

Soporte

Existen algunos manuales creados para comprender el uso del sistema que le será enviado
vía email, además estarán disponibles en todo momento en la web, bien sea vía Google
Drive, Google Docs, Dropbox, entre otros.

Contará también con una sesión en Slack donde estará disponible un grupo para comunicar
los eventos o inconvenientes y será atendido a la mayor brevedad posible.

Sugerencias
Si desea realizar modificaciones al proyecto, por ejemplo cambios de diseño en el pdf, u
otros, realicelo en un servidor diferente al que se le haya hecho la instalación, ello con el fin
de que cuando haya actualizaciones por parte de Factura Perú, puede obtenerlas sin ningún
inconveniente.