Alfresco EVT, herramienta para validación del entorno antes de instalar

Mi compañero en AlfrescoPeter Monks (Technical Director for Business Development), ha desarrollado un pequeño programa que permite validar el entorno donde se va a desplegar Alfresco tanto Enterprise como Community, aunque sin duda es más útil para Enterprise. Desde blyx.com quiero mostraros qué es y cómo funciona. Y dadas las fechas en las que estamos, a modo de regalo de Navidad.
Esta útil herramienta llamada Alfresco Environmente Validaton Tool (EVT) , comprueba varios puntos del sistema, base de datos y entorno específico, y nos muestra un informe donde podemos ver qué parámetros debemos cambiar para asegurarnos que Alfresco funcionará correctamente en nuestra red y enlaces donde encontrar esos recursos o recomendaciones. Básicamente analiza los puntos que desde Alfresco entendemos son más críticos o donde podemos encontrar problemas, de esta forma los evitamos.
Usarla es muy sencillo y funciona tanto en LINUX/UNIX como en windows ejecutando un script desde la línea de comandos. Claro, debe estar Java instalado en el sistema. Descomprimimos el zip que descargamos de la web del proyecto, ejecutamos  evt.sh o evt.cmd.

[bash]
# ./evt.sh -help

Usage: evt[.sh|.cmd] [-?|–help] [-v] [-V|-vv]
-t databaseType -h databaseHost [-r databasePort]
[-d databaseName] -l databaseLogin [-p databasePassword]

where: -?|–help – display this help
-v – produce verbose output
-V|-vv – produce super-verbose output (stack traces)
databaseType – the type of database. May be one of:
mysql, postgresql, oracle, mssqlserver, db2
databaseHost – the hostname of the database server
databasePort – the port the database is listening on (optional –
defaults to default for the database type)
databaseName – the name of the Alfresco database (optional –
defaults to ‘alfresco’)
databaseLogin – the login Alfresco will use to connect to the
database
databasePassword – the password for that user (optional)
[/bash]

Aquí vemos un ejemplo de la ejecución en un servidor Linux CentOS 5.5. No voy a usar la opción -vv porque no se ve bien en el blog, pero en tu caso ¡úsala! porque mostrará más información y recomendaciones para solucionar los problemas o alertas que detecte (INFO, WARN! y FAIL!!):
[bash]

# ./evt.sh -t mysql -h localhost -d alfresco -l alfresco -p alfresco

Alfresco Environment Validation Tool (for Alfresco Enterprise 3.3)
——————————————————————

Validating JVM
Vendor : Sun Microsystems Inc. …………………..PASS
Version : 1.6.0_21 ………………………………PASS
JVM Architecture : 32 bit ………………………………..INFO
Java Home : /usr/java/jre1.6.0_21 …………………..PASS

Validating Operating System
OS : Linux …………………………………PASS
Distribution : CentOS release 5.5 (Final) ………………WARN!
OS Architecture : 32 bit ………………………………..INFO
File Descriptors : 65535 …………………………………PASS

Validating Server Hardware
CPU Clock Speed : 2673Mhz ……………………………….PASS
CPU Count : 2 sockets, 2 cores ……………………..PASS
Installed RAM : 2032MB ………………………………..WARN!

Validating Network
Local Hostname : server ………………………………..PASS
IP Address : 10.10.100.100 ………………………….PASS
DNS Hostname : server.blyx.com ………………………..PASS
TCP 8005 (Tomcat) : available ……………………………..PASS
TCP 8080 (HTTP) : available ……………………………..PASS
TCP 50500 (RMI) : available ……………………………..PASS
TCP 21 (FTP) : available ……………………………..PASS
TCP 139 (NetBT) : available ……………………………..PASS
TCP 445 (SMB) : available ……………………………..PASS
TCP 7070 (Sharepoint) : available ……………………………..PASS
TCP 25 (SMTP) : available ……………………………..PASS
TCP 143 (IMAP) : available ……………………………..PASS
UDP 137 (NetBT) : available ……………………………..PASS
UDP 138 (NetBT) : available ……………………………..PASS
Database Hostname : resolved ………………………………PASS
Packet Loss : (please wait) 0% ……………………….PASS
Average Response Time : 0.186ms ……………………………….PASS
Response Time Std Dev : 0.042ms ……………………………….PASS

