Repositorio para el trabajo práctico N°2 de la materia "72.42 - Programación de Objetos Distribuidos" - ITBA

Siguiendo los pasos provistos por la cátedra en el archivo Hazelcast - Configuración Java, es necesario primero construir el proyecto corriendo:

mvn clean install

Esto generará los archivos necesarios para correr el trabajo práctico. En la raíz del proyecto encontrarán archivos .sh usados para correr el servidor y las consultas.

./runserver.sh

./queryX.sh -Daddresses='xx.xx.xx.xx:XXXX;yy.yy.yy.yy:YYYY' -DinPath=XX -DoutPath=YY [params]

Donde

• queryX es el script que corre la query X.
• Daddresses refiere a las direcciones IP de los nodos con sus puertos (una o más, separadas por punto y coma)
• DinPath indica el path donde están los archivos de entrada bikes.csv y stations.csv.
• DoutPath indica el path donde estarán ambos archivos de salida.
• params son los parámetros extras que corresponden para algunas queries.

Las queries 1 y 3 se corren sin parametros adicionales, mientras que la query 2 utiliza un -Dn=n (numero entero) y la y la query 4 utiliza -DstartDate=dd/MM/yyyy y -DendDate=dd/MM/yyyy.

• En la consigna se pedía que los clientes corrieran desde terminal sin incluir la extensión .sh (Ejemplo: ./query1 ...). Esto depende de la configuración de la terminal, pero en el caso de este desarrollo (y como está aclarado en este README), el proyecto se corrió con la extensión incluida.
• Es importante notar que la compilación de los .sh presenta inconvenientes cuando se compilan en windows. Al compilarse el proyecto en windows, se genera al final de las lineas el \n\r. Esto es algo que impide la correcta ejecución de los scripts, dado que marca un error al no reconocer las lineas desde un sistema Linux. Para esto, se tiene el siguiente comando que elimina el \r de todas las lineas, dejando así comandos ejecutables en un sistema Linux:

find . -name '*.sh' -exec sed -i -e 's/\r$//' {} \;

• Aunque no fue aclarado en la consigna, la lectura de un .csv de 14 millones de líneas es imposible (hazelcast da un error de heap space). Debido a esta imposibilidad, se fijo, en la clase ParsingUtils.java, una constante denominada MAX_LINES_TO_READ, que indica el valor máximo de entradas que se leerán de un archivo. De ser más corto, no habrá inconveniente.
• Si se quiere modificar, alcanza con entrar a la clase, cambiar el valor por el deseado, y comenzar desde el paso 1.
• Tambien, existe la funcion para realizar la lectura del archivo en forma de batch, sin embargo, para los testeos y el analisis de la performance se desperdiciaba mucho tiempo.