Alfresco Manual de Instalación y Configuración para Windows XP

Autor: Pablo A. Conejeros Garrido

Instalación de Alfresco Community Tomcat 2.1.0

Requerimientos:
· Java Development Kit disponible desde http ://java.sun.com
· Alfresco community tomcat disponible desde http://wiki.alfresco.com/wiki/Download_Alfresco_Community_Network
· Base de datos MySQL Server 5.0 disponible desde http://www.mysql.com
· OpenOffice para la transformación de documentos disponible desde http://www.openoffice.org

Instalación de JDK

La instalación del “JDK” es el software necesario para hacer funcionar las aplicaciones “JAVA” en nuestra máquina.

Para instalar el JDK, procedemos a descargarlo de la dirección:
http://java.sun.com/j2se/1.5.0/download.jsp, vamos hasta donde dice JDK 5.0 Update 15 (o una versión superior si existe) y hacemos clic en el botón Download. Luego en la ventana, elegimos el sistema operativo o plataforma en el que será instalado, en lenguaje dejamos multi-lenguaje y seleccionamos el checkbox en el que aceptamos las licencias y pinchamos en el botón continue, seleccionamos en Windows Offline Installation, cuyo tamaño de archivo tiene 51.75 MB. Para instalar JDK abrimos el archivo descargado, la instalación es prácticamente automática, no tiene complicación, pulsar “siguiente” en las pantallas.

Instalación de MySQL Server 5.0

Por defecto, Alfresco viene configurado para base de datos HSQL, pero nosotros vamos a montarlo sobre base de datos MySQL de la siguiente manera:

Procedemos a descargarlo desde la siguiente dirección http://dev.mysql.com/downloads/mysql/5.0.html, presionamos el botón download que aparece bajo MySQL Community Server. Navegamos hacia la parte de nuestro sistema operativo, que en este caso es Windows y así bajarnos la versión compatible con este sistema operativo. Por mi parte baje la versión que corresponde a Windows ZIP/Setup.EXE (x86), este archivo tiene un tamaño de 44.3M. Debemos hacer clic en “Pick a mirror”, lo que nos llevará a la pantalla siguiente, que nos dice que queremos bajar el archivo mysql-essential-5.0.51b-win32.msi, aquí se nos pedirán los datos de e-mail y contraseña que debemos ingresar, en caso de no estar registrados podemos hacerlo de manera gratuita, una vez registrados podemos proceder a descargar el archivo que hemos seleccionado con anterioridad, y para ellos especificamos un destino para la descarga. Ahora si no queremos registrarnos podemos hacer clic en la parte de más abajo de donde se nos pide el e-mail y contraseña, que dice » No thanks, just take me to the downloads!, esto quiere decir que no queremos registrarnos pero que igualmente deseamos descargar el producto seleccionado, entonces aparecerá una lista con servidores disponibles para realizar la descarga y el tipo de protocolo que utilizan para la transferencia de los archivos, elegimos la ubicación que más nos conviene y hacemos clic en el protocolo de transferencia para comenzar la descarga, finalmente especificamos el destino de descarga del archivo.

Para instalar MySQL, debemos abrir y descomprimir el archivo descargado de Internet, que contendrá un archivo “Setup.EXE“, lo ejecutamos, siempre pinchamos sobre el botón “siguiente” hasta que se instale MySQL y finalmente pulsamos en Finalizar. Podemos realizar la configuración inmediatamente una vez instalado MySQL Server 5.0, así es que una finalizada la instalación se nos preguntará si queremos realizar la configuración de inmediato, para ello hacemos clic en aceptar y se abrirá el asistente de configuración, en caso contrario podemos realizar la configuración posteriormente, para ello debemos dirigirnos al menú Inicio > Todos los programas > MySQL > MySQL Server 5.0 > MySQL Server Instance Config Wizard

Configuración de MySQL Server 5.0

Seguimos con la configuración hasta la ventana “Please select the default character set“, aquí se nos pide cual será el conjunto de caracteres que utilizaremos por defecto, seleccionamos “Best Support For Multilingualism“, que es la que provee el conjunto UTF8 compatible con Alfresco. En la siguiente ventana nos indica que vamos a iniciar “MySQL” como un servicio de Windows, marcamos también la opción “Include Bin Directory in Windows PATH“. Luego la siguiente pantalla trata sobre las opciones de seguridad en la que introducimos la contraseña del “root“. Finalmente aparece la pantalla “Ready to execute…”, hacemos clic en el botón Execute y con ello finalizamos la instalación.

Para probar que hemos instalado bien “MySQL“, abrimos una ventana en “MSDOS” y escribimos lo siguiente “mysql –u root –p“, introducimos la contraseña del “root” y si todo se ha hecho como lo explicado anteriormente no debe de haber errores. Otra opción es hacer lo siguiente, abrimos una ventana de línea de comandos para MySQL, para ello hacemos clic en menú inicio, luego en todos los programas y ubicamos en este la carpeta MySQL, ahí se desplegará MySQL Server 5.0 y luego aparecerá un nuevo menú en el cual seleccionamos MySQL Command Line Client, esta es una ventana idéntica a la de de MSDOS que viene con Windows XP, en esta ventana nos pedirá la contraseña de root o administrador de la base de datos, luego de introducir esta contraseña se nos muestra un mensaje de bienvenida a MySQL Server 5.0, ello demuestra que no hay errores en la configuración e instalación.

Creación de la Base de Datos Alfresco

Una vez instalado MySQL Serer 5.0 se deben seguir los siguientes pasos para crear la base de datos:

1º Escribimos la sentencia en la pantalla de MS-DOS (línea de comandos) mysql -u root –p, aquí nos pedirá la contraseña de root, la cual debemos ingresar.

2º Ejecutamos la sentencia create database alfresco; aquí estamos creando la base de datos con el nombre alfresco para el repositorio de documentos.

3º Luego ejecutamos la sentencia use alfresco; esto es para cambiar y usar la base de datos que recién hemos creado para el repositorio.

4º Debemos crear el usuario y asignarle los permisos correspondientes utilizando la sentencia create user alfresco_user identified by password 'alfresco_pass'; aquí estamos creando al usuario alfresco e identificándolo con la contraseña alfresco. Luego le damos los permisos de acceso a la base de datos utilizando la sentencia grant all on alfresco.* to 'alfresco_user'; A veces la sentencia de crear el usuario alfresco falla, y se puede emplear esta en su lugar:

GRANT ALL PRIVILEGES ON alfresco.* TO 'alfresco_user'@'localhost' IDENTIFIED BY 'alfresco_pass' WITH GRANT OPTION;

Para ser originales, supongamos que hemos puesto que alfresco_user=alfresco y alfresco_pass=alfresco.

5º Lo siguiente es ir al archivo repository.properties que se encuentra en este caso en C:\Alfresco\tomcat\webapps\alfresco\WEB-INF\classes\alfresco y editar las propiedades relacionadas con la base de datos. Otra opción preferible es no tocar ese fichero repository.properties y modificar el custom-repository.properties, que es el que yo he modificado y que se encuentra en mi caso en C:\Alfresco\tomcat\shared\classes\alfresco\extension. Las propiedades a modificar son:

Comente todas las líneas de conexión HSQL utilizando #, es decir, debe quedar de la siguiente forma:

# HSQL connection
#
#db.driver=org.hsqldb.jdbcDriver
#db.url=jdbc:hsqldb:file:alf_data/hsql_data/alfresco;ifexists=true;shutdown=true;

Luego debe descomentar las líneas de conexión MySQL y ajustar según corresponda, es decir, debe quedar de la siguiente forma:

# MySQL connection (This is default and requires mysql-connector-java-5.0.3-bin.jar, which ships with the Alfresco server)
#
db.driver=org.gjt.mm.mysql.Driver
db.url=jdbc:mysql://localhost/alfresco

