Chapter 4. Test the deployment
4.1. Perform a basic test Copy linkLink copied to clipboard!
The basic test verifies that instances can ping each other. The test also checks the Floating IP SSH access. This example describes how you can perform this test from the undercloud.
This procedure requires that you follow a large number of individual steps. For convenience, the procedure is divided into smaller parts. However, you must follow all steps in the following order.
In this setup, a flat network is used to create the _External_ network, and _VXLAN_ is used for the _Tenant_ networks. _VLAN External_ networks and _VLAN Tenant_ networks are also supported, depending on the desired deployment.
4.1.1. Create a new network for testing Copy linkLink copied to clipboard!
Source the credentials to access the overcloud:
$ source /home/stack/overcloudrcCreate an external neutron network to access the instance from outside the overcloud:
$ openstack network create --external --project service --external --provider-network-type flat --provider-physical-network datacentre externalCreate the corresponding neutron subnet for the new external network that you create in the previous step:
$ openstack subnet create --project service --no-dhcp --network external --gateway 192.168.37.1 --allocation-pool start=192.168.37.200,end=192.168.37.220 --subnet-range 192.168.37.0/24 external-subnetDownload the cirros image that you want to use to create overcloud instances:
$ wget http://download.cirros-cloud.net/0.3.4/cirros-0.3.4-x86_64-disk.imgUpload the cirros image to glance on the overcloud:
$ openstack image create cirros --public --file ./cirros-0.3.4-x86_64-disk.img --disk-format qcow2 --container-format bareCreate a
tinyflavor to use for overcloud instances:$ openstack flavor create m1.tiny --ram 512 --disk 1 --publicCreate a VXLAN tenant network to host the instances:
$ openstack network create net_test --provider-network-type=vxlan --provider-segment 100Create a subnet for the tenant network that you created in the previous step:
$ openstack subnet create --network net_test --subnet-range 123.123.123.0/24 testFind and store the ID of the tenant network:
$ net_mgmt_id=$(openstack network list | grep net_test | awk '{print $2}')Create an instance
cirros1and attach it to thenet_testnetwork andSSHsecurity group:$ openstack server create --flavor m1.tiny --image cirros --nic net-id=$vlan1 --security-group SSH --key-name RDO_KEY --availability-zone nova:overcloud-novacompute-0.localdomain cirros1Create a second instance called
cirros2, also attached to thenet_testnetwork andSSHsecurity group:$ openstack server create --flavor m1.tiny --image cirros --nic net-id=$vlan1 --security-group SSH --key-name RDO_KEY --availability-zone nova:overcloud-novacompute-0.localdomain cirros2
4.1.2. Set up networking in the test environment Copy linkLink copied to clipboard!
Find and store the ID of the admin project:
$ admin_project_id=$(openstack project list | grep admin | awk '{print $2}')Find and store the default security group of the admin project:
$ admin_sec_group_id=$(openstack security group list | grep $admin_project_id | awk '{print $2}')Add a rule to the admin default security group to allow ICMP traffic ingress:
$ openstack security group rule create $admin_sec_group_id --protocol icmp --ingressAdd a rule to the admin default security group to allow ICMP traffic egress:
$ openstack security group rule create $admin_sec_group_id --protocol icmp --egressAdd a rule to the admin default security group to allow SSH traffic ingress:
$ openstack security group rule create $admin_sec_group_id --protocol tcp --dst-port 22 --ingressAdd a rule to the admin default security group to allow SSH traffic egress:
$ openstack security group rule create $admin_sec_group_id --protocol tcp --dst-port 22 --egress
4.1.3. Test the connectivity Copy linkLink copied to clipboard!
-
From horizon, you should be able to access the novnc console for an instance. Use the password from overcloudrc to log in to horizon as admin. The default credentials for cirros images are username
cirrosand passwordcubswin:). From the novnc console, verify that the instance receives a DHCP address:
$ ip addr showNoteYou can also run the command
nova console-log <instance id>from the undercloud to verify that the instance receives a DHCP address.- Repeat the steps 1 and 2 for all other instances.
- From one instance, attempt to ping the other instances. This will validate the basic Tenant network connectivity in the overcloud.
- Verify that you can reach other instances by using a Floating IP.
4.1.4. Create devices Copy linkLink copied to clipboard!
Create a floating IP on the external network to be associated with
cirros1instance:$ openstack floating ip create externalCreate a router to handle NAT between the floating IP and
cirros1tenant IP:$ openstack router create testSet the gateway of the router to be the external network:
$ openstack router set test --external-gateway externalAdd an interface to the router attached to the tenant network:
$ openstack router add subnet test testFind and store the floating IP that you create in Step 1:
$ floating_ip=$(openstack floating ip list | head -n -1 | grep -Eo '[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+')Associate the floating IP with the
cirros1instance:$ openstack server add floating ip cirros1 $floating_ipFrom a node that has external network access, attempt to log in to the instance:
$ ssh cirros@$floating_ip
4.2. Perform advanced tests Copy linkLink copied to clipboard!
You can test several components of the OpenDaylight configuration and deployment after you deploy OpenDaylight. To test specific parts of the installation, you must follow several procedures. Each procedure is described separately.
You must perform the procedures on the overcloud nodes.
4.2.1. Connect to overcloud nodes Copy linkLink copied to clipboard!
To connect to the overcloud nodes and ensure that they are operating correctly, complete the following steps:
Procedure
- Log in to the undercloud.
Enter the following command to start the process:
$ source /home/stack/stackrcList all instances:
$ openstack server list- Choose the required instance and note the instance IP address in the list.
Connect to the machine with the IP address from the list that you obtain in the previous step:
$ ssh heat-admin@<IP from step 4>Switch to superuser:
$ sudo -i
4.2.2. Test OpenDaylight Copy linkLink copied to clipboard!
To test that OpenDaylight is operating correctly, you must verify that the service is operational and that the specified features are loaded correctly.
Procedure
- Log in to the overcloud node running OpenDaylight as a superuser, or to an OpenDaylight node running in a custom role.
Verify that the OpenDaylight Controller is running on all Controller nodes:
# docker ps | grep opendaylight 2363a99d514a 192.168.24.1:8787/rhosp13/openstack-opendaylight:latest "kolla_start" 4 hours ago Up 4 hours (healthy) opendaylight_apiVerify that HAProxy is properly configured to listen on port 8081:
# docker exec -it haproxy-bundle-docker-0 grep -A7 opendaylight /etc/haproxy/haproxy.cfg listen opendaylight bind 172.17.0.10:8081 transparent bind 192.168.24.10:8081 transparent mode http balance source server overcloud-controller-0.internalapi.localdomain 172.17.0.22:8081 check fall 5 inter 2000 rise 2 server overcloud-controller-1.internalapi.localdomain 172.17.0.12:8081 check fall 5 inter 2000 rise 2 server overcloud-controller-2.internalapi.localdomain 172.17.0.13:8081 check fall 5 inter 2000 rise 2Use HAproxy IP to connect the karaf account. The karaf password is
karaf:# ssh -p 8101 karaf@localhostList the installed features.
# feature:list -i | grep odl-netvirt-openstackIf there is an
xin the third column of the list, as generated during the procedure, then the feature is correctly installed.Verify that the API is operational.
# web:list | grep neutronThis API endpoint is set in
/etc/neutron/plugins/ml2/ml2_conf.iniand used by the neutron to communicate with OpenDaylight.Verify that VXLAN tunnels between the nodes are up.
# vxlan:showTo test that the REST API is responding correctly, list the modules that are using it.
# curl -u "admin:admin" http://localhost:8081/restconf/modulesThe output will be similar (the example has been shortened).
{"modules":{"module":[{"name":"netty-event-executor","revision":"2013-11-12","namespace":"urn:opendaylight:params:xml:ns:yang:controller:netty:eventexecutor"},{"name" ...List the REST streams that use the host internal_API IP.
# curl -u "admin:admin" http://localhost:8081/restconf/streamsYou get a similar output:
{"streams":{}}Run the following command with host internal_API IP to verify that NetVirt is operational:
# curl -u "admin:admin" http://localhost:8081/restconf/operational/network-topology:network-topology/topology/netvirt:1Note the following output to confirm that NetVirt is operational.
{"topology":[{"topology-id":"netvirt:1"}]}
4.2.3. Test Open vSwitch Copy linkLink copied to clipboard!
To validate Open vSwitch, connect to one of the Compute nodes and verify that it is properly configured and connected to OpenDaylight.
Procedure
- Connect to one of the Compute nodes in the overcloud as a superuser.
List the Open vSwitch settings.
# ovs-vsctl showNote multiple Managers in the output. In this example, lines 2 and 3 display multiple Managers.
6b003705-48fc-4534-855f-344327d36f2a Manager "ptcp:6639:127.0.0.1" Manager "tcp:172.17.1.16:6640" is_connected: true Bridge br-ex fail_mode: standalone Port br-ex-int-patch Interface br-ex-int-patch type: patch options: {peer=br-ex-patch} Port br-ex Interface br-ex type: internal Port "eth2" Interface "eth2" Bridge br-isolated fail_mode: standalone Port "eth1" Interface "eth1" Port "vlan50" tag: 50 Interface "vlan50" type: internal Port "vlan30" tag: 30 Interface "vlan30" type: internal Port br-isolated Interface br-isolated type: internal Port "vlan20" tag: 20 Interface "vlan20" type: internal Bridge br-int Controller "tcp:172.17.1.16:6653" is_connected: true fail_mode: secure Port br-ex-patch Interface br-ex-patch type: patch options: {peer=br-ex-int-patch} Port "tun02d236d8248" Interface "tun02d236d8248" type: vxlan options: {key=flow, local_ip="172.17.2.18", remote_ip="172.17.2.20"} Port br-int Interface br-int type: internal Port "tap1712898f-15" Interface "tap1712898f-15" ovs_version: "2.7.0"-
Verify that the
tcpmanager points to the IP of the node where OpenDaylight is running. -
Verify that the Managers show
is_connected: trueto ensure that connectivity to OpenDaylight from OVS is established and uses the OVSDB protocol. - Verify that each bridge (other than br-int) exists and corresponds to the NIC template used for deployment with the Compute role.
- Verify that the tcp connection corresponds to the IP where the OpenDaylight service is running.
-
Verify that the bridge br-int shows
is_connected: trueand that an OpenFlow protocol connection to OpenDaylight is established.
More information
- OpenDaylight creates the br-int bridge automatically.
4.2.4. Verify the Open vSwitch configuration on Compute nodes. Copy linkLink copied to clipboard!
- Connect to a Compute node as a superuser.
List the Open vSwitch configuration settings.
# ovs-vsctl list open_vswitchRead the output. It will be similar to this example.
_uuid : 4b624d8f-a7af-4f0f-b56a-b8cfabf7635d bridges : [11127421-3bcc-4f9a-9040-ff8b88486508, 350135a4-4627-4e1b-8bef-56a1e4249bef] cur_cfg : 7 datapath_types : [netdev, system] db_version : "7.12.1" external_ids : {system-id="b8d16d0b-a40a-47c8-a767-e118fe22759e"} iface_types : [geneve, gre, internal, ipsec_gre, lisp, patch, stt, system, tap, vxlan] manager_options : [c66f2e87-4724-448a-b9df-837d56b9f4a9, defec179-720e-458e-8875-ea763a0d8909] next_cfg : 7 other_config : {local_ip="11.0.0.30", provider_mappings="datacentre:br-ex"} ovs_version : "2.7.0" ssl : [] statistics : {} system_type : RedHatEnterpriseServer system_version : "7.4-Maipo"-
Verify that the value of the
other_configoption has the correctlocal_ipset for the local interface that connects to the Tenant network through VXLAN tunnels. -
Verify that the
provider_mappingsvalue under theother_configoption matches the value in the OpenDaylightProviderMappings heat template parameter. This configuration maps the neutron logical networks to corresponding physical interfaces.
4.2.5. Verify neutron configuration Copy linkLink copied to clipboard!
Procedure
- Connect to the superuser account on one of the Controller role nodes.
-
Ensure that the
/etc/neutron/neutron.conffile containsservice_plugins=odl-router_v2,trunk. Ensure that the
/etc/neutron/plugin.inifile contains the following ml2 configuration:[ml2] mechanism_drivers=opendaylight_v2 [ml2_odl] password=admin username=admin url=http://192.0.2.9:8081/controller/nb/v2/neutronOn one of the overcloud controllers, verify that neutron agents are running properly.
# openstack network agent listVerify that the
admin_state_upvalue for both the Metadata and DHCP agents areTrue:+--------------------------------------+----------------+--------------------------+-------------------+-------+----------------+------------------------+ | id | agent_type | host | availability_zone | alive | admin_state_up | binary | +--------------------------------------+----------------+--------------------------+-------------------+-------+----------------+------------------------+ | 3be198c5-b3aa-4d0e-abb4-51b29db3af47 | Metadata agent | controller-0.localdomain | | :-) | True | neutron-metadata-agent | | 79579d47-dd7d-4ef3-9614-cd2f736043f3 | DHCP agent | controller-0.localdomain | nova | :-) | True | neutron-dhcp-agent | +--------------------------------------+----------------+--------------------------+-------------------+-------+----------------+------------------------+
More information
-
The IP in the
plugin.ini, mentioned in step 3, should be the InternalAPI Virtual IP Address (VIP). - There is no Open vSwitch agent, nor L3 agent, listed in output of step 5, which is a desired state, as both are now managed by OpenDaylight.