Secciones

2. Instalación

2.1 Requisitos

Para usar Ganzúa necesitará una implementación completa de la edición estándar del entorno de tiempo de ejecución de Java 2 (o JRE por sus siglas en inglés2.1) versión 1.4 o superior, que cuente con una implementación de las interfaces para procesamiento de XML de Java (o JAXP por sus siglas en inglés2.2) versión 1.2 o superior.

  
2.2 Plataformas Recomendadas

Dado que Ganzúa es una aplicación Java, es independiente-de-plataforma. Debe correr sin ningún problema en cualquier plataforma con una implementación completa del JRE versión 1.4 o superior con una implementación de JAXP versión 1.2 o superior.

Ganzúa ha sido ejecutada satisfactoriamente en las siguientes plataformas:

Si logra ejecutar Ganzúa en alguna otra plataforma, por favor contácteme (vea el capítulo 5), para que pueda añadirla al listado.

  
2.3 Instalando Ganzúa

Esta sección indica cómo instalar Ganzúa en las distintas plataformas en las que ha sido ejecutado satisfactoriamente. No es necesario que lea todas las secciones, basta con que consulte la que trata sobre la plataforma que quiere usar.

2.3.1 GNU/Linux

Preparando la Instalación

Para ejecutar Ganzúa, necesitará una implementación completa de la edición estándar del entorno de tiempo de ejecución de Java 2 (JRE) versión 1.4 o superior. Si no tiene una instalada en su sistema, tendrá que conseguir una de las implementaciones para GNU/Linux. La que se usó para probar Ganzúa, fue la de Sun Microsystems, que puede encontrarse en http://java.sun.com , pero podría usar la de IBM (http://www.ibm.com), la de Blackdown (http://www.blackdown.org) o alguna otra. De ser posible, instale un JRE para la versión 5.0 o superior de la edición estándar de la plataforma Java 2 (J2SE), así podrá evitar actualizar el JAXP que se incluye con su JRE.

Instalando Ganzúa

Una vez que tiene instalada una implementación del JRE versión 1.4 o superior, siga los siguientes pasos para instalar Ganzúa:

  1. Descargue el paquete binario del sitio de Ganzúa: http://ganzua.sourceforge.net
  2. Expanda el paquete y ponga los archivos extraídos donde usted quiera que Ganzúa quede instalado. Asegúrese de que la ruta al directorio de instalación no contenga directorios cuyos nombres incluyan caracteres fuera del alfabeto inglés o 0-9 (por ejemplo: caracteres acentuados o ñ), de lo contrario el programa puede funcionar de manera incorrecta.

Ahora debe poder ejecutar Ganzúa usando el comando java -jar ganzua.jar desde el directorio en el que instaló el programa.

Pruebe su Instalación

Ejecute Ganzúa y seleccione la opción Abrir del menú Archivo. Ahora elija un proyecto de criptoanálisis de entre los que se incluyen como ejemplo en GANZÚA/examples/projects/es donde GANZÚA representa al directorio en el que instaló el programa.

Si logró abrir el proyecto sin ningún problema, felicidades, puede saltarse el resto de este capítulo. Si, por el contrario, apareció un mensaje de error indicando que debe actualizar su versión de JAXP, salga del programa y lea la siguiente sección, que le indicará cómo hacerlo.

Actualizando su Versión de JAXP

Si su implementación del JRE no incluye una implementación de las interfaces para procesamiento de XML de Java (JAXP) versión 1.2 o superior, tendrá que instalar una. Xerces2 Java Parser (versión 2.6 o superior) provee tal implementación. Para instalarlo haga lo siguiente:

  1. Descargue la aplicación findEndorsedDirs.jar de http://ganzua.sourceforge.net . Este JAR ejecutable le indicará cuáles son los directorios de estándares respaldados de Java (donde puede colocar la implementación de JAXP) en su JRE.
  2. Descargue la versión más reciente de Xerces2 Java Parser de
    http://xml.apache.org/xerces2-j/
  3. Extraiga los archivos del paquete comprimido
  4. Ejecute findEndorsedDirs con el comando
    java -jar findEndorsedDirs.jar
  5. Copie todos los archivos JAR (aquellos que terminan en .jar) del paquete de Xerces2 a cualquiera de los directorios listados por findEndorsedDirs. Si el directorio no existe, créelo.
  6. Salga de cualquier Ganzúa que tenga en ejecución.
  7. Vuelva a hacer la prueba de la sección anterior para confirmar que ha actualizado la versión de JAXP.

No necesitará findEndorsedDirs.jar ni el paquete de Xerces2 en adelante, así que puede borrarlos.

Si tiene algún problema, contácteme (ver capítulo 5) para poder darle solución en versiones futuras de la documentación de Ganzúa.

2.3.2 Mac OS X (10.3 o superior)

Preparando la Instalación

Mac OS X 10.3 (o superior) incluye la implementación de Apple del JRE versión 1.4.1 (o superior), pero descargar cualquier actualización disponible para la plataforma Java con Actualización de Software puede mejorar el rendimiento de Ganzúa y hacer la instalación más fácil. Para ejecutar Actualización de Software seleccione esa opción del menú Apple o elija Preferencias del Sistema, después Actualización de Software del menú Visualización y ahora pulse el botón Buscar.

Instalando Ganzúa

Ahora está listo para instalar Ganzúa. Para ello siga los siguientes pasos:

  1. Descargue el paquete para Mac OS X del sitio de Ganzúa: http://ganzua.sourceforge.net
  2. Abra el paquete y arrastre el directorio que contiene a Ganzúa y otros archivos y directorios (carpetas) al lugar donde quiera que quede instalado. De preferencia póngalo dentro de la carpeta Aplicaciones, pues de lo contrario el programa puede funcionar de manera inadecuada.
    Algunos de los archivos y directorios de la carpeta de Ganzúa son importantes para el funcionamiento del programa y no debe moverlos o borrarlos del directorio de instalación. Esto se explica con mayor detalle en la sección 2.4.

Eso es todo. Ahora puede ejecutar Ganzúa haciendo doble clic en su icono.

Pruebe su Instalación

Ejecute Ganzúa y seleccione Abrir en el menú Archivo. Ahora elija uno de los proyectos de criptoanálisis que se incluyen como ejemplo en el directorio GANZÚA/examples/projects/es donde GANZÚA representa al directorio donde instaló el programa.

Si logró abrir el proyecto satisfactoriamente, felicidades, puede saltarse el resto de este capítulo. Si, por el contrario, apareció un mensaje de error indicando que debe actualizar su versión de JAXP, salga del programa y lea la siguiente sección, que le indicará cómo hacerlo.

Actualizando su Versión de JAXP

Si el JRE no incluye una implementación de las interfaces para procesamiento de XML de Java (JAXP) versión 1.2 o superior, tendrá que instalar una, como Xerces2 Java Parser (versión 2.6 o superior). Para instalarlo haga lo siguiente:

Descargue la aplicación findEndorsedDirs.jar de http://ganzua.sourceforge.net . Este JAR ejecutable le indicará cuales son los directorios de estándares respaldados de Java (donde puede colocar la implementación de JAXP) en su implementación del JRE.

  1. Descargue la aplicación findEndorsedDirs.jar de http://ganzua.sourceforge.net . Este JAR ejecutable le indicará cuáles son los directorios de estándares respaldados de Java (donde puede colocar la implementación de JAXP) en su implementación del JRE.
  2. Descargue la versión más reciente de Xerces2 Java Parser de
    http://xml.apache.org/xerces2-j/
  3. Extraiga los archivos del paquete comprimido.
  4. Ejecute findEndorsedDirs haciendo doble clic en el archivo findEndorsedDirs.jar
  5. Copie todos los archivos JAR (aquellos que terminan en .jar) del paquete de Xerces2 a cualquiera de los directorios listados por findEndorsedDirs. Si el directorio no existe, créelo.
    Note que los nombres de los directorios que muestra findEndorsedDirs.jar están en inglés, así que el directorio System en su computadora puede llamarse Sistema, o Libraries llamarse Librería.
  6. Salga de cualquier Ganzúa que tenga en ejecución.
  7. Vuelva a hacer la prueba de la sección anterior para confirmar que ha actualizado la versión de JAXP.

