Andante ======= pre20030919 - Initial version (still a prototype) - Not documented yet! http://gsd.ime.usp.br/andante README - compilation and execution instructions ------ The system is currently in a prototype stage, so it is very difficult to compile and run it. We will strive to release a decent version as soon as possible. Feel free to contact us through the URL above. * Required software - Java 2 SDK, Standard Edition v1.4 (J2SDK) http://java.sun.com - Aglets 2.0.2 http://aglets.sourceforge.net - Apache Ant 1.5.4 http://ant.apache.org/ * Compilation Uncompress and extract the tar file: $ tar zxvf andante-pre20030919.tgz Change to the directory named 'andante-pre20030919': $ cd andante-pre20030919 Compile: $ ant The compiled classes will be in the directory 'andante-pre20030919/build'. * Execution First of all, run the CORBA Name Server (included in the J2SDK): $ tnameserv -ORBInitialPort 1050 (The Name Server will be listening on the port 1050.) From now we will assume that the sources were extracted to the directory '/home/user/andante-pre20030919' and the Aglets package is installed in '/home/user/aglets'. In order to run the Aglet-based parts of the system, we need to use the shell script 'asd' located at '/home/user/andante-pre20030919/classes'. Edit this file and change the part that looks like the following: # Set this to your installation directory AGLET_HOME=/home/user/aglets JDK_HOME=/usr/local/j2sdk to match your own directories (AGLET_HOME should be where you installed the Aglets and JDK_HOME where your J2SDK is). Alternatively, you may use the system environment variables. To run any Andante application or infra-structure element, you need to change to the directory '/home/user/andante-pre20030919/build'. Now you may run one or more Stages, each one uses two ports. So you may run more than one Stage in the same machine, provided you choose distinct ports. To run one Stage: $ asd andante.AndanteTest -daemon -port 4444 -controlport 5555 \ -ORBInitialPort 1050 -ORBInitialHost villa Please note that the parameter 'ORBInitialPort' and 'ORBInitialHost' refer to the Name Server: the value '1050' is its port and 'villa' is the name of the machine in which it is running. You should change this values accordingly. After running one or more Stages, we need to run an application that creates/manages Musical Agents. One way is to use the Tahiti interface included on the Aglet package. For this we need to create a symbolic link from the directory where the Tahiti looks for the Java classes to the directory where the Andante classes are: $ ln -s /home/user/andante-pre20030919/build/andante \ /home/user/aglets/public/andante You may now run the Tahiti interface, but the class andante.MusicalAglet already does that: $ asd andante.agent.MusicalAglet -port 6666 -controlport 7777 Use the Tahiti to create and dispatch Musical Agents to a Stage (click on "Create" and fill only the field "name" with, for example, "andante.apps.noiseweaver.NoiseAgent"). Finally, we may run an Andante application, the NoiseWeaver: $ java andante.apps.noiseweaver.NoiseWeaver