blob: 30343757e8102aca3f3784acb893eeaad9d883e8 [file] [log] [blame]
tom6a9f2722014-09-13 17:00:02 -07001#!/bin/bash
2# ONOS developer BASH profile conveniences
tom5a18e802014-09-18 12:38:15 -07003# Simply include in your own .bash_aliases or .bash_profile
tom6a9f2722014-09-13 17:00:02 -07004
5# Root of the ONOS source tree
Thomas Vachuska045c01d2014-12-04 00:18:06 -08006export ONOS_ROOT=${ONOS_ROOT:-~/onos}
tom6a9f2722014-09-13 17:00:02 -07007
8# Setup some environmental context for developers
Pavlin Radoslavov93617212014-10-16 09:54:04 -07009if [ -z "${JAVA_HOME}" ]; then
10 if [ -x /usr/libexec/java_home ]; then
Thomas Vachuskad8531152014-11-03 14:39:57 -080011 export JAVA_HOME=$(/usr/libexec/java_home -v 1.8)
12 elif [ -d /usr/lib/jvm/java-8-oracle ]; then
13 export JAVA_HOME="/usr/lib/jvm/java-8-oracle"
Jonathan Harte3c951e2015-07-14 13:28:35 -070014 elif [ -d /usr/lib/jvm/java-8-openjdk-amd64 ]; then
15 export JAVA_HOME="/usr/lib/jvm/java-8-openjdk-amd64"
Pavlin Radoslavov93617212014-10-16 09:54:04 -070016 fi
17fi
Thomas Vachuska7b652ad2014-10-30 14:10:51 -070018
Jian Li98dc9ad2016-01-06 14:05:47 -080019export MAVEN=${MAVEN:-~/Applications/apache-maven-3.3.9}
Thomas Vachuska7b652ad2014-10-30 14:10:51 -070020
Jian Li11599162016-01-15 15:46:16 -080021export KARAF_VERSION=${KARAF_VERSION:-3.0.5}
Thomas Vachuska255b65f2014-11-23 14:25:31 -080022export KARAF_ROOT=${KARAF_ROOT:-~/Applications/apache-karaf-$KARAF_VERSION}
23export KARAF_LOG=$KARAF_ROOT/data/log/karaf.log
tom6a9f2722014-09-13 17:00:02 -070024
25# Setup a path
Thomas Vachuska4ccc7d32015-09-03 13:39:40 -070026export PATH="$PATH:$ONOS_ROOT/tools/dev/bin"
27export PATH="$PATH:$ONOS_ROOT/tools/test/bin:$ONOS_ROOT/tools/test/scenarios/bin"
tom1cd74ae2014-10-01 14:58:32 -070028export PATH="$PATH:$ONOS_ROOT/tools/build"
Thomas Vachuska255b65f2014-11-23 14:25:31 -080029export PATH="$PATH:$MAVEN/bin:$KARAF_ROOT/bin"
tom6a9f2722014-09-13 17:00:02 -070030
Roan Huang0fa4bc42015-05-01 15:38:20 +080031# Setup cell enviroment
32export ONOS_CELL=${ONOS_CELL:-local}
33
Thomas Vachuskac3c969a2015-08-19 16:51:16 -070034# Setup default web user/password
35export ONOS_WEB_USER=onos
36export ONOS_WEB_PASS=rocks
Thomas Vachuskaaf0ee532015-08-19 14:17:36 -070037
38# Setup default location of test scenarios
Thomas Vachuskae76f6532015-07-08 09:40:53 -070039export ONOS_SCENARIOS=$ONOS_ROOT/tools/test/scenarios
40
tom6a9f2722014-09-13 17:00:02 -070041# Convenience utility to warp to various ONOS source projects
42# e.g. 'o api', 'o dev', 'o'
43function o {
Ray Milkey33d81c62016-04-01 13:18:02 -070044 cd $(find $ONOS_ROOT/ -type d -and \( -name 'buck-out' -o -name '.git' -o -name 'target' -o -name 'gen-src' -o -name 'src' \) -prune -o -type d | \
HIGUCHI Yuta709e4fe2016-03-12 21:29:41 -080045 egrep "${1:-$ONOS_ROOT}" | head -n 1)
tom6a9f2722014-09-13 17:00:02 -070046}
47
48# Short-hand for 'mvn clean install' for us lazy folk
49alias mci='mvn clean install'
Michele Santuari91ee01b2016-04-04 17:04:46 -070050alias mcis='mvn clean install -DskipTests -Dcheckstyle.skip'
51alias mis='mvn install -DskipTests -Dcheckstyle.skip'
tom6a9f2722014-09-13 17:00:02 -070052
tom82d6bde2014-09-23 17:33:58 -070053# Short-hand for ONOS build, package and test.
54alias ob='onos-build'
Thomas Vachuska1e60f972015-10-19 09:55:52 -070055alias obf='ob -DskipTests -Dcheckstyle.skip'
Thomas Vachuskad16ce182014-10-29 17:25:29 -070056alias obi='onos-build -Dmaven.test.failure.ignore=true'
tom1cd74ae2014-10-01 14:58:32 -070057alias obs='onos-build-selective'
Thomas Vachuska7cbfd4f2014-11-04 18:22:49 -080058alias obd='onos-build-docs'
tom82d6bde2014-09-23 17:33:58 -070059alias op='onos-package'
Thomas Vachuskafcd61142015-04-23 13:59:08 -070060alias ok='onos-karaf'
tomcaf3bf72014-09-23 13:20:53 -070061alias ot='onos-test'
tom0511a522014-10-04 12:06:02 -070062alias ol='onos-log'
toma6897792014-10-08 22:21:05 -070063alias ow='onos-watch'
Thomas Vachuska3cd677d2015-05-20 11:25:49 -070064alias ocl='onos-check-logs'
Thomas Vachuska85314292014-11-14 17:52:12 -080065alias oi='setPrimaryInstance'
tomca8f6702014-10-07 09:28:53 -070066alias pub='onos-push-update-bundle'
tom6a9f2722014-09-13 17:00:02 -070067
Thomas Vachuska152f9fd2015-04-02 16:28:13 -070068# Short-hand for tailing and searching the ONOS (karaf) log
tom1cd74ae2014-10-01 14:58:32 -070069alias tl='$ONOS_ROOT/tools/dev/bin/onos-local-log'
Thomas Vachuska152f9fd2015-04-02 16:28:13 -070070alias gl='grep $KARAF_LOG --colour=auto -E -e '
71
Charles M.C. Chan870cc032015-04-24 04:57:42 +080072function filterLocalLog {
Thomas Vachuska152f9fd2015-04-02 16:28:13 -070073 tl | grep --colour=always -E -e "${1-org.onlab|org.onosproject}"
74}
Charles M.C. Chan870cc032015-04-24 04:57:42 +080075alias tlo='filterLocalLog'
Charles M.C. Chane39f3142015-05-22 18:35:24 +080076alias tle='tlo "ERROR|WARN|Exception|Error"'
Charles M.C. Chan870cc032015-04-24 04:57:42 +080077
78function filterLog {
79 ol | grep --colour=always -E -e "${1-org.onlab|org.onosproject}"
80}
81alias olo='filterLog'
Thomas Vachuska3cd677d2015-05-20 11:25:49 -070082alias ole='olo "ERROR|WARN|Exception|Error"'
tom6a9f2722014-09-13 17:00:02 -070083
84# Pretty-print JSON output
85alias pp='python -m json.tool'
86
Thomas Vachuskaaf0ee532015-08-19 14:17:36 -070087# Short-hand to launch Java API docs, REST API docs and ONOS GUI
Thomas Vachuska24c849c2014-10-27 09:53:05 -070088alias docs='open $ONOS_ROOT/docs/target/site/apidocs/index.html'
Thomas Vachuskaaf0ee532015-08-19 14:17:36 -070089alias rsdocs='onos-rsdocs'
tom1a2908c2014-09-23 16:37:39 -070090alias gui='onos-gui'
tom5c255702014-09-18 06:57:39 -070091
92
tom5a18e802014-09-18 12:38:15 -070093# Test related conveniences
94
tom5a18e802014-09-18 12:38:15 -070095# SSH to a specified ONOS instance
tom0872a172014-09-23 11:24:26 -070096alias sshctl='onos-ssh'
97alias sshnet='onos-ssh $OCN'
tom5a18e802014-09-18 12:38:15 -070098
Thomas Vachuska785f5812015-03-19 01:11:00 -070099
100# Sets the primary instance to the specified instance number.
101function setPrimaryInstance {
102 export OCI=$(env | egrep "OC[0-9]+" | sort | egrep OC${1:-1} | cut -d= -f2)
103 echo $OCI
104}
105
Thomas Vachuska1eff3a62016-05-03 01:07:24 -0700106# ON.Lab shared test cell warden address
107export CELL_WARDEN="10.254.1.19"
108
tomecd0fbd2014-09-19 08:47:05 -0700109# Applies the settings in the specified cell file or lists current cell definition
110# if no cell file is given.
111function cell {
Thomas Vachuska1eff3a62016-05-03 01:07:24 -0700112 cell=$1
113 case "$cell" in
114 "borrow")
115 aux="/tmp/cell-$$"
Thomas Vachuskae91541f2016-05-05 23:15:41 -0700116 curl -sS -X POST "http://$CELL_WARDEN:4321/?duration=${2:-0}&user=${3:-$(id -un)}" \
Thomas Vachuska1eff3a62016-05-03 01:07:24 -0700117 -d "$(cat ~/.ssh/id_rsa.pub)" > $aux
118 . $aux
119 rm -f $aux
120 export ONOS_INSTANCES=$(env | grep 'OC[0-9]*=' | sort | cut -d= -f2)
121 setPrimaryInstance 1 >/dev/null
Thomas Vachuskab8261902016-05-04 00:10:42 -0700122 onos-verify-cell
Thomas Vachuska1eff3a62016-05-03 01:07:24 -0700123 ;;
124 "return")
Thomas Vachuskae91541f2016-05-05 23:15:41 -0700125 curl -sS -X DELETE "http://$CELL_WARDEN:4321/?user=${2:-$(id -un)}"
Thomas Vachuskab8261902016-05-04 00:10:42 -0700126 unset ONOS_CELL ONOS_NIC ONOS_IP ONOS_APPS ONOS_BOOT_FEATURES
127 unset OCI OCN OCT ONOS_INSTANCES ONOS_FEATURES
128 unset $(env | sed -n 's:\(^OC[0-9]\{1,\}\)=.*:\1 :g p')
Thomas Vachuska1eff3a62016-05-03 01:07:24 -0700129 ;;
130
131 "status")
Thomas Vachuskab8261902016-05-04 00:10:42 -0700132 curl -sS "http://$CELL_WARDEN:4321/" | sort
Thomas Vachuska1eff3a62016-05-03 01:07:24 -0700133 ;;
134
135 "")
136 env | egrep "ONOS_CELL"
137 env | egrep "OCI"
138 env | egrep "OC[0-9]+" | sort
139 env | egrep "OC[NT]"
140 env | egrep "ONOS_" | egrep -v 'ONOS_ROOT|ONOS_CELL|ONOS_INSTANCES' | sort
141 ;;
142
143 *)
tomecd0fbd2014-09-19 08:47:05 -0700144 [ ! -f $ONOS_ROOT/tools/test/cells/$1 ] && \
145 echo "No such cell: $1" >&2 && return 1
Thomas Vachuska0a4c2702015-07-06 08:43:41 -0700146 unset ONOS_CELL ONOS_NIC ONOS_IP ONOS_APPS ONOS_BOOT_FEATURES
Bob Lantz53228832016-04-15 15:00:43 -0700147 unset OCI OCN OCT ONOS_INSTANCES ONOS_FEATURES
Ayaka Koshibeebb54442015-01-09 14:22:19 -0800148 unset $(env | sed -n 's:\(^OC[0-9]\{1,\}\)=.*:\1 :g p')
Thomas Vachuska330aef12015-10-15 12:00:33 -0700149 export ONOS_USER=${ONOS_USER:-sdn}
Bob Lantze7b43032016-02-25 04:02:24 -0800150 export ONOS_GROUP=${ONOS_GROUP:-sdn}
Thomas Vachuska3c831fa2015-08-17 18:44:15 -0700151 export ONOS_WEB_USER=onos
152 export ONOS_WEB_PASS=rocks
Thomas Vachuskacce11ca2014-10-16 11:52:29 -0700153 export ONOS_CELL=$1
tomecd0fbd2014-09-19 08:47:05 -0700154 . $ONOS_ROOT/tools/test/cells/$1
Thomas Vachuska0a4c2702015-07-06 08:43:41 -0700155 export ONOS_INSTANCES=$(env | grep 'OC[0-9]*=' | sort | cut -d= -f2)
Thomas Vachuska785f5812015-03-19 01:11:00 -0700156 setPrimaryInstance 1 >/dev/null
tomecd0fbd2014-09-19 08:47:05 -0700157 cell
Thomas Vachuska1eff3a62016-05-03 01:07:24 -0700158 esac
tomecd0fbd2014-09-19 08:47:05 -0700159}
160
Thomas Vachuskae6185572016-05-04 19:26:15 -0700161[ -n "$ONOS_CELL" -a "$ONOS_CELL" != "borrow" ] && cell $ONOS_CELL > /dev/null
tomecd0fbd2014-09-19 08:47:05 -0700162
163# Lists available cells
164function cells {
tom2482e6f2014-10-01 16:51:48 -0700165 for cell in $(ls -1 $ONOS_ROOT/tools/test/cells); do
Thomas Vachuska785f5812015-03-19 01:11:00 -0700166 printf "%-16s %s\n" \
tom2482e6f2014-10-01 16:51:48 -0700167 "$([ $cell = $ONOS_CELL ] && echo $cell '*' || echo $cell)" \
168 "$(grep '^#' $ONOS_ROOT/tools/test/cells/$cell | head -n 1)"
169 done
tomecd0fbd2014-09-19 08:47:05 -0700170}
tom5a18e802014-09-18 12:38:15 -0700171
Thomas Vachuska9507d2a2015-12-01 20:45:57 -0800172# Find a process by regex
tom5c255702014-09-18 06:57:39 -0700173function spy {
174 ps -ef | egrep "$@" | grep -v egrep
175}
176
Thomas Vachuska9507d2a2015-12-01 20:45:57 -0800177# Kill a process by regex
tom5c255702014-09-18 06:57:39 -0700178function nuke {
tom85258ee2014-10-07 00:10:02 -0700179 spy "$@" | cut -c7-11 | xargs kill
tom5c255702014-09-18 06:57:39 -0700180}
Ayaka Koshibea9985132014-12-18 14:55:22 -0800181
Thomas Vachuskaea2d9fd2015-09-23 13:13:25 -0700182# Edit a cell file by providing a cell name; opens the cell file in $EDITOR.
183function vicell {
184 local apply=false
185 local create=false
Ayaka Koshibe77acdc72016-02-03 17:19:24 -0800186 local ${cdf:=$ONOS_CELL}
Thomas Vachuskaea2d9fd2015-09-23 13:13:25 -0700187 local cpath="${ONOS_ROOT}/tools/test/cells/"
Ayaka Koshibea9985132014-12-18 14:55:22 -0800188
Ayaka Koshibe77acdc72016-02-03 17:19:24 -0800189 if [ "$1" = "-h" ] ; then
Thomas Vachuskaea2d9fd2015-09-23 13:13:25 -0700190 printf "usage: vicell [file] [options]\n\noptions:\n"
Ayaka Koshibe77acdc72016-02-03 17:19:24 -0800191 printf "\t[file]: cell name (default: current cell)\n"
Thomas Vachuskaea2d9fd2015-09-23 13:13:25 -0700192 printf "\t-a: apply the cell after editing\n"
Ayaka Koshibe77acdc72016-02-03 17:19:24 -0800193 printf "\t-e: [editor] set EDITOR to [editor] (default: *vi*)\n"
Thomas Vachuskaea2d9fd2015-09-23 13:13:25 -0700194 printf "\t-c: create cell file if none exist\n\n"
195 return 1
196 fi
Ayaka Koshibea9985132014-12-18 14:55:22 -0800197
Thomas Vachuskaea2d9fd2015-09-23 13:13:25 -0700198 while [ $# -gt 0 ]; do
199 case "$1" in
200 -a) apply=true ;;
201 -e) EDITOR=$2; shift ;;
202 -c) create=true ;;
203 *) cdf="$1" ;;
204 esac
205 shift
206 done
Ayaka Koshibea9985132014-12-18 14:55:22 -0800207
Ayaka Koshibe77acdc72016-02-03 17:19:24 -0800208 if [ ! -e "${cpath}${cdf}" ] && ! ($create) ; then
Thomas Vachuskaea2d9fd2015-09-23 13:13:25 -0700209 printf "${cdf} : no such cell\n" && return 1
210 fi
Ayaka Koshibea9985132014-12-18 14:55:22 -0800211
Thomas Vachuskaea2d9fd2015-09-23 13:13:25 -0700212 if [ -z "${EDITOR}" ] || [ -x "$(which ${EDITOR})" ]; then
213 unset EDITOR && vi ${cpath}${cdf}
214 else
215 $EDITOR ${cpath}${cdf}
216 fi
217 ($apply) && cell ${cdf}
Ayaka Koshibea9985132014-12-18 14:55:22 -0800218}
Ayaka Koshibeaec629622015-01-05 20:33:29 -0800219
Thomas Vachuska9507d2a2015-12-01 20:45:57 -0800220# Autocomplete for certain utilities
Ayaka Koshibeaec629622015-01-05 20:33:29 -0800221. ${ONOS_ROOT}/tools/test/bin/ogroup-opts
Thomas Vachuska9507d2a2015-12-01 20:45:57 -0800222
223
224# Load AT&T MPLS topo GEO data
Ayaka Koshibe77acdc72016-02-03 17:19:24 -0800225alias atttopo='onos-netcfg $OCI $ONOS_ROOT/tools/test/topos/attmpls-cfg.json'
Simon Huntcf7e3b52016-02-29 23:26:16 -0800226
227# Load UK topo GEO data
228alias uktopo='onos-netcfg $OCI $ONOS_ROOT/tools/test/topos/uk-cfg.json'
Brian O'Connor9be23632016-04-08 18:23:45 -0700229
230# Git annotated one-line log
231alias gil='git log --oneline --decorate=short'
232
233# Buck (if "buck" is not on the PATH)
234[ -z "$(which buck)" ] && alias buck="onos-buck"