How to run multiple computations?

A common scenario is to run repeated experiments with the same or similar configuration in each execution. AgE tries to facilitate such a scenario by making it possible to run multiple computations one after another.

Using console

When using the console (or standalone node with the console) you can start multiple computations using the following commands:

computation.load({ config:'file:conf/1.xml' });
computation.start();
computation.waitUntilFinished();
computation.clean();

computation.load({ config:'file:conf/2.xml' });
computation.start();
computation.waitUntilFinished();
computation.clean();

Or you can prepare the whole Javascript file and run it in the batch mode of the console:

For example, save this file as configuration.js:

for (var i = 1; i <= 2; i++) {
    computation.load({ config:'file:conf/' + i + '.xml' });
    computation.start();
    computation.waitUntilFinished();
    computation.clean();
}

And run:

age3-console/bin/age3-console configuration.js

As always, it is also possible to run it from Gradle:

./gradlew age3-console:shell -PappArgs="['configuration.js']"

Using “client” API

It is also possible to use the internal, not-really-documented API located in the pl.edu.agh.age.client package. This is API used by the console to perform its tasks.

You need to have implementations injected to your class and it need to be created by Spring:

public final class MyClass {

    private final WorkerServiceClient workerServiceClient;

    @Inject public MyClass(final WorkerServiceClient workerServiceClient) {
        this.workerServiceClient = requireNonNull(workerServiceClient);
    }
}

Passing additional properties to computations

It is sometimes required to pass additional properties to computations. In AgE it is possible using standard properties files. Both the computation command in the console and the node parameters can be used to pass them. In both cases all passed files are loaded and merged together.

Using console

When using the console (or standalone node with the console) you can pass propertiesFiles parameter:

computation.load({ config:'file:conf/1.xml', propertiesFiles:['file:conf/1.properties', 'file:conf/2.properties'] });

Note: when configuration and properties files are loaded using the console, they are read on the host where console is located, so nodes do not need to have access to these files.