Testing VM Connectivity

Connectivity to a specific VM instance can be tested by ping from DHCP server using either the GUI or CLI.

Test Connectivity with GUI

  1. Navigate to the Compute > Instances view.

  2. Select a specific instance and select More from the top menu.

    test-connectivity

  3. Select Test Connectivity. The Test Connectivity window is displayed.

    test-connectivity-window

  4. Select either arping or ping for the connectivity test.

    Note

    Ping checks layer 3 connectivity and is blocked by security-group filtering, if traffic is not allowed from any IP in the subnet. Arping check layer 2 connectivity and bypasses security-group filtering.

  5. Click OK. A message is displayed that the connectivity test is taking place.

  6. A few seconds later, the test results will be displayed indicting success or failure as well as other relevant details. This status report is also available in the right-hand sidebar.

Test Connectivity with CLI

  1. The ‘guestnet-admin-tool ping-vm create’ command which tests the VMs connectivity requires the ID of the given VM. Note: ’–command-type’ is either ‘ping’ (default) or ‘arping’

    guestnet-admin-tool ping-vm create [-h]
                                       [-f {adaptive_table,json,shell,table,value,yaml}]
                                       [-c COLUMN] [--max-width <integer>]
                                       [--noindent] [--prefix PREFIX]
                                       [-m [NAME=VALUE [NAME=VALUE ...]]]
                                       [--command-type COMMAND_TYPE]
                                       [--name NAME]
                                       vm_id
    
  2. Run the ‘vm list’ command to locate the ID of  VM-1.

    vm list -c id -c name
    
  3. This returns a list of VMs and their IDs.

    +--------------------------------------+-----------------------------------------------------+
    | id                                   | name                                                |
    +======================================+=====================================================+
    | cfdb1753-f8e6-4d32-8ec8-e22d76fbc11e | VM-1                                                |
    +--------------------------------------+-----------------------------------------------------+
    
  4. Test connectivity for VM-1.

    guestnet-admin-tool ping-vm create cfdb1753-f8e6-4d32-8ec8-e22d76fbc11e
    
  5. This returns a temporary, pending status of the VM’s connectivity.

    +--------------+--------------------------------------+
    | id           | a8c3ee99-8966-4f7c-b127-6ce31c397b2d |
    | name         | none                                 |
    | status       | pending                              |
    | command_type | ping                                 |
    | created_at   | 2019-05-07T13:40:02.132361           |
    | output       | -                                    |
    | project_id   | bd616bd0a58f467cb0e96eeb5af6b53c     |
    | updated_at   | 2019-05-07T13:40:02.132369           |
    | user_id      | admin                                |
    | vm_id        | cfdb1753-f8e6-4d32-8ec8-e22d76fbc11e |
    +--------------+--------------------------------------+
    
  6. Wait a few seconds and then request the final status of this VM connectivity test using the ‘guestnet-admin-tool ping-vm get ping_vm_id‘.

    guestnet-admin-tool ping-vm get a8c3ee99-8966-4f7c-b127-6ce31c397b2d
    
  7. This returns the final, succeeded/failed status of the VM connectivity test with relevant output details.

    +--------------+----------------------------------------------------------------+
    | id           | a8c3ee99-8966-4f7c-b127-6ce31c397b2d                           |
    | name         | none                                                           |
    | status       | succeeded                                                      |
    | command_type | ping                                                           |
    | created_at   | 2019-05-07T13:40:02                                            |
    |              +----------------------------------------------------------------+
    | output       | PING 10.11.12.10 (10.11.12.10) 56(84) bytes of data.           |
    |              | 64 bytes from 10.11.12.10: icmp_seq=1 ttl=64 time=2.33 ms      |
    |              | 64 bytes from 10.11.12.10: icmp_seq=2 ttl=64 time=0.369 ms     |
    |              |                                                                |
    |              | --- 10.11.12.10 ping statistics ---                            |
    |              | 2 packets transmitted, 2 received, 0% packet loss, time 1001ms |
    |              | rtt min/avg/max/mdev = 0.369/1.350/2.332/0.982 ms              |
    |              |                                                                |
    |              +----------------------------------------------------------------+
    | project_id   | bd616bd0a58f467cb0e96eeb5af6b53c                               |
    | updated_at   | 2019-05-07T13:40:04                                            |
    | user_id      | admin                                                          |
    | vm_id        | cfdb1753-f8e6-4d32-8ec8-e22d76fbc11e                           |
    +--------------+----------------------------------------------------------------+
    

    Note

    This information is automatically deleted after approximately one hour.

Additional Commands for VM Connectivity Testing

  1. Delete a specific VM connectivity test

    guestnet-admin-tool ping-vm delete ping_vm_id
    
  2. List all VM connectivity tests for a specific VM

    guestnet-admin-tool ping-vm list --vm-id VM_ID
    
  3. List all VM connectivity tests for all VMs

    guestnet-admin-tool ping-vm list