Manual de Instalación SIGESP con Sistema Operativo DEBIAN Modificación Nº2
Manual de Instalación del Sistema SIGESP S.O DEBIAN Modificación Nº 02
Página | 2
Noviembre 2011
Elaborado Por: Ing. Carlos Zambrano y Jonathan Márquez. Modificado Por: AdS. Mª Angélica Matheus
Revisado Por :
Aprobado Por:
Firma:
Firma:
Manual de Instalación del Sistema SIGESP S.O DEBIAN Modificación Nº 02
PARA COMENZAR CON LA INSTALACIÓN DEL SISTEMA SIGESP SE DEBEN SEGUIR LOS SIGUIENTES PASOS: Página | 3 1.
Se debe tener conexión a Internet directa para la descarga de los paquetes necesarios para el SIGESP. Se procura que el servicio del firewall de la máquina no esté levantado de lo contrario no permitiría la descarga de los paquetes. Completadas las mismas e instalados los paquetes se puede volver a levantar el servicio del firewall.
Se edita el archivo sources.list, que se encuentra en la ruta
/etc/apt, con
cualquier editor de texto por ejemplo el nano. El sources.list sirve para que el apt
que es la instrucción para descargar los paquetes tenga el
direccionamiento a los links que va a llamar. Se debe comentar con # todo lo que este llamando al CD en caso de tener solo el CD de arranque y no el de instalación completa que sería varios CDS o un DVD. La ruta quedara de esta forma nano /etc/apt/source.list •
-Tipee ifconfig en consola con este comando se verifica el estado de las ip que se tienen en la tarjeta de red.
•
-Escribir por consola el comando dhclient eth0 para buscar las ip dinámicamente.
2. Ubíquese nuevamente en el archivo sources.list y copie estos enlaces en la última línea del mismo.
Elaborado Por: Ing. Carlos Zambrano y Jonathan Márquez. Modificado Por: AdS. Mª Angélica Matheus
Revisado Por :
Aprobado Por:
Firma:
Firma:
Manual de Instalación del Sistema SIGESP S.O DEBIAN Modificación Nº 02
Por favor comente todo con # al principio del archivo y agregue estas 2 líneas: deb http://xxx.xxx.xxx.xxx/mirror-sigesp/ stable main deb http://xxx.xxx.xxx.xxx/mirror-sigesp/ stable main contrib non-free Estos sources son los configurados en nuestra empresa los cuales han sido adaptados para que con esta simple configuración usted posea todos los paquetes necesarios para la nueva versión de Sigesp. Para obtener la dirección ip debe comunicarse con nuestras oficinas al momento de hacer la instalación, este repositorio es compatible con Debian Lenny. Si la versión del sistema operativo es mayor a Lenny puede usar las siguientes líneas de comando: deb http://debian.crosslink.net/debian/ stable main deb-src http://debian.crosslink.net/debian/ stable main deb http://http.us.debian.org/debian/ squeeze main contrib non-free deb-src http://http.us.debian.org/debian/ squeeze main contrib non-free deb http://security.debian.org/ squeeze/updates main contrib non-free deb-src http://security.debian.org/ squeeze/updates main contrib non-free deb http://ftp.us.debian.org/debian/ squeeze-proposed-updates main contrib non-free deb-src http://ftp.us.debian.org/debian/ squeeze-proposed-updates main contrib non-free
3. Tipee el comando apt-get update en una consola como usuario root para que actualice la lista que se agregó anteriormente, chequee que no existan errores. 4. Bajo la misma consola de root tipee el comando apt-get install “Paquete a Instalar” Nota: Si el comando apt-get update funcionó sin problemas, podemos pasar a instalar nuestros paquetes, puesto que ya se posee una configuración directa con nuestro servidor de paquetes, con una línea de comando puede instalar los necesarios. 5. Para la plataforma del sistema SIGESP se requieren los siguientes paquetes:
apt-get install apache2
Elaborado Por: Ing. Carlos Zambrano y Jonathan Márquez. Modificado Por: AdS. Mª Angélica Matheus
Revisado Por :
Aprobado Por:
Firma:
Firma:
Página | 4
Manual de Instalación del Sistema SIGESP S.O DEBIAN Modificación Nº 02
apt-get install php5
En caso de querer utilizar Mysql como gestor de base de datos instalar:
apt-get install php5-mysql
apt-get install mysql-server
apt-get install mysql-admin
apt-get install mysql-query-browser
Si se prefiere utilizar Postgres como gestor de base de datos instalar:
apt-get install php5-pgsql
apt-get install php5-gd
apt-get install postgresql
apt-get install pgadmin3
Si ya posee el Sigesp, use este comando (Esto es para la versión Enterprise): # apt-get install tomcat6 Si iniciaste una instalación nueva, use este comando (Esto es para la versión Enterprise) (PostgreSql): # apt-get install apache2 php5 php5-pgsql php5-gd postgresql pgadmin3 tomcat6 unrar-free ssh Elaborado Por: Ing. Carlos Zambrano y Jonathan Márquez. Modificado Por: AdS. Mª Angélica Matheus
Revisado Por :
Aprobado Por:
Firma:
Firma:
Página | 5
Manual de Instalación del Sistema SIGESP S.O DEBIAN Modificación Nº 02
Si iniciaste una instalación nueva, use este comando (Esto es para la versión Enterprise) (MySql): Página | 6 # apt-get install apache2 php5 php5-mysql php5-gd mysql-server mysql-admin tomcat6 unrar-free ssh
Este comando de instalación del apt, va así tal cual como se aprecia, los paquetes se separan con un solo espacio y solo debe confirmar la configuración de los mismos, en algunos casos como lo es para el mysql le pedirá que cree una contraseña para el usuario root.
CONFIGURACIÓN DE PAQUETES INSTALADOS. APACHE Configuración del charset:
Luego de haber instalado el apache se debe modificar el archivo denominado charset que está ubicado en la carpeta etc/apache2/conf.d
Para abrirlo se puede utilizar cualquier editor de texto, por ejemplo el nano.
El comando quedara nano /etc/apache2/conf.d/charset
Se descomentará la línea AddDefaultCharset UTF-8 y la reemplazamos por la siguiente: AddDefaultCharset ISO-8859-1. Con esto se podrán visualizar correctamente los acentos y eñes dentro del sistema.
Configuración del php.ini
Se encuentra ubicado en la ruta etc/php5/apache2
Elaborado Por: Ing. Carlos Zambrano y Jonathan Márquez. Modificado Por: AdS. Mª Angélica Matheus
Revisado Por :
Aprobado Por:
Firma:
Firma:
Manual de Instalación del Sistema SIGESP S.O DEBIAN Modificación Nº 02
El comando será nano /etc/php5/apache2/php.ini
Se modifican los siguientes parámetros como se describe a continuación: Página | 7
max_execution_time = 0
(por defecto trae 30)
Este valor significa el tiempo máximo en segundos que se le permite usar a un script antes de ejecutarse, por lo tanto al colocarle el valor en Cero (0) permitirá que los procesos largos no sean interrumpidos por el navegador. max_input_time = 1024
(por defecto trae 60)
Este valor indica el tiempo máximo en segundos que el script puede invertir en analizar datos recibidos, este valor depende de max_execution_time, ya que todos los scripts están sujetos a este valor, y como está de forma ilimitada esto permitirá que los procesos largos no sean interrumpidos por el navegador. memory_limit = 2048M
(por defecto trae 8)
El valor indica el tamaño máximo de memoria en bytes que se permite usar para la ejecución de un script. Depende del máximo de memoria disponible en el servidor, así se evita que se consuma toda la memoria disponible de un servidor en un solo proceso y permitirá que los reportes que contengan mucha información puedan ser generados sin ser interrumpidos por el navegador. max_input_var = 8000
(por defecto trae 1000)
Limita el número de variables que pueden llegar por $_GET, $_POST y $_COOKIE. Esto ha llevado a que aplicaciones que emplean formularios con muchos inputs tipo checkbox / hidden / text, puedan tener problemas al perder datos en la recepción desde el servidor. Elaborado Por: Ing. Carlos Zambrano y Jonathan Márquez. Modificado Por: AdS. Mª Angélica Matheus
Revisado Por :
Aprobado Por:
Firma:
Firma:
Manual de Instalación del Sistema SIGESP S.O DEBIAN Modificación Nº 02
error_reporting = E_ALL & ~E_NOTICE, debe estar descomentada y al final de dicha línea colocarle & ~E_WARNING quedara de la siguiente manera: error_reporting = E_ALL & ~E_NOTICE & ~E_WARNING
Página | 8
Esta variable indica todos los errores críticos, excluyendo advertencias que pueden indicar mal funcionamiento del código pero no impiden la ejecución del php. Nos vamos a la carpeta /etc/php5/conf.d y se edita el archivo suhosin.ini y se colocara “ ; ” en la línea extensión=suhosin.so quedando de la siguiente manera ;extensión=suhosin.so
Utilice el siguiente comando para reiniciar los servicios:
Nombre del servicio a reiniciar
/etc/init.d/apache2 restart Nota: Los fuentes que en este caso están en la carpeta sigesp se deben copiar en la carpeta virtual que genera el apache2 var/www/ Para darle permisos a las fuentes chmod –R 777 /var/www
Todas estas carpetas a las que se esta accesando no tienen permiso para modificaciones. Es por esto que deben utilizar el comando chmod.
Elaborado Por: Ing. Carlos Zambrano y Jonathan Márquez. Modificado Por: AdS. Mª Angélica Matheus
Cuando un comando este precedido por el signo # significa que está en comentario. Para descomentarlo solo basta con quitar dicho signo.
Revisado Por :
Aprobado Por:
Firma:
Firma:
Manual de Instalación del Sistema SIGESP S.O DEBIAN Modificación Nº 02
MySQL Página | 9 Para el gestor de MYSQL se empleará el manejador Mysql-Administrator,
este permite realizar backups (respaldo) y restauraciones de bases de datos en sus pestañas respectivas. Este gestor debe configurarse para que las bases de datos tomen los datos con charset UTF8, para ello debemos modificar el archivo my.cnf y buscar la palabra “mysqldump” la cual se buscara en consola por medio de este comando nano /etc/mysql/my.conf justamente en la línea anterior que no debe tener nada colocamos esto: #If no specific storage engine/table type is defined in an SQLCreate statement the default type will be used. default-storage-engine=innodb #Set the default character set. default-character-set=utf8 #Set the default collation. default-collation=utf8_general_ci -
Se busca la linea bind-address la cual se comenta #
-
Utilice el siguiente comando para reiniciar los servicios /etc/init.d/mysql restart esto para tome los cambios el mysql.
PostgreSQL y PgAdmin III Para el PostgreSQL se configuran los siguientes archivos:
Elaborado Por: Ing. Carlos Zambrano y Jonathan Márquez. Modificado Por: AdS. Mª Angélica Matheus
Revisado Por :
Aprobado Por:
Firma:
Firma:
Manual de Instalación del Sistema SIGESP S.O DEBIAN Modificación Nº 02
Se edita el archivo postgresql.conf que se encuentra en la ruta /etc/postgresql/8.X/main/postgresql.conf
Allí se busca la línea listen_addresses=’localhost’ la cual se descomenta y se Página | 10 reemplaza la palabra ‘localhost’ por ‘ *’ quedando de la siguiente manera: listen_addresses=’*’
Se
edita
el
archivo
pg_hba.conf
que
se
encuentra
en
la
ruta:
/etc/postgresql/8.X/main/pg_hba.cong
Se busca la última línea
Aquí se colocaran las ip que tendrán acceso remoto al postgres, se ubicaran al final del archivo en donde se colocara la línea de código host all all seguido de la ip, mascara de red y el md5. Ejemplo: host
all
all 192.xxx.x.xx 255.255.255.0 md5
Para el pgadmin III se debe crear un súper usuario debido a que el mismo trae por defecto el súper usuario postgres y se desconoce la clave, por tal motivo se procede de la siguiente manera:
Si lo que se quiere es modificar el usuario postgres, una vez tipeado el comando su postgres colocamos la instrucción psql, esto ejecutara la consola postgres, luego escribimos el comando: ALTER ROLE postgres WITH PASSWORD ‘contraseña’; -Si el comando funcionó correctamente debe decir “ALTER ROLE”. -Se sale de la consola con \q. -Se coloca exit para salir de la consola de postgres. Elaborado Por: Ing. Carlos Zambrano y Jonathan Márquez. Modificado Por: AdS. Mª Angélica Matheus
Revisado Por :
Aprobado Por:
Firma:
Firma:
Manual de Instalación del Sistema SIGESP S.O DEBIAN Modificación Nº 02
Utilice el siguiente comando para reiniciar los servicios:
Nombre del servicio a reiniciar
/etc/init.d/postgresql restart
Reiniciar los servicios de apache2, mysql, postgresql al modificar cualquiera de ellos. Php5 no se reinicia puesto que sus cambios son alterados al reiniciar el servicio de apache2
Continuando con la instalación del paquete pgadmin III: •
Ingrese al mismo
•
Haga clic sobre el icono
•
Sitúese sobre address, escriba localhost.
•
Sitúese en description, coloque DATA (Esto es indistinto, es una descripción
(esto es solo para modo grafico).
para tu data). •
Sitúese en username, coloque el nombre del usuario que se creó con el comando createruser y haga clic en ok.
•
Ubíquese en la opción databases, proceda a crear el repositorio, para la base de datos.
•
Si al tratar de crear la nueva base de datos no le permite crearlo con el encoding en Latin9 primero entre al usuario su postgres, luego entre a la consola psql y ejecute la siguiente línea de comando: update pg_database set encoding=16 where datname=’db_ejemplo’; -Se sale de la consola con \q. - exit para salir de la consola de postgres.
Elaborado Por: Ing. Carlos Zambrano y Jonathan Márquez. Modificado Por: AdS. Mª Angélica Matheus
Revisado Por :
Aprobado Por:
Firma:
Firma:
Página | 11
Manual de Instalación del Sistema SIGESP S.O DEBIAN Modificación Nº 02
Luego de esto ubíquese en el contenedor database y actualice para visualizar los cambios. •
Creado el repositorio colóquese sobre el mismo y haga clic con el botón Página | 12 derecho, elija la opción restore para restaurar la base de datos.
•
Busque el archivo.backup, el mismo se encuentra en la carpeta donde están los fuentes.
Observe: Otorgar los permisos necesarios a las fuentes de SIGESP, con el comando chmod-R 777” nombre de la carpeta a otorgar permisos”
TOMCAT6 •
Para montar el birt y que tenga una buena permisologia debemos ir al archivo de configuración tomcat6 que se encuentra en la ruta /etc/default/, dentro de este archivo se encuentra una variable llamada TOMCAT_SECURITY por defecto esta variable se encuentra con el valor “yes”, solo debemos cambiarlo a “no”, igualmente debemos reiniciar el tomcat con el comando anteriormente dado /etc/init.d/tomcat6 restart
•
El birt es un complemento que será entregado por nosotros en la instalación, esta llamada carpeta debe ir en esta ubicación /var/lib/tomcat6/webapps, la misma debe ir con permisos , Chmod -R 777 /var/lib/tomcat6/webapps nuevamente reiniciamos el tomcat /etc/init.d/tomcat6 restart.
•
Como el tomcat 6 define un puerto por defecto que es el 8180, debemos cambiarlo, buscamos el archivo server.xml que se encuentra en el directorio /etc/tomcat6, buscamos la palabra “” alli se encuentra una variable llamada Connector port="8180" cambiamos el valor 8180 por 8081. Página | 13 •
De la misma forma se puede iniciar, detener o reiniciar el servicio del tomcat con el comando /etc/init.d/tomcat6 [start | stop | restart]
•
Para asegurarnos que el tomcat está corriendo simplemente vamos al navegador (firefox, iceweasel..) y tipeamos http://localhost:8081/ apareciendo esta pantalla:
Cuando se trabaja desde una maquina remotamente no se coloca localhost en la dirección del navegador
se coloca la ip del servidor con el cual se esta
trabajando. Luego de montar la base de datos, ubíquese en la dirección var/www/sigesp y edite el archivo sigesp_config.php de la siguiente forma:
Elaborado Por: Ing. Carlos Zambrano y Jonathan Márquez. Modificado Por: AdS. Mª Angélica Matheus
Revisado Por :
Aprobado Por:
Firma:
Firma:
Manual de Instalación del Sistema SIGESP S.O DEBIAN Modificación Nº 02
1. Editar el archivo de acuerdo al gestor de base de datos a emplear. Caso A: Postgresql $empresa["hostname"][1]="localhost";
Página | 14
$empresa["port"][1]="5432"; $empresa["database"][1]="db_instituto_2008"; >Nombre de la base de datos $empresa["login"][1]="postgres"; $empresa["password"][1]="instituto"; > El password del usuario $empresa["gestor"][1]="POSTGRES"; $empresa["width"][1]="70"; $empresa["height"][1]="70"; $empresa["logo"][1]="logo.jpg"; Caso B: Mysql $empresa["hostname"][2]="localhost"; $empresa["port"][2]="3306"; $empresa["database"][2]="db_instituto_2008"; >Nombre de la base de datos $empresa["login"][2]="root"; $empresa["password"][2]=""; > El password del usuario $empresa["gestor"][2]="MYSQLT"; $empresa["width"][2]="70"; $empresa["height"][2]="70"; $empresa["logo"][2]="logo.jpg"; Para
la
versión
de
SIGESP
Enterprise,
ubíquese
en
la
dirección
/var/www/sigesp/base/xml/ y edite el archivo sigesp_xml_configuracion.xml de la siguiente manera:
Elaborado Por: Ing. Carlos Zambrano y Jonathan Márquez. Modificado Por: AdS. Mª Angélica Matheus
Revisado Por :
Aprobado Por:
Firma:
Firma:
Manual de Instalación del Sistema SIGESP S.O DEBIAN Modificación Nº 02
localhost 5432 db_prueba_2011 alias_bd usuario contraseña POSTGRES nombre_directorio logo.jpg 70 70
Página | 15
Normas para Actualizar los fuentes de la plataforma SIGESP La idea principal del manejo de los fuentes y de actualizaciones es tener 2 directorios virtuales uno para las pruebas piloto y otro el de producción (Donde van a trabajar los usuarios día a día), esto con la finalidad de garantizar el buen manejo de los fuentes y que se entorpezca en lo más mínimo a los usuarios finales. Bajo esta filosofía el procedimiento abajo descrito se debe hacer primero en los fuentes de prueba y una vez validada y certificada la actualización en los fuentes de producción. 1. Verificar correo enviado por Calidad, el cual va a indicar nro de Solicitud y una breve descripción. (El nro de solicitud ya debe ser de su conocimiento ya que al recibir el correo se da respuesta con la misma). 2. Descargar la Actualización enviada por Calidad y verificar que sistemas abarca la misma. Elaborado Por: Ing. Carlos Zambrano y Jonathan Márquez. Modificado Por: AdS. Mª Angélica Matheus
Revisado Por :
Aprobado Por:
Firma:
Firma:
Manual de Instalación del Sistema SIGESP S.O DEBIAN Modificación Nº 02
3. Realizar Backup de los fuentes que se van a actualizar, es decir, si en la actualización enviada por SIGESP, están las carpetas de CFG, SCG y SHARED Ud. Debe tomar estas carpetas de sus fuentes copiarlas en el Página | 16 directorio de respaldo de fuentes. Esto con la finalidad de que si sucede alguna eventualidad pueda regresar a su versión anterior. 4. Llenar el formato de registro de actualizaciones proporcionado por SIGESP, con toda la actualización referente a la misma. 5. Actualizar permisos de la Carpeta del SIGESP, colóquese en un nivel antes de la carpeta donde se encuentren los mismos, un ejemplo seria: Si los fuentes están en la carpeta /var/www/ debería ubicarme en /var para así concederle permisos a la carpeta www. Estos permisos deben ser relectura y escritura esto con la finalidad de garantizar que todos los archivos se reemplacen sin ningún problema. 6. Una vez dado los permisos, entrar a la carpeta de los fuentes y reemplazar los archivos por los enviados por calidad. 7. Finalmente Actualizar de nuevo los permisos como lo indica el punto nro. 5. Esto para garantizar que una vez reemplazados los archivos tengan los permisos pertinentes. 8. Hacer las pruebas pertinentes con la finalidad de certificar que la actualización enviada corrige ó mejora lo solicitado. 9. Enviar correo a calidad indicando la efectividad de la actualización. Es importante destacar que los puntos 5 y 7 (los referidos a darle los permisos a las carpetas) son de suma importancia ya que la falta de permisología de lectura y escritura afectar la actualización de los fuentes causando inconvenientes y molestias a la hora de probar las soluciones enviadas, ya que
Elaborado Por: Ing. Carlos Zambrano y Jonathan Márquez. Modificado Por: AdS. Mª Angélica Matheus
Revisado Por :
Aprobado Por:
Firma:
Firma:
Manual de Instalación del Sistema SIGESP S.O DEBIAN Modificación Nº 02
pareciera que no fueran efectivas cuando en realidad es que los archivos no han sido actualizados de manera correcta. Página | 17 No olvide otorgar permiso al directorio virtual completo al momento de realizar actualizaciones de las fuentes e inclusive antes de actualizar. El comando a utilizar es el siguiente: var# chmod –R 777 www/
El Directorio de Respaldo de Fuentes, es un Directorio donde se deben ubicar los fuentes antes de hacer las actualizaciones enviadas por SIGESP y lo más recomendable es que lo organice por Fecha y luego por Nro. de solicitud.
Elaborado Por: Ing. Carlos Zambrano y Jonathan Márquez. Modificado Por: AdS. Mª Angélica Matheus
Revisado Por :
Aprobado Por:
Firma:
Firma: