|
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.
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.
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.
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.
Una vez que tiene instalada una implementación del JRE versión 1.4 o superior, siga los siguientes pasos para instalar Ganzúa:
Ahora debe poder ejecutar Ganzúa usando el comando java -jar ganzua.jar desde el directorio en el que instaló el programa.
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.
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:
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.
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.
Ahora está listo para instalar Ganzúa. Para ello siga los siguientes pasos:
Eso es todo. Ahora puede ejecutar Ganzúa haciendo doble clic en su icono.
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.
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.
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.
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.
Una vez que tiene instalada una implementación del JRE versión 1.4 o superior, siga los siguientes pasos para instalar Ganzúa:
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.
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.
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:
No necesitará findEndorsedDirs.jar ni el paquete de Xerces2 en adelante, así que puede borrarlos.
Esta sección explica cómo están organizados los archivos de Ganzúa, qué contienen y cómo cambiar su configuración.
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 .
Si descargó el paquete de código fuente, debe tener los siguientes archivos y directorios:
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.
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.
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:
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:
