Skip to content

SONATA Profiler: Configuration

Manuel Peuster edited this page Aug 31, 2017 · 2 revisions

Configuring son-profile to use son-emu

The config file is a YAML file containing information to be used by son-profile.
Currently, there is no fixed parser for it, so any keyword can be added. This is done to encourage use of this file for configuration of testing environments.
The file can be found in son-cli/src/son/profile/config.yml

Sections of the configuration file

General Information

It contains general information like who wrote it, what version is it using and a description of the file.

Target Platforms

Contains a short description as a comment and afterwards descriptions of remote hosts to be used in running experiments.

Example Code

target_platforms:
  host_name_1:
    address: "127.0.0.1"
    package_port: 5000
    ssh_port: 22
    ssh_user: "ssh_user"
    ssh_key_loc: "~/.ssh/id_rsa"
  host_name_2:
    address: "127.0.0.1"
    ssh_user: "ssh_user2"
    ssh_key_loc: "~/.ssh/id_rsa"

Keyword explanation

  • target_platforms is the keyword the list is identified by (this cannot be changed, otherwise the code wont work)
  • host_name_1 and host_name_2 are identifiers for the host and will be used as the name in code, logs and results
  • address is the network address or hostname of the host described
  • package_port is the port used to upload and instantiate the package. This argument is optional and defaults to 5000
  • ssh_port is the port which used to connect via ssh. This argument is optional and defaults to 22
  • ssh_user is the user which is used to connect via ssh. This user has to exist on the remote host and be capable of passless sudo
  • ssh_key_loc the location of the ssh key (on the local client) to be used in the ssh connection. It has to be registered on the remote host to allow login without password and it has to be for the user specified in ssh_user

Requirements

Requirements for the remote host are:

  1. Son-Emu has to be installed in the home of the user specified by ssh_user or a symlink named son-emu to the son-emu install is present
  2. it has to allow a ssh connection by the user specified by ssh_user using the key specified by ssh_key_loc without requesting a password
    This implies that the ssh key is present on the local host under the specified path
  3. the user specified by ssh_user can use sudo without a password being requested