Se describe a continuación los distintos pasos de instalación de Prodoc. Los pasos a a seguir son:
Primero debe elegirse la forma de almacenamiento de toda la información de metadatos a almacenar. Para ello debe elegirse el sistema de base de datos a utilizar y crearse un usuario en el mismo con capacidad de:
Las órdenes pueden ser diferentes dependiendo de la base de datos y el interfaz de administración, pero serán similares a las de Oracle:
CREATE USER Prodoc IDENTIFIED BY Password;Las órdenes anteriores son un EJEMPLO sencillo, es conveniente aplicar permisos más restrictivos o roles existentes y limitar a un SCHEMA.
Debe descomprimirse el archivo zip en el lugar del disco deseado, manteniendo la estructura de carpetas interna.
Este cliente debe instalarse al menos una vez para la administración del sistema y además para todos los usuarios que utilicen esta forma de acceso. Para ello debe iniciar el script de sistema Install.sh o Install.bat (según el sistema operativo) y cumplimentar los datos requeridos en pantalla.
En el caso del Linux, dependiendo de la configuración y modelo de seguridad, puede ser necesario cambiar los permisos de Install.sh o de Setup.sh (una vez creado) asignando permisos de ejecución: "chmod 777 Install.sh" o usando otras herramientas o instrucciones.
Por defecto se elegirá el idioma del equipo, siempre que esté soportado, en otro caso se utilizará inglés (EN). Si se desea forzar otro idioma puede pasarse como parámetro de dos letras a la aplicación (Ej. Install.sh EN). Ver Soporte Idiomas
Es posible realizar este paso sin presentar el interfaz de usuario. Para ello debe invocarse el programa de instalacion pasándole los parametos "NO_UI" y el nombre de un fichero (Ej."Install.sh NO_UI Install.properties") con los datos adecuados (los mismos que para el modo interactivo). En el paquete de instalación se suministra un ejemplo que será necesario modificar de acuerdo al entorno de instalación.
Con los datos suministrados, el programa de instalación creará un fichero de configuración y un script de arranque Prodoc.sh o Prodoc.bat según el sistema operativo. Estos ficheros pueden copiarse y usarse en cualquier equipo siempre que:
en otro caso debe utilizase el programa de instalación o modificar manualmente el archivo de configuración (Prodoc.properties).
Si desea utilizarse repositorio documental Amazon S3, deberá descargarse e instalarse las librerías AWS S3 correspondientes, e incluirlas en el classpath.
IMPORTANTE: Tanto para la instalación como para el funcionamiento normal, es importante que el servidor de BBDD (o al menos la sesión "Usuario de conexión a BBDD" con la que se conecta OPD) funcione en modo AutoCommit=off, es decir, hasta que no se confirme o cancele la transacción por parte de OPD no se debe consolidarse información alguna a la BBDD
Una vez instalado el cliente, debe ejecutarse la aplicación de creación de la estructura de datos Setup.sh o Setup.bat, contestando a las preguntas de la aplicación.
Por defecto se elegirá el idioma del equipo, siempre que esté soportado, en otro caso se utilizará inglés (EN). Si se desea forzar otro idioma puede pasarse como parámetro de dos letras a la aplicación (Ej. Setup.sh EN). Ver Soporte Idiomas
Este proceso creará toda la estructura de tablas y elementos necesaria para OPD. Posteriormente, al definir nuevos tipos de Documento o Carpeta se crearán tablas y elementos auxiliares.
Es posible realizar este paso sin presentar el interfaz de usuario. Para ello debe invocarse el programa de instalacion pasándole los parametos "NO_UI" y el nombre de un fichero (Ej."Setup.sh NO_UI Setup.properties") con los datos adecuados (los mismos que para el modo interactivo). En el paquete de instalación se suministra un ejemplo que será necesario modificar de acuerdo al entorno de instalación.
Es conveniente revisar la configuracion de trazas log4j para ajustarla a las necesidades y carpetas deseadas. Hay que recordar que el nivel de traza está centralizado en el fichero de configuración Prodoc.properties.
Una vez creada la estructura básica, deberá instalarse los clientes de los usuarios.
Para los usuarios que utilicen el cliente Swing, basta copiar la carpeta que contiene la primera instalación realizada, ya que incluye las referencias al servidor.
Si el acceso para otros usuarios es a través del cliente Web, o si hay usuarios que utilizarán conexión cliente pesado servidor Web, deberá instalarse la aplicación J2EE. Para ello, en un servidor J2EE soportado deberá desplegarse el WAR de la aplicación. Debe comprobarse que el tamaño máximo de subida de archivos es mayor que el tamaño del fichero WAR (para Tomcat debe verificarse el fichero tomcat\webapps\manager\WEB-INF\web.xml y comprobar los valores de <multipart-config> ). Además, se deberá copiar a la carpeta lib de la aplicación, donde están otros archivos jar como Prodoc.jar, los ficheros del driver JDBC de la BBDD utilizada. A continuación debe configurarse el fichero de configuración Prodoc.properties que utilizará la aplicación J2EE con la herramienta Install o copiando un properties ya creado.
Por ultimo, debe crearse una variable de sistema de entorno OPDWeb que referencie a la carpeta donde está el archivo OPDWeb.properties (Ej.: OPDWeb=/OpenProdoc/Web/Conf ), modificando la entrada para que referencie la ubicación del fichero Prodoc.properties
Alternativamente, puede hacerse lo siguiente: en el directorio home (ej.: /home/J_Smith) del usuario con que se ejecuta el servidor J2EE debe copiarse el archivo OPDWeb.properties, modificando la entrada para que referencie la ubicación del fichero Prodoc.properties Debe tenerse en cuenta que cuando el servidor de aplicaciones está instalado como servicio, generalmente NO tiene un usuario ni una carpetas "home".
Otra opción es crear una subcarpeta de nombre "conf" contenida en la carpeta en la que se ejecute la aplicación, dentro de la cual puede copiarse el fichero Prodoc.properties.
El proceso de instalación NO crea el repositorio de FullText. Si desea usar las funciones de Búsqueda por Texto Libre DEBE crearse el repositorio para FullText en las carpetas o sistema de archivos elegido Y activar (o crear nuevas) tareas de actualización de los índices Fulltext. El programa de instalación crea 3 tareas pero están inicialmente DESACTIVADAS. DESPUÉS de crear el repsitorio pueden activarse o crear otras otras nuevas.
El proceso de instalación define tipos de documento RIS pero no los crea. Si se desea usar en OpenProdoc las funciones RIS, debe crearse/activarse los tipos de documentos ya definidos o crear nuevos tipos. Debe tenerse cuidado con los tamaños de registro y las limitaciones de las BBDD ya que los limites son muy diferentes y en algunas BBDD , el uso de UTF8 puede dividir por dos el tamaño máximo de un registro. Por tanto debe ajustarse los tamaños y definicion de metadatos a las propias necesidades y al entorno.
Debe revisarse y activarse la ejecución de Tareas Programadas o Tareas asociadas a eventos. Para ello debe tenerse en cuenta en qué ordenador u ordenadores se ejecutarán o generarán las tareas, y en ellos debe quitarse el comentario de las entradas del fichero Prodoc.properties corrrespondientes y ajustar los valores deseados.