diff --git a/README.md b/README.md index 7dd85eb4..6b29dd9f 100644 --- a/README.md +++ b/README.md @@ -107,6 +107,51 @@ cinder --debug show $volume_id cinder --debug delete $volume_id cinder --debug list ``` +### Quick Verify + +A sample of admin-openrc.sh and an installation verification script can be found +in devstack/ directory. + +#### admin-openrc.sh + +Create client environment variables for the admin user as the following: + +``` +export OS_PROJECT_DOMAIN_ID=default +export OS_USER_DOMAIN_ID=default +export OS_PROJECT_NAME=admin +export OS_TENANT_NAME=admin +export OS_USERNAME=admin +export OS_PASSWORD=password #change password as you set in your own environment +export OS_AUTH_URL=http://127.0.0.1:5000 +export OS_IDENTITY_API_VERSION=3 #It's very important to set region name of top openstack, + #because tricircle has different API urls. +export OS_IMAGE_API_VERSION=2 +export OS_REGION_NAME=RegionOne + +``` +The command to use the admin-openrc.sh is: + +``` +source tricircle/devstack/admin-openrc.sh +``` + +#### verify_top_install.sh + +This script is to quickly verify the installation of Tricircle in Top OpenStack +as the step 5-9 above and save the output to logs. +Before verifying the installation, you should modify the script to your own +environment. + +- 1 The default post URL is 127.0.0.1, change it if needed, +- 2 The default create net1 is 10.0.0.0/24, change it if needed. + +Then you do the following steps in Top OpenStack to verify: + +``` +cd tricircle/devstack/ +./verify_top_install.sh 2>&1 | tee logs +``` ## Cross-pod L3 networking with DevStack Now stateless design supports cross-pod l3 networking. @@ -393,3 +438,31 @@ neutron floatingip-associate $floatingip_id $port_id ``` Now you should be able to access virtual machine with floating ip bound from the external network. + +### Quick verify + +A sample of admin-openrc.sh and an installation verification script can be found +in devstack/ directory. + +And a demo blog with virtualbox can be found in [this](http://shipengfei92.cn/play_tricircle_with_virtualbox). + +#### verify_cross_pod_install.sh + +This script is to quickly verify the installation of Tricircle in Cross Pod +OpenStack as the contents above and save the output to logs. +Before verifying the installation, some parameters should be modified to your own +environment. + +- 1 The default URL is 127.0.0.1, change it if needed, +- 2 This script create a external network 10.50.11.0/26 according to the work environment, +change it if needed. +- 3 This script create 2 subnets 10.0.1.0/24 and 10.0.2.0/24, Change these if needed. +- 4 The default created floating-ip is attached to the VM with port 10.0.2.3 created by +the subnets, modify it according to your environment. + +Then do the following steps in Node1 OpenStack to verify network functions: + +``` +cd tricircle/devstack/ +./verify_cross_pod_install.sh 2>&1 | tee logs +``` diff --git a/devstack/admin-openrc.sh b/devstack/admin-openrc.sh new file mode 100644 index 00000000..c6063c3b --- /dev/null +++ b/devstack/admin-openrc.sh @@ -0,0 +1,9 @@ +export OS_PROJECT_DOMAIN_ID=default +export OS_USER_DOMAIN_ID=default +export OS_PROJECT_NAME=admin +export OS_TENANT_NAME=admin +export OS_USERNAME=admin +export OS_PASSWORD=password +export OS_AUTH_URL=http://127.0.0.1:5000 +export OS_IDENTITY_API_VERSION=3 +export OS_REGION_NAME=RegionOne diff --git a/devstack/verify_cross_pod_install.sh b/devstack/verify_cross_pod_install.sh new file mode 100755 index 00000000..717dffaf --- /dev/null +++ b/devstack/verify_cross_pod_install.sh @@ -0,0 +1,143 @@ +#!/bin/bash +# +# Script name: verify_cross_pod_install.sh +# This script is to verify the installation of Tricircle in cross pod L3 networking. +# It verify both east-west and north-south networks. +# +# In this script, there are some parameters you need to consider before running it. +# +# 1, Post URL whether is 127.0.0.1 or something else, +# 2, This script create 2 subnets 10.0.1.0/24 and 10.0.2.0/24, Change these if needed. +# 3, This script create external subnet ext-net 10.50.11.0/26, Change it according +# your own environment. +# 4, The floating ip attached to the VM with ip 10.0.2.3, created by the script +# "verify_cross_pod_install.sh", modify it to your own environment. +# +# Change the parameters according to your own environment. +# Finally, execute "verify_cross_pod_install.sh" in the Node1. +# +# Author: Pengfei Shi +# + +set -o xtrace + +TEST_DIR=$(pwd) +echo "Test work directory is $TEST_DIR." + +if [ ! -r admin-openrc.sh ];then + set -o xtrace + echo "Your work directory doesn't have admin-openrc.sh," + echo "Please check whether you are in tricircle/devstack/ or not and run this script." +exit 1 +fi + +echo "Begining the verify testing..." + +echo "Import client environment variables:" +source $TEST_DIR/admin-openrc.sh + +echo "******************************" +echo "* Verify Endpoint *" +echo "******************************" + +echo "List openstack endpoint:" +openstack --debug endpoint list + +token=$(openstack token issue | awk 'NR==5 {print $4}') + +echo $token + +curl -X POST http://127.0.0.1:19999/v1.0/pods -H "Content-Type: application/json" \ + -H "X-Auth-Token: $token" -d '{"pod": {"pod_name": "RegionOne"}}' + +curl -X POST http://127.0.0.1:19999/v1.0/pods -H "Content-Type: application/json" \ + -H "X-Auth-Token: $token" -d '{"pod": {"pod_name": "Pod1", "az_name": "az1"}}' + +curl -X POST http://127.0.0.1:19999/v1.0/pods -H "Content-Type: application/json" \ + -H "X-Auth-Token: $token" -d '{"pod": {"pod_name": "Pod2", "az_name": "az2"}}' + +echo "******************************" +echo "* Verify Nova *" +echo "******************************" + +echo "Show nova aggregate:" +nova aggregate-list + +curl -X POST http://127.0.0.1:9696/v2.0/networks -H "Content-Type: application/json" \ + -H "X-Auth-Token: $token" \ + -d '{"network": {"name": "net1", "admin_state_up": true, "availability_zone_hints": ["az1"]}}' +curl -X POST http://127.0.0.1:9696/v2.0/networks -H "Content-Type: application/json" \ + -H "X-Auth-Token: $token" \ + -d '{"network": {"name": "net2", "admin_state_up": true, "availability_zone_hints": ["az2"]}}' + +echo "Create external network ext-net by curl:" +curl -X POST http://127.0.0.1:9696/v2.0/networks -H "Content-Type: application/json" \ + -H "X-Auth-Token: $token" \ + -d '{"network": {"name": "ext-net", "admin_state_up": true, "router:external": true, "provider:network_type": "vlan", "provider:physical_network": "extern", "availability_zone_hints": ["Pod2"]}}' + +echo "Create test flavor:" +nova flavor-create test 1 1024 10 1 + +echo "******************************" +echo "* Verify Neutron *" +echo "******************************" + +echo "Create external subnet with floating ips:" +neutron subnet-create --name ext-subnet --disable-dhcp ext-net 10.50.11.0/26 --allocation-pool start=10.50.11.30,end=10.50.11.50 --gateway 10.50.11.1 + +echo "Create router for subnets:" +neutron router-create router + +echo "Set router external gateway:" +neutron router-gateway-set router ext-net + +echo "Create net1 in Node1:" +neutron subnet-create net1 10.0.1.0/24 + +echo "Create net2 in Node2:" +neutron subnet-create net2 10.0.2.0/24 + +net1_id=$(neutron net-list |grep net1 | awk '{print $2}') +net2_id=$(neutron net-list |grep net2 | awk '{print $2}') +image_id=$(glance image-list |awk 'NR==4 {print $2}') + +echo "Boot vm1 in az1:" +nova boot --flavor 1 --image $image_id --nic net-id=$net1_id --availability-zone az1 vm1 +echo "Boot vm2 in az2:" +nova boot --flavor 1 --image $image_id --nic net-id=$net2_id --availability-zone az2 vm2 + +subnet1_id=$(neutron net-list |grep net1 |awk '{print $6}') +subnet2_id=$(neutron net-list |grep net2 |awk '{print $6}') + +echo "Add interface of subnet1:" +neutron router-interface-add router $subnet1_id +echo "Add interface of subnet2:" +neutron router-interface-add router $subnet2_id + +echo "******************************" +echo "* Verify VNC connection *" +echo "******************************" + +echo "Get the VNC url of vm1:" +nova --os-region-name Pod1 get-vnc-console vm1 novnc +echo "Get the VNC url of vm2:" +nova --os-region-name Pod2 get-vnc-console vm2 novnc + +echo "**************************************" +echo "* Verify External network *" +echo "**************************************" + +echo "Create floating ip:" +neutron floatingip-create ext-net + +echo "Show floating ips:" +neutron floatingip-list + +echo "Show neutron ports:" +neutron port-list + +floatingip_id=$(neutron floatingip-list | awk 'NR==4 {print $2}') +port_id=$(neutron port-list |grep 10.0.2.3 |awk '{print $2}') + +echo "Associate floating ip:" +neutron floatingip-associate $floatingip_id $port_id diff --git a/devstack/verify_top_install.sh b/devstack/verify_top_install.sh new file mode 100755 index 00000000..8fc69279 --- /dev/null +++ b/devstack/verify_top_install.sh @@ -0,0 +1,94 @@ +#!/bin/bash +# +# Script name: verify_top_install.sh +# This script is to verify the installation of Tricircle in Top OpenStack. +# +# In this script, there are some parameters you need to consider before running it. +# +# 1, Post URL whether is 127.0.0.1 or something else, +# 2, This script create a subnet called net1 10.0.0.0/24, Change these if needed. +# +# Change the parameters according to your own environment. +# Execute "verify_top_install.sh" in the top OpenStack +# +# Author: Pengfei Shi +# + +set -o xtrace + +TEST_DIR=$(pwd) +echo "Test work directory is $TEST_DIR." + +if [ ! -r admin-openrc.sh ];then + set -o xtrace + echo "Your work directory doesn't have admin-openrc.sh," + echo "Please check whether you are in tricircle/devstack/ or not and run this script." +exit 1 +fi + +echo "Begining the verify testing..." + +echo "Import client environment variables:" +source $TEST_DIR/admin-openrc.sh + +echo "******************************" +echo "* Verify Endpoint *" +echo "******************************" + +echo "List openstack endpoint:" + +openstack --debug endpoint list + +token=$(openstack token issue | awk 'NR==5 {print $4}') + +echo $token + +curl -X POST http://127.0.0.1:19999/v1.0/pods -H "Content-Type: application/json" \ + -H "X-Auth-Token: $token" -d '{"pod": {"pod_name": "RegionOne"}}' + +curl -X POST http://127.0.0.1:19999/v1.0/pods -H "Content-Type: application/json" \ + -H "X-Auth-Token: $token" -d '{"pod": {"pod_name": "Pod1", "az_name": "az1"}}' + +echo "******************************" +echo "* Verify Nova *" +echo "******************************" + +echo "Show nova aggregate:" +nova --debug aggregate-list + +echo "Create test flavor:" +nova --debug flavor-create test 1 1024 10 1 + +echo "******************************" +echo "* Verify Neutron *" +echo "******************************" + +echo "Create net1:" +neutron --debug net-create net1 + +echo "Create subnet of net1:" +neutron --debug subnet-create net1 10.0.0.0/24 + +image_id=$(glance image-list |awk 'NR==4 {print $2}') +net_id=$(neutron net-list|grep net1 |awk '{print $2}') + +echo "Boot vm1 in az1:" +nova --debug boot --flavor 1 --image $image_id --nic net-id=$net_id --availability-zone az1 vm1 + +echo "******************************" +echo "* Verify Cinder *" +echo "******************************" + +echo "Create a volume in az1:" +cinder --debug create --availability-zone=az1 1 + +echo "Show volume list:" +cinder --debug list +volume_id=$(cinder list |grep lvmdriver-1 | awk '{print $2}') + +echo "Show detailed volume info:" +cinder --debug show $volume_id + +echo "Delete test volume:" +cinder --debug delete $volume_id +cinder --debug list