No necesitará findEndorsedDirs.jar ni el paquete de Xerces2 en adelante, así que puede borrarlos.

Si tiene algún problema, contácteme (ver capítulo 5) para poder indicar la solución en versiones futuras de la documentación de Ganzúa.

2.3.3 Windows

Preparando la Instalación

Para ejecutar Ganzúa, necesitará una implementación completa de la edición estándar del entorno de tiempo de ejecución de Java 2 (JRE) versión 1.4 o superior. Si no tiene una instalada en su sistema, o sólo tiene un programa llamado Microsoft Java Virtual Machine (que no es una implementación del JRE), tendrá que conseguir una de las implementaciones para Windows. La que se usó para probar Ganzúa, fue la de Sun Microsystems, que puede encontrarse en http://java.sun.com , pero podría usar la de IBM (http://www.ibm.com), o alguna otra. De ser posible instale un JRE para la versión 5.0 o superior de la edición estándar de la plataforma Java 2 (J2SE), así podrá evitar actualizar el JAXP que se incluye con su JRE.

Instalando Ganzúa

Una vez que tiene instalada una implementación del JRE versión 1.4 o superior, siga los siguientes pasos para instalar Ganzúa:

  1. Descargue el paquete binario del sitio de Ganzúa: http://ganzua.sourceforge.net
  2. Expanda el paquete y ponga los archivos extraídos donde quiera que Ganzúa quede instalado. Asegúrese de que la ruta al directorio de instalación no contenga directorios cuyos nombres incluyan caracteres fuera del alfabeto inglés o 0-9 (por ejemplo: caracteres acentuados o ñ), de lo contrario el programa puede funcionar de manera incorrecta.
    Algunos de los archivos y directorios de la carpeta de Ganzúa son importantes para el funcionamiento del programa y no debe moverlos o borrarlos del directorio de instalación. Esto se explica con mayor detalle en la sección 2.4.

Ahora debe poder ejecutar Ganzúa haciendo doble clic en ganzua.jar o usando el comando java -jar ganzua.jar desde el directorio en que instaló el programa.

Pruebe su Instalación

Ejecute Ganzúa y seleccione la opción Abrir del menú Archivo. Ahora elija un proyecto de criptoanálisis de entre los que se incluyen como ejemplo con Ganzúa en GANZÚA/examples/projects/es donde GANZÚA representa al directorio donde instaló el programa.

Si logró abrir el proyecto sin ningún problema, felicidades, puede saltarse el resto de este capítulo. Si, por el contrario, apareció un mensaje de error indicando que debe actualizar su versión de JAXP, salga del programa y lea la siguiente sección, que le indicará cómo hacerlo.

Actualizando su Versión de JAXP

Si el JRE no incluye una implementación de las interfaces para procesamiento de XML de Java (JAXP) versión 1.2 o superior, tendrá que instalar una, como Xerces2 Java Parser (versión 2.6 o superior). Para instalarlo haga lo siguiente:

  1. Descargue la aplicación findEndorsedDirs.jar de http://ganzua.sourceforge.net . Este JAR ejecutable le indicará cuáles son los directorios de estándares respaldados de Java (donde puede colocar la implementación de JAXP) en su implementación del JRE.
  2. Descargue la versión más reciente de Xerces2 Java Parser de
    http://xml.apache.org/xerces2-j/
  3. Extraiga los archivos del paquete comprimido.
  4. Ejecute findEndorsedDirs haciendo doble clic en el archivo findEndorsedDirs.jar o con el comando
    java -jar findEndorsedDirs.jar
  5. Copie todos los archivos JAR (aquellos que terminan en .jar) del paquete de Xerces2 a cualquiera de los directorios listados por findEndorsedDirs. Si el directorio no existe, créelo.
  6. Salga de cualquier Ganzúa que tenga en ejecución.
  7. Vuelva a hacer la prueba de la sección anterior para confirmar que ha actualizado la versión de JAXP.

