pads:artisinst
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
pads:artisinst [2012/10/16 08:56] – gdangelo | pads:artisinst [2019/11/15 13:03] (current) – gda | ||
---|---|---|---|
Line 7: | Line 7: | ||
* **GNU/ | * **GNU/ | ||
* **Bash shell**: command line usage | * **Bash shell**: command line usage | ||
+ | * **ARTÌS**: general structure, please see [[http:// | ||
+ | * **GAIA/ | ||
===== Assumptions ===== | ===== Assumptions ===== | ||
- | * **UBUNTU Linux 10.04.1**: desktop version, fully updated | + | * **UBUNTU Linux 12.04.1**: desktop version, fully updated |
- | ===== Basic Installation ===== | + | ===== Installation ===== |
==== Download ==== | ==== Download ==== | ||
- | The last version of the ARTÌS/GAIA software can be freely downloaded from the [[pads: | + | The last version of the ARTÌS/GAIA software can be freely downloaded from the [[pads: |
- | <fc # | + | <color # |
< | < | ||
- | wget http:// | + | wget http:// |
</ | </ | ||
Untar the downloaded file in the chosen directory. | Untar the downloaded file in the chosen directory. | ||
- | <fc # | + | <color # |
< | < | ||
- | tar xvfz ARTIS-2.0.0-LUNES-0.0.1.tar.bz2 | + | tar xvfj ARTIS-2.0.4-i686.tar.bz2 |
</ | </ | ||
==== Missing libraries ==== | ==== Missing libraries ==== | ||
- | <fc # | + | <color # |
- | | name ^ description ^ | + | | name ^ description |
^ libgcrypt11 | ^ libgcrypt11 | ||
^ libgcrypt-dev | ^ libgcrypt-dev | ||
Line 40: | Line 42: | ||
^ libglib2.0-dev | ^ libglib2.0-dev | ||
- | <fc # | + | <color # |
< | < | ||
sudo apt-get install libgcrypt11 libgcrypt-dev libglib2.0-0 libglib2.0-dev | sudo apt-get install libgcrypt11 libgcrypt-dev libglib2.0-0 libglib2.0-dev | ||
</ | </ | ||
+ | |||
+ | ===== Basic Usage ===== | ||
+ | |||
==== A simple example ==== | ==== A simple example ==== | ||
Line 49: | Line 54: | ||
Now we are ready for testing our ARTÌS/GAIA installation. In the main directory of the software (e.g. the ARTIS-2.0.0 directory) there is the STRUCTURE.TXT file that describes the whole software structure including EXAMPLES and MODELS. We will start from the WIRELESS example that is contained in the EXAMPLES directory. In this simple model there is a set of wireless devices moving in a toroidal 2D space. The interactions among them are based on proximity. | Now we are ready for testing our ARTÌS/GAIA installation. In the main directory of the software (e.g. the ARTIS-2.0.0 directory) there is the STRUCTURE.TXT file that describes the whole software structure including EXAMPLES and MODELS. We will start from the WIRELESS example that is contained in the EXAMPLES directory. In this simple model there is a set of wireless devices moving in a toroidal 2D space. The interactions among them are based on proximity. | ||
- | <fc # | + | <color # |
< | < | ||
- | cd ARTIS-2.0.0/ | + | cd ARTIS-2.0.4/ |
</ | </ | ||
All the models and examples are provided as source code and therefore need to be compiled before usage, in all cases a Makefile is provided. | All the models and examples are provided as source code and therefore need to be compiled before usage, in all cases a Makefile is provided. | ||
- | <fc # | + | <color # |
< | < | ||
make | make | ||
Line 63: | Line 68: | ||
If the compilation is successful then the **sima** and the **wireless** binaries have been created in the current directory. A couple of shell scripts are provided for running the example, in this case we will use the **run** script. Running the script with no parameters generates an error and shows the syntax to be used. | If the compilation is successful then the **sima** and the **wireless** binaries have been created in the current directory. A couple of shell scripts are provided for running the example, in this case we will use the **run** script. Running the script with no parameters generates an error and shows the syntax to be used. | ||
- | <fc # | + | <color # |
< | < | ||
./run | ./run | ||
Line 72: | Line 77: | ||
The first parameter (#LP) is the number of Logical Processes used in the simulation and the second one (#SMH) is the number of objects to simulate. | The first parameter (#LP) is the number of Logical Processes used in the simulation and the second one (#SMH) is the number of objects to simulate. | ||
- | <fc # | + | <color # |
< | < | ||
./run 2 100 | ./run 2 100 | ||
Line 83: | Line 88: | ||
Both the LPs have completed the execution, the elapsed amount of time is shown in the output. The execution has produced one log file for each LP in which is reported a step-by-step evolution of simulated model. The log files are named {{: | Both the LPs have completed the execution, the elapsed amount of time is shown in the output. The execution has produced one log file for each LP in which is reported a step-by-step evolution of simulated model. The log files are named {{: | ||
- | <fc # | + | <color # |
< | < | ||
gedit 0.out | gedit 0.out | ||
Line 103: | Line 108: | ||
Now we can proceed with a much more complex simulated model in which are used the features offered by the [[pads: | Now we can proceed with a much more complex simulated model in which are used the features offered by the [[pads: | ||
- | <fc # | + | <color # |
< | < | ||
cd.. | cd.. | ||
Line 112: | Line 117: | ||
Also in this case it is necessary to compile the simulated model using the provided Makefile. | Also in this case it is necessary to compile the simulated model using the provided Makefile. | ||
- | <fc # | + | <color # |
< | < | ||
make | make | ||
Line 119: | Line 124: | ||
If the compilation is successful then the **sima** and the **mig-agents** binaries have been created in the current directory. As usual a shell script (i.e. **run**) can be executed to start the simulation. Running the script with no parameters generates an error and shows the syntax to be used. | If the compilation is successful then the **sima** and the **mig-agents** binaries have been created in the current directory. As usual a shell script (i.e. **run**) can be executed to start the simulation. Running the script with no parameters generates an error and shows the syntax to be used. | ||
- | <fc # | + | <color # |
< | < | ||
./run | ./run | ||
Line 128: | Line 133: | ||
The first parameter (#TOT_LP) is the total number of Logical Processes used in the simulation, the second one (#LP) is the amount of LPs to be run on this computer and, finally, (#IA) is the number of objects to simulate. | The first parameter (#TOT_LP) is the total number of Logical Processes used in the simulation, the second one (#LP) is the amount of LPs to be run on this computer and, finally, (#IA) is the number of objects to simulate. | ||
- | <fc # | + | <color # |
< | < | ||
./run 2 2 100 | ./run 2 2 100 | ||
Line 141: | Line 146: | ||
In this case the useful information in the log file of the second LP. | In this case the useful information in the log file of the second LP. | ||
- | <fc # | + | <color # |
< | < | ||
gedit 1.out | gedit 1.out | ||
Line 147: | Line 152: | ||
{{: | {{: | ||
+ | |||
+ | As shown in the first lines of the log file, in this case both the ARTÌS and the GAIA layers have been initialized. The simulated objects produce a some amount of interactions and the GAIA framework implements some migrations to enhance the communication load-balancing. In this case the computational load-balancing features are turned off. | ||
{{: | {{: | ||
+ | |||
+ | The source code of the simple simulation model ({{: | ||
+ |
pads/artisinst.1350377810.txt.gz · Last modified: 2012/10/16 08:56 by gdangelo