#!/bin/bash # ONOS developer BASH profile conveniences # Simply include in your own .bash_aliases or .bash_profile # Root of the ONOS source tree export ONOS_ROOT=${ONOS_ROOT:-~/onos} # This is a hack to remove symlinks from the ONOS_ROOT path. To be removed when # the protobuf buck rules can handle symlinks ONOS_ROOT=$(pushd $ONOS_ROOT >/dev/null && pwd -P && popd >/dev/null) # Setup some environmental context for developers if [ -z "${JAVA_HOME}" ]; then if [ -x /usr/libexec/java_home ]; then export JAVA_HOME=$(/usr/libexec/java_home -v 1.8) elif [ -d /usr/lib/jvm/java-8-oracle ]; then export JAVA_HOME="/usr/lib/jvm/java-8-oracle" elif [ -d /usr/lib/jvm/java-8-openjdk-amd64 ]; then export JAVA_HOME="/usr/lib/jvm/java-8-openjdk-amd64" fi fi export MAVEN=${MAVEN:-~/Applications/apache-maven-3.3.9} export KARAF_VERSION=4.2.1 export KARAF_ROOT=${KARAF_ROOT:-~/Applications/apache-karaf-$KARAF_VERSION} export KARAF_LOG=$KARAF_ROOT/data/log/karaf.log # Setup a path export PATH="$PATH:$ONOS_ROOT/tools/dev/bin" export PATH="$PATH:$ONOS_ROOT/tools/test/bin:$ONOS_ROOT/tools/test/scenarios/bin" export RUN_PACK_PATH=${RUN_PACK_PATH:-$ONOS_ROOT/tools/package/runtime/bin} export PATH="$RUN_PACK_PATH:$PATH" export PATH="$PATH:$ONOS_ROOT/tools/build" export PATH="$PATH:$MAVEN/bin:$KARAF_ROOT/bin" # Setup cell enviroment export ONOS_CELL=${ONOS_CELL:-local} # Setup default web user/password export ONOS_WEB_USER=onos export ONOS_WEB_PASS=rocks # Setup default location of test scenarios export ONOS_SCENARIOS=$ONOS_ROOT/tools/test/scenarios # Setup path to Mininet custom scripts export ONOS_MN_PY=$ONOS_ROOT/tools/dev/mininet/onos.py export BMV2_MN_PY=$ONOS_ROOT/tools/dev/mininet/bmv2.py # Convenience utility to warp to various ONOS source projects # e.g. 'o api', 'o dev', 'o' function o { cd $(find $ONOS_ROOT/ -type d -and \( -name 'bazel-*' -o -name 'buck-out' -o -name '.git' -o -name 'target' -o -name 'gen-src' -o -name 'src' \) -prune -o -type d | \ egrep "${1:-$ONOS_ROOT}" | awk '{print length($1)"\t"$1}' | sort -n | cut -f2 | head -n 1) } # Buck (if "buck" is not on the PATH) [ -z "$(which buck)" ] && alias buck="onos-buck" # Short-hand for ONOS build, package and test. alias op="SHLVL=1 bazel build //:onos" alias ot="bazel run //:buildifier_check && bazel query 'tests(//...)' | SHLVL=1 xargs bazel test --test_summary=terse --test_output=errors" alias ob="op && ot" alias obd="SHLVL=1 bazel build //docs:external //docs:internal" alias ok="SHLVL=1 bazel run onos-local --" alias oh="onos localhost halt" alias ol='onos-log' alias ow='onos-watch' alias ocl='onos-check-logs' alias oi='setPrimaryInstance' # Short-hand for tailing and searching the ONOS (karaf) log alias tl='$ONOS_ROOT/tools/dev/bin/onos-local-log' alias gl='grep $KARAF_LOG --colour=auto -E -e ' function filterLocalLog { tl | grep --colour=always -E -e "${1-org.onlab|org.onosproject}" } alias tlo='filterLocalLog' alias tle='tlo "ERROR|WARN|Exception|Error"' function filterLog { ol | grep --colour=always -E -e "${1-org.onlab|org.onosproject}" } alias olo='filterLog' alias ole='olo "ERROR|WARN|Exception|Error"' # Pretty-print JSON output alias pp='python -m json.tool' # Short-hand to launch Java API docs, REST API docs and ONOS GUI alias docs='open $ONOS_ROOT/docs/target/site/apidocs/index.html' alias rsdocs='onos-rsdocs' alias gui='onos-gui' # Short-hand for 'mvn clean install' for us lazy folk alias mci='mvn clean install' # Git annotated one-line log alias gil='git log --oneline --decorate=short' # Test related conveniences # SSH to a specified ONOS instance alias sshctl='onos-ssh' alias sshnet='onos-ssh $OCN' # Runs a sequence of STC scenarios until the first failure. function stcs { for s in "$@"; do if [[ $s =~ ^[0-9]*$ ]]; then printf "Waiting %d seconds...\n" $s sleep $s else printf "Running scenario %s...\n" $s stc $s || return 1 fi done } # Applies the settings in the specified topology recipe file or lists current # topo recipe definition if no topo recipe file is given. function topo { topo=${1:-""} case "$topo" in "") env | egrep "ONOS_TOPO" env | egrep "(OTD|OTL|OTH)=" ;; *) [ ! -f $ONOS_ROOT/tools/test/topos/$1.recipe ] && echo "No such topo recipe: $1" >&2 && return 1 unset ONOS_TOPO OTD OTL OTH ONOS_DEVICES ONOS_HOSTS ONOS_DEVICES="" ONOS_HOSTS="" unset $(env | sed -n 's:\(^OT[DLH][0-9]\{1,\}\)=.*:\1 :g p') export ONOS_TOPO=$1 . $ONOS_ROOT/tools/test/topos/$1.recipe let d=1; while [ $d -le $OTD ]; do dev="$(printf 'of:%016x' $d)" export OTD$d=$dev; export ONOS_DEVICES="$ONOS_DEVICES $dev" let d=d+1; done let h=1; while [ $h -le $OTH ]; do host="$(printf '00:00:00:00:00:%02x/-1' $h)" export OTH$h=$host; export ONOS_HOSTS="$ONOS_HOSTS $host" let h=h+1 done topo esac } # Lists available topo recipes function topos { for topo in $(ls -1 $ONOS_ROOT/tools/test/topos/*.recipe); do name=$(basename $topo .recipe) printf "%-16s %s\n" \ "$([ $name = $ONOS_TOPO ] && echo $name '*' || echo $name)" \ "$(grep '^#' $topo | head -n 1)" done } # Sets the primary instance to the specified instance number. function setPrimaryInstance { export ONOS_INSTANCES=$(env | grep 'OC[0-9]*=' | sort | cut -d= -f2) if [ -z "${OCC1-}" ]; then aux=/tmp/cell-$$.aux let i=1 for n in $ONOS_INSTANCES; do echo "export OCC$i=$n" >> $aux let i=i+1 done [ -f $aux ] && source $aux && rm $aux fi export ONOS_CORES=$(env | grep 'OCC[0-9]*=' | sort | cut -d= -f2) export OCI=$(env | egrep "OC[0-9]+" | sort | egrep OC${1:-1} | cut -d= -f2) echo $OCI } # Sets minority (OCMI) and majority (OCMA) variables function setMinorityMajority { nodes=($(env | grep 'OC[0-9]*=' | sort | cut -d= -f2)) middle=$(expr "${#nodes[@]}" / "2") index=0 min=1 maj=1 for node in "${nodes[@]}"; do if [ "$index" -gt "$middle" ]; then export OCMI${min}=${node} min=$(expr $min + 1) else export OCMA${maj}=${node} maj=$(expr $maj + 1) fi index=$(expr $index + 1) done } # Open Networking Foundation shared test cell warden address export CELL_WARDEN="10.192.19.72" export CELL_SLAVE_1=$CELL_WARDEN export CELL_SLAVE_2="10.192.19.71" export CELL_SLAVE_3="10.192.19.70" export CELL_SLAVE_4="10.192.19.77" # disabled export CELL_SLAVES="$CELL_SLAVE_1 $CELL_SLAVE_2 $CELL_SLAVE_3" # Clears cell environment function clearCell { unset ONOS_CELL ONOS_NIC ONOS_IP ONOS_APPS ONOS_BOOT_FEATURES unset OCI OCN OCT ONOS_INSTANCES ONOS_CORES ONOS_FEATURES unset ONOS_USER ONOS_GROUP ONOS_WEB_USER ONOS_WEB_PASS unset $(env | sed -n 's:\(^OC[0-9]\{1,\}\)=.*:\1 :g p') unset $(env | sed -n 's:\(^OCC[0-9]\{1,\}\)=.*:\1 :g p') unset $(env | sed -n 's:\(^OCMI[0-9]\{1,\}\)=.*:\1 :g p') unset $(env | sed -n 's:\(^OCMA[0-9]\{1,\}\)=.*:\1 :g p') } # Applies the settings in the specified cell file or lists current cell definition # if no cell file is given. function cell { cell=${1:-""} case "$cell" in "borrow") clearCell aux="/tmp/cell-$$" duration=${2:-0} spec=${3:-3+1} spec=${spec//+/%2B} user=${4:-$(id -un)} hint=${5:-""} query="duration=$duration&spec=$spec&user=$user&cellNameHint=$hint" curl -sS -X POST "http://$CELL_WARDEN:4321/?$query" -d "$(cat ~/.ssh/id_rsa.pub)" > $aux . $aux rm -f $aux setPrimaryInstance 1 >/dev/null setMinorityMajority >/dev/null onos-verify-cell topo default >/dev/null ;; "return") curl -sS -X DELETE "http://$CELL_WARDEN:4321/?user=${2:-$(id -un)}" clearCell ;; "status") curl -sS "http://$CELL_WARDEN:4321/" | sort ;; "") env | egrep "^ONOS_CELL" env | egrep "^OCC[0-9]+" | sort env | egrep "^OC[0-9]+" | sort env | egrep "^OC[INT]" | sort env | egrep "^ONOS_" | egrep -v 'ONOS_ROOT|ONOS_CELL|ONOS_INSTANCES|ONOS_CORES|ONOS_DEVICES|ONOS_HOSTS' | sort ;; *) [ ! -f $ONOS_ROOT/tools/test/cells/$1 ] && echo "No such cell: $1" >&2 && return 1 clearCell export ONOS_USER=sdn export ONOS_GROUP=sdn export ONOS_WEB_USER=onos export ONOS_WEB_PASS=rocks export ONOS_CELL=$1 . $ONOS_ROOT/tools/test/cells/$1 setPrimaryInstance 1 >/dev/null cell topo default >/dev/null esac } [ -n "$ONOS_CELL" -a "$ONOS_CELL" != "borrow" ] && cell $ONOS_CELL > /dev/null # Lists available cells function cells { for cell in $(ls -1 $ONOS_ROOT/tools/test/cells); do printf "%-16s %s\n" \ "$([ ! -z $ONOS_CELL ] && [ $cell = $ONOS_CELL ] && echo $cell '*' || echo $cell)" \ "$(grep '^#' $ONOS_ROOT/tools/test/cells/$cell | head -n 1)" done } # Find a process by regex function spy { ps -ef | egrep "$@" | grep -v egrep } # Kill a process by regex function nuke { spy "$@" | cut -c7-11 | xargs kill } # Edit a cell file by providing a cell name; opens the cell file in $EDITOR. function vicell { local apply=false local create=false local ${cdf:=$ONOS_CELL} local cpath="${ONOS_ROOT}/tools/test/cells/" if [ "$1" = "-h" ] ; then printf "usage: vicell [file] [options]\n\noptions:\n" printf "\t[file]: cell name (default: current cell)\n" printf "\t-a: apply the cell after editing\n" printf "\t-e: [editor] set EDITOR to [editor] (default: *vi*)\n" printf "\t-c: create cell file if none exist\n\n" return 1 fi while [ $# -gt 0 ]; do case "$1" in -a) apply=true ;; -e) EDITOR=$2; shift ;; -c) create=true ;; *) cdf="$1" ;; esac shift done if [ ! -e "${cpath}${cdf}" ] && ! ($create) ; then printf "${cdf} : no such cell\n" && return 1 fi if [ -z "${EDITOR}" ] || [ -x "$(which ${EDITOR})" ]; then unset EDITOR && vi ${cpath}${cdf} else $EDITOR ${cpath}${cdf} fi ($apply) && cell ${cdf} } # Autocomplete for certain utilities . ${ONOS_ROOT}/tools/test/bin/ogroup-opts # Load AT&T MPLS topo GEO data alias atttopo='onos-netcfg $OCI $ONOS_ROOT/tools/test/topos/attmpls-cfg.json' # Load UK topo GEO data alias uktopo='onos-netcfg $OCI $ONOS_ROOT/tools/test/topos/uk-cfg.json'