You are on page 1of 24

MANUALDEINSTALACIN ORFEO

TABLA DE CONTENIDO
1. CONSIDERACIONES PREVIAS............................................................2 2. REQUERIMIENTOS.............................................................................2 3. SERVIDOR WEB...................................................................................3 3.1 INSTALACIN 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 CONFIGURACIN ARCHIVO CONFIG.PHP..........................10 4.1.2 CONFIGURACION DEL OCI8................................................11 5. INGRESAR A ORFEO.........................................................................18 6. SERVIDOR DE IMGENES................................................................19 6.1 CREACIN DE LA BODEGA.........................................................20

MANUALDEINSTALACIN ORFEO

El presente manual ha sido elaborado con el nimo de ser una gua para aquellas personas que requieren instalar Orfeo y que hasta ahora estn dando sus primeros pasos con Linux. Este manual ha sido realizado por: Angie Milena Morales Maury (eignamaury@gmail.com) y Nelson Soriano Soriano (smylo2@gmail.com).

1. CONSIDERACIONES PREVIAS

En este manual se presentarn los pasos necesarios para instalar el Gestor Documental Orfeo bajo la distribucin linux Ubuntu 8.04 (Hardy Heron) y con Base de Datos Oracle.

2. REQUERIMIENTOS

Tener conexin a red y la configuracin 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 instalacin 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

MANUALDEINSTALACIN ORFEO
entidad todos los servidores pueden instalarse en uno solo o tambin 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 Imgenes

3. SERVIDOR WEB

3.1 INSTALACIN 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

MANUALDEINSTALACIN ORFEO
Si esta detrs de un proxy se debe configurar el archivo /etc/subversion/servers, para que en la seccin [global] se tenga el puerto y la direccin 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 libreras de php:

MANUALDEINSTALACIN ORFEO
php5xsl php5xmlrpc Verificar que en el archivo /etc/php5/apache2/php.ini estn 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 estn 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" <Directory "/var/www/orfeo_3.6.0"> "/var/www/orfeo_3.7.0" 5

MANUALDEINSTALACIN ORFEO

3.3 DESCARGA DE ORFEO Es necesario tener subversin para descargar Orfeo:

Mediante consola ubquese en var/www as: cd /var/www //esta es la ruta donde descargar Orfeo Descargue Orfeo de la siguiente manera:

Versin 3.6.0 svn co http://orfeo.superservicios.gov.co:8033/repos/orfeo/branches/o rfeo_3.6.0 username=public password=orfeo Versin 3.0.7 svn co https://orfeogpl.info/svn/src/orfeo-3.7.2username=public password=orfeo

MANUALDEINSTALACIN ORFEO
3.4 COMPROBAR PAQUETES

Es necesario comprobar que PHP se est ejecutndose 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: <?php phpinfo(); ?> Ejecute su navegador Web y en la direccin URL coloque: http://IPServidorOrfeo/phpinfo.php esto deber mostrarle una pgina con la configuracin de PHP

MANUALDEINSTALACIN 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 conexin,

MANUALDEINSTALACIN ORFEO
el cliente que instalamos fue el oci8.

4.1 PROCEDIMIENTO

