Informe metodología GAIA - “Buscador de talento amigo”

Manual de instalación, compilación y ejecución - “Buscador de talento amigo”
Manual de instalación, compilación y ejecución:
“Buscador de talento amigo”
Especialización en Ingeniería de Software
Arquitectura de sistemas multi-agentes
Universidad Autónoma de Manizales
Jorge Iván Meza Martínez
jimezam@gmail.com
http://www.jorgeivanmeza.com/
Versión 0.1
Manizales
2008
Jorge Iván Meza Martínez - 1/9
Manual de instalación, compilación y ejecución - “Buscador de talento amigo”
Contenido
1. Introducción.
2. Requerimientos.
2.1 Para el prototipo de la red social.
2.2 Para el prototipo SMA de escritorio.
3. Instalación.
3.1 Prototipo web de una red social.
3.1.1 Descripción de la base de datos.
3.2 Prototipo de la aplicación de escritorio.
4. Compilación.
5. Ejecución.
Jorge Iván Meza Martínez - 2/9
Manual de instalación, compilación y ejecución - “Buscador de talento amigo”
1. Introducción
El presente documento describe las actividades necesarias para realizar la instalación,
compilación desde fuentes y ejecución de la distribución binaria del prototipo de Buscador
de talento amigo.
Debe tenerse en cuenta que el prototipo se encuentra dividido en dos secciones: una web
representada por el prototipo de red social y otro de escritorio el cual es el SMA que
realiza efectivamente la búsqueda de talento a lo ancho de la red social.
A continuación se describen también los requerimientos de hardware y de software que son
prerequisitos necesarios para la correcta compilación y ejecución del aplicativo en cualquier
estación de trabajo. La instalación de estos excede el ámbito de este documento.
Jorge Iván Meza Martínez - 3/9
Manual de instalación, compilación y ejecución - “Buscador de talento amigo”
2. Requerimientos
Para la instalación del prototipo del Buscador de talento amigo basado en un sistema
multiagente utilizando J2SE y Jade se requiere que se cuente con el siguiente hardware y
software instalado
2.1 Para el prototipo de la red social.
●
●
Servidor web Apache.
Módulo de PHP con soporte para SQLite.
2.2 Para el prototipo SMA de escritorio.
●
●
●
●
●
JRE 1.6 (J2SDK para compilar desde fuentes).
Librerías de Jade (incluídas en la distribución).
Librerías de GeoNames (incluídas en la distribución).
Librerías de JCoord (incluídas en la distribución).
Acceso a Internet.
Jorge Iván Meza Martínez - 4/9
Manual de instalación, compilación y ejecución - “Buscador de talento amigo”
3. Instalación
3.1 Prototipo web de una red social simple basada en la especificación de hCard.
1. Copie la carpeta MandarinaSocial bajo el directorio público del servidor web.
2. Edite los registros de la red social manipulando la base de datos
<path>/MandarinaSocial/data/database.sqlite.
3. Consulte la dirección http://<servidor>/<path>/MandarinaSocial utilizando
un navegador web.
Ajuste los significados de <servidor> y <path> según los valores específicos del
sistema donde se instala.
El prototipo de red social no incluye funciones de edición, así que para manipular su
información (#2) utilice cualquier herramienta de administración de bases de datos SQLite.
Por facilidad se recomienda utilizar SQLite Manager que es un plugin del navegador Firefox.
3.1.1 Descripción de la base de datos.
Contacto
id
email
nombres
apellidos
profesion
rol
ciudad
departamento
pais
foto
-
Nombre de usuario del contacto
Dirección de correo electrónico
Nombres reales
Apellidos reales
Profesión con que cuenta
Funciones que desempeña
Ciudad de vivienda
Departamento de vivienda
País de vivienda
Imágen (no utilizado actualmente)
Representa a cada uno de los usuarios que pertenecen a la red social.
de usuario (id) deberán ser únicos.
Los identificadores
Amistad
Jorge Iván Meza Martínez - 5/9
Manual de instalación, compilación y ejecución - “Buscador de talento amigo”
contacto
amigo
- Usuario propietario de la relación
- Usuario con el cual se comparte la relación
Representa la relación de amistad entre dos usuarios de la red social: contacto es
amigo de amigo.
Los valores almacenados en los campos contacto y amigo deberán coincidir con los
almacenados en contacto.id.
3.2 Prototipo de la aplicación de escritorio basado en la plataforma para SMA Jade.
1. Copie el contenido de la carpeta TalentoAmigo a cualquier ubicación de la
estación de trabajo.
Verifique que contenga la siguiente estructura de directorios.
\bin
\src
\lib
- distribución binaria ya compilada
- distribución de código fuente
- conjunto de librerías requeridas para su ejecución
Jorge Iván Meza Martínez - 6/9
Manual de instalación, compilación y ejecución - “Buscador de talento amigo”
4. Compilación
Para compilar las clases ubicadas en el directorio \src de la distribución del cliente de
escritorio utilice el siguiente comando desde el directorio raíz de la distribución o utilice el
script compile.bat para mayor facilidad.
javac -classpath %CLASSPATH%;lib\* -sourcepath src -d bin Clase.java
Para compilar la totalidad de las clases de los agentes del prototipo ejecute los siguientes
comandos o utilice el script compileAll.bat para mayor facilidad.
compile.bat
compile.bat
compile.bat
compile.bat
src\ta\agents\DistanceCalculatorAgent.java
src\ta\agents\GeolocatorAgent.java
src\ta\agents\AttenderAgent.java
src\ta\agents\SearchAgent.java
Jorge Iván Meza Martínez - 7/9
Manual de instalación, compilación y ejecución - “Buscador de talento amigo”
5. Ejecución
Para ejecutar la aplicación de escritorio ubicada en el directorio \bin de la distribución,
utilice el siguiente comando desde el directorio raíz o utilice el script run.bat para mayor
facilidad.
java -classpath %CLASSPATH%;lib\*;bin jade.Boot -gui
attender:ta.agents.AttenderAgent
geoloc:ta.agents.GeolocatorAgent
distcalc:ta.agents.DistanceCalculatorAgent
Jorge Iván Meza Martínez - 8/9
Manual de instalación, compilación y ejecución - “Buscador de talento amigo”
Creative Commons
Jorge Iván Meza Martínez - 9/9