6º Luego se debe editar el archivo custom-hibernate-dialect.properties, el cual se encuentra en la misma ubicación del archivo anterior (custom-repository.properites). Las propiedades a modificar son las siguientes:

Comente todas las líneas de conexión HSQL utilizando #, es decir, debe quedar de la siguiente forma:

# HSQL dialect
#
#hibernate.dialect=org.hibernate.dialect.HSQLDialect

Luego debe descomentar las líneas de conexión MySQL y ajustar según corresponda, es decir, debe quedar de la siguiente forma:

# MySQL dialect (default)
#
hibernate.dialect=org.hibernate.dialect.MySQLInnoDBDialect

Nota: Respecto a la aplicación, más conocida como driver y denominada “J connector” necesario para que la base de datos funcione bajo plataformas desarrolladas en Java como Alfresco, y así pueda funcionar con la base de datos MySQL Server 5.0, debo decir que Alfresco ya viene con un conector MySQL por defecto (mysql-connector-java-5.0.3-bin.jar) ubicado en C:\Alfresco\tomcat\common\lib, por lo tanto no es necesario descargar la última versión, esto lo he comprobado ya que Alfresco está funcionando con MySQL Server 5.0 gracias al conector que viene por defecto en Alfresco. Por último, sobre saber si está funcionando con esa base de datos, pues se me ocurre una prueba sencilla que consiste en acceder a la base de datos creada, y consultar alguna de las tablas, por ejemplo, ALF_NODE o ALF_AUTHORITY, esta última contiene los diferentes usuarios-grupos de Alfresco, bastaría con que se creara uno nuevo y ver si se añade un registro en la nueva base de datos.

Para hacer la consulta a alguna tabla se debe estar dentro de la base de datos, si no lo estamos nos arrojará un error, diciéndonos que no hemos seleccionado ninguna base de datos, una vez adentro podemos ejecutar la sentencia SELECT * FROM ALF_NODE; la cual nos dará el detalle de la tabla con este nombre que contiene el registro de los archivos y los espacios creados dentro del repositorio Alfresco, o también podemos ejecutar SELECT * FROM ALF_AUTHORITY; que nos dará el detalle de la tabla con ese nombre que contiene los registros de los usuarios y grupos creados dentro del repositorio Alfresco.

Instalación de Alfresco Community Tomcat 2.1.0

La instalación del servidor de Alfresco es bastante sencilla, sólo debe descargar desde la página Web esta aplicación compatible con el sistema operativo que se este utilizando en la máquina servidor, para ello siga los siguientes pasos:

1º En el navegador de páginas Web coloque la url http://wiki.alfresco.com/wiki/Download_Alfresco_Community_Network, en este sitio Web podrá encontrar una gran cantidad de información sobre esta aplicación de gestión documental, este sitio se encuentra disponible sólo en el idioma inglés, y podrá encontrar las últimas modificaciones y versiones de esta aplicación.

2º Una vez en la página anterior, hay un link que se denomina Download Alfresco Labs en la parte izquierda de la página principal, ya que en la parte derecha se puede obtener Alfresco integrado con un Gestor de Contenidos Web (Web Content Management).

3º Cuando hemos hecho clic en el link Download Alfresco Labs, este nos llevará a otra sección en donde se nos consultan algunos datos referentes a como utilizaremos la aplicación, es decir, bajo que plataformas y aplicaciones estará en funcionamiento el servidor Alfresco, esto es sólo información adicional que requieren los desarrolladores independientes o comunitarios de Alfresco, para así realizar un feedback o retroalimentación de información, para que así ellos puedan ayudarnos en caso que lo necesitemos y también para desarrollar mejoras a la aplicación.

4º En caso de que queramos proporcionar la información mencionada en el punto anterior, debemos seleccionar las aplicaciones y plataformas en que usaremos Alfresco, por ejemplo, en este caso se ha seleccionado lo siguiente:

Sistema Operativo (Operating System) : Windows XP
Aplicación de Servidor (Aplication Server) : Tomcat
Arquitectura (Architecture) : Java
Portal Web (Portal) : Navegador (Browser Only)

