Guía de instalación del sistema de documentos

laborales Orquídea

Orquídea V 2.1.1
Fecha de publicación: Mayo 2016
Autor Deivis Henriquez

Este documento se proporciona «tal cual». Algunos de los ejemplos que aparecen aquí se
proporcionan únicamente con fines ilustrativos y son ficticios. No se pretende indicar ni debe
deducirse ninguna asociación ni conexión real.
Este documento no otorga derecho legal sobre el proyecto desarrollado. Este documento puede copiarse
y usarse para fines internos y de referencia.

Copyleft © 2014-2016 Orquídea.

2
Contenido

4 CAPITULO 1: Objetivo
4 CAPITULO 2: Requisitos
5 CAPITULO 3: Configuración servidor Apache
6 CAPITULO 4: Ejecutar script de base de datos
7 CAPITULO 5: Inicializando Orquídea V 2.1.1

3
Objetivo

El presente manual tiene como objetivo asesorar al usuario en la instalación del sistema de
documentos laborales Orquídea

Requisitos

Poseer una versión estable del sistema SIGESP, con al menos un periodo de nomina
procesado correctamente.
Servidor web Apache en cualquier versión bajo Windows 2000/XP/Vista/7 ó Linux/UNIX capaz
de ejecutar PHP5
PHP 5.3.x instalado y funcionando en el servidor, con las siguientes extensiones php5-mysql,
php5-mysqli (para la versión MySQL), php5-pgsql, php5-curl y php5-gd
Manejador de base de datos MySQL 5.x (Para la versión MySQL)
Manejador de base de datos PostgreSQL 9.x (Para la versión PostgreSQL)
Navegador Mozilla Firefox (Recomendado)

4
Configurando Apache

Orquidea utiliza un módulo llamado mod_rewrite para la reescritura de URLs y las hace más
comprensibles y fáciles de recordar. Por esto, el módulo debe ser configurado e instalado en Apache.

Para esto, debe chequear que el módulo esté habilitado en el httpd.conf (de acuerdo a la versión de
apache).

Habilitando Mod_Rewrite en S.O. Basados en GNU/Linux (Debian, Ubuntu y derivadas)

Nos aseguramos primero de activar el mod_rewrite de esta manera y como usuario root

a2enmod rewrite

Para Windows hay que activar el modulo en el archivo httpd.conf, es decir sustituir esta línea de
código

#LoadModule rewrite_module modules/mod_rewrite.so

por esta

LoadModule rewrite_module modules/mod_rewrite.so

Después de este paso editamos el siguiente archivo:

$ sudo vi /etc/apache2/sites-enabled/000-default

Recuerde que puede escoger cualquier editor: vi, nano, gedit, etc en este ejemplo usamos vi. Cuando
estemos dentro de dicho archivo, vamos a cambiar las siguientes líneas que aparezcan así:
AllowOverride None por esta otra: AllowOverride All

<Directory "/to/document/root">
Options Indexes FollowSymLinks
AllowOverride All
Order allow,deny
Allow from all
</Directory>

En el caso de la distribución Ubuntu y Xubuntu, existen 4 líneas de estas dentro del archivo 000-
default.

Ahora solo reiniciamos nuestro servicio Apache

#/etc/init.d/apache2 restart

5
Ejecutando el script de base de datos
Inicializamos la aplicación MySQL-Workbench o PGADMIN 3 (Según sea el caso) y ejecutamos la
siguiente sentencia.

create database orquidea;

Verificamos que nuestra base de datos haya sido creada.

Seleccionamos nuestra base de datos y procedemos a importar nuestro script orquidea_*.sql,

presionamos el icono (Abrir script SQL), el sistema desplegara una ventana donde importaremos
nuestro script.

Para finalizar presionamos el botón ejecutar.

6
Inicializando Orquídea
Debemos descomprimir nuestro archivo orquidea.rar y ubicar la carpeta orquidea en el directorio de
archivos de nuestro servidor apache (DocumentRoot).

NOTA: En sistemas Linux debemos establecer permisos de escritura y lectura sobre el directorio del
sistema.

Parametrizar databases.ini

