Documentos de Académico
Documentos de Profesional
Documentos de Cultura
LINUX - WINDOWS
2019
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
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.
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
● 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
● 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
● cd /var/www/html/
Una vez ubicado allí con la herramienta git, si ya se le ha compartido acceso a repositorio
ejecute lo siguiente:
Esto creará una carpeta llamada facturadorpro4, luego de la descarga puede entrar en la
carpeta con cd facturadorpro4, 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=facturadorpro4.oo
● DB_DATABASE=facturadorpro4
● DB_USERNAME=root
● DB_PASSWORD=
Seguidamente:
Si todo marcha bien es hora de agregar los paquetes faltantes en el proyecto y ejecutar las
migraciones.
● cd /var/www/html/facturadorpro4
● composer install
● php artisan migrate --seed
● cd /etc/apache2/sites-available/
● touch facturadorpro4.conf
● nano facturadorpro4.conf
<VirtualHost *:80>
ServerAdmin admin@example.com
DocumentRoot /var/www/html/ facturadorpro4/public
ServerName sudominio.com
ServerAlias *.sudominio.com
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 facturadorpro4.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/facturadorpro4
● 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
Instalación Laragon
Una vez descargado laragon, ejecute el programa, visualizará la siguiente ventana,
● Seleccione “Ejecutar”.
Figura 3. Idioma
Figura 4. Asistente
Figura 6. Opciones
● Seleccione “Instalar”
Figura 7. Instalar
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 a la pestaña Servicios & Puertos, para cambiar el puerto de apache, mysql, o
cambiar de servidor, dependiendo de sus requerimientos.
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/multifacturalonew.git
Le solicitará su usuario y password de gitlab, debe escribirlos para que puede continuar el
proceso.
Cuando termine de descargar el proyecto, ingrese a la carpeta del proyecto, use el siguiente
comando en la terminal.
● cd multifacturalonew
Ahora debe crear la base de datos principal, en este caso se llamará multifacturalonew, y
así debe estar configurada en el archivo .env.
Figura 17. Crear base de datos
Si todo se realizó correctamente, ya tendrá las tablas del usuario principal creadas, y podrá
acceder mediante la web, al proyecto.
Accesos:
● usuario: admin@gmail.com
● contraseña: 123456
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.
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.
● 127.0.0.1 miprueba.multifacturalonew.oo
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 Factúralo Perú, puede obtenerlas sin
ningún inconveniente.