MANUAL DE INSTALACIÓN ORFEO
TABLA DE CONTENIDO 1. CONSIDERACIONES PREVIAS............................................................2 2. REQUERIMIENTOS.............................................................................2 3. SERVIDOR WEB...................................................................................3 3.1 INSTALACIÓN DE PAQUETES ......................................................3 3.2 CONFIGURACION DE PAQUETES.................................................4 3.3 DESCARGA DE ORFEO..................................................................5 3.4 COMPROBAR PAQUETES .............................................................6 4. SERVIDOR DE BASE DE DATOS..........................................................8 4.1 PROCEDIMIENTO..........................................................................8 4.1.1 CONFIGURACIÓN ARCHIVO CONFIG.PHP..........................10 4.1.2 CONFIGURACION DEL OCI8................................................11 5. INGRESAR A ORFEO.........................................................................18 6. SERVIDOR DE IMÁGENES................................................................19 6.1 CREACIÓN DE LA BODEGA.........................................................20
1
MANUAL DE INSTALACIÓN ORFEO
El presente manual ha sido elaborado con el ánimo de ser una guía para aquellas personas que requieren instalar Orfeo y que hasta ahora están dando sus primeros pasos con Linux. Este manual ha sido realizado por: Angie Milena Morales Maury (
[email protected]) y Nelson Soriano Soriano (
[email protected]).
1. CONSIDERACIONES PREVIAS
En este manual se presentarán los pasos necesarios para instalar el Gestor Documental Orfeo bajo la distribución linux Ubuntu 8.04 (Hardy Heron) y con Base de Datos Oracle.
2. REQUERIMIENTOS
●
Tener conexión a red y la configuración adecuada para que se permita la descarga de los paquetes y archivos que se necesitan.
●
El equipo o el servidor que se tenga destinado para la instalación del Gestor Documental.
●
Se nombraran los servidores o Servicios que requiere Orfeo para su funcionamiento, se debe tener en cuenta que no necesariamente son equipos separados, dependiendo de la 2
MANUAL DE INSTALACIÓN ORFEO entidad todos los servidores pueden instalarse en uno solo o también se pueden tener equipos separados dependiendo del estudio de necesidades de la entidad.
1. Servidor Web 2. Servidor de Base de Datos 3. Servidor de Imágenes
3. SERVIDOR WEB
3.1 INSTALACIÓN DE PAQUETES - PHP5 - Apache2 - Orfeo 3.6.0 – 3.7.0 - Subversion - Install Client Oci8 Instalar apache 2, php 5 y el manejador de versiones subversion El subversion se puede descargar de http://subversion.tigris.org
3
MANUAL DE INSTALACIÓN ORFEO Si esta detrás de un proxy se debe configurar el archivo /etc/subversion/servers, para que en la sección [global] se tenga el puerto y la dirección de su proxy.
Para instalar los paquetes Desde de una terminal de comandos: sudo apt-get install php5-gd apache2 libapache2-mod-php5 php5-imap subversion locales
En caso de que se use un proxy, es necesario exportar las variables de entorno http_proxy y ftp_proxy para llevar a cabo la descarga de paquetes: export http_proxy=http://ipproxy:puerto export ftp_proxy=ftp://ipproxy:puerto
3.2 CONFIGURACION DE PAQUETES Configurar las librerías de php:
4
MANUAL DE INSTALACIÓN ORFEO php5xsl php5xmlrpc Verificar que en el archivo /etc/php5/apache2/php.ini estén las siguientes variables con los respectivos valores. register_globals = On display_errors = Off session.save_path = ?/tmp? session.gc_maxlifetime = 0 session.cache_expire = 0 session.use_trans_sid = 1 Verificar que en el archivo /etc/apache2/apache2.conf estén las siguientes variables con los respectivos valores. # LoadModule php5_module modules/libphp5.so Addtype application/x-httpd-php .php Addtype application/x-httpd-php-source .phps DirectoryIndex index.html index.php login.php DocumentRoot "/var/www/orfeo_3.6.0" "/var/www/orfeo_3.7.0" "/var/www/orfeo_3.7.0" 5
MANUAL DE INSTALACIÓN ORFEO
3.3 DESCARGA DE ORFEO Es necesario tener subversión para descargar Orfeo:
●
Mediante consola ubíquese en var/www así: cd /var/www //esta es la ruta donde descargará Orfeo
●
Descargue Orfeo de la siguiente manera:
Versión 3.6.0 svn co http://orfeo.superservicios.gov.co:8033/repos/orfeo/branches/o rfeo_3.6.0 username=public –password=orfeo Versión 3.0.7 svn co https://orfeogpl.info/svn/src/orfeo-3.7.2username=public – password=orfeo
6
MANUAL DE INSTALACIÓN ORFEO 3.4 COMPROBAR PAQUETES
Es necesario comprobar que PHP se está ejecutándose cuando apache inicia, siga los siguientes pasos, para verificar esto:
–
Inicie el servicio de apache con: Mediante consola: sudo /etc/init.d/apache2 start
En /var/www cree un archivo llamado phpinfo.php, con el siguiente contenido: Ejecute su navegador Web y en la dirección URL coloque: http://IPServidorOrfeo/phpinfo.php esto deberá mostrarle una página con la configuración de PHP
7
MANUAL DE INSTALACIÓN ORFEO así:
4. SERVIDOR DE BASE DE DATOS El servidor de la Base de Datos puede ser cualquiera de estos: PostGres (GPL) Oracle MsSql En nuestro caso la Base de Datos esta en Oracle 9i, por tanto es necesario tener un cliente para Oracle que nos permita la conexión,
8
MANUAL DE INSTALACIÓN ORFEO el cliente que instalamos fue el oci8.
4.1 PROCEDIMIENTO
Para la creación de la Base de Datos se utilizaron 3 archivos que se descargaron
de
la
página
(http://orfeogpl.org/ata/node/90).
Los
de tres
Orfeopgl.org
archivos
son
los
siguientes (elimine la extensión .txt): o370.dmp o370.sql o370.log - Cree un usuario, asigne le permisos de DBA. - Importe el export en el usuario anterior creado. - Descargue los 3 archivos adjuntos en su equipo. - En una ventana de comandos, ejecutar la siguiente inscripción para importar el export: imp usr_orfeo/pwd_orfeo@Svc file=ruta/a/archivo/o370.dmp log=ruta/a/archivo/o370.log fromuser=fldoc touser=usr_orfeo commit=y ignore=y 9
MANUAL DE INSTALACIÓN ORFEO
- Alimente la B.D. ejecutando el script de inicialización. - Desde el mismo SqlPlus ejecute @ruta/a/archivo/o370.sql - DONDE: usr_orfeo : //Usuario de la B.D que tiene los permisos de DBA. pwd_orfeo : //Contraseña del usuario anterior. ruta/a/archivo/ : Path físico al archivo referenciado. Svc : Es la cadena de conexión a Oracle. El script de inicialización crea una "Dependencia de pruebas" con código
998
y
un
usuario
ADMON
(perteneciente
a
dicha
dependencia) con perfil de administración. A través de él podrá loguearse y empezar la parametrización del sistema con los datos de la entidad. Nota: Antes de ingresar a Orfeo con el usuario ADMON se debe configurar el archivo config.php y configurar el Cliente para Oracle Oci8. 4.1.1 CONFIGURACIÓN ARCHIVO CONFIG.PHP Es necesario modificar el config.php con los datos que corresponden
10
MANUAL DE INSTALACIÓN ORFEO para que se pueda dar la conexión y el funcionamiento inicial de Orfeo.
Encontramos este archivo config.php.oracle en la siguiente ruta • Ubicarse en el directorio /var/www/orfeo_3.6.0 /var/www/orfeo_3.7.0 • Renombrar config.php.oracle a config.php Mediante consola: sudo cp config.php.oracle config.php Editar el archivo config.php y cambiar los valores a sus respectivos parámetros, de la siguiente forma: servicio = "nombre de instancia" // instancia de oracle para DB usuario = "orfeo" // Usuario DB contrasena= "contraseña"// Contraseña DB servidor = "ip del servidor" // Servidor DB db = "nombre de instancia" //Se deja igual que el servicio driver = "oci8” // Driver de la base de datos ambiente = "orfeo" //Variable que indica el ambiente de trabajo 11
MANUAL DE INSTALACIÓN ORFEO entidad= "nombre de entidad" ADODB_PATH="/var/www/orfeo_3.7.0/adodb/ //Ruta estatica completa del path de adodb entidad_largo= "nombre largo de entidad" entidad_tel = "telefono entidad" entidad_dir = "dirección de entidad" ADODB_CACHE_DIR = "/tmp"
4.1.2 CONFIGURACION DEL OCI8 Necesitamos habilitar la librería oci8 en PHP5 utilizando Instant Client de Oracle en Ubuntu, de la siguiente manera: • Instalar módulos y librerías PHP5. Mediante consola: apt-get install php5-common php5 php5-dev php5-cli • Instalar los paquetes build-essential y php-pear. Mediante consola: apt-get install build-essential php-pear • Instalar la librería libaio1. 12
MANUAL DE INSTALACIÓN ORFEO
Mediante consola: apt-get install libaio1 • Descargar la última versión de SDK e Instant Client de Oracle. (archivos SDK.zip y Basic.zip versión 11.1.0.6.0) http://www.oracle.com/technology/software/tech/oci/instantclient/i ndex.html • Crear un directorio para extraer los archivos zip.
Mediante consola: mkdir /opt/oracle • Mover los archivos zip al directorio /opt/oracle
Mediante consola: mv /ruta/archivos/zip/Basic.zip /opt/oracle mv /ruta/archivos/zip/SDK.zip /opt/oracle • Ingresar al directorio /opt/oracle 13
MANUAL DE INSTALACIÓN ORFEO
Mediante consola: cd /opt/oracle • Descomprimir los archivos zip
Mediante consola: unzip *.zip • Renombrar el directorio instantclient_11_1
Mediante consola: mv instantclient_11_1 instantclient • Ingresar al directorio instantclient
Mediante consola: cd instantclient • Crear enlaces simbólicos
14
MANUAL DE INSTALACIÓN ORFEO Mediante consola: ln -s libclntsh.so.11.1 libclntsh.so ln -s libocci.so.11.1 libocci.so
para
verificar
que
los
enlaces
simbólicos
fueron
correctamente creados ejecutar en consola el comando ls -l como se muestra a continuación:
• Crear un directorio src en /opt/oracle
Mediante consola: mkdir /opt/oracle/src 15
MANUAL DE INSTALACIÓN ORFEO • Ingresar al directorio src, descargar el archivo tar.gz oci8 (oci8-1.2.4.tgz) de http://pecl.php.net/package/oci8 y guardarlo en /opt/oracle/src
Mediante consola: cd /opt/oracle/src wget -c http://pecl.php.net/get/oci8-1.2.4.tgz • Extraer las librerías oci8 Mediante consola: tar xzvf /opt/oracle/src/oci8-1.2.4.tgz • Ingresar al directorio oci8-1.2.4 y ejecutar phpize
Mediante consola: cd /opt/oracle/src/oci8-1.2.4 phpize
16
MANUAL DE INSTALACIÓN ORFEO
imagen ejemplo de lo ejecutado en consola • Definir la variable de ambiente ORACLE_HOME
Mediante consola: export ORACLE_HOME=/opt/oracle/instantclient • Configurar oci8 para instalarlo con los parámetros necesarios
./configure --withoci8=share,instantclient,/opt/oracle/instantclient
Ejecutar make para compilar make • Instalar oci8 17
MANUAL DE INSTALACIÓN ORFEO Mediante consola: make install
imagen ejemplo del comando make en consola • Crear el archivo oci8.ini en /etc/php5/apache2 (o en la ruta donde se encuentran los archivos que indican las librerías de PHP5 a cargar) y agregar la siguiente línea extension=oci8.so • Reiniciar el servicio apache
Mediante consola: /etc/init.d/apache2 restart
Nota :Para verificar que la librería oci8 quedó habilitada se debe tener el archivo llamado phpinfo.php En pasos anteriores este archivo ya había sido creado compruebe que en la siguiente ruta /var/www este el archivo phpinfo.php y 18
MANUAL DE INSTALACIÓN ORFEO que contiene la siguiente información: Ingresar en un navegador Web la dirección URL http://localhost/phpinfo.php y verificar que aparece oci8. Como lo muestra la siguiente imagen:
19
MANUAL DE INSTALACIÓN ORFEO 5. INGRESAR A ORFEO
Ingresar a Orfeo de la siguiente manera: • Abrir el Navegador Web se recomienda Firefox, y colocar la siguiente URL: • http://IPServidorOrfeo/orfeo_3.7.0/ • http://IPServidorOrfeo/orfeo_3.6.0/
Deberá aparecer una página como la que muestra la imagen:
20
MANUAL DE INSTALACIÓN ORFEO
Ingrese con el usuario ADMON y digite cualquier clave mayor de 3 caracteres. 6. SERVIDOR DE IMÁGENES (BODEGA) Este servidor es donde almacenarán los las imágenes (.tiff) y documentos de las dependencias que se crearon en Orfeo. Se puede asignar una máquina aparte con este fin, todo depende de la cantidad de radicados que se generen en la Entidad. Teniendo 21
MANUAL DE INSTALACIÓN ORFEO presente los siguientes datos para los cálculos:
• Se digitaliza generalmente a 200 o 150 dpi (Blanco y Negro) • Cada Hoja ocupa aproximadamente 60 K • En promedio cada documento tiene 14 Hojas. 6.1 CREACIÓN DE LA BODEGA • Crear la Bodega física en /var:
Mediante consola: cd /var mkdir bodega Nota:Bodega debe pertenecer al grupo de apache.
Ejemplo: Si el Grupo de apache es www-data Para que bodega pertenezca a ese grupo, mediante consola se debe escribir el siguiente comando: chown www-data:www-data bodega/ • Dentro de la bodega se crean las siguientes carpetas: 22
MANUAL DE INSTALACIÓN ORFEO Para crear las carpetas dentro de bodega el comando es mkdir y el respectivo nombre. Es importante mirar la ruta en donde se deben ir generando, se sugiere la siguiente estructura:
bodega/prod bodega/prod/masiva bodega/prod/pdfs bodega/prod/pdfs/guias bodega/prod/pdfs/planillas bodega/prod/pdfs/planillas/dev bodega/prod/pdfs/planillas/envios bodega/prod/tmp/workDir/cacheODT bodega/prod/año bodega/prod/año/dependencia bodega/prod/año/dependencia/docs Nota: La carpeta dependencia se crea con el número asignado a la dependencia en Orfeo, por cada dependencia debe existir una carpeta. Por ejemplo: 100 Secretaria General 23
MANUAL DE INSTALACIÓN ORFEO bodega/prod/año/100 Es aconsejable codificar las dependencias antes de generar las carpetas según el organigrama de la entidad.
Cambiar los permisos de la bodega Mediante consola: chmod 755 o 775. Crear el enlace simbólico a la Bodega física desde Orfeo, de la siguiente forma: Mediante consola: ln -s /var/bodega /var/www/orfe_3.7.0/bodega orfeo_3.6.0/bodega Para verificar que el enlace simbólico apunte correctamente, cuando ingresemos a la bodega que esta dentro de Orfeo se deben ver todas las carpetas creadas en la bodega física que se había creado dentro de /var/ bodega.
24
