Getting started

Getting started#

Prerequisites#

  • Python version 3.9 or higher.

  • Vagrant: Vagrant and VirtualBox.

  • FABRIC: An account and an allocation on FABRIC.

  • Chameleon: An account and an allocation on Chameleon Cloud.

Installation#

Installing Kiso varies based on what testbed(s) you want to use. Choose one of the following:

Vagrant#

pip install kiso[vagrant]

See Set up on Vagrant for more information.

Hint

Starting a new experiment? Check out our Vagrant starter kit for a quick start.

FABRIC#

pip install kiso[fabric]

# On macOS
brew install rsync

See Set up on FABRIC for more information.

Caution

Some FABRIC sites assign IPv6 addresses as the management IP. macOS’ rsync implementation fails connecting to these IPv6 address via jump hosts. To fix this, install rsync from Homebrew.

Hint

Starting a new experiment? Check out our FABRIC starter kit for a quick start.

Chameleon Cloud#

pip install kiso[chameleon]

See Set up on Chameleon Cloud for more information.

See Set up on Chameleon Edge for more information.

Hint

Starting a new experiment? Check out our Chameleon starter kit for a quick start.

Combine multiple testbeds#

pip install kiso[all]
# - OR -
pip install kiso[vagrant,fabric,chameleon]

Next Steps#

  • Your first experiment — walkthrough from a fresh installation of Kiso to a working experiment result

  • Concepts — understand how sites, software, deployments, and experiments fit together

  • Experiment gallery — explore real-world experiments built with Kiso