DocMGR

Instalación de DocMGR 0.55.3

Documento original http://diariodeunadministrador.blogspot.com/2006/03/instalacin-de-docmgr-0553.html

DocMGR 0.55.3 http://www.docmgr.org/ es un gestor de documentación que incluye características tales como indexación de contenidos, control de versiones, gestión de usuarios y grupos, colecciones de archivos… entre otras.

Para instalar docmanager 0.55.3 necesitamos los siguientes paquetes para Debian Sid. La mínima versión para Debian es Etch (que tiene php 5) o Sarge si lo compilamos, o usamos un backport. Con la madurez actual de Etch (testing a 28-03-2006) recomiendo esta por sus archivos más actualizados y estabilidad moderada. Entre los siguientes paquetes, es posible que no se necesiten todos, pero son los que hay en mi instalación (en negrita, algunos que no pueden faltar, aparte de los propios de cada programa claro)

PHP 5.x Postgresql 8.x Apache 2.x

Otras aplicaciones externas requeridas para añadir funcionalidad

A continuación pongo la información del DocMGR instalado sobre los programas que usa. Cuando lo instaléis y os logoneéis, podéis ir a Administrar –> Aplicaciones externas y os informará de que tenéis y que no. Con apt-get install podéis instalar todo lo que os falte y que queráis usar. Algunas son xpdf, clamav o antiword.

Una vez instalados vamos a configurar cada parte de forma básica para que funcione (después se puede ir afinando)

Configuración Postgresql

Editamos el archivo /etc/postgresql/8.1/main/pg_hba.conf que se encarga de la seguridad y añadimos o cambiamos lo que hay en negrita. A mi no me ha funcionado postgresql sin hacer esto.

Configuramos PHP

Editamos el archivo /etc/php5/apache2/php.ini para el servidor apache y /etc/php5/cli/php.ini que es el de configuración del cliente para que usen postgresql y otras cosas mas: Las anteriores directivas están igual en los dos ficheros. Además debe aparecer la sección [PostgreSQL].

Configuramos Apache 2

Editamos el archivo /etc/apache2/apache2.conf El archivo /etc/apache2/sites-enabled/000-default contiene los sitios permitidos del servidor. Este es el archivo que viene por defecto y el contenido está modificado, no es el que viene originalmente, así que hay que tener cuidado con esto y fijaros en lo que hay antes de hacer nada.

En este caso tenemos: Recargamos los ficheros de los servidores para asegurarnos de que las configuraciones se van a aplicar con Reloading apache 2.0 configuration…

Reloading PostgreSQL 8.1 database server: main.

Poner archivos de DocMGR en apache2

Una vez que los requisitos están cumplidos, debemos hacer funcionar la aplicación. Para ello, debemos tener descargados los archivos

docmgr-0.55.3.tar.gz desde http://sourceforge.net/project/showfiles.php?group_id=39658 Spanish.zip desde http://wiki.docmgr.org/index.php/Language_Files

El primero lo descomprimimos con tar y se nos creará la carpeta doc en el directorio donde lo descomprimamos, con todos los subdirectorios y archivos de DocMGR.

El segundo lo descomprimimos con unzip, que nos dará como resultado los archivos Castellano.php y es.js que son los archivos de idioma Castellano. Estos los movemos a la carpeta doc/lang/ para que estén disponibles para DocMGR.

Archive: Spanish.zip inflating: Castellano.php inflating: es.js

Una vez hecho esto, movemos el directorio doc/ , ya con el idioma español, al directorio raíz de apache2

Le cambiamos el propietario y grupo a a www-data que es el usuario de apache2, para que pueda manejar los archivos.

Le cambiamos los permisos a 770 para que solo el usuario y grupo www-data tenga acceso (o root).

Creación de la base de datos de DocMGR

A continuación, creamos la base de datos docmgr usando el comando su para ejecutar el comando proporcionado con (-c) con el usuario de sistema postgres (-l) desde consola de root. El comando createdb esta disponible cuando instalamos postgresql.

Creamos la estructura de la base de datos docmgr con el script docmgr.pgsql que se encuentra en el directorio /var/www/doc/scripts. Primero cambiamos el propietario y grupo del script a postgres para que pueda ser ejecutado y después lo ejecutamos así:

Con el comando psql podemos gestionar Postgresql, la opción -d es la base de datos donde vamos a ejecutar las sentencias del archivo dado con -f y con el usuario de la base de datos llamado postgres. Cuando os pida la contraseña del usuario, dais a intro sin escribir nada. Si usais otro usuario pues escribis la contraseña si tiene.

En la carpeta /var/www/doc/scripts/ hay otros archivos interesantes que podréis ejecutar según vuestros intereses, recordando siempre cambiar los permisos. De hecho, recomiendo encarecidamente cambiar los permisos de toda esta carpeta para que no se puedan acceder con el servidor web. Entre otros están los script de indexación o de generación de bases de datos de versiones anteriores a postgres.

También hay otro archivo importante que deberíais configurar a vuestro gusto este es /var/www/doc/config/config.php y es el archivo que sirve para configurar DocMGR, entre otras cosas, parametros de conexión a la base de datos (si cambiais el nombre de la base de datos, puerto, host, etc. hay que ponerlo aquí), directorio de los ficheros, directorio de importación, lenguaje por defecto,etc.

Para más información www.docmgr.org

Comprobación de la instalación

Para comprobar que todo ha salido correctamente, abrimos nuestro navegador web favorito (en mi caso Firefox) y ponemos la dirección http://localhost que debería llevarnos a la pantalla de login.

inicio sesión

Si es así, ya esta funcionando, después introducimos el usuario admin y contraseña admin por defecto y ya podemos usarlo y configurarlo.