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 { |
tom | cf8dd2a | 2014-10-10 08:37:20 -0700 | [diff] [blame] | 44 | cd $(find $ONOS_ROOT/ -type d | egrep -v '\.git|target|gen-src' | \ |
tom | 9a693fd | 2014-10-03 11:32:19 -0700 | [diff] [blame] | 45 | egrep "${1:-$ONOS_ROOT}" | egrep -v "$ONOS_ROOT/.+/src/" | 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' |
Yuta HIGUCHI | 007cdff | 2014-11-20 13:39:05 -0800 | [diff] [blame] | 50 | alias mcis='mvn clean install -DskipTests -Dcheckstyle.skip -U -T 1C' |
| 51 | alias mis='mvn install -DskipTests -Dcheckstyle.skip -U -T 1C' |
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 | |
tom | ecd0fbd | 2014-09-19 08:47:05 -0700 | [diff] [blame] | 106 | # Applies the settings in the specified cell file or lists current cell definition |
| 107 | # if no cell file is given. |
| 108 | function cell { |
| 109 | if [ -n "$1" ]; then |
| 110 | [ ! -f $ONOS_ROOT/tools/test/cells/$1 ] && \ |
| 111 | echo "No such cell: $1" >&2 && return 1 |
Thomas Vachuska | 0a4c270 | 2015-07-06 08:43:41 -0700 | [diff] [blame] | 112 | unset ONOS_CELL ONOS_NIC ONOS_IP ONOS_APPS ONOS_BOOT_FEATURES |
| 113 | unset OCI OCN OCT ONOS_INSTANCES ONOS_USER ONOS_GROUP ONOS_FEATURES |
Ayaka Koshibe | ebb5444 | 2015-01-09 14:22:19 -0800 | [diff] [blame] | 114 | unset $(env | sed -n 's:\(^OC[0-9]\{1,\}\)=.*:\1 :g p') |
Thomas Vachuska | 330aef1 | 2015-10-15 12:00:33 -0700 | [diff] [blame] | 115 | export ONOS_USER=${ONOS_USER:-sdn} |
Thomas Vachuska | 3c831fa | 2015-08-17 18:44:15 -0700 | [diff] [blame] | 116 | export ONOS_WEB_USER=onos |
| 117 | export ONOS_WEB_PASS=rocks |
Thomas Vachuska | cce11ca | 2014-10-16 11:52:29 -0700 | [diff] [blame] | 118 | export ONOS_CELL=$1 |
tom | ecd0fbd | 2014-09-19 08:47:05 -0700 | [diff] [blame] | 119 | . $ONOS_ROOT/tools/test/cells/$1 |
Thomas Vachuska | 0a4c270 | 2015-07-06 08:43:41 -0700 | [diff] [blame] | 120 | export ONOS_INSTANCES=$(env | grep 'OC[0-9]*=' | sort | cut -d= -f2) |
Thomas Vachuska | 785f581 | 2015-03-19 01:11:00 -0700 | [diff] [blame] | 121 | setPrimaryInstance 1 >/dev/null |
tom | ecd0fbd | 2014-09-19 08:47:05 -0700 | [diff] [blame] | 122 | cell |
| 123 | else |
| 124 | env | egrep "ONOS_CELL" |
| 125 | env | egrep "OCI" |
Pavlin Radoslavov | 711145a | 2014-10-16 17:45:48 -0700 | [diff] [blame] | 126 | env | egrep "OC[0-9]+" | sort |
Thomas Vachuska | 785f581 | 2015-03-19 01:11:00 -0700 | [diff] [blame] | 127 | env | egrep "OC[NT]" |
Thomas Vachuska | 3c831fa | 2015-08-17 18:44:15 -0700 | [diff] [blame] | 128 | env | egrep "ONOS_" | egrep -v 'ONOS_ROOT|ONOS_CELL|ONOS_INSTANCES' | sort |
tom | ecd0fbd | 2014-09-19 08:47:05 -0700 | [diff] [blame] | 129 | fi |
| 130 | } |
| 131 | |
Roan Huang | 0fa4bc4 | 2015-05-01 15:38:20 +0800 | [diff] [blame] | 132 | cell $ONOS_CELL > /dev/null |
tom | ecd0fbd | 2014-09-19 08:47:05 -0700 | [diff] [blame] | 133 | |
| 134 | # Lists available cells |
| 135 | function cells { |
tom | 2482e6f | 2014-10-01 16:51:48 -0700 | [diff] [blame] | 136 | for cell in $(ls -1 $ONOS_ROOT/tools/test/cells); do |
Thomas Vachuska | 785f581 | 2015-03-19 01:11:00 -0700 | [diff] [blame] | 137 | printf "%-16s %s\n" \ |
tom | 2482e6f | 2014-10-01 16:51:48 -0700 | [diff] [blame] | 138 | "$([ $cell = $ONOS_CELL ] && echo $cell '*' || echo $cell)" \ |
| 139 | "$(grep '^#' $ONOS_ROOT/tools/test/cells/$cell | head -n 1)" |
| 140 | done |
tom | ecd0fbd | 2014-09-19 08:47:05 -0700 | [diff] [blame] | 141 | } |
tom | 5a18e80 | 2014-09-18 12:38:15 -0700 | [diff] [blame] | 142 | |
Thomas Vachuska | 9507d2a | 2015-12-01 20:45:57 -0800 | [diff] [blame] | 143 | # Find a process by regex |
tom | 5c25570 | 2014-09-18 06:57:39 -0700 | [diff] [blame] | 144 | function spy { |
| 145 | ps -ef | egrep "$@" | grep -v egrep |
| 146 | } |
| 147 | |
Thomas Vachuska | 9507d2a | 2015-12-01 20:45:57 -0800 | [diff] [blame] | 148 | # Kill a process by regex |
tom | 5c25570 | 2014-09-18 06:57:39 -0700 | [diff] [blame] | 149 | function nuke { |
tom | 85258ee | 2014-10-07 00:10:02 -0700 | [diff] [blame] | 150 | spy "$@" | cut -c7-11 | xargs kill |
tom | 5c25570 | 2014-09-18 06:57:39 -0700 | [diff] [blame] | 151 | } |
Ayaka Koshibe | a998513 | 2014-12-18 14:55:22 -0800 | [diff] [blame] | 152 | |
Thomas Vachuska | ea2d9fd | 2015-09-23 13:13:25 -0700 | [diff] [blame] | 153 | # Edit a cell file by providing a cell name; opens the cell file in $EDITOR. |
| 154 | function vicell { |
| 155 | local apply=false |
| 156 | local create=false |
| 157 | local cdf="" |
| 158 | local cpath="${ONOS_ROOT}/tools/test/cells/" |
Ayaka Koshibe | a998513 | 2014-12-18 14:55:22 -0800 | [diff] [blame] | 159 | |
Thomas Vachuska | ea2d9fd | 2015-09-23 13:13:25 -0700 | [diff] [blame] | 160 | if [ -z "$1" ] || [ "$1" = "-h" ] ; then |
| 161 | printf "usage: vicell [file] [options]\n\noptions:\n" |
| 162 | printf "\t-a: apply the cell after editing\n" |
| 163 | printf "\t-e: [editor] set EDITOR to [editor] (default *vi*)\n" |
| 164 | printf "\t-c: create cell file if none exist\n\n" |
| 165 | return 1 |
| 166 | fi |
Ayaka Koshibe | a998513 | 2014-12-18 14:55:22 -0800 | [diff] [blame] | 167 | |
Thomas Vachuska | ea2d9fd | 2015-09-23 13:13:25 -0700 | [diff] [blame] | 168 | while [ $# -gt 0 ]; do |
| 169 | case "$1" in |
| 170 | -a) apply=true ;; |
| 171 | -e) EDITOR=$2; shift ;; |
| 172 | -c) create=true ;; |
| 173 | *) cdf="$1" ;; |
| 174 | esac |
| 175 | shift |
| 176 | done |
Ayaka Koshibe | a998513 | 2014-12-18 14:55:22 -0800 | [diff] [blame] | 177 | |
Thomas Vachuska | ea2d9fd | 2015-09-23 13:13:25 -0700 | [diff] [blame] | 178 | if [ ! -e "${cpath}${cdf}" ] && [ "$create" = "false" ]; then |
| 179 | printf "${cdf} : no such cell\n" && return 1 |
| 180 | fi |
Ayaka Koshibe | a998513 | 2014-12-18 14:55:22 -0800 | [diff] [blame] | 181 | |
Thomas Vachuska | ea2d9fd | 2015-09-23 13:13:25 -0700 | [diff] [blame] | 182 | if [ -z "${EDITOR}" ] || [ -x "$(which ${EDITOR})" ]; then |
| 183 | unset EDITOR && vi ${cpath}${cdf} |
| 184 | else |
| 185 | $EDITOR ${cpath}${cdf} |
| 186 | fi |
| 187 | ($apply) && cell ${cdf} |
Ayaka Koshibe | a998513 | 2014-12-18 14:55:22 -0800 | [diff] [blame] | 188 | } |
Ayaka Koshibe | aec62962 | 2015-01-05 20:33:29 -0800 | [diff] [blame] | 189 | |
Thomas Vachuska | 9507d2a | 2015-12-01 20:45:57 -0800 | [diff] [blame] | 190 | # Autocomplete for certain utilities |
Ayaka Koshibe | aec62962 | 2015-01-05 20:33:29 -0800 | [diff] [blame] | 191 | . ${ONOS_ROOT}/tools/test/bin/ogroup-opts |
Thomas Vachuska | 9507d2a | 2015-12-01 20:45:57 -0800 | [diff] [blame] | 192 | |
| 193 | |
| 194 | # Load AT&T MPLS topo GEO data |
Thomas Vachuska | 3600846 | 2016-01-07 15:38:20 -0800 | [diff] [blame] | 195 | alias atttopo='onos-netcfg $OCI $ONOS_ROOT/tools/test/topos/attmpls-cfg.json' |