Tutorial - Instalación y ejecución rápida

---

Este tutorial muestra cómo instalar una versión básica de PELEA (pelea1level) y probar su funcionamiento. Se apoya en un MDPSim modificado para simular un entorno de forma que pueda comprobarse si la acción planificada ha tenido el efecto esperado o no. En este tutorial PELEA usa el planificador MetricFF.

Antes de empezar, es útil crear una nueva carpeta y descomprimir allí todo lo que se descargue para que quede agrupado. A continuación se muestra un ejemplo del árbol de directorios tras una instalación completa:

Pelea: directorio raíz.

• domains: dominios y problemas en PDDL.
• MDPSim: el simulador del entorno.
• Metric-FF: un planificador.
• pelea1level: PELEA.
• temp: una carpeta temporal para PELEA.

Compilación

1. Descargar y descomprimir los ficheros necesarios:
• La versión de PELEA pelea1level del repositorio.
• MDPSim, dentro de util en el repositorio.
• El planificador MetricFF.
• Dominio y problema en PDDL para comprobar el funcionamiento.
2. Compilar PELEA. Con NetBeans se puede hacer así:
   • Nuevo proyecto Java Application desmarcando la opción Create main class.
   • Descomprimir todo el contenido de la carpeta de PELEA dentro del directorio del nuevo proyecto.
   • En las propiedades del proyecto agregar todas las librerías .jar de la carpeta lib.
   • Establecer la clase org.peleame.main como clase principal en las propiedades del proyecto.
   • Compilar el proyecto para que se genere un .jar.
3. Compilar MDPSim:
   • Ir al directorio de MDPSim.
   • Ejecutar ./configure (puede hacer falta dar permiso de ejecución al script) y make.
4. Compilar MetricFF si no lo está:
   • Ir al directorio de MetricFF.
   • Ejecutar make (puede hacer falta instalar flex y bison con apt-get).

Configuración

1. Editar configuration4.xml, de la carpeta raíz de PELEA.
   • Actualizar todos los directorios que aparecen en este .xml (dominio, problema, temporal y los del planificador).

Ejecución de prueba

Cada módulo de PELEA es un proceso aparte y todos ellos deben estar ejecutándose simultáneamente para poderse comunicar. El Monitoring registra las conexiones de todos ellos, por lo que debe iniciarse el primero. También hace falta tener iniciado MDPSim antes de arrancar el módulo Executive.

Para poder ver la salida de todos los componentes hay que usar una consola para cada uno, por esto puede ser útil abrir pestañas para agrupar todo en una única ventana de terminal. Un script facilita mucho la ejecución (ejemplo para pelea1level y para pelea2level).

1. Arrancar MDPSim. Es necesario indicarle el dominio y el problema en PDDL. Por ejemplo, desde el directorio de MDPSim:
   • ./mdpsim -v9 -P 57380 ../domains/domain.pddl ../domains/problem.pddl
2. Levantar PELEA. Se arrancan todos los módulos en consolas individuales, dejando que se registren en el Monitoring antes de iniciar el siguiente. Por ejemplo, desde el directorio de PELEA:
   • java -jar ./dist/pelea1level.jar -c ./configuration4.xml -n M1 -t 7 -m 1
   • java -jar ./dist/pelea1level.jar -c ./configuration4.xml -n DS1 -t 1 -m 2
   • java -jar ./dist/pelea1level.jar -c ./configuration4.xml -n ROVER0 -t 2 -m 2

Volver a Lista de tutoriales