Debe editar el archivo databases.ini ubicado en la ruta orquidea/config, actualizamos las siguientes
líneas para la conexión a la base de datos de Orquidea:

[production]
host = IP_BD_ORQUIDEA
username = NOMBRE_USUARIO_BD
password = CONTRASEÑA_BD
name = NOMBRE_BD
type = TIPO_BD

Sustituimos

IP_BD_ORQUIDEA Por la ip del servidor donde se encuentra la base de datos

NOMBRE_USUARIO_BD por el nombre de nuestro usuario de base de datos
CONTRASEÑA_BD por la contraseña de acceso del usuario.
NOMBRE_BD por el nombre de nuestra base de datos.
TIPO_BD sustituir por mysqli para la versión MySQL o pgsql para PostgreSQL.

Una vez culminamos procedemos a agregar el siguiente código para establecer la conexión o
conexiones con la base de datos o bases de datos de SIGESP, cabe desatacar que SIGESP usa
bases de datos diferentes para cada periodo, debe replicar este fragmento de código tantas bases de
datos de SIGESP tenga activas.

[AÑO_PERIODO]
host = IP_BD_SIGESP
username = NOMBRE_USUARIO_BD
password = CONTRASEÑA_BD
name = NOMBRE_BD_SIGESP
type = pgsql

Sustituimos

AÑO_PERIODO Por el año del periodo por ej. 2016

IP_BD_SIGESP Por la ip del servidor donde se encuentra la base de datos de SIGESP

7
 NOMBRE_USUARIO_BD por el nombre de nuestro usuario de base de datos de SIGESP
CONTRASEÑA_BD por la contraseña de acceso del usuario.
NOMBRE_BD por el nombre de nuestra base de datos de SIGESP

Parametrizar config.ini

Procedemos a editar el archivo config.ini ubicado en la ruta orquídea/config, con el fin de poder activar
la recuperación de contraseñas desde la ventana de inicio y activar los periodos de las BD en el
sistema.

En la etiqueta [application], actualizar el valor de la constante:

[application]
directorio_sigesp = IP_SERVIDOR/DIRECTORIOSIGESP

Sustituir por la URL del sistema SIGESP, por ejemplo http://192.168.1.1/sigesp/

En la etiqueta correo actualizar los siguientes valores

[correo]
nombre_servidor = IP_NOMBRE_DOMINIO_SERVIDOR
servidor_smtp = IP_SMTP
seguridad_smtp = CAPA_SEGURIDAD
puerto_smtp = PUERTO_SMTP
usuario_smtp = USUARIO_SMTP
password_smtp = CONTRASEÑA_SMTP

Sustituimos

IP_NOMBRE_DOMINIO_SERVIDOR Ip o nombre del servidor orquídea ejemplo

http://192.168.1.1
IP_SMTP ip o nombre del dominio del servidor SMTP a utilizar.
CAPA_SEGURIDAD si el servidor utiliza alguna capa de seguridad por ejemplo SSL
PUERTO_SMTP puerto donde funciona el servidor SMTP
USUARIO_SMTP usuario o correo del servidor SMTP
CONTRASEÑA_SMTP contraseña de acceso al servidor SMTP

Al final del archivo se encuentra la etiqueta [sigesp], que corresponde a los periodos de las bases de
datos, recuerde que debe colocar el año del periodo, no el nombre de la base de datos.

[sigesp]
bd = PERIODO1,PERIODO2,ETC,……

Sustituimos los valores de la constante bd, por los años de los periodos de las BD de SIGESP, estos
deben estar separados por coma por ejemplo 2014,2015,2016

8
Para finalizar nuestra instalación verificamos que hemos seguido el procedimiento correctamente
ingresando en mozilla firefox la url de nuestro sistema:

http://url_servidor_produccion/orquidea/administrador

Los datos de acceso por defecto son:

Usuario: admin
Contraseña: 12345678

Para poner en funcionamiento el sistema es necesario sincronizar la base de datos de Orquídea con
los datos de la base de datos de SIGESP, para mayor información verificar el manual administrador en
la sección Organización y Nominas.