Sponsored by the National Science Foundation Today’s Exercise

Sponsored by the National Science Foundation 2 Objectives Use GENI account to get SAVI credentials Get compute resources (VMs) from GENI and SAVI Learn Ansible basics to install and configure VMs

Sponsored by the National Science Foundation 3 Major Steps Access SAVI from the GENI Portal Get a VM from GENI and SAVI Install and configure software the VMs –Automated using Ansible Verify everything worked –Using Lively Web

Sponsored by the National Science Foundation 4 Experiment Setup Client VM (provided for your convenience-- has tools such as ansible installed)

Sponsored by the National Science Foundation 5 Tools Used tutorials.sh A wrapper around the GENI Omni tool Makes it easy to get VMs from GENI and Omni –Omni tool and OpenStack tools are needed for anything more than getting VMs Ansible A configuration management tool

Sponsored by the National Science Foundation 6 Ansible

Sponsored by the National Science Foundation 7 What do experimenters need? Ensure experiment is in a known configuration Easily repeat existing experiment setups (for multiple runs, changing parameters, etc) Reproduce configuration across space and time Easy to build many nodes that look the same Useful for scaling up the size of topologies (space) Useful for rebuilding a topology repeatedly (time)

Sponsored by the National Science Foundation 8 CM Systems are Idempotent CM systems are usually idempotent Repeated runs generates the same state Contrast to a shell script which encodes how to transition between two known states The state is usually easy to describe. iperf should be (or not be) installed File foo.html should exist (or not) Describing all possible transitions from every possible previous state is hard. If iperf is not already installed, then install it, else do nothing Known State A Known State B Shell script A -> B Unknown State A Known State B ? CM Idempotent

Sponsored by the National Science Foundation 9 Ansible Setup Experimenter ssh  Public key is stored on each remote machine  Private key is stored on local machine  Ansible client installed GENI Slice  Inventory file describes substrate

Sponsored by the National Science Foundation 10 Using Ansible Ad Hoc mode Execute individual commands on one or more nodes Playbooks Enforce configurations Written in YAML Inventory file Lists hosts to be managed –Organized by groups

Sponsored by the National Science Foundation 11 Get Started! Log into the GENI Portal Request to join the project tridentcom Tutorial instructions:

Sponsored by the National Science Foundation 12 Generate SSH Keys and SSL Certs Look for the ssh and ssl tabs under your Portal profile page –No need to download ssh key or ssl cert

Sponsored by the National Science Foundation 13 Download Omni Configuraion Back to Profile page on Portal “Download your Omni Data”

Sponsored by the National Science Foundation 14 Get SAVI Account Access SAVI from the GENI Portal home page Wait for with SAVI account details Username Password Tenant name

Sponsored by the National Science Foundation 15 Follow the Instructions Start with Step 1 Tutorial instructions:

Sponsored by the National Science Foundation 16 Experiment Setup Download your Omni Bundle from the Portal Make sure you have ssh keys and ssl certs Login to Client machine Use username and password from Run omni-configure on client machine After you scp/winscp to Client machine Use a tool called “tutorials.sh” to create VMs Install and configure software on VMs Create Ansible playbooks Run playbooks See you VMs show up on a map Your VMs post their IP address and location to Lively Web