csit/libraries/OpenStackOperations.robot

   1 *** Settings ***
   2 Documentation     Openstack library. This library is useful for tests to create network, subnet, router and vm instances
   3 Library           SSHLibrary
   4 Resource          Utils.robot
   5 Variables         ../variables/Variables.py
   6
   7 *** Keywords ***
   8 Source Password
   9     [Arguments]    ${force}=no    ${source_pwd}=yes
  10     [Documentation]    Sourcing the Openstack PAsswords for neutron configurations
  11     Run Keyword If    '${source_pwd}' == 'yes' or '${force}' == 'yes'    Write Commands Until Prompt    cd ${DEVSTACK_DEPLOY_PATH}; source openrc admin admin
  12
  13 Get Tenant ID From Security Group
  14     [Documentation]    Returns tenant ID by reading it from existing default security-group.
  15     ${devstack_conn_id}=    Get ControlNode Connection
  16     Switch Connection    ${devstack_conn_id}
  17     ${output}=    Write Commands Until Prompt    neutron security-group-show default | grep "| tenant_id" | awk '{print $4}'
  18     Log    ${output}
  19     [Return]    ${output}
  20
  21 Create Network
  22     [Arguments]    ${network_name}    ${additional_args}=${EMPTY}    ${verbose}=TRUE
  23     [Documentation]    Create Network with neutron request.
  24     ${devstack_conn_id}=    Get ControlNode Connection
  25     Switch Connection    ${devstack_conn_id}
  26     ${command}    Set Variable If    "${verbose}" == "TRUE"    neutron -v net-create ${network_name} ${additional_args}    neutron net-create ${network_name} ${additional_args} | grep -w id | awk '{print $4}'
  27     ${output}=    Write Commands Until Prompt    ${command}    30s
  28     Log    ${output}
  29     [Return]    ${output}
  30
  31 List Networks
  32     [Documentation]    List networks and return output with neutron client.
  33     ${devstack_conn_id}=    Get ControlNode Connection
  34     Switch Connection    ${devstack_conn_id}
  35     ${output}=    Write Commands Until Prompt    neutron net-list    30s
  36     Close Connection
  37     Log    ${output}
  38     [Return]    ${output}
  39
  40 List Subnets
  41     [Documentation]    List subnets and return output with neutron client.
  42     ${devstack_conn_id}=    Get ControlNode Connection
  43     Switch Connection    ${devstack_conn_id}
  44     ${output}=    Write Commands Until Prompt    neutron subnet-list    30s
  45     Close Connection
  46     Log    ${output}
  47     [Return]    ${output}
  48
  49 Delete Network
  50     [Arguments]    ${network_name}
  51     [Documentation]    Delete Network with neutron request.
  52     ${devstack_conn_id}=    Get ControlNode Connection
  53     Switch Connection    ${devstack_conn_id}
  54     ${output}=    Write Commands Until Prompt    neutron -v net-delete ${network_name}    30s
  55     Close Connection
  56     Log    ${output}
  57     Should Contain    ${output}    Deleted network: ${network_name}
  58
  59 Create SubNet
  60     [Arguments]    ${network_name}    ${subnet}    ${range_ip}
  61     [Documentation]    Create SubNet for the Network with neutron request.
  62     ${devstack_conn_id}=    Get ControlNode Connection
  63     Switch Connection    ${devstack_conn_id}
  64     ${output}=    Write Commands Until Prompt    neutron -v subnet-create ${network_name} ${range_ip} --name ${subnet}    30s
  65     Close Connection
  66     Log    ${output}
  67     Should Contain    ${output}    Created a new subnet
  68
  69 Create Port
  70     [Arguments]    ${network_name}    ${port_name}
  71     [Documentation]    Create Port with neutron request.
  72     ${devstack_conn_id}=    Get ControlNode Connection
  73     Switch Connection    ${devstack_conn_id}
  74     ${output}=    Write Commands Until Prompt    neutron -v port-create ${network_name} --name ${port_name}    30s
  75     Close Connection
  76     Log    ${output}
  77     Should Contain    ${output}    Created a new port
  78
  79 Delete Port
  80     [Arguments]    ${port_name}
  81     [Documentation]    Delete Port with neutron request.
  82     ${devstack_conn_id}=    Get ControlNode Connection
  83     Switch Connection    ${devstack_conn_id}
  84     ${output}=    Write Commands Until Prompt    neutron -v port-delete ${port_name}    30s
  85     Close Connection
  86     Log    ${output}
  87     Should Contain    ${output}    Deleted port: ${port_name}
  88
  89 List Ports
  90     [Documentation]    List ports and return output with neutron client.
  91     ${devstack_conn_id}=    Get ControlNode Connection
  92     Switch Connection    ${devstack_conn_id}
  93     ${output}=    Write Commands Until Prompt    neutron port-list    30s
  94     Close Connection
  95     Log    ${output}
  96     [Return]    ${output}
  97
  98 Verify Gateway Ips
  99     [Documentation]    Verifies the Gateway Ips with dump flow.
 100     ${output}=    Write Commands Until Prompt    sudo ovs-ofctl -O OpenFlow13 dump-flows br-int
 101     Log    ${output}
 102     : FOR    ${GatewayIpElement}    IN    @{GATEWAY_IPS}
 103     \    Should Contain    ${output}    ${GatewayIpElement}
 104
 105 Verify Dhcp Ips
 106     [Documentation]    Verifies the Dhcp Ips with dump flow.
 107     ${output}=    Write Commands Until Prompt    sudo ovs-ofctl -O OpenFlow13 dump-flows br-int
 108     Log    ${output}
 109     : FOR    ${DhcpIpElement}    IN    @{DHCP_IPS}
 110     \    Should Contain    ${output}    ${DhcpIpElement}
 111
 112 Verify No Dhcp Ips
 113     [Documentation]    Verifies the Dhcp Ips with dump flow.
 114     ${output}=    Write Commands Until Prompt    sudo ovs-ofctl -O OpenFlow13 dump-flows br-int
 115     Log    ${output}
 116     : FOR    ${DhcpIpElement}    IN    @{DHCP_IPS}
 117     \    Should Not Contain    ${output}    ${DhcpIpElement}
 118
 119 Delete SubNet
 120     [Arguments]    ${subnet}
 121     [Documentation]    Delete SubNet for the Network with neutron request.
 122     Log    ${subnet}
 123     ${devstack_conn_id}=    Get ControlNode Connection
 124     Switch Connection    ${devstack_conn_id}
 125     ${output}=    Write Commands Until Prompt    neutron -v subnet-delete ${subnet}
 126     Close Connection
 127     Log    ${output}
 128     Should Contain    ${output}    Deleted subnet: ${subnet}
 129
 130 Verify No Gateway Ips
 131     [Documentation]    Verifies the Gateway Ips removed with dump flow.
 132     ${output}=    Write Commands Until Prompt    sudo ovs-ofctl -O OpenFlow13 dump-flows br-int
 133     Log    ${output}
 134     : FOR    ${GatewayIpElement}    IN    @{GATEWAY_IPS}
 135     \    Should Not Contain    ${output}    ${GatewayIpElement}
 136
 137 Delete Vm Instance
 138     [Arguments]    ${vm_name}
 139     [Documentation]    Delete Vm instances using instance names.
 140     ${devstack_conn_id}=    Get ControlNode Connection
 141     Switch Connection    ${devstack_conn_id}
 142     ${output}=    Write Commands Until Prompt    nova force-delete ${vm_name}    40s
 143     Close Connection
 144
 145 Get Net Id
 146     [Arguments]    ${network_name}    ${devstack_conn_id}
 147     [Documentation]    Retrieve the net id for the given network name to create specific vm instance
 148     Switch Connection    ${devstack_conn_id}
 149     ${output}=    Write Commands Until Prompt    neutron net-list | grep "${network_name}" | get_field 1    30s
 150     Log    ${output}
 151     ${splitted_output}=    Split String    ${output}    ${EMPTY}
 152     ${net_id}=    Get from List    ${splitted_output}    0
 153     Log    ${net_id}
 154     [Return]    ${net_id}
 155
 156 Get Port Id
 157     [Arguments]    ${port_name}    ${devstack_conn_id}
 158     [Documentation]    Retrieve the port id for the given port name to attach specific vm instance to a particular port
 159     Switch Connection    ${devstack_conn_id}
 160     ${output}=    Write Commands Until Prompt    neutron port-list | grep "${port_name}" | awk '{print $2}'    30s
 161     Log    ${output}
 162     ${splitted_output}=    Split String    ${output}    ${EMPTY}
 163     ${port_id}=    Get from List    ${splitted_output}    0
 164     Log    ${port_id}
 165     [Return]    ${port_id}
 166
 167 Create Vm Instances
 168     [Arguments]    ${net_name}    ${vm_instance_names}    ${image}=cirros-0.3.4-x86_64-uec    ${flavor}=m1.nano    ${sg}=default
 169     [Documentation]    Create X Vm Instance with the net id of the Netowrk.
 170     ${devstack_conn_id}=    Get ControlNode Connection
 171     Switch Connection    ${devstack_conn_id}
 172     ${net_id}=    Get Net Id    ${net_name}    ${devstack_conn_id}
 173     : FOR    ${VmElement}    IN    @{vm_instance_names}
 174     \    ${output}=    Write Commands Until Prompt    nova boot --image ${image} --flavor ${flavor} --nic net-id=${net_id} ${VmElement} --security-groups ${sg}    30s
 175     \    Log    ${output}
 176     \    Wait Until Keyword Succeeds    25s    5s    Verify VM Is ACTIVE    ${VmElement}
 177
 178 Create Vm Instance With Port On Compute Node
 179     [Arguments]    ${port_name}    ${vm_instance_name}    ${compute_node}    ${image}=cirros-0.3.4-x86_64-uec    ${flavor}=m1.nano
 180     [Documentation]    Create One VM instance using given ${port_name} and for given ${compute_node}
 181     ${devstack_conn_id}=    Get ControlNode Connection
 182     Switch Connection    ${devstack_conn_id}
 183     ${port_id}=    Get Port Id    ${port_name}    ${devstack_conn_id}
 184     ${hostname_compute_node}=    Run Command On Remote System    ${compute_node}    hostname
 185     ${output}=    Write Commands Until Prompt    nova boot --image ${image} --flavor ${flavor} --nic port-id=${port_id} ${vm_instance_name} --availability-zone nova:${hostname_compute_node}    30s
 186     Log    ${output}
 187     Wait Until Keyword Succeeds    25s    5s    Verify VM Is ACTIVE    ${vm_instance_name}
 188
 189 Verify VM Is ACTIVE
 190     [Arguments]    ${vm_name}
 191     [Documentation]    Run these commands to check whether the created vm instance is active or not.
 192     ${output}=    Write Commands Until Prompt    nova show ${vm_name} | grep OS-EXT-STS:vm_state    30s
 193     Log    ${output}
 194     Should Contain    ${output}    active
 195
 196 View Vm Console
 197     [Arguments]    ${vm_instance_names}
 198     [Documentation]    View Console log of the created vm instances using nova show.
 199     : FOR    ${VmElement}    IN    @{vm_instance_names}
 200     \    ${output}=    Write Commands Until Prompt    nova show ${VmElement}
 201     \    Log    ${output}
 202     \    ${output}=    Write Commands Until Prompt    nova console-log ${VmElement}
 203     \    Log    ${output}
 204
 205 Ping Vm From DHCP Namespace
 206     [Arguments]    ${net_name}    ${vm_ip}
 207     [Documentation]    Reach all Vm Instance with the net id of the Netowrk.
 208     Log    ${vm_ip}
 209     ${devstack_conn_id}=    Get ControlNode Connection
 210     Switch Connection    ${devstack_conn_id}
 211     ${net_id}=    Get Net Id    ${net_name}    ${devstack_conn_id}
 212     Log    ${net_id}
 213     ${output}=    Write Commands Until Prompt    sudo ip netns exec qdhcp-${net_id} ping -c 3 ${vm_ip}    20s
 214     Log    ${output}
 215     Close Connection
 216     Should Contain    ${output}    64 bytes
 217
 218 Ping From DHCP Should Not Succeed
 219     [Arguments]    ${net_name}    ${vm_ip}
 220     [Documentation]    Should Not Reach Vm Instance with the net id of the Netowrk.
 221     Log    ${vm_ip}
 222     ${devstack_conn_id}=    Get ControlNode Connection
 223     Switch Connection    ${devstack_conn_id}
 224     ${net_id}=    Get Net Id    ${net_name}    ${devstack_conn_id}
 225     Log    ${net_id}
 226     ${output}=    Write Commands Until Prompt    sudo ip netns exec qdhcp-${net_id} ping -c 3 ${vm_ip}    20s
 227     Close Connection
 228     Log    ${output}
 229     Should Not Contain    ${output}    64 bytes
 230
 231 Ping From Instance
 232     [Arguments]    ${dest_vm}
 233     [Documentation]    Ping to the expected destination ip.
 234     ${output}=    Write Commands Until Expected Prompt    ping -c 3 ${dest_vm}    ${OS_SYSTEM_PROMPT}
 235     Log    ${output}
 236     [Return]    ${output}
 237
 238 Curl Metadata Server
 239     [Documentation]    Ping to the expected destination ip.
 240     ${output}=    Write Commands Until Expected Prompt    curl -i http://169.254.169.254    ${OS_SYSTEM_PROMPT}
 241     Write Commands Until Prompt    exit
 242     Should Contain    ${output}    200
 243
 244 Close Vm Instance
 245     [Documentation]    Exit the vm instance.
 246     ${output}=    Write Commands Until Prompt    exit
 247     Log    ${output}
 248
 249 Check If Console Is VmInstance
 250     [Arguments]    ${console}=cirros
 251     [Documentation]    Check if the session has been able to login to the VM instance
 252     ${output}=    Write Commands Until Expected Prompt    id    ${OS_SYSTEM_PROMPT}
 253     Should Contain    ${output}    ${console}
 254
 255 Exit From Vm Console
 256     [Documentation]    Check if the session has been able to login to the VM instance and exit the instance
 257     ${rcode}=    Run Keyword And Return Status    Check If Console Is VmInstance    cirros
 258     Run Keyword If    ${rcode}    Write Commands Until Prompt    exit
 259     Get OvsDebugInfo
 260
 261 Check Ping
 262     [Arguments]    ${ip_address}
 263     [Documentation]    Run Ping command on the IP available as argument
 264     ${output}=    Write Commands Until Expected Prompt    ping -c 3 ${ip_address}    ${OS_SYSTEM_PROMPT}
 265     Should Contain    ${output}    64 bytes
 266
 267 Check Metadata Access
 268     [Documentation]    Try curl on the Metadataurl and check if it is okay
 269     ${output}=    Write Commands Until Expected Prompt    curl -i http://169.254.169.254    ${OS_SYSTEM_PROMPT}
 270     Should Contain    ${output}    200
 271
 272 Test Operations From Vm Instance
 273     [Arguments]    ${net_name}    ${src_ip}    ${list_of_local_dst_ips}    ${l2_or_l3}=l2    ${list_of_external_dst_ips}=${NONE}    ${user}=cirros
 274     ...    ${password}=cubswin:)
 275     [Documentation]    Login to the vm instance using ssh in the network.
 276     ${devstack_conn_id}=    Get ControlNode Connection
 277     Switch Connection    ${devstack_conn_id}
 278     ${net_id}=    Get Net Id    ${net_name}    ${devstack_conn_id}
 279     ${output}=    Write Commands Until Expected Prompt    sudo ip netns exec qdhcp-${net_id} ssh ${user}@${src_ip} -o ConnectTimeout=10 -o StrictHostKeyChecking=no    d:
 280     Log    ${output}
 281     ${output}=    Write Commands Until Expected Prompt    ${password}    ${OS_SYSTEM_PROMPT}
 282     Log    ${output}
 283     ${rcode}=    Run Keyword And Return Status    Check If Console Is VmInstance
 284     Run Keyword If    ${rcode}    Write Commands Until Expected Prompt    ifconfig    ${OS_SYSTEM_PROMPT}
 285     Run Keyword If    ${rcode}    Write Commands Until Expected Prompt    route    ${OS_SYSTEM_PROMPT}
 286     Run Keyword If    ${rcode}    Write Commands Until Expected Prompt    arp -an    ${OS_SYSTEM_PROMPT}
 287     ${dest_vm}=    Get From List    ${list_of_local_dst_ips}    0
 288     Log    ${dest_vm}
 289     Run Keyword If    ${rcode}    Check Ping    ${dest_vm}
 290     ${dest_dhcp}=    Get From List    ${list_of_local_dst_ips}    1
 291     Log    ${dest_dhcp}
 292     Run Keyword If    ${rcode}    Check Ping    ${dest_dhcp}
 293     ${dest_vm}=    Get From List    ${list_of_local_dst_ips}    2
 294     Log    ${dest_vm}
 295     Run Keyword If    ${rcode}    Check Ping    ${dest_vm}
 296     Run Keyword If    ${rcode}    Check Metadata Access
 297     Run Keyword If    '${l2_or_l3}' == 'l3'    Ping Other Instances    ${list_of_external_dst_ips}
 298     [Teardown]    Exit From Vm Console
 299
 300 Ping Other Instances
 301     [Arguments]    ${list_of_external_dst_ips}
 302     [Documentation]    Check reachability with other network's instances.
 303     ${rcode}=    Run Keyword And Return Status    Check If Console Is VmInstance
 304     ${dest_vm}=    Get From List    ${list_of_external_dst_ips}    0
 305     Log    ${dest_vm}
 306     Run Keyword If    ${rcode}    Check Ping    ${dest_vm}
 307     ${dest_dhcp}=    Get From List    ${list_of_external_dst_ips}    1
 308     Log    ${dest_dhcp}
 309     Run Keyword If    ${rcode}    Check Ping    ${dest_dhcp}
 310     ${dest_vm}=    Get From List    ${list_of_external_dst_ips}    2
 311     Log    ${dest_vm}
 312     Run Keyword If    ${rcode}    Check Ping    ${dest_vm}
 313
 314 Create Router
 315     [Arguments]    ${router_name}
 316     [Documentation]    Create Router and Add Interface to the subnets.
 317     ${devstack_conn_id}=    Get ControlNode Connection
 318     Switch Connection    ${devstack_conn_id}
 319     ${output}=    Write Commands Until Prompt    neutron -v router-create ${router_name}    30s
 320     Close Connection
 321     Should Contain    ${output}    Created a new router
 322
 323 Add Router Interface
 324     [Arguments]    ${router_name}    ${interface_name}
 325     ${devstack_conn_id}=    Get ControlNode Connection
 326     Switch Connection    ${devstack_conn_id}
 327     ${output}=    Write Commands Until Prompt    neutron -v router-interface-add ${router_name} ${interface_name}
 328     Close Connection
 329     Should Contain    ${output}    Added interface
 330
 331 Remove Interface
 332     [Arguments]    ${router_name}    ${interface_name}
 333     [Documentation]    Remove Interface to the subnets.
 334     ${devstack_conn_id}=    Get ControlNode Connection
 335     Switch Connection    ${devstack_conn_id}
 336     ${output}=    Write Commands Until Prompt    neutron -v router-interface-delete ${router_name} ${interface_name}
 337     Close Connection
 338     Should Contain    ${output}    Removed interface from router
 339
 340 Delete Router
 341     [Arguments]    ${router_name}
 342     [Documentation]    Delete Router and Interface to the subnets.
 343     ${devstack_conn_id}=    Get ControlNode Connection
 344     Switch Connection    ${devstack_conn_id}
 345     ${output}=    Write Commands Until Prompt    neutron -v router-delete ${router_name}    60s
 346     Close Connection
 347     Should Contain    ${output}    Deleted router:
 348
 349 Get DumpFlows And Ovsconfig
 350     [Arguments]    ${openstack_node_ip}
 351     [Documentation]    Get the OvsConfig and Flow entries from OVS from the Openstack Node
 352     Log    ${openstack_node_ip}
 353     SSHLibrary.Open Connection    ${openstack_node_ip}    prompt=${DEFAULT_LINUX_PROMPT}
 354     Utils.Flexible SSH Login    ${OS_USER}    ${DEVSTACK_SYSTEM_PASSWORD}
 355     SSHLibrary.Set Client Configuration    timeout=${default_devstack_prompt_timeout}
 356     Write Commands Until Expected Prompt    ip -o link    ]>
 357     Write Commands Until Expected Prompt    ip -o addr    ]>
 358     Write Commands Until Expected Prompt    ip route    ]>
 359     Write Commands Until Expected Prompt    arp -an    ]>
 360     ${nslist}=    Write Commands Until Expected Prompt    ip netns list | awk '{print $1}'    ]>
 361     @{lines}    Split To Lines    ${nslist}
 362     : FOR    ${line}    IN    @{lines}
 363     \    Write Commands Until Expected Prompt    sudo ip netns exec ${line} ip -o link    ]>
 364     \    Write Commands Until Expected Prompt    sudo ip netns exec ${line} ip -o addr    ]>
 365     \    Write Commands Until Expected Prompt    sudo ip netns exec ${line} ip route    ]>
 366     Write Commands Until Expected Prompt    sudo ovs-vsctl show    ]>
 367     Write Commands Until Expected Prompt    sudo ovs-vsctl list Open_vSwitch    ]>
 368     Write Commands Until Expected Prompt    sudo ovs-ofctl show br-int -OOpenFlow13    ]>
 369     Write Commands Until Expected Prompt    sudo ovs-ofctl dump-flows br-int -OOpenFlow13    ]>
 370     Write Commands Until Expected Prompt    sudo ovs-ofctl dump-groups br-int -OOpenFlow13    ]>
 371     Write Commands Until Expected Prompt    sudo ovs-ofctl dump-group-stats br-int -OOpenFlow13    ]>
 372
 373 Get ControlNode Connection
 374     ${control_conn_id}=    SSHLibrary.Open Connection    ${OS_CONTROL_NODE_IP}    prompt=${DEFAULT_LINUX_PROMPT_STRICT}
 375     Utils.Flexible SSH Login    ${OS_USER}    ${DEVSTACK_SYSTEM_PASSWORD}
 376     SSHLibrary.Set Client Configuration    timeout=30s
 377     Source Password    force=yes
 378     [Return]    ${control_conn_id}
 379
 380 Get OvsDebugInfo
 381     [Documentation]    Get the OvsConfig and Flow entries from all Openstack nodes
 382     Run Keyword If    0 < ${NUM_OS_SYSTEM}    Get DumpFlows And Ovsconfig    ${OS_CONTROL_NODE_IP}
 383     Run Keyword If    1 < ${NUM_OS_SYSTEM}    Get DumpFlows And Ovsconfig    ${OS_COMPUTE_1_IP}
 384     Run Keyword If    2 < ${NUM_OS_SYSTEM}    Get DumpFlows And Ovsconfig    ${OS_COMPUTE_2_IP}
 385
 386 Show Debugs
 387     [Arguments]    ${vm_indices}
 388     [Documentation]    Run these commands for debugging, it can list state of VM instances and ip information in control node
 389     ${devstack_conn_id}=    Get ControlNode Connection
 390     Switch Connection    ${devstack_conn_id}
 391     ${output}=    Write Commands Until Prompt    sudo ip netns list
 392     Log    ${output}
 393     : FOR    ${index}    IN    @{vm_indices}
 394     \    ${output}=    Write Commands Until Prompt    nova show ${index}    30s
 395     \    Log    ${output}
 396     Close Connection
 397     List Networks
 398     List Subnets
 399     List Ports
 400
 401 Create Security Group
 402     [Arguments]    ${sg_name}    ${desc}
 403     ${devstack_conn_id}=    Get ControlNode Connection
 404     Switch Connection    ${devstack_conn_id}
 405     ${output}=    Write Commands Until Prompt    nova secgroup-create ${sg_name} ${desc}    40s
 406     Close Connection
 407
 408 Create Security Rule
 409     [Arguments]    ${direction}    ${protocol}    ${min_port}    ${max_port}    ${remote_ip}    ${sg_name}
 410     ${devstack_conn_id}=    Get ControlNode Connection
 411     Switch Connection    ${devstack_conn_id}
 412     ${output}=    Write Commands Until Prompt    neutron security-group-rule-create --direction ${direction} --protocol ${protocol} --port-range-min ${min_port} --port-range-max ${max_port} --remote-ip-prefix ${remote_ip} ${sg_name}
 413     Close Connection