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.
# ./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)
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!!):

# ./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!! ****

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. 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.