Instalacion y configuracion

Glosario de terminos empleados

Anillo Empleamos este termino para definir al conjunto de ordenadores conectados, compartiendo informacion.
Tarea Es la subida o bajada de un archivo.
Archivo fs Almacena informacion de un archivo subido para poder recuperarlo en otra ocasion.

Requisitos

Para conocer la version Java que tenemos instalada: 
java -version
Si estas en Ubuntu y tienes varias versiones instaladas, puedes elegir la que deseas emplear: 
sudo update-alternatives --config java

Instalacion

Tras obtener el fichero de instalacion debes ejecutar el siguiente comando: 
java -jar madagascar_setup.jar
Tras esto se activara el programa de instalacion. Acepta la licencia y tras esto tendras que configurar el directorio de instalacion:

setup1
El directorio no debe tener espacios en blanco. Si te es necesario separar partes del path emplea _.

Tras esto pulsa siguiente e instala los paquetes que estan marcados.

Puesta en marcha

Tras la instalacion se ha generado un script que se encarga de lanzar la aplicacion. Si estas en windows tiene extension BAT y si estas en Linux es un sript shell que puedes lanzar desde el propio escritorio o mediante consola: 
sh startmadagascar o ./startmadagascar
Dicho script se encuentra en {cube_intall_path}/madagascar. Si estas en windows solo tienes que ejecutar el .bat.

Pantalla principal de la aplicacion.

Barra de herramientas:


Conectar con un anillo.
Desconectar de un anillo.
Permite obtener informacion de un fichero fs.
Sube un archivo al anillo.
Baja un archivo del anillo.
Inicia una tarea previamente detenida.
Detiene una tarea
Sistema de actualizaciones.

Puedes obtener informacion del estado de una tarea seleccionandola y pinchando sobre la pestaña resumen:
En esta captura se aprecia que se llevan subidos 11.5 Mbytes de un total de 70.7. Si pinchas en la pestaña nodo se obtiene informacion del mismo, teniendo la posibilidad de ver el nombre del anillo al que has conectado, el tamaño de la cache o la cantidad de disco duro que compartes. El directorio en el que se almacenan los fragmentos compartidos es {cube_intall_path}/cube/cubeFS/hd



Esta es la zona en la que se muestran las tareas. Si seleccionamos una y pulsamos con el boton derecho del raton aparece un menu contextual que nos permite obtener informacion del archivo fs asociado a la tarea y tambien permite borrarla.

Conectar a un anillo

Para conectar a un anillo necesitamos conocer la ip de un nodo que nos sirva de enlace al anillo al que desemaos conectar. Si no coneces ninguno, puedes usar hipercube.servebeer.com y el puerto destino 8429.



Como puerto local puedes poner el que tu quieras, pero eso si, DEBE SER UN PUERTO ABIERTO EN EL ROUTER Y DIRIGIDO A TU ORDENADOR. Ademas, hay que tener en cuenta que debes de darle permisos tambien en el cortafuegos de tu ordenador en caso de estar activo. Si estas en Linux, sera IpTables.
Madagascar obtiene automaticamente tu IP externa sin hacer uso del protocolo Upnp. Si deseas ver dicha IP solo tienes que pinchar sobre la pestaña NAT. NOTA:Debido a que tiene que obtener la IP, es posible que en algunas ocasiones tarde unos segundos. Esto depende del estado del servidor. Tras introducir la ip y el puerto destino, pulsamos aceptar y cuando estemos conectados aparecera en la parte inferior izquierda de la pantalla principal el estado como conectado. Si en ese momento pulsamos sobre la pestaña nodo podremos ver el nombre del anillo al que hemos conectado.

Subir archivo

Tenemos que decir el nombre del fichero fs en el que se almacenara la informacion de los datos subidos y que, cuando finalice la subida, estara en disposicion de ser distribuido, pasandoselo a tus amigos y permitiendoles descargar lo que tu subiste.
Tras esto decimos lo que queremos subir. En la version actual, los fs solo pueden almacenar un archivo por lo que la mejor opcion, en caso de querer subir un conjunto de archivos en un mismo fs, es comprimirlos. Seria aconsejable que añadas en la descripcion del archivo en que formato has comprimido.



Al subir un archivo debes seleccionar la persistencia: Con la persistencia temporal se consigue eliminar de forma automatica de un anillo aquellos datos no descargados. Por contra, la persistencia TOTAL hace que se mantengan dichos datos, pues no seran tenidos en cuenta por el recolector de fragmentos caducados. Tras aceptar esto, se nos permite añadir metadatos al archivo como por ejemplo la descripcion. En ella detallamos el contenido de lo que se va a descagar. Ademas de la descripcion podemos añadir licencia de distribucion, copyright y autores del contenido que se publica.

Descarga de un archivo

Para descargar un archivo necesitamos el fichero fs y decirle el nombre del fichero en el que se almacenaran los datos descargados.

Consejos

Es aconsejable cerrar bien la aplicacion cuando se desee terminar, para no perder datos. Cuando se desea desconectar del anillo puede que tarde unos segundos. Esto es debido a que esta terminando de operar con los ultimos fragmentos que quedan en cola. Lo mismo ocurre cuando le damos a detener el trabajo, que se detendra pero tiene que vaciarse la cola de fragmentos pendientes.

Nota sobre rendimiento: En las subidas de archivos se requere mas recursos que para descarga. Es la primera version beta por tanto tened paciencia. Esto se corregira en posteriores lanzamientos.
Enjoy!!!!!