Zack Williams | 961ffcd | 2016-05-20 07:03:35 -0700 | [diff] [blame] | 1 | #!/usr/bin/env bash |
Andy Bavier | ea5b44c | 2016-04-08 16:12:30 -0400 | [diff] [blame] | 2 | |
Andy Bavier | 0acc364 | 2016-05-04 16:17:07 -0700 | [diff] [blame] | 3 | function cleanup_from_previous_test() { |
Zack Williams | 5028fb4 | 2016-06-01 14:52:29 -0700 | [diff] [blame] | 4 | echo "## Cleanup ##" |
| 5 | |
| 6 | echo "Destroying juju environment" |
| 7 | juju destroy-environment --force -y manual |
| 8 | |
Andy Bavier | de3f467 | 2016-06-01 17:02:42 -0400 | [diff] [blame] | 9 | VMS=$( sudo uvt-kvm list ) |
Andy Bavier | 0acc364 | 2016-05-04 16:17:07 -0700 | [diff] [blame] | 10 | for VM in $VMS |
| 11 | do |
Zack Williams | 5028fb4 | 2016-06-01 14:52:29 -0700 | [diff] [blame] | 12 | echo "Destroying $VM" |
Andy Bavier | 97faeec | 2016-05-10 13:23:04 -0400 | [diff] [blame] | 13 | sudo uvt-kvm destroy $VM |
Andy Bavier | 0acc364 | 2016-05-04 16:17:07 -0700 | [diff] [blame] | 14 | done |
| 15 | |
Zack Williams | 5028fb4 | 2016-06-01 14:52:29 -0700 | [diff] [blame] | 16 | echo "Cleaning up files" |
Andy Bavier | 0acc364 | 2016-05-04 16:17:07 -0700 | [diff] [blame] | 17 | rm -rf ~/.juju |
| 18 | rm -f ~/.ssh/known_hosts |
| 19 | rm -rf ~/openstack-cluster-setup |
| 20 | |
Zack Williams | 5028fb4 | 2016-06-01 14:52:29 -0700 | [diff] [blame] | 21 | echo "Cleaning up libvirt/dnsmasq" |
Zack Williams | 17508be | 2016-05-31 21:52:35 -0700 | [diff] [blame] | 22 | sudo rm -f /var/lib/libvirt/dnsmasq/xos-mgmtbr.leases |
| 23 | sudo killall dnsmasq |
Zack Williams | 5028fb4 | 2016-06-01 14:52:29 -0700 | [diff] [blame] | 24 | sudo service libvirt-bin restart |
Andy Bavier | 0acc364 | 2016-05-04 16:17:07 -0700 | [diff] [blame] | 25 | } |
| 26 | |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 27 | function bootstrap() { |
| 28 | cd ~ |
| 29 | sudo apt-get update |
Zack Williams | 4e5d1d2 | 2016-06-13 11:10:03 -0700 | [diff] [blame] | 30 | sudo apt-get -y install software-properties-common curl git mosh tmux dnsutils python-netaddr |
Zack Williams | 65b72c8 | 2016-05-21 21:52:46 -0700 | [diff] [blame] | 31 | sudo add-apt-repository -y ppa:ansible/ansible |
| 32 | sudo apt-get update |
| 33 | sudo apt-get install -y ansible |
| 34 | |
| 35 | [ -e ~/.ssh/id_rsa ] || ssh-keygen -t rsa -N "" -f ~/.ssh/id_rsa |
| 36 | cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys |
| 37 | |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 38 | git clone https://github.com/open-cloud/openstack-cluster-setup.git |
| 39 | cd ~/openstack-cluster-setup |
Zack Williams | 02f252b | 2016-06-13 12:24:26 -0700 | [diff] [blame] | 40 | git checkout $SETUP_BRANCH |
Andy Bavier | ea5b44c | 2016-04-08 16:12:30 -0400 | [diff] [blame] | 41 | |
Zack Williams | 7e19a8a | 2016-05-24 06:42:47 -0700 | [diff] [blame] | 42 | sed -i "s/ubuntu/`whoami`/" $INVENTORY |
Zack Williams | 65b72c8 | 2016-05-21 21:52:46 -0700 | [diff] [blame] | 43 | cp vars/example_keystone.yml vars/cord_keystone.yml |
Andy Bavier | ea5b44c | 2016-04-08 16:12:30 -0400 | [diff] [blame] | 44 | |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 45 | # Log into the local node once to get host key |
| 46 | ssh -o StrictHostKeyChecking=no localhost "ls > /dev/null" |
| 47 | } |
| 48 | |
| 49 | function setup_openstack() { |
Zack Williams | f72e7b6 | 2016-06-02 09:57:23 -0700 | [diff] [blame] | 50 | # Run the playbook, but check to see if we're on cloudlab |
| 51 | if [[ -x /usr/testbed/bin/mkextrafs ]] |
| 52 | then |
Zack Williams | 32d711d | 2016-06-02 10:53:30 -0700 | [diff] [blame] | 53 | ansible-playbook -i $INVENTORY cord-single-playbook.yml --extra-vars="on_cloudlab=True" |
Zack Williams | f72e7b6 | 2016-06-02 09:57:23 -0700 | [diff] [blame] | 54 | else |
| 55 | ansible-playbook -i $INVENTORY cord-single-playbook.yml |
| 56 | fi |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 57 | } |
| 58 | |
Andy Bavier | 9927f96 | 2016-05-20 14:09:36 -0400 | [diff] [blame] | 59 | function build_xos_docker_images() { |
Andy Bavier | 97faeec | 2016-05-10 13:23:04 -0400 | [diff] [blame] | 60 | echo "" |
Andy Bavier | 9927f96 | 2016-05-20 14:09:36 -0400 | [diff] [blame] | 61 | echo "Checking out XOS branch $BUILD_BRANCH" |
Andy Bavier | 97faeec | 2016-05-10 13:23:04 -0400 | [diff] [blame] | 62 | ssh ubuntu@xos "cd xos; git config --global user.email 'ubuntu@localhost'; git config --global user.name 'XOS ExampleService'" |
Andy Bavier | 9927f96 | 2016-05-20 14:09:36 -0400 | [diff] [blame] | 63 | ssh ubuntu@xos "cd xos; git checkout $BUILD_BRANCH" |
Zack Williams | 97225f8 | 2016-05-24 08:23:37 -0700 | [diff] [blame] | 64 | |
Andy Bavier | 9927f96 | 2016-05-20 14:09:36 -0400 | [diff] [blame] | 65 | if [[ $EXAMPLESERVICE -eq 1 ]] |
| 66 | then |
| 67 | echo "" |
| 68 | echo "Adding exampleservice to XOS" |
Andy Bavier | 676c646 | 2016-06-06 14:31:20 -0400 | [diff] [blame] | 69 | ssh ubuntu@xos "cd xos; git cherry-pick cd6e972210f4134ffb2f7a36fb3c4baf33f02bef" |
Andy Bavier | 9927f96 | 2016-05-20 14:09:36 -0400 | [diff] [blame] | 70 | fi |
Zack Williams | 97225f8 | 2016-05-24 08:23:37 -0700 | [diff] [blame] | 71 | |
Andy Bavier | 97faeec | 2016-05-10 13:23:04 -0400 | [diff] [blame] | 72 | echo "Rebuilding XOS containers" |
Zack Williams | 72a9ab4 | 2016-06-08 08:32:49 -0700 | [diff] [blame] | 73 | ssh ubuntu@xos "cd xos/containers/xos; make base" |
Andy Bavier | 97faeec | 2016-05-10 13:23:04 -0400 | [diff] [blame] | 74 | ssh ubuntu@xos "cd xos/xos/configurations/cord-pod; make local_containers" |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 75 | } |
| 76 | |
| 77 | function setup_xos() { |
Zack Williams | d78bbb4 | 2016-05-23 08:53:20 -0700 | [diff] [blame] | 78 | |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 79 | echo "Setting up XOS, will take a few minutes" |
Zack Williams | 3ecbfd0 | 2016-05-22 15:30:21 -0700 | [diff] [blame] | 80 | ssh ubuntu@xos "cd xos/xos/configurations/cord-pod; make" |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 81 | echo "" |
| 82 | echo "Pause 2 minutes" |
| 83 | sleep 120 |
| 84 | |
Andy Bavier | ada2b3b | 2016-06-12 10:33:01 -0400 | [diff] [blame] | 85 | ssh ubuntu@xos "cd xos/xos/configurations/cord-pod; make vtn; make fabric" |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 86 | echo "" |
| 87 | echo "Pause 30 seconds" |
| 88 | sleep 30 |
| 89 | |
Andy Bavier | 0d0d0f7 | 2016-06-12 13:47:12 -0400 | [diff] [blame] | 90 | ssh ubuntu@xos "cd xos/xos/configurations/cord-pod; make cord" |
Zack Williams | 455cec4 | 2016-05-25 16:07:36 -0700 | [diff] [blame] | 91 | |
| 92 | if [[ $EXAMPLESERVICE -eq 1 ]] |
| 93 | then |
| 94 | ssh ubuntu@xos "cd xos/xos/configurations/cord-pod; make exampleservice" |
| 95 | fi |
Andy Bavier | 0d0d0f7 | 2016-06-12 13:47:12 -0400 | [diff] [blame] | 96 | |
| 97 | echo "" |
| 98 | echo "(Temp workaround for bug in Synchronizer) Pause 60 seconds" |
| 99 | sleep 60 |
| 100 | ssh ubuntu@xos "cd xos/xos/configurations/cord-pod; make vtn" |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 101 | } |
| 102 | |
| 103 | function setup_test_client() { |
Zack Williams | 3ecbfd0 | 2016-05-22 15:30:21 -0700 | [diff] [blame] | 104 | ssh ubuntu@nova-compute "sudo apt-get -y install lxc" |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 105 | |
| 106 | # Change default bridge |
Zack Williams | 3ecbfd0 | 2016-05-22 15:30:21 -0700 | [diff] [blame] | 107 | ssh ubuntu@nova-compute "sudo sed -i 's/lxcbr0/databr/' /etc/lxc/default.conf" |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 108 | |
| 109 | # Create test client |
Zack Williams | 3ecbfd0 | 2016-05-22 15:30:21 -0700 | [diff] [blame] | 110 | ssh ubuntu@nova-compute "sudo lxc-create -t ubuntu -n testclient" |
| 111 | ssh ubuntu@nova-compute "sudo lxc-start -n testclient" |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 112 | |
| 113 | # Configure network interface inside of test client with s-tag and c-tag |
Zack Williams | 3ecbfd0 | 2016-05-22 15:30:21 -0700 | [diff] [blame] | 114 | ssh ubuntu@nova-compute "sudo lxc-attach -n testclient -- ip link add link eth0 name eth0.222 type vlan id 222" |
| 115 | ssh ubuntu@nova-compute "sudo lxc-attach -n testclient -- ip link add link eth0.222 name eth0.222.111 type vlan id 111" |
| 116 | ssh ubuntu@nova-compute "sudo lxc-attach -n testclient -- ifconfig eth0.222 up" |
| 117 | ssh ubuntu@nova-compute "sudo lxc-attach -n testclient -- ifconfig eth0.222.111 up" |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 118 | } |
| 119 | |
| 120 | function run_e2e_test() { |
| 121 | source ~/admin-openrc.sh |
| 122 | |
| 123 | echo "*** Wait for vSG VM to come up" |
| 124 | i=0 |
Zack Williams | 961ffcd | 2016-05-20 07:03:35 -0700 | [diff] [blame] | 125 | |
Andy Bavier | 97faeec | 2016-05-10 13:23:04 -0400 | [diff] [blame] | 126 | until nova list --all-tenants|grep 'vsg.*ACTIVE' > /dev/null |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 127 | do |
Andy Bavier | 97faeec | 2016-05-10 13:23:04 -0400 | [diff] [blame] | 128 | sleep 60 |
| 129 | (( i += 1 )) |
| 130 | echo "Waited $i minutes" |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 131 | done |
| 132 | |
| 133 | # get mgmt IP address |
| 134 | ID=$( nova list --all-tenants|grep mysite_vsg|awk '{print $2}' ) |
| 135 | MGMTIP=$( nova interface-list $ID|grep 172.27|awk '{print $8}' ) |
| 136 | |
| 137 | echo "" |
| 138 | echo "*** ssh into vsg VM, wait for Docker container to come up" |
| 139 | i=0 |
| 140 | until ssh -o ProxyCommand="ssh -W %h:%p ubuntu@nova-compute" ubuntu@$MGMTIP "sudo docker ps|grep vcpe" > /dev/null |
| 141 | do |
Andy Bavier | 97faeec | 2016-05-10 13:23:04 -0400 | [diff] [blame] | 142 | sleep 60 |
| 143 | (( i += 1 )) |
| 144 | echo "Waited $i minutes" |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 145 | done |
| 146 | |
| 147 | echo "" |
| 148 | echo "*** Run dhclient in test client" |
Zack Williams | 961ffcd | 2016-05-20 07:03:35 -0700 | [diff] [blame] | 149 | |
Zack Williams | 3ecbfd0 | 2016-05-22 15:30:21 -0700 | [diff] [blame] | 150 | ssh ubuntu@nova-compute "sudo lxc-attach -n testclient -- dhclient eth0.222.111" > /dev/null |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 151 | |
| 152 | echo "" |
| 153 | echo "*** Routes in test client" |
Zack Williams | 3ecbfd0 | 2016-05-22 15:30:21 -0700 | [diff] [blame] | 154 | ssh ubuntu@nova-compute "sudo lxc-attach -n testclient -- route -n" |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 155 | |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 156 | echo "" |
| 157 | echo "*** Test external connectivity in test client" |
Zack Williams | 3ecbfd0 | 2016-05-22 15:30:21 -0700 | [diff] [blame] | 158 | ssh ubuntu@nova-compute "sudo lxc-attach -n testclient -- ping -c 3 8.8.8.8" |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 159 | |
| 160 | echo "" |
| 161 | if [ $? -eq 0 ] |
| 162 | then |
Andy Bavier | 97faeec | 2016-05-10 13:23:04 -0400 | [diff] [blame] | 163 | echo "*** [PASSED] End-to-end connectivity test" |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 164 | else |
Andy Bavier | 97faeec | 2016-05-10 13:23:04 -0400 | [diff] [blame] | 165 | echo "*** [FAILED] End-to-end connectivity test" |
| 166 | exit 1 |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 167 | fi |
| 168 | } |
| 169 | |
Andy Bavier | 97faeec | 2016-05-10 13:23:04 -0400 | [diff] [blame] | 170 | function run_exampleservice_test () { |
| 171 | source ~/admin-openrc.sh |
| 172 | |
| 173 | echo "*** Wait for exampleservice VM to come up." |
Andy Bavier | 9927f96 | 2016-05-20 14:09:36 -0400 | [diff] [blame] | 174 | echo "!!! NOTE that currently the VM will only be created after you login" |
| 175 | echo "!!! to XOS and manually create an ExampleService tenant." |
Andy Bavier | 97faeec | 2016-05-10 13:23:04 -0400 | [diff] [blame] | 176 | i=0 |
| 177 | until nova list --all-tenants|grep exampleservice.*ACTIVE > /dev/null |
| 178 | do |
| 179 | sleep 60 |
| 180 | (( i += 1 )) |
| 181 | echo "Waited $i minutes" |
| 182 | done |
| 183 | |
| 184 | # get mgmt IP address |
| 185 | ID=$( nova list --all-tenants|grep mysite_exampleservice|awk '{print $2}' ) |
| 186 | MGMTIP=$( nova interface-list $ID|grep 172.27|awk '{print $8}' ) |
| 187 | PUBLICIP=$( nova interface-list $ID|grep 10.168|awk '{print $8}' ) |
| 188 | |
| 189 | echo "" |
| 190 | echo "*** ssh into exampleservice VM, wait for Apache come up" |
| 191 | i=0 |
| 192 | until ssh -o ProxyCommand="ssh -W %h:%p ubuntu@nova-compute" ubuntu@$MGMTIP "ls /var/run/apache2/apache2.pid" |
| 193 | do |
| 194 | sleep 60 |
| 195 | (( i += 1 )) |
| 196 | echo "Waited $i minutes" |
| 197 | done |
| 198 | |
| 199 | |
| 200 | echo "" |
| 201 | echo "*** Install curl in test client" |
| 202 | ssh ubuntu@nova-compute "sudo lxc-attach -n testclient -- apt-get -y install curl" |
| 203 | |
| 204 | echo "" |
| 205 | echo "*** Test connectivity to ExampleService from test client" |
| 206 | ssh ubuntu@nova-compute "sudo lxc-attach -n testclient -- curl -s http://$PUBLICIP" |
| 207 | } |
| 208 | |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 209 | # Parse options |
| 210 | RUN_TEST=0 |
Andy Bavier | 97faeec | 2016-05-10 13:23:04 -0400 | [diff] [blame] | 211 | EXAMPLESERVICE=0 |
Zack Williams | 80d4f22 | 2016-06-01 15:42:03 -0700 | [diff] [blame] | 212 | BUILD_BRANCH="master" |
Zack Williams | 02f252b | 2016-06-13 12:24:26 -0700 | [diff] [blame] | 213 | SETUP_BRANCH="master" |
Zack Williams | ed9ced0 | 2016-05-24 06:37:04 -0700 | [diff] [blame] | 214 | INVENTORY="inventory/single-localhost" |
| 215 | |
Zack Williams | 02f252b | 2016-06-13 12:24:26 -0700 | [diff] [blame] | 216 | while getopts "b:ehi:ts:" opt; do |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 217 | case ${opt} in |
Andy Bavier | 9927f96 | 2016-05-20 14:09:36 -0400 | [diff] [blame] | 218 | b ) BUILD_BRANCH=$OPTARG |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 219 | ;; |
Andy Bavier | 97faeec | 2016-05-10 13:23:04 -0400 | [diff] [blame] | 220 | e ) EXAMPLESERVICE=1 |
| 221 | ;; |
Andy Bavier | 9927f96 | 2016-05-20 14:09:36 -0400 | [diff] [blame] | 222 | h ) echo "Usage:" |
Zack Williams | ed9ced0 | 2016-05-24 06:37:04 -0700 | [diff] [blame] | 223 | echo " $0 install OpenStack and prep XOS and ONOS VMs [default]" |
Zack Williams | 02f252b | 2016-06-13 12:24:26 -0700 | [diff] [blame] | 224 | echo " $0 -b <branch> build XOS containers using the <branch> branch of XOS git repo" |
Zack Williams | ed9ced0 | 2016-05-24 06:37:04 -0700 | [diff] [blame] | 225 | echo " $0 -e add exampleservice to XOS" |
| 226 | echo " $0 -h display this help message" |
| 227 | echo " $0 -i <inv_file> specify an inventory file (default is inventory/single-localhost)" |
| 228 | echo " $0 -t do install, bring up cord-pod configuration, run E2E test" |
Zack Williams | 02f252b | 2016-06-13 12:24:26 -0700 | [diff] [blame] | 229 | echo " $0 -s <branch> use branch <branch> of the openstack-cluster-setup git repo" |
Andy Bavier | cb02433 | 2016-04-29 15:52:26 -0400 | [diff] [blame] | 230 | exit 0 |
| 231 | ;; |
Zack Williams | ed9ced0 | 2016-05-24 06:37:04 -0700 | [diff] [blame] | 232 | i ) INVENTORY=$OPTARG |
Andy Bavier | cb02433 | 2016-04-29 15:52:26 -0400 | [diff] [blame] | 233 | ;; |
Zack Williams | ed9ced0 | 2016-05-24 06:37:04 -0700 | [diff] [blame] | 234 | t ) RUN_TEST=1 |
Andy Bavier | cb02433 | 2016-04-29 15:52:26 -0400 | [diff] [blame] | 235 | ;; |
Zack Williams | 02f252b | 2016-06-13 12:24:26 -0700 | [diff] [blame] | 236 | s ) SETUP_BRANCH=$OPTARG |
| 237 | ;; |
Andy Bavier | 9927f96 | 2016-05-20 14:09:36 -0400 | [diff] [blame] | 238 | \? ) echo "Invalid option: -$OPTARG" |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 239 | exit 1 |
| 240 | ;; |
| 241 | esac |
Andy Bavier | ea5b44c | 2016-04-08 16:12:30 -0400 | [diff] [blame] | 242 | done |
| 243 | |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 244 | # What to do |
Andy Bavier | 0acc364 | 2016-05-04 16:17:07 -0700 | [diff] [blame] | 245 | if [[ $RUN_TEST -eq 1 ]] |
| 246 | then |
| 247 | cleanup_from_previous_test |
| 248 | fi |
| 249 | |
Andy Bavier | f000173 | 2016-05-05 09:21:49 -0700 | [diff] [blame] | 250 | set -e |
| 251 | |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 252 | bootstrap |
| 253 | setup_openstack |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 254 | |
| 255 | if [[ $RUN_TEST -eq 1 ]] |
| 256 | then |
Zack Williams | 80d4f22 | 2016-06-01 15:42:03 -0700 | [diff] [blame] | 257 | build_xos_docker_images |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 258 | setup_xos |
| 259 | setup_test_client |
| 260 | run_e2e_test |
Andy Bavier | 97faeec | 2016-05-10 13:23:04 -0400 | [diff] [blame] | 261 | if [[ $EXAMPLESERVICE -eq 1 ]] |
| 262 | then |
| 263 | run_exampleservice_test |
| 264 | fi |
Andy Bavier | 7634904 | 2016-05-04 16:10:29 -0700 | [diff] [blame] | 265 | fi |
Andy Bavier | 97faeec | 2016-05-10 13:23:04 -0400 | [diff] [blame] | 266 | |
| 267 | exit 0 |
Zack Williams | 961ffcd | 2016-05-20 07:03:35 -0700 | [diff] [blame] | 268 | |