Luego de ello debemos introducir un correo electrónico para que nos envíen información y aceptar las condiciones de uso y términos de la licencia, en caso de que queramos obviar el paso anterior sólo debemos hacer clic en el link que dice Skip to download page » que nos llevará al servidor de SourceForge directamente en donde podremos elegir la versión de la aplicación y algunos complementos adicionales.

5º Elegir la versión que se descargará de Alfresco y dar una ubicación en donde se guardará esta
aplicación.

6º Una vez terminada la descarga, lo único que debemos hacer es descomprimir el archivo en una carpeta específica, en este caso se ha creado una carpeta llamada Alfresco en el disco C: del disco duro del PC, en ella se ha descomprimido todo el contenido del archivo descargado recientemente, así se mantienen los archivos intactos que vienen en la aplicación para no realizar grandes modificaciones en cuanto a la ubicación de la carpeta del servidor Alfresco.

7º Finalmente lo que nos queda por realizar es probar el funcionamiento del servidor Alfresco, para ello nos dirigimos a la carpeta donde instalamos Alfresco, en este caso en C:\Alfresco y hacemos clic en el archivo alf_start.bat, con ello aparecerán dos pantallas tipo MS-DOS, las cuales una de ellas representa el inicio de servicios propios de Alfresco y la otra es referente a los servicios que nos provee el servidor Tomcat que viene integrado.

Nota: En la pantalla tipo MS-DOS del servidor Tomcat, debemos esperar que nos aparezca un mensaje para poder iniciar el cliente Web de Alfresco, este mensaje dice que “el servidor se iniciará en xxxxx ms” o en inglés como viene por defecto sería “Server is startup in xxxxx ms”, una vez que nos da este mensaje podremos utilizar el cliente Web en nuestro navegador de páginas Web.

Sólo nos resta probar el cliente Web de Alfresco, para ello colocamos en nuestro navegador lo siguiente: http://localhost:8080/alfresco y con ello se iniciará el cliente Web en donde ingresaremos primeramente como invitados o guest al servidor Alfresco. Para ingresar al servidor Alfresco desde otro PC conectado a la red, se debe colocar en el navegador lo siguiente: http://nombre_servidor:8080/alfresco.

Instalación de OpenOffice 2.4

Si desea disponer de una serie de transformaciones para los documentos que estén disponibles desde dentro de Alfresco, es necesario instalar OpenOffice. Esto es totalmente opcional y puede efectuarse en cualquier momento, incluso después de que Alfresco se ha instalado. En este caso se procederá con la instalación de OpenOffice 2.4 en su versión en español para Windows XP. Se debe señalar que este producto es de versión gratuita, por lo tanto, no tendremos problemas de números de serie a la hora de registrarlo, sólo debemos leer el acuerdo de licencia del producto.

1º En el navegador colocamos la url http://download.openoffice.org/other.html#es para proceder a descargar el producto.

2º Nos aparecerá una pantalla con los distintos idiomas en que está disponible OpenOffice 2.4, en este caso he elegido la versión en español de OpenOffice 2.4, por lo que hay que dirigirse a esa sección dentro de la misma página, si se quiere puede bajarse la versión en el idioma que convenga.

3º Para descargar el archivo, debemos hacer clic en el link que dice Download bajo la columna de
Windows, para bajar la versión compatible con Windows XP, y sólo resta con elegir una ubicación donde guardaremos el archivo en el cuadro de diálogo que aparecerá para realizar la descarga del archivo seleccionado.

4º Una vez finalizada la descarga se procede a la instalación del producto, para ello se debe hacer doble clic en el archivo descargado y comenzará la instalación.

5º Instale OpenOffice con los valores por defecto (excepto asociaciones de archivos, a menos que usted desee).

6º Inicie uno de los programas de OpenOffice para pasar por el proceso de registro inicial, y luego cierre la aplicación que acaba de abrir.

7º Finalmente detenga y reinicie el servidor Alfresco si ya se estaba ejecutándolo.