caminos

This crate provides the CAMINOS simulator as a binary. Most of the functionality is obtained from the caminos-lib crate.

Usage

To use this simulator first install it.

$ cargo install caminos

Then you should be able to run it.

$ caminos --help

To perform a single simulation create a file my_experiment.cfg and execute the simulator. See the caminos-lib crate for documentation on its format.

$ caminos my_experiment.cfg

You may set the --results flags to write the simulation result into it instead of to stdout.

For more complex experiments it is recommended to make a new directory /path/to/my/experiment. This directory should include a file main.cfg describing the experiment to perform and a file main.od describing the outputs to be generated. It may contain a file remote to help to pull result files launched remotely. Then, to run all the simulations locally and create the outputs execute the following.

$ caminos /path/to/my/experiment

Executing Simulations Using SLURM

If we have access to a machine with a SLURM queue system then a way to proceed is as follows.

• Make a local experiment with its main.cfg.
• Create the /path/to/my/experiment/remote

[
	Remote{
		name: "default",
		host: "the.remote.host",
		username: "myusername",
		root: "/path/in/the/remote/machine/to/my/experiment",
		binary: "/path/in/the/remote/to/caminos",
	},
]

• Perform a push to create the files in the remote.

local$ caminos /path/to/my/experiment --action=push

• Login into the remote machine.
• Create the slurm jobs

the.remote.host$ caminos /path/in/the/remote/machine/to/my/experiment --action=slurm

• Close the connection to the remote machine.
• Pull the results. It is fine if only a few have ended, you are indicated how many are yet to be completed.

local$ caminos /path/to/my/experiment --action=pull

• You may now generate your desired outputs if you are so inclined.

local$ caminos /path/to/my/experiment --action=output

Special modes

The special flag enables extra modes other than simulating scenarios. Currently the only such availale mode is exporting a topology. By setting --special=export and --special_args='Export{...}' it will create a topology file. An example command is the following.

$ caminos --special=export --special_args='Export{topology:RandomRegularGraph{routers:500,degree:20,servers_per_router:1},seed:5,filename:"the_topology_file"}'