Para la creacin de la Base de Datos se utilizaron 3 archivos que se descargaron de la pgina Los tres de Orfeopgl.org son los (http://orfeogpl.org/ata/node/90). archivos

siguientes (elimine la extensin .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 inscripcin 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

MANUALDEINSTALACIN ORFEO

- Alimente la B.D. ejecutando el script de inicializacin. - 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 : //Contrasea del usuario anterior. ruta/a/archivo/ : Path fsico al archivo referenciado. Svc : Es la cadena de conexin a Oracle. El script de inicializacin crea una "Dependencia de pruebas" con cdigo 998 y un usuario ADMON (perteneciente a dicha dependencia) con perfil de administracin. A travs de l podr loguearse y empezar la parametrizacin 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 CONFIGURACIN ARCHIVO CONFIG.PHP Es necesario modificar el config.php con los datos que corresponden

10

MANUALDEINSTALACIN ORFEO
para que se pueda dar la conexin 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 parmetros, de la siguiente forma: servicio = "nombre de instancia" // instancia de oracle para DB usuario = "orfeo" // Usuario DB contrasena= "contrasea"// Contrasea 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

MANUALDEINSTALACIN 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 = "direccin de entidad" ADODB_CACHE_DIR = "/tmp"

4.1.2 CONFIGURACION DEL OCI8 Necesitamos habilitar la librera oci8 en PHP5 utilizando Instant Client de Oracle en Ubuntu, de la siguiente manera: Instalar mdulos y libreras 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 librera libaio1. 12

MANUALDEINSTALACIN ORFEO

Mediante consola: apt-get install libaio1 Descargar la ltima versin de SDK e Instant Client de Oracle. (archivos SDK.zip y Basic.zip versin 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

MANUALDEINSTALACIN 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 simblicos

14

MANUALDEINSTALACIN ORFEO
Mediante consola: ln -s libclntsh.so.11.1 libclntsh.so ln -s libocci.so.11.1 libocci.so

para

verificar

que

los

enlaces

simblicos

fueron

correctamente creados ejecutar en consola el comando ls -l como se muestra a continuacin:

Crear un directorio src en /opt/oracle

Mediante consola: mkdir /opt/oracle/src 15

MANUALDEINSTALACIN 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 libreras 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

MANUALDEINSTALACIN 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 parmetros necesarios

./configure --withoci8=share,instantclient,/opt/oracle/instantclient

Ejecutar make para compilar make Instalar oci8 17

MANUALDEINSTALACIN 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 libreras de PHP5 a cargar) y agregar la siguiente lnea extension=oci8.so Reiniciar el servicio apache

Mediante consola: /etc/init.d/apache2 restart

Nota :Para verificar que la librera oci8 qued habilitada se debe tener el archivo llamado phpinfo.php En pasos anteriores este archivo ya haba sido creado compruebe que en la siguiente ruta /var/www este el archivo phpinfo.php y 18

MANUALDEINSTALACIN ORFEO
que contiene la siguiente informacin: <?php phpinfo(); ?> Ingresar en un navegador Web la direccin URL http://localhost/phpinfo.php y verificar que aparece oci8. Como lo muestra la siguiente imagen:

19

MANUALDEINSTALACIN 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 pgina como la que muestra la imagen:

20

MANUALDEINSTALACIN ORFEO

Ingrese con el usuario ADMON y digite cualquier clave mayor de 3 caracteres. 6. SERVIDOR DE IMGENES (BODEGA) Este servidor es donde almacenarn los las imgenes (.tiff) y documentos de las dependencias que se crearon en Orfeo. Se puede asignar una mquina aparte con este fin, todo depende de la cantidad de radicados que se generen en la Entidad. Teniendo 21

MANUALDEINSTALACIN ORFEO
presente los siguientes datos para los clculos:

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 CREACIN DE LA BODEGA Crear la Bodega fsica 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

MANUALDEINSTALACIN 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/ao bodega/prod/ao/dependencia bodega/prod/ao/dependencia/docs Nota: La carpeta dependencia se crea con el nmero asignado a la dependencia en Orfeo, por cada dependencia debe existir una carpeta. Por ejemplo: 100 Secretaria General 23

MANUALDEINSTALACIN ORFEO
bodega/prod/ao/100 Es aconsejable codificar las dependencias antes de generar las carpetas segn el organigrama de la entidad.

Cambiar los permisos de la bodega Mediante consola: chmod 755 o 775. Crear el enlace simblico a la Bodega fsica 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 simblico apunte correctamente, cuando ingresemos a la bodega que esta dentro de Orfeo se deben ver todas las carpetas creadas en la bodega fsica que se haba creado dentro de /var/ bodega.

24