miércoles, 21 de abril de 2010

03-Instalación Alfresco 3.3 Community WAR en GNU\Linux Kubuntu Lucid Lynx (Configuración Básica)

Configuración básica de Alfresco

Una vez desplegados los war, Alfresco tiene dos directorios de configuración, uno para el mismo y otro para share que son:
  • <configroot>: /var/lib/tomcat6/webapps/alfresco/WEB-INF
  • <configrootshare>: /var/lib/tomcat6/webapps/share/WEB-INF
Dentro de estos directorios se puede configurar alfresco o share.

El fichero general de configuración de alfresco lo tenemos en
/var/lib/tomcat6/webapps/alfresco/WEB-INF/classes/alfresco-global.properties.sample

Podemos configurar las opciones generales en este fichero y después renombrarle quitando .sample, Pero este fichero es muy básico así que copiaremos el fichero que viene con alfresco-community-war-3.3.tar.gz. Lo copiamos desde el directorio donde lo descomprimimos (alfresco) al directorio donde se ha desplegado alfresco y le cambiamos el propietario y grupo a tomcat6. En concreto estos comandos.

$ sudo cp extensions/extension/alfresco-global.properties \
> /var/lib/tomcat6/webapps/alfresco/WEB-INF/classes/
$ sudo chown tomcat6:tomcat6 /var/lib/tomcat6/webapps/alfresco/WEB-INF/classes/alfresco-global.properties

Y ahora lo editamos. Este fichero es el general de configuración. Es mejor poner todos los cambios aquí y no tocar los ficheros generales de alfresco. Así en las actualizaciones no perderemos los cambios de esos ficheros que deberemos reconfigurar.

$ sudo vim /var/lib/tomcat6/webapps/alfresco/WEB-INF/classes/alfresco-global.properties

Pongo las secciones que he cambiado, el fichero es más largo.

###############################
## Common Alfresco Properties #
###############################

#
# Sample custom content and index data location
#-------------
# Repositorio de documentación de Alfresco que
# creamos antes.
dir.root=/home/casa/backups/alf_data

#
# Sample database connection properties
#-------------
# Datos de conexión de la base de datos. Si cambiamos
# la contraseña o el usuario al configurar mysql
# debemos cambiarlos aquí.
db.name=alfresco
db.username=alfresco
db.password=alfresco
db.host=localhost
db.port=3306

#
# External locations
#-------------
# Rutas a los programas que necesita alfresco y que
# instalamos previamente. Podemos usar whereis.
ooo.exe=/usr/bin/soffice
#ooo.enabled=false
#img.root=./ImageMagick
img.exe=/usr/bin/convert
swf.exe=/usr/bin/pdf2swf

#
# MySQL connection
#-------------
# Driver de mysql. Por defecto usa el dialecto
# hybernate de InnoDB asi que no ponemos nada más.
db.driver=org.gjt.mm.mysql.Driver
db.url=jdbc:mysql://${db.host}:${db.port}/${db.name}

#
# Index Recovery Mode
#-------------
index.recovery.mode=FULL

#
# Outbound Email Configuration
#-------------
mail.host=localhost
mail.port=25
#mail.username=anonymous
#mail.password=
mail.encoding=UTF-8
mail.from.default=admin@dominio.com
#mail.smtp.auth=false

Si vamos ahora a http://localhost/alfresco veremos, por fin, la página de alfresco funcionando.



Entramos dando a login(guest) y usuario: admin, contraseña: admin. Nos vamos a la configuración de usuarios, editamos el usuario admin y cambiamos su contraseña por una nuestra.

Configuración del Idioma

Para elegir el idioma español bajamos el pack en español de alfresco y share de aquí

http://forge.alfresco.com/projects/alfrescoeses/

En mi caso el último es el de la versión 3.2 beta. Hay que tener en cuenta que no está totalmente traducido. Lo descomprimimos y copiamos los ficheros en la carpeta correspondiente:

$ mkdir lang_es
$ cd lang_es/
$ unzip ../alfresco_3.2_ES-beta1.zip
$ sudo cp alfresco_3.2_ES-beta1/messages/* /var/lib/tomcat6/webapps/alfresco/WEB-INF/classes/alfresco/messages/
$ sudo chown tomcat6:tomcat6 /var/lib/tomcat6/webapps/alfresco/WEB-INF/classes/alfresco/messages/*

Para share

$ sudo cp -R alfresco_3.2_ES-beta1/web-extension/site-webscripts/org/alfresco/* /var/lib/tomcat6/webapps/share/WEB-INF/classes/alfresco/site-webscripts/org/alfresco/
$ sudo cp alfresco_3.2_ES-beta1/messages/slingshot_es.properties /var/lib/tomcat6/webapps/share/WEB-INF/classes/alfresco/messages/
$ sudo chown -R tomcat6:tomcat6 /var/lib/tomcat6/webapps/share/WEB-INF/classes/alfresco/site-webscripts/org/alfresco/* /var/lib/tomcat6/webapps/share/WEB-INF/classes/alfresco/messages/slingshot_es.properties

Por último, editamos el siguiente fichero y añadimos el lenguaje español quedando así

$ sudo vim /var/lib/tomcat6/webapps/alfresco/WEB-INF/classes/alfresco/web-client-config.xml

   <config evaluator="string-compare" condition="Languages">

      <!-- the list of available language files -->

      <languages>

         <language locale="es_ES">Español</language>

         <language locale="en_US">English</language>

      </languages>

   </config>

Reiniciamos la aplicación (no hace falta reiniciar tomcat siempre, podemos entrar en el manager y reiniciar solo la aplicación)

$ sudo /etc/init.d/tomcat6 restart

Y comprobamos eligiendo español en la pantalla de login, aunque la misma pantalla de login debería estar ya en español.

Configuración del log de alfresco y share (ver apendice I para comando sed)

Vamos a configurar el log de alfresco para que se guarde en el directorio por defecto de logs.

# sed 's/^M//' /var/lib/tomcat6/webapps/alfresco/WEB-INF/classes/log4j.properties > /var/lib/tomcat6/webapps/alfresco/WEB-INF/classes/log4j.properties_tmp

# mv /var/lib/tomcat6/webapps/alfresco/WEB-INF/classes/log4j.properties_tmp /var/lib/tomcat6/webapps/alfresco/WEB-INF/classes/log4j.properties

# sed 's/^M//' /var/lib/tomcat6/webapps/share/WEB-INF/classes/log4j.properties > /var/lib/tomcat6/webapps/share/WEB-INF/classes/log4j.properties_tmp

# mv /var/lib/tomcat6/webapps/share/WEB-INF/classes/log4j.properties_tmp /var/lib/tomcat6/webapps/share/WEB-INF/classes/log4j.properties

Cambiamos la directiva siguiente en cada fichero log4j.properties (alfresco y share) y guardamos

log4j.appender.File.File=/var/log/tomcat6/alfresco.log

# chown tomcat6:tomcat6 \
> /var/lib/tomcat6/webapps/alfresco/WEB-INF/classes/log4j.properties \
> /var/lib/tomcat6/webapps/share/WEB-INF/classes/log4j.properties

Podemos ver en el apéndice la explicación del comando sed (importante teclearlo y no copiar y pegar)


Apéndice I – Solución de caractéres de final de linea Unix/DOS


Si en algún fichero, al ejecutar vim para editarlo nos sale un carácter ^M al final de linea es que está en formato DOS y por tanto usa como final de linea el CR+LF y no LF como en Unix. Así que eliminamos las ^M que salen al final de la linea antes de editarlo con los siguientes comandos.

NOTA: El comando sed hay que escribirlo, no vale con cortar y pegar ya que donde pone ^M en realidad tenemos que pulsar las teclas CTRL+v+m para que salga el carácter ^M. Usamos el usuario root.

# sed 's/^M//' alfresco-global.properties.sample > alfresco-global.properties.sample_tmp
# mv alfresco-global.properties.sample_tmp alfresco-global.properties.sample

Ahora si

$ sudo vim /var/lib/tomcat6/webapps/alfresco/WEB-INF/classes/alfresco-global.properties.sample
Related Posts with Thumbnails