FacturaloPeru - Manual de Instalación - 10-18

Manual de Instalación Facturador PRO

facturaloperu.com 2018

1

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 php7.2 y todas las librerias requeridas por el aplicativo y Laravel Si no se instala Apache2 en conjunto con php7.2, instalarlo Instalar Mysql, si lo desea PhpMyAdmin para hacer las primeras pruebas de base de datos Instalar Git, Curl, Composer Configurar el VirtualHost

2

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 16.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 como usuario Root antes que nada; 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 install php7.2 php7.2-mbstring php7.2-soap php7.2-zip php7.2-mysql php7.2-curl php7.2-gd php7.2-xml libapache2-php7.2 Si no se instala Apache ejecutar apt-get install apache2 Instalamos ​Mysql​, phpmyadmin opcional apt-get install mysql-server-5.7 mysql-client-5.7 phpmyadmin se le solicitara contraseña dos veces, con su confirmación, tanto para mysql como para phpmyadmin Instalamos ​Curl ​y ​Git apt-get install git 3

apt-get install curl Si todo avanza correctamente, accediendo a su dominio debe mostrar parecida a la siguiente

una pantalla

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/ ya ubicado allí con la herramienta git, si ya se le ha compartido acceso a repositorio ejecute lo siguiente: git clone https://gitlab.com/eriquegasparcarlos/multifacturalo.git esto creará una carpeta llamada multifacturalo, luego de la descarga puede entrar en la carpeta con cd, dentro puede ejecutar lo siguiente para configurar el archivo .env

4

cp .env.example .env de esta manera creará el archivo .env a partir del ejemplo, donde deberá editar las líneas APP_URL_BASE=multifacturalo.oo DB_DATABASE=multifacturalo 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. a continuación php artisan key:generate luego deberá registrar la base de datos mediante phpmyadmin, accediendo a la ruta sudominio.com/phpmyadmin ​con el usuario root y contraseña agregada en la instalación entrará en el panel, la siguiente imagen muestra la sección de creación de una nueva base de datos.

Figura 1. Crear base de datos mediante phpmyadmin Si todo marcha bien es hora de agregar los paquetes faltante en el proyecto y correr las migraciones cd /var/www/html/multifacturalo composer install php artisan migrate --seed Puede verificar actualizando phpmyadmin, en la lista de la derecha se mostrará la base de datos creada. Es turno de configurar el VirtualHost para que el proyecto se ejecute directamente sobre su dominio.

5

Como usuario root nuevamente dirigirse a la ruta de configuraciones de apache y crear un nuevo archivo, ejecute lo siguiente cd /etc/apache2/sites-availables/ touch multifacturalo.conf cd sites-availables nano multifacturalo.conf se abrirá un editor de textos en la consola donde deberá agregar lo siguiente ServerAdmin [email protected] DocumentRoot /var/www/html/​multifacturalo​/public ​ServerName sudominio.com ServerAlias *.sudominio.com

Options +FollowSymlinks AllowOverride All Require all granted

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

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 multifacturalo.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/multifacturalo chmod -R 755 storage chmod -R 755 bootstrap/cache 6

También es necesario ejecutar el siguiente comando para establecer la ruta de los archivos cargados de la empresa php artisan storage:link

Proceso usando Laragon Si desea probar el aplicativo en local, puede descargar la herramienta Laragon, la cual le ofrece todos los requerimientos básicos y con unos cuantos clics tendrá el aplicativo ejecutándose en su máquina sin problemas. Debe descargarlo a través de ​laragon.org/download​ esta herramienta le ofrece: Apache 2 o Nginx Mysql 5.7 php 7.2 Composer Git HeidiSql Entre otras una vez instalado deberá activar la extensión ​PHP-SOAP, ​puede activarlo desde el panel de herramientas si lo ha instalado sobre windows, clic derecho sobre el botón de notificación de Laragon, ubicar el mouse sobre PHP, sobre Extensiones y pulsar sobre Soap

Figura 1. Habilitando SOAP en Laragon Desplegar el proyecto en la carpeta ​laragon/www/ y reiniciar el servicio de Apache para que Laragon reconozca el proyecto y automáticamente pueda acceder a la url que tendrá el mismo nombre que su carpeta de proyecto. 7

Figura 2. Recargar Apache Para dirigirse a la url Laragon ofrece una manera mediante el mismo botón de notificación, mediante www le aparecerá un menú con el nombre del aplicativo, al pulsar sobre el será llevado al navegador directo al aplicativo.

Figura 3. Ubicando url mediante www

Despliegue y recomendaciones

8

Si el Aplicativo es obtenido mediante un archivo comprimido, este contará con todo lo necesario listo para hacer el despliegue y comenzar a utilizar, evitará realizar comandos típicos de una instalación de Laravel como lo son: composer install php artisan key:generate php artisan migrate Se dejará una carpeta que contiene un archivo con la extensión .sql, este debe ser importado a Mysql, en algunos casos se debe crear con anterioridad el nombre de la base de datos, si utiliza algún gestor de base de datos como PhpMyAdmin, HeidiSql, Navicat, entre otros le será mucho más cómoda la importación, si por el contrario solo puede hacerlo mediante la línea de comandos, la documentación de Mysql le puede servir en el tema, algunos de los comandos a utilizar serán por ejemplo: mysql -u root -p (para ingresar a la línea de comandos Mysql) create database ; (para crear la base de datos con el nombre indicado) use ; (acceder a la base de datos para ejecutar consultas por ejemplo “select * from users”) source (para ejecutar un archivo .sql) Alojar el proyecto será únicamente descomprimirlo en la carpeta que esté predeterminada para ver el sitio en la web, en algunos casos puede llamarse www, html, public_html entre otros, dependerá si lo está alojando en un hosting compartido, servidor, o herramienta sea Xampp, Laragon, etc. Una vez colocado en la carpeta correcta deberá configurar el archivo .env que se encuentra en la carpeta raíz del proyecto, deberá editar las siguiente sección: DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=facturaloperu DB_USERNAME=root DB_PASSWORD=secret Cambiando los campos de ​DB_DATABASE DB_USERNAME y ​DB_PASSWORD ​por los correspondientes. Podemos resumir entonces que para hacer un despliegue solo requiere descomprimir el archivos sobre el servidor web, importar la base de datos, configurar el archivo .env y si esta todo correcto solo tendrá que dirigirse a la url y comenzar a utilizar el aplicativo.

9

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.

10