.. sipcoescolar documentation master file, created by sphinx-quickstart on Sun Nov 13 21:34:01 2016. You can adapt this file completely to your liking, but it should at least contain the root `toctree` directive. Instalación de SIPCO-EDUCACIÓN.! ================================ Este sistema está escrito en lenguaje PHP enmarcado en el framework CodeIgniter junto con lenguaje sql para interactuar con base de datos relacionales en MySQL. Está diseñado para ser usado desde un navegador de internet (o cualquier interprete de documentos HTML y bases de datos) y para su instalación es necesario tener disponible instalaciones estables de: * Lenguaje PHP version 7 (o superior) * Servidor de Bases de Datos MySQL * Servidor WEB (Preferiblemente APACHE 2 o mayor) * Permisos de Root (para sistemas Unix) * Espacio en disco no menor a 80MB dependiendo de la cantidad de datos a manejar. PARA SISTEMAS UNIX (Linux – MAC) --------------------------------- La instalación aquí presentada sirve para instalar el software en un equipo que no se asemeja a un alojamiento profesional (Hosting). Debido a que el sistema aunque complejo puede trabajar incluso desde una Laptop, se plantea esta forma de instalación para que sea usado hasta en la escuela más pequeña del país sin ningún contratiempo y con todas las funcionalidades que puede ofrecer el software. Se puede instalar en otros sistemas operativos pero aquí solo se mostrará la forma de como instalarlo para sistemas Linux derivados de Debian. Previo a la instalación se debe haber creado un usuario con permisos Root si no se ha hecho ya. Según su distribución de sistema operativo debe realizar la instalación de apache, PHP, MySQL y PHPMYADMIN. Para los usuarios de Ubuntu y derivados de Debian los comandos son: ``sudo apt-get update`` Instale Apache ~~~~~~~~~~~~~~ Para instalar el servidor web que va a entregar la pagina principal y el resto de las paginas relacionadas. Usaremos el servidor web APACHE (se puede utilizar cualquier version a partir de la 2.4) ``sudo apt-get install apache2`` Para probar la configuración de apache debe ejecutar el comando: ``sudo apache2ctl configtest`` Si sale un mensaje de error proceda a abrir el archivo apache2.conf con el siguiente comando ``sudo nano /etc/apache2/apache2.conf`` ... y agregue al final la linea: :: ServerName server_domain_or_IP repita el comando ``sudo apache2ctl configtest`` y verifique que no hay mensaje de error. Reinicie apache ``sudo systemctl restart apache2`` Ajuste el firewall para el tráfico web ``sudo ufw allow in "Apache Full"`` Instale MySQL ~~~~~~~~~~~~~ EL comando a ejecutar en un terminal (consola) es: ``sudo apt-get install mysql-server phpmyqadmin`` Configure la seguridad para la base de datos ``sudo mysql_secure_installation`` … continúe los pasos hasta el final de la instalación. Se configurará el usuario y la contraseña de usuario para MySQL que serán las usadas en el archivo “database.php” del sistema. Instale PHP ~~~~~~~~~~~ El comando para instalar este lenguaje desde la consola (terminal) es: ``sudo apt-get install php libapache2-mod-php php-mcrypt php-mysql`` Luego, reinicie Apache ``sudo systemctl restart apache2`` Compruebe que apache está activo y sin problemas ``sudo systemctl status apache2`` Si hace falta, instale los módulos necesarios para el intérprete php ``sudo apt-get install php-cli php-xml`` Descomprima el archivo **sipco-educacion.local.zip** en la carpeta: :: /var/www/ y dele los permisos necesarios para poder trabajar en ellos. El comando chmod 754 es lo recomendado. Tenga en cuenta que para guardar información en el sistema debe tener una base de datos creada. Abra en un navegador el programa: :: localhost/phpmyadmin ... y luego de autenticarse, cree una base de datos con el nombre “bdsipcoedu”. Cuando esté listo, importe el archivo: :: bdsipcoedu_inicial.sql que se encuentra en: :: /var/www/sipco-educacion.local/backup/ Agregue un servidor virtual para que pueda llamar al sistema por su nombre desde un navegador. Agregue un archivo llamado “sipco-educacion.local.conf” en el directorio: :: /etc/apache2/sites-available y agregue las siguientes líneas: :: DocumentRoot /var/www/sipco-educacion.local ServerName sipco-educacion.local ServerAlias www.sipco-educacion.local ServerAdmin admin@sipco-educacion.com ErrorLog /var/www/sipco-educacion.local/application/logs/error-sipco-edu.log CustomLog /var/www/sipco-educacion.local/application/logs/access-sipco-edu.log combined # vim: syntax=apache ts=4 sw=4 sts=4 sr noet . Guarde el archivo y luego en la linea de comando escriba ``sudo a2ensite sipco-educacion.local.conf`` Abra el archivo host que se encuentra en la carpeta: /etc/ ... y agregue al final las líneas :: 127.0.0.2 sipco-educacion.local Reinicie apache ``sudo systemctl restart apache2`` Por ultimo es necesario activar el mod Rewrite con los comandos: ``cat /etc/apache2/mods-available/rewrite.load`` ... y luego ``sudo a2enmod rewrite`` Reinicie apache de nuevo: ``sudo systemctl restart apache2`` Edite el archivo apache2.conf con el siguiente comando: ``sudo gedit /etc/apache2/sites-available/000-default.conf`` ... busque las lineas que se lean igual a las siguientes: :: Options FollowSymLinks AllowOverride None Require all denied . borrelas y en esa misma linea en la que quedó pegue todo lo siguiente (todo lo que empiece con las etiquetas " y "): :: # # Options FollowSymLinks # AllowOverride None # Require all denied # # # Options Indexes FollowSymLinks # AllowOverride None # Require all granted # # # Options Indexes FollowSymLinks # AllowOverride None # Require all granted # ################################################# Options FollowSymLinks MultiViews AllowOverride All Require all granted Options Indexes FollowSymLinks MultiViews AllowOverride None Require all granted AllowOverride None Require all granted Options Indexes FollowSymLinks MultiViews AllowOverride All Require all granted # agregar el servidor virtual Options Indexes FollowSymLinks MultiViews AllowOverride All Require all granted . Si no hay mensajes de error, abra un navegador y escriba en la barra de dirección :: http://sipco-educacion.local Eso es todo lo que hace falta para ejecutar el programa. En caso de necesitar desinstalarlo, solo es necesario borrar la carpeta principal donde se copiaron los archivos del software y eliminar la base de datos del servidor de base de datos. Si se desea desinstalar absolutamente todos los programas anteriormente instalados solo es necesario escribir en una consola ``sudo apt-get autoremove [nombreDelProgramaAdesinstalar]`` De esta manera los sistemas basados en Debian desinstalan automáticamente los programas y dependencias instaladas previamente en el sistema.