tom | 6a9f272 | 2014-09-13 17:00:02 -0700 | [diff] [blame] | 1 | #!/bin/bash |
| 2 | # ONOS developer BASH profile conveniences |
tom | 5a18e80 | 2014-09-18 12:38:15 -0700 | [diff] [blame] | 3 | # Simply include in your own .bash_aliases or .bash_profile |
tom | 6a9f272 | 2014-09-13 17:00:02 -0700 | [diff] [blame] | 4 | |
| 5 | # Root of the ONOS source tree |
Thomas Vachuska | 045c01d | 2014-12-04 00:18:06 -0800 | [diff] [blame] | 6 | export ONOS_ROOT=${ONOS_ROOT:-~/onos} |
tom | 6a9f272 | 2014-09-13 17:00:02 -0700 | [diff] [blame] | 7 | |
| 8 | # Setup some environmental context for developers |
Pavlin Radoslavov | 9361721 | 2014-10-16 09:54:04 -0700 | [diff] [blame] | 9 | if [ -z "${JAVA_HOME}" ]; then |
| 10 | if [ -x /usr/libexec/java_home ]; then |
Thomas Vachuska | d853115 | 2014-11-03 14:39:57 -0800 | [diff] [blame] | 11 | 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 Hart | e3c951e | 2015-07-14 13:28:35 -0700 | [diff] [blame] | 14 | elif [ -d /usr/lib/jvm/java-8-openjdk-amd64 ]; then |
| 15 | export JAVA_HOME="/usr/lib/jvm/java-8-openjdk-amd64" |
Pavlin Radoslavov | 9361721 | 2014-10-16 09:54:04 -0700 | [diff] [blame] | 16 | fi |
| 17 | fi |
Thomas Vachuska | 7b652ad | 2014-10-30 14:10:51 -0700 | [diff] [blame] | 18 | |
Jian Li | 98dc9ad | 2016-01-06 14:05:47 -0800 | [diff] [blame] | 19 | export MAVEN=${MAVEN:-~/Applications/apache-maven-3.3.9} |
Thomas Vachuska | 7b652ad | 2014-10-30 14:10:51 -0700 | [diff] [blame] | 20 | |
Jian Li | 1159916 | 2016-01-15 15:46:16 -0800 | [diff] [blame] | 21 | export KARAF_VERSION=${KARAF_VERSION:-3.0.5} |
Thomas Vachuska | 255b65f | 2014-11-23 14:25:31 -0800 | [diff] [blame] | 22 | export KARAF_ROOT=${KARAF_ROOT:-~/Applications/apache-karaf-$KARAF_VERSION} |
| 23 | export KARAF_LOG=$KARAF_ROOT/data/log/karaf.log |
tom | 6a9f272 | 2014-09-13 17:00:02 -0700 | [diff] [blame] | 24 | |
| 25 | # Setup a path |
Thomas Vachuska | 4ccc7d3 | 2015-09-03 13:39:40 -0700 | [diff] [blame] | 26 | export PATH="$PATH:$ONOS_ROOT/tools/dev/bin" |
| 27 | export PATH="$PATH:$ONOS_ROOT/tools/test/bin:$ONOS_ROOT/tools/test/scenarios/bin" |
tom | 1cd74ae | 2014-10-01 14:58:32 -0700 | [diff] [blame] | 28 | export PATH="$PATH:$ONOS_ROOT/tools/build" |
Thomas Vachuska | 255b65f | 2014-11-23 14:25:31 -0800 | [diff] [blame] | 29 | export PATH="$PATH:$MAVEN/bin:$KARAF_ROOT/bin" |
tom | 6a9f272 | 2014-09-13 17:00:02 -0700 | [diff] [blame] | 30 | |
Roan Huang | 0fa4bc4 | 2015-05-01 15:38:20 +0800 | [diff] [blame] | 31 | # Setup cell enviroment |
| 32 | export ONOS_CELL=${ONOS_CELL:-local} |
| 33 | |
Thomas Vachuska | c3c969a | 2015-08-19 16:51:16 -0700 | [diff] [blame] | 34 | # Setup default web user/password |
| 35 | export ONOS_WEB_USER=onos |
| 36 | export ONOS_WEB_PASS=rocks |
Thomas Vachuska | af0ee53 | 2015-08-19 14:17:36 -0700 | [diff] [blame] | 37 | |
| 38 | # Setup default location of test scenarios |
Thomas Vachuska | e76f653 | 2015-07-08 09:40:53 -0700 | [diff] [blame] | 39 | export ONOS_SCENARIOS=$ONOS_ROOT/tools/test/scenarios |
| 40 | |
tom | 6a9f272 | 2014-09-13 17:00:02 -0700 | [diff] [blame] | 41 | # Convenience utility to warp to various ONOS source projects |
| 42 | # e.g. 'o api', 'o dev', 'o' |
| 43 | function o { |
Ray Milkey | 33d81c6 | 2016-04-01 13:18:02 -0700 | [diff] [blame] | 44 | 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 Yuta | 709e4fe | 2016-03-12 21:29:41 -0800 | [diff] [blame] | 45 | egrep "${1:-$ONOS_ROOT}" | head -n 1) |
tom | 6a9f272 | 2014-09-13 17:00:02 -0700 | [diff] [blame] | 46 | } |
| 47 | |
| 48 | # Short-hand for 'mvn clean install' for us lazy folk |
| 49 | alias mci='mvn clean install' |
Michele Santuari | 91ee01b | 2016-04-04 17:04:46 -0700 | [diff] [blame] | 50 | alias mcis='mvn clean install -DskipTests -Dcheckstyle.skip' |
| 51 | alias mis='mvn install -DskipTests -Dcheckstyle.skip' |
tom | 6a9f272 | 2014-09-13 17:00:02 -0700 | [diff] [blame] | 52 | |
tom | 82d6bde | 2014-09-23 17:33:58 -0700 | [diff] [blame] | 53 | # Short-hand for ONOS build, package and test. |
| 54 | alias ob='onos-build' |
Thomas Vachuska | 1e60f97 | 2015-10-19 09:55:52 -0700 | [diff] [blame] | 55 | alias obf='ob -DskipTests -Dcheckstyle.skip' |
Thomas Vachuska | d16ce18 | 2014-10-29 17:25:29 -0700 | [diff] [blame] | 56 | alias obi='onos-build -Dmaven.test.failure.ignore=true' |
tom | 1cd74ae | 2014-10-01 14:58:32 -0700 | [diff] [blame] | 57 | alias obs='onos-build-selective' |
Thomas Vachuska | 7cbfd4f | 2014-11-04 18:22:49 -0800 | [diff] [blame] | 58 | alias obd='onos-build-docs' |
tom | 82d6bde | 2014-09-23 17:33:58 -0700 | [diff] [blame] | 59 | alias op='onos-package' |
Thomas Vachuska | fcd6114 | 2015-04-23 13:59:08 -0700 | [diff] [blame] | 60 | alias ok='onos-karaf' |
tom | caf3bf7 | 2014-09-23 13:20:53 -0700 | [diff] [blame] | 61 | alias ot='onos-test' |
tom | 0511a52 | 2014-10-04 12:06:02 -0700 | [diff] [blame] | 62 | alias ol='onos-log' |
tom | a689779 | 2014-10-08 22:21:05 -0700 | [diff] [blame] | 63 | alias ow='onos-watch' |
Thomas Vachuska | 3cd677d | 2015-05-20 11:25:49 -0700 | [diff] [blame] | 64 | alias ocl='onos-check-logs' |
Thomas Vachuska | 8531429 | 2014-11-14 17:52:12 -0800 | [diff] [blame] | 65 | alias oi='setPrimaryInstance' |
tom | ca8f670 | 2014-10-07 09:28:53 -0700 | [diff] [blame] | 66 | alias pub='onos-push-update-bundle' |
tom | 6a9f272 | 2014-09-13 17:00:02 -0700 | [diff] [blame] | 67 | |
Thomas Vachuska | 152f9fd | 2015-04-02 16:28:13 -0700 | [diff] [blame] | 68 | # Short-hand for tailing and searching the ONOS (karaf) log |
tom | 1cd74ae | 2014-10-01 14:58:32 -0700 | [diff] [blame] | 69 | alias tl='$ONOS_ROOT/tools/dev/bin/onos-local-log' |
Thomas Vachuska | 152f9fd | 2015-04-02 16:28:13 -0700 | [diff] [blame] | 70 | alias gl='grep $KARAF_LOG --colour=auto -E -e ' |
| 71 | |
Charles M.C. Chan | 870cc03 | 2015-04-24 04:57:42 +0800 | [diff] [blame] | 72 | function filterLocalLog { |
Thomas Vachuska | 152f9fd | 2015-04-02 16:28:13 -0700 | [diff] [blame] | 73 | tl | grep --colour=always -E -e "${1-org.onlab|org.onosproject}" |
| 74 | } |
Charles M.C. Chan | 870cc03 | 2015-04-24 04:57:42 +0800 | [diff] [blame] | 75 | alias tlo='filterLocalLog' |
Charles M.C. Chan | e39f314 | 2015-05-22 18:35:24 +0800 | [diff] [blame] | 76 | alias tle='tlo "ERROR|WARN|Exception|Error"' |
Charles M.C. Chan | 870cc03 | 2015-04-24 04:57:42 +0800 | [diff] [blame] | 77 | |
| 78 | function filterLog { |
| 79 | ol | grep --colour=always -E -e "${1-org.onlab|org.onosproject}" |
| 80 | } |
| 81 | alias olo='filterLog' |
Thomas Vachuska | 3cd677d | 2015-05-20 11:25:49 -0700 | [diff] [blame] | 82 | alias ole='olo "ERROR|WARN|Exception|Error"' |
tom | 6a9f272 | 2014-09-13 17:00:02 -0700 | [diff] [blame] | 83 | |
| 84 | # Pretty-print JSON output |
| 85 | alias pp='python -m json.tool' |
| 86 | |
Thomas Vachuska | af0ee53 | 2015-08-19 14:17:36 -0700 | [diff] [blame] | 87 | # Short-hand to launch Java API docs, REST API docs and ONOS GUI |
Thomas Vachuska | 24c849c | 2014-10-27 09:53:05 -0700 | [diff] [blame] | 88 | alias docs='open $ONOS_ROOT/docs/target/site/apidocs/index.html' |
Thomas Vachuska | af0ee53 | 2015-08-19 14:17:36 -0700 | [diff] [blame] | 89 | alias rsdocs='onos-rsdocs' |
tom | 1a2908c | 2014-09-23 16:37:39 -0700 | [diff] [blame] | 90 | alias gui='onos-gui' |
tom | 5c25570 | 2014-09-18 06:57:39 -0700 | [diff] [blame] | 91 | |
| 92 | |
tom | 5a18e80 | 2014-09-18 12:38:15 -0700 | [diff] [blame] | 93 | # Test related conveniences |
| 94 | |
tom | 5a18e80 | 2014-09-18 12:38:15 -0700 | [diff] [blame] | 95 | # SSH to a specified ONOS instance |
tom | 0872a17 | 2014-09-23 11:24:26 -0700 | [diff] [blame] | 96 | alias sshctl='onos-ssh' |
| 97 | alias sshnet='onos-ssh $OCN' |
tom | 5a18e80 | 2014-09-18 12:38:15 -0700 | [diff] [blame] | 98 | |
Thomas Vachuska | 785f581 | 2015-03-19 01:11:00 -0700 | [diff] [blame] | 99 | |
| 100 | # Sets the primary instance to the specified instance number. |
| 101 | function setPrimaryInstance { |
| 102 | export OCI=$(env | egrep "OC[0-9]+" | sort | egrep OC${1:-1} | cut -d= -f2) |
| 103 | echo $OCI |
| 104 | } |
| 105 | |
Thomas Vachuska | 1eff3a6 | 2016-05-03 01:07:24 -0700 | [diff] [blame] | 106 | # ON.Lab shared test cell warden address |
| 107 | export CELL_WARDEN="10.254.1.19" |
| 108 | |
tom | ecd0fbd | 2014-09-19 08:47:05 -0700 | [diff] [blame] | 109 | # Applies the settings in the specified cell file or lists current cell definition |
| 110 | # if no cell file is given. |
| 111 | function cell { |
Thomas Vachuska | 1eff3a6 | 2016-05-03 01:07:24 -0700 | [diff] [blame] | 112 | cell=$1 |
| 113 | case "$cell" in |
| 114 | "borrow") |
| 115 | aux="/tmp/cell-$$" |
Thomas Vachuska | 0d33700 | 2016-05-04 10:00:18 -0700 | [diff] [blame] | 116 | curl -sS -X POST "http://$CELL_WARDEN:4321/?user=$(id -un)&duration=${2:-0}" \ |
Thomas Vachuska | 1eff3a6 | 2016-05-03 01:07:24 -0700 | [diff] [blame] | 117 | -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 |
| 122 | cell |
| 123 | ;; |
| 124 | "return") |
| 125 | curl -sS -X DELETE "http://$CELL_WARDEN:4321/?user=$(id -un)" |
| 126 | ;; |
| 127 | |
| 128 | "status") |
| 129 | curl -sS "http://$CELL_WARDEN:4321/" |
| 130 | ;; |
| 131 | |
| 132 | "") |
| 133 | env | egrep "ONOS_CELL" |
| 134 | env | egrep "OCI" |
| 135 | env | egrep "OC[0-9]+" | sort |
| 136 | env | egrep "OC[NT]" |
| 137 | env | egrep "ONOS_" | egrep -v 'ONOS_ROOT|ONOS_CELL|ONOS_INSTANCES' | sort |
| 138 | ;; |
| 139 | |
| 140 | *) |
tom | ecd0fbd | 2014-09-19 08:47:05 -0700 | [diff] [blame] | 141 | [ ! -f $ONOS_ROOT/tools/test/cells/$1 ] && \ |
| 142 | echo "No such cell: $1" >&2 && return 1 |
Thomas Vachuska | 0a4c270 | 2015-07-06 08:43:41 -0700 | [diff] [blame] | 143 | unset ONOS_CELL ONOS_NIC ONOS_IP ONOS_APPS ONOS_BOOT_FEATURES |
Bob Lantz | 5322883 | 2016-04-15 15:00:43 -0700 | [diff] [blame] | 144 | unset OCI OCN OCT ONOS_INSTANCES ONOS_FEATURES |
Ayaka Koshibe | ebb5444 | 2015-01-09 14:22:19 -0800 | [diff] [blame] | 145 | unset $(env | sed -n 's:\(^OC[0-9]\{1,\}\)=.*:\1 :g p') |
Thomas Vachuska | 330aef1 | 2015-10-15 12:00:33 -0700 | [diff] [blame] | 146 | export ONOS_USER=${ONOS_USER:-sdn} |
Bob Lantz | e7b4303 | 2016-02-25 04:02:24 -0800 | [diff] [blame] | 147 | export ONOS_GROUP=${ONOS_GROUP:-sdn} |
Thomas Vachuska | 3c831fa | 2015-08-17 18:44:15 -0700 | [diff] [blame] | 148 | export ONOS_WEB_USER=onos |
| 149 | export ONOS_WEB_PASS=rocks |
Thomas Vachuska | cce11ca | 2014-10-16 11:52:29 -0700 | [diff] [blame] | 150 | export ONOS_CELL=$1 |
tom | ecd0fbd | 2014-09-19 08:47:05 -0700 | [diff] [blame] | 151 | . $ONOS_ROOT/tools/test/cells/$1 |
Thomas Vachuska | 0a4c270 | 2015-07-06 08:43:41 -0700 | [diff] [blame] | 152 | export ONOS_INSTANCES=$(env | grep 'OC[0-9]*=' | sort | cut -d= -f2) |
Thomas Vachuska | 785f581 | 2015-03-19 01:11:00 -0700 | [diff] [blame] | 153 | setPrimaryInstance 1 >/dev/null |
tom | ecd0fbd | 2014-09-19 08:47:05 -0700 | [diff] [blame] | 154 | cell |
Thomas Vachuska | 1eff3a6 | 2016-05-03 01:07:24 -0700 | [diff] [blame] | 155 | esac |
tom | ecd0fbd | 2014-09-19 08:47:05 -0700 | [diff] [blame] | 156 | } |
| 157 | |
Thomas Vachuska | 1eff3a6 | 2016-05-03 01:07:24 -0700 | [diff] [blame] | 158 | [ -n "$ONOS_CELL" ] && cell $ONOS_CELL > /dev/null |
tom | ecd0fbd | 2014-09-19 08:47:05 -0700 | [diff] [blame] | 159 | |
| 160 | # Lists available cells |
| 161 | function cells { |
tom | 2482e6f | 2014-10-01 16:51:48 -0700 | [diff] [blame] | 162 | for cell in $(ls -1 $ONOS_ROOT/tools/test/cells); do |
Thomas Vachuska | 785f581 | 2015-03-19 01:11:00 -0700 | [diff] [blame] | 163 | printf "%-16s %s\n" \ |
tom | 2482e6f | 2014-10-01 16:51:48 -0700 | [diff] [blame] | 164 | "$([ $cell = $ONOS_CELL ] && echo $cell '*' || echo $cell)" \ |
| 165 | "$(grep '^#' $ONOS_ROOT/tools/test/cells/$cell | head -n 1)" |
| 166 | done |
tom | ecd0fbd | 2014-09-19 08:47:05 -0700 | [diff] [blame] | 167 | } |
tom | 5a18e80 | 2014-09-18 12:38:15 -0700 | [diff] [blame] | 168 | |
Thomas Vachuska | 9507d2a | 2015-12-01 20:45:57 -0800 | [diff] [blame] | 169 | # Find a process by regex |
tom | 5c25570 | 2014-09-18 06:57:39 -0700 | [diff] [blame] | 170 | function spy { |
| 171 | ps -ef | egrep "$@" | grep -v egrep |
| 172 | } |
| 173 | |
Thomas Vachuska | 9507d2a | 2015-12-01 20:45:57 -0800 | [diff] [blame] | 174 | # Kill a process by regex |
tom | 5c25570 | 2014-09-18 06:57:39 -0700 | [diff] [blame] | 175 | function nuke { |
tom | 85258ee | 2014-10-07 00:10:02 -0700 | [diff] [blame] | 176 | spy "$@" | cut -c7-11 | xargs kill |
tom | 5c25570 | 2014-09-18 06:57:39 -0700 | [diff] [blame] | 177 | } |
Ayaka Koshibe | a998513 | 2014-12-18 14:55:22 -0800 | [diff] [blame] | 178 | |
Thomas Vachuska | ea2d9fd | 2015-09-23 13:13:25 -0700 | [diff] [blame] | 179 | # Edit a cell file by providing a cell name; opens the cell file in $EDITOR. |
| 180 | function vicell { |
| 181 | local apply=false |
| 182 | local create=false |
Ayaka Koshibe | 77acdc7 | 2016-02-03 17:19:24 -0800 | [diff] [blame] | 183 | local ${cdf:=$ONOS_CELL} |
Thomas Vachuska | ea2d9fd | 2015-09-23 13:13:25 -0700 | [diff] [blame] | 184 | local cpath="${ONOS_ROOT}/tools/test/cells/" |
Ayaka Koshibe | a998513 | 2014-12-18 14:55:22 -0800 | [diff] [blame] | 185 | |
Ayaka Koshibe | 77acdc7 | 2016-02-03 17:19:24 -0800 | [diff] [blame] | 186 | if [ "$1" = "-h" ] ; then |
Thomas Vachuska | ea2d9fd | 2015-09-23 13:13:25 -0700 | [diff] [blame] | 187 | printf "usage: vicell [file] [options]\n\noptions:\n" |
Ayaka Koshibe | 77acdc7 | 2016-02-03 17:19:24 -0800 | [diff] [blame] | 188 | printf "\t[file]: cell name (default: current cell)\n" |
Thomas Vachuska | ea2d9fd | 2015-09-23 13:13:25 -0700 | [diff] [blame] | 189 | printf "\t-a: apply the cell after editing\n" |
Ayaka Koshibe | 77acdc7 | 2016-02-03 17:19:24 -0800 | [diff] [blame] | 190 | printf "\t-e: [editor] set EDITOR to [editor] (default: *vi*)\n" |
Thomas Vachuska | ea2d9fd | 2015-09-23 13:13:25 -0700 | [diff] [blame] | 191 | printf "\t-c: create cell file if none exist\n\n" |
| 192 | return 1 |
| 193 | fi |
Ayaka Koshibe | a998513 | 2014-12-18 14:55:22 -0800 | [diff] [blame] | 194 | |
Thomas Vachuska | ea2d9fd | 2015-09-23 13:13:25 -0700 | [diff] [blame] | 195 | while [ $# -gt 0 ]; do |
| 196 | case "$1" in |
| 197 | -a) apply=true ;; |
| 198 | -e) EDITOR=$2; shift ;; |
| 199 | -c) create=true ;; |
| 200 | *) cdf="$1" ;; |
| 201 | esac |
| 202 | shift |
| 203 | done |
Ayaka Koshibe | a998513 | 2014-12-18 14:55:22 -0800 | [diff] [blame] | 204 | |
Ayaka Koshibe | 77acdc7 | 2016-02-03 17:19:24 -0800 | [diff] [blame] | 205 | if [ ! -e "${cpath}${cdf}" ] && ! ($create) ; then |
Thomas Vachuska | ea2d9fd | 2015-09-23 13:13:25 -0700 | [diff] [blame] | 206 | printf "${cdf} : no such cell\n" && return 1 |
| 207 | fi |
Ayaka Koshibe | a998513 | 2014-12-18 14:55:22 -0800 | [diff] [blame] | 208 | |
Thomas Vachuska | ea2d9fd | 2015-09-23 13:13:25 -0700 | [diff] [blame] | 209 | if [ -z "${EDITOR}" ] || [ -x "$(which ${EDITOR})" ]; then |
| 210 | unset EDITOR && vi ${cpath}${cdf} |
| 211 | else |
| 212 | $EDITOR ${cpath}${cdf} |
| 213 | fi |
| 214 | ($apply) && cell ${cdf} |
Ayaka Koshibe | a998513 | 2014-12-18 14:55:22 -0800 | [diff] [blame] | 215 | } |
Ayaka Koshibe | aec62962 | 2015-01-05 20:33:29 -0800 | [diff] [blame] | 216 | |
Thomas Vachuska | 9507d2a | 2015-12-01 20:45:57 -0800 | [diff] [blame] | 217 | # Autocomplete for certain utilities |
Ayaka Koshibe | aec62962 | 2015-01-05 20:33:29 -0800 | [diff] [blame] | 218 | . ${ONOS_ROOT}/tools/test/bin/ogroup-opts |
Thomas Vachuska | 9507d2a | 2015-12-01 20:45:57 -0800 | [diff] [blame] | 219 | |
| 220 | |
| 221 | # Load AT&T MPLS topo GEO data |
Ayaka Koshibe | 77acdc7 | 2016-02-03 17:19:24 -0800 | [diff] [blame] | 222 | alias atttopo='onos-netcfg $OCI $ONOS_ROOT/tools/test/topos/attmpls-cfg.json' |
Simon Hunt | cf7e3b5 | 2016-02-29 23:26:16 -0800 | [diff] [blame] | 223 | |
| 224 | # Load UK topo GEO data |
| 225 | alias uktopo='onos-netcfg $OCI $ONOS_ROOT/tools/test/topos/uk-cfg.json' |
Brian O'Connor | 9be2363 | 2016-04-08 18:23:45 -0700 | [diff] [blame] | 226 | |
| 227 | # Git annotated one-line log |
| 228 | alias gil='git log --oneline --decorate=short' |
| 229 | |
| 230 | # Buck (if "buck" is not on the PATH) |
| 231 | [ -z "$(which buck)" ] && alias buck="onos-buck" |