Execution of testing routines

Esta sección tratará de solventar las dudas de los usuarios finales de la aplicación desarrollada como PFC. En las siguientes secciones se indicará como instalar el software, ejecutarlo, conocer los mensajes de error, etc.

Requisitos

El primer apartado está dedicado a los requisitos necesarios para ejecutar la aplicación desarrollada, tanto a nivel de hardware como a nivel de software.

Requisitos Hardware

En la siguiente tabla se detallan los requisitos hardware1 _{necesarios para} poder ejecutar el programa.

Procesador Pentium IV 2600

Memoria RAM 512 MB

Disco Duro 3 MB2

Tarjeta gráfica Compatible vga

Versión Paralela Acceso a Cluster/Grid

Tabla 21: Requisitos hardware

Requisitos Software

A la hora de ejecutar la aplicación será necesario cumplir los siguientes requisitos de software.

Sistema Operativo Linux (kernel > 2.14)

Librerías Librería MPI3

Versión secuencial Binario de la versión secuencial del

algoritmo

Versión paralela Binario de la versión paralela del

algoritmo

Para compilar Si desea compilar alguna de las

versiones necesitará las librerías de desarrollo de MPI4

Tabla 22: Requisitos software

1 Requisitos tomados de los ordenadores de desarrollo, pero podría funcionar sobre configuraciones menores

2 Se necesitará almacenamiento extra para las imágenes hiperespectrales 3 Ver sección Instalación para mas información

Instalación

Esta sección abarca el proceso de instalación del programa desarrollado. El programa viene distribuido como un tar.gz en el que se encuentran por un lado los binarios de la aplicación y por otro el código fuente de la misma, permitiendo al usuario compilar el código si desea personalizar el binario para una distribución concreta.

Librerías

Para el correcto funcionamiento de la aplicación es necesario tener instaladas la librería MPI. Esta librería implementa el middelware necesario para correr la aplicación de forma paralela. La instalación puede variar de una distribución a otra, así que daremos las instrucciones básicas para instalar la librería en las principales distribuciones, así como a partir de su código fuente.

Además de esto, si desea compilar el código fuente proporcionado, tanto de la versión paralela, como la secuencial, necesitará obtener las librerías de desarrollo de MPI.

En la siguiente tabla se detalla la forma de instalar las librerías necesarias para correr el programa y para compilarlo.

Distribuciones Debian apt-get install mpich-bin openmpi-bin mpi-doc Distribuciones Red Hat yum install mpich-bin openmpi-bin mpi-doc

Compilar Librería5 _1.

Descargue el código fuente de la web de MPI6_.

2. Descomprima el archivo descargado con: tar xvf

mpich.tar.gz

3. Acceda a la carpeta y ejecute:

./configure ./make ./make install

Librerías de desarrollo apt-get libmpich1.0-dev (Debian)

yum install libmpich1.0-dev (Red Hat/Fedora)

5 Puede encontrar mas información sobre la compiladión de MPICH en : http://www-unix.mcs.anl.gov/mpi/mpich1/compiler.html

Instalación de binarios

Para instalar la versión de binarios solamente tendrá que descomprimir el fichero proporcionado en la carpeta que desee, para ello, ejecute:

$> gunzip Fichero.tar.gz

Este comando le creará una carpeta donde se encuentran por un lado los binarios de la aplicación (directorio bin) y por otro el código fuente de la misma (directorio src). Si desea compilar el código fuente puede hacerlo ejecutando:

$> make

en el directorio src. Esto le creará los binarios en la ruta bin, antes citada.

Ejecución

A continuación mostramos la forma de ejecutar las dos versiones desarrolladas: secuencial y paralela.

Versión secuencial

Para ejecutar la versión secuencial debe ejecutar el siguiente comando: $> ./sequential [opciones] NombreFichero

A continuación enumeramos las posibles opciones de ejecución de la versión secuencial:

● -w: Establece el tamaño de la ventana de procesamiento. El valor de la

ventana debe ser menor de 9 y mayor o igual que 3 e impar.

● -o: Configura el nombre del fichero de salida. Por defecto output.bsq ● -no-save: No salvará el resultado.

● --help: Muestra la ayuda.

Un ejemplo de uso sería:

$> ./sequential -no-save AVIRIS_RAD

Versión paralela

Para ejecutar la versión paralela debe ejecutar el siguiente comando: $> mpirun parallel -np X [opciones] NombreFichero

La opción -np establece el número de procesadores que se usarán en la ejecución. A continuación enumeramos las posibles opciones de ejecución de la versión paralela:

● -w: Establece el tamaño de la ventana de procesamiento. El valor de la

ventana debe ser menor de 9 y mayor o igual que 3 e impar.

● -o: Configura el nombre del fichero de salida. Por defecto output.bsq. ● -no-save: No salvará el resultado.

● -e: Número de líneas que se usan en la estimación del reparto de recursos. ● --help: Muestra la ayuda.

Un ejemplo de uso sería:

$> mpirun parallel -np 16 -e 5 -w 5 AVIRIS_RAD

En el comando de ejemplo se ejecuta la simulación para 16 procesadores, usando 5 líneas para estimar la carga de los procesadores y una ventana de 5x5.

Mensajes de error

Por último se describen los posibles mensajes de error que pueden aparecer a la hora de ejecutar cada uno de los programas. Generalmente los errores son comunes a las dos aplicaciones, así que si alguno de los mensajes sólo pertenece a una de las versiones se indica.

Invalid option

Uno de los parámetros no es válido. Compruebe la sintaxis del comando ejecutado.

Unable to load bsq image

No se puede leer el archivo de imagen indicado. Compruebe que la imagen está en la ruta especificada y el nombre de la misma.

Unable to create output file

No se ha podido crear el fichero de salida. Compruebe que existe la carpeta destino, tiene suficiente espacio y tiene permisos de escritura sobre el destino.

Incorrect format

El formato de la imagen no es válido. Revise la imagen de entrada. Unable to calculate workload (paralela)

No se ha podido calcular la carga de trabajo para los procesadores. Revise la configuración de la imagen, y del cluster.