No necesitará findEndorsedDirs.jar ni el paquete de Xerces2 en adelante, así que puede borrarlos.

  
2.4 Configurando Ganzúa

Esta sección explica cómo están organizados los archivos de Ganzúa, qué contienen y cómo cambiar su configuración.

  
2.4.1 Archivos y Directorios de Ganzúa

2.4.1.1 Paquetes Binarios

Si descargó un paquete binario, debe de contar con los siguientes archivos y directorios (carpetas). En el caso del paquete para Mac OS X, debe haber una aplicación en lugar de ganzua.jar .

 
Figura: Contenido del paquete binario
Contenido del paquete binario
COPYING
Archivo con la licencia de Ganzúa (GPL).
ganzua.jar
el JAR ejecutable que contiene a Ganzúa.
En Mac OS X este archivo se encuentra dentro de la aplicación, y se puede acceder a él seleccionando Mostrar contenido del paquete en el menú contextual que aparece al hacer Control-clic en el icono de la aplicación dentro de Finder.
 
Figura: ganzua.jar está dentro del paquete de la aplicación en Mac OS X
Mostrar contenido del paquete
langFreq.jar
JAR ejecutable del programa para obtener las frecuencias relativas estándar de caracteres, digramas y trigramas de lenguajes.
schemata
directorio que contiene esquemas para XML (escritos en el lenguaje para definición de esquemas del W3C) usados para verificar que los archivos XML usados por Ganzúa (con frecuencias relativas estándar de lenguajes, proyectos de criptoanálisis, etc.) estén bien formados.
frequencies
directorio con archivos de frecuencias relativas de lenguajes. Este es el directorio en el que Ganzúa busca las frecuencias relativas de lenguajes por omisión.
examples
directorio con ejemplos.
manual
directorio donde puede encontrar este manual en formato PDF y la lista de cambios al programa a partir de las versiones previas.

2.4.1.2 Paquete de Código Fuente

Si descargó el paquete de código fuente, debe tener los siguientes archivos y directorios:

 
Figura: Contenido del paquete de código fuente
Contenido del paquete de código fuente
COPYING
Archivo con la licencia de Ganzúa (GPL).
build.xml
un archivo usado para compilar Ganzúa con la herramienta Apache Ant.
src
directorio con el código fuente de Ganzúa.
schemata
directorio que contiene esquemas para XML (escritos en el lenguaje para definición de esquemas del W3C) usados para verificar que los archivos XML usados por Ganzúa (con frecuencias relativas estándar de lenguajes, proyectos de criptoanálisis, etc.) estén bien formados. Igual que en el paquete binario.
frequencies
directorio con archivos de frecuencias relativas de lenguajes. Este es el directorio en el que Ganzúa busca las frecuencias relativas de lenguajes por omisión. Igual que en el paquete binario.
examples
directorio con ejemplos. Igual que en el paquete binario.
manual
directorio donde puede encontrar este manual en formato PDF y la lista de cambios al programa a partir de las versiones previas.

  
2.4.2 Archivos y Directorios Indispensables

Para usar Ganzúa necesita los archivos ganzua.jar, langFreq.jar, los esquemas y las frecuencias de lenguajes. Puede prescindir del resto de los archivos y directorios.