Validating 3rd Party Apps
Can fork OpenOffice : yes …………………………………..PASS
OpenOffice Version : unknown ……………………………….WARN!
Can fork ImageMagick : yes …………………………………..PASS
ImageMagick Version : 6.2 …………………………………..PASS
Can fork pdf2swf : yes …………………………………..PASS

Validating Database
Database Type : mysql …recognised …………………….PASS
JDBC Driver Loaded : yes …………………………………..PASS
Database Connectivity : connected ……………………………..PASS
Scrollable Result Sets: true ………………………………….PASS
JDBC Driver Version : 5.1 …………………………………..PASS
MySQL Version : 5.1.52 ………………………………..PASS
Default Storage Engine: InnoDB ………………………………..PASS
Case Sensitivity Level: 0 …………………………………….WARN!
Client Encoding : utf8 ………………………………….PASS
Connection Encoding : utf8 ………………………………….PASS
Database Encoding : latin1 ………………………………..FAIL!!
Filesystem Encoding : binary ………………………………..PASS
Results Encoding : utf8 ………………………………….PASS
Server Encoding : utf8 ………………………………….PASS
System Encoding : utf8 ………………………………….PASS

**** FINAL GRADE: FAIL!! ****

[/bash]

Como vemos en el report, se han analizado muchos puntos que pueden afectar al correcto funcionamiento de Alfresco:
  • Máquina virtual de Java.
  • Sistema Operativo (incluyendo file descriptors).
  • Hardware del servidor.
  • Información de la red, puertos disponibles y tiempos de respuesta con la base de datos.
  • Aplicaciones de terceros que necesita Alfresco para funcionar al 100%.
  • Configuración de la base de datos.
El ejemplo anterior tiene muchos errores para que veáis lo que puede detectar la herramienta. En ese sistema no sería recomendable instalar Alfresco.
Nota: recuerda ejecutar el comando antes de instalar Alfresco o con Alfresco parado, de lo contrario encontrarás muchos FAIL!! y WARN!

Espero que os sea útil.

A propósito, ¡Feliz Navidad a todos! ¡Y Feliz año 2011! Será el décimo aniversario de blyx.com (10 años desde que compré el dominio). Un año impar, seguro que es un buen año para todos.

11 thoughts to “Alfresco EVT, herramienta para validación del entorno antes de instalar”

  1. Hola Toni:

    Después de tener escrito el comentario, el submit ha fallado y he perdido el comentario ;(
    Resumo. Una excelente herramienta. Muy muy útil. Nosotros teníamos cosas así en nuestros proyectos para evitar perder tiempo en los pasos a producción.

    Un saludo

  2. Una herramienta muy útil a la hora de instalar Alfresco ECM y evitar tener problemas más adelante, sobre todo en casos de codificación de caracteres 😉

  3. Hola,

    Una consulta en dos de los campos que me dan como WARN!
    Una es el de puesto SMB, uso como sistema un W2003 Server, que tendria que hacer?

    La otra es el campo “Response Time Std Dev ” que me da como unknow y no se el motivo.

    Gracias

  4. Hola Isamel, puedes usar la opción -vv para ver el informe con más detalle. En cuanto a SMB como puerto utilizado, es normal en Windows aunque siempre puedes desactivar compartir carpetas de la interfaz de red y se soluciona.

  5. Acabo de probarla. Muy útil y muy fácil y rápida de usar.
    Gracias Toni.

  6. Muy interesante, viene muy bien para una primera instalación en un nuevo entorno.

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.