Ganzúa hace uso extensivo de archivos XML (eXtensible Markup Language). Éstos son usados para guardar proyectos, frecuencias de lenguajes y dar instrucciones a la aplicación langFreq.jar. Los archivos XML son similares a los de HTML en que ambos son archivos de texto con etiquetas. Ganzúa verifica la estructura de estos archivos usando esquemas de XML (que a su vez son archivos XML) escritos en el lenguaje para definición de esquemas del W3C. De esta manera, Ganzúa le permite acceder a los datos que ha creado y hacer documentos compatibles con Ganzúa en cualquier editor de texto, y si tiene un editor de XML capaz de usar esquemas de XML, puede verificar su validez mientras los escribe.

Puede renombrar o mover los directorios con los esquemas y frecuencias relativas (schemata y frequencies) si gusta, pero tendrá que notificar al programa sobre los cambios editando un par de archivos de configuración.

Moviendo los Directorios con Esquemas y Frecuencias Relativas

Si quiere mover o renombrar el directorio con los esquemas de XML y/o el de frecuencias relativas de lenguajes tendrá que cerrar toda Ganzúa en ejecución y editar dos archivos de configuración para notificar al programa sobre los cambios.

Los archivos de configuración están dentro de los archivos JAR, uno dentro de ganzua.jar y el otro dentro de langFreq.jar. Ambos se llaman config.properties y tienen la misma estructura. Para editarlos, hágalo de la misma manera en que editaría archivos de texto dentro de un paquete ZIP (los archivos JAR pueden ser manipulados como archivos ZIP). Si sabe cómo utilizar el editor EMACS, puede abrir los archivos JAR y editar los archivos config.properties directamente.

Si cambia el nombre del directorio con los esquemas o lo mueve, tendrá que cambiar la línea 
#schemataDir = /usr/local/share/ganzua/schemata/

Borre el carácter # al inicio de la línea y cambie el valor después del carácter = por el nombre completo (trayectoria absoluta) del directorio donde puso los esquemas.

Si cambia el nombre del directorio con las frecuencias relativas de lenguajes o lo mueve,, tendrá que cambiar la línea 
#langFreqDir = /usr/local/share/ganzua/frequencies/

Borre el carácter # al inicio de la línea y cambie el valor después del carácter = por el nombre completo (trayectoria absoluta) del directorio donde puso las frecuencias relativas.

Recuerde que esto debe hacerse en ambos archivos JAR.

  
2.5 Acerca del Paquete de Código Fuente

Dado que Ganzúa es software libre, el código fuente está disponible en el sitio de Ganzúa (http://ganzua.sourceforge.net) para que lo pueda descargar, modificar, distribuir, etc. como se especifica en la licencia GPL.

Para compilar el código fuente, necesitará un compilador para el lenguaje de programación Java versión 1.4 o superior y la herramienta Apache Ant (http://ant.apache.org) versión 1.5 o superior.

Durante el desarrollo de Ganzúa versión 1.01 se usaron los siguientes compiladores:

Hay dos archivos con instrucciones para la herramienta Apache Ant en el paquete de código fuente de Ganzúa. El primero está en el directorio raíz del paquete y puede usarse para generar los JARs ejecutables y la documentación. El segundo se encuentra en el directorio src y compila el programa dejándolo en la estructura del código fuente (no lo pone en un JAR). Para más información sobre estos archivos use el comando ant -projecthelp en los directorios en que se encuentran.

Si quiere ejecutar Ganzúa fuera de un paquete JAR, tendrá que editar el archivo config.properties del directorio src/net/sourceforge/ganzua, como se explica en la sección 2.4.2, aún si no movió o renombró lo directorios de esquemas o frecuencias relativas. Una vez que haya editado el archivo, use el siguiente comando dentro del directorio src para ejecutar Ganzúa:

java net.sourceforge.ganzua.Analyzer

Analyzer es el nombre de la clase que contiene el programa principal de Ganzúa.

Si desea ejecutar el programa para generar las frecuencias relativas de lenguajes use el comando:

java net.sourceforge.ganzua.LangFreq 



Notas a pie de página

... inglés2.1
Java 2 Runtime Environment, Sandard Edition
... inglés2.2
Java API for XML Processing
Jesús Adolfo García Pasquel 2004-10-04