Verify ifmap-server

Verify ifmap-server

OpenContrail uses the standard Interface for Metadata Access Point (IF-MAP) mechanism for the configuration data distribution among OpenContrail configuration and control nodes.

To verify ifmap-server:

  1. Log in to any OpenContrail controller node.

  2. Verify that the virtual machine interface (VMI) is present in ifmap.

    1. Select from the following options:

      • Run the following command:

        ifmap-view visual visual 2>&1  | grep "contrail:virtual-machine-interface"
        

        Example of system response:

        'contrail:virtual-machine-interface:default-domain:TestingTenant:071b9c54-25ed-41cf-ab89-4f60b60e0e66',
        'contrail:virtual-machine-interface:default-domain:TestingTenant:7c05158a-5c4b-458c-bb88-e6de2146856e',
        'contrail:virtual-machine-interface:default-domain:TestingTenant:3187786b-6f11-4c3b-9d0d-3ce9d02de4cf',
        'contrail:virtual-machine-interface:default-domain:TestingTenant:3187786b-6f11-4c3b-9d0d-3ce9d02de4cf',
        
      • Verify the virtual machine interfaces directly by ID. For example:

        ifmap-view visual visual 2>&1  | grep 071b9c54-25ed-41cf-ab89-4f60b60e0e66
        

        Example of system response:

        'contrail:virtual-machine-interface:default-domain:TestingTenant:071b9c54-25ed-41cf-ab89-4f60b60e0e66'
        
    2. If the record of the virtual machine interface in question is missing on the OpenContrail controller node, restart the ifmap-server and contrail-config-nodemgr services on this node:

      service ifmap-server restart
      service supervisor-config restart
      
    3. Verify the number of result items:

      ifmap-view 10.10.10.201 visual visual  2>&1 | grep <virtual_machine>
      

      Example of system response:

      INFO: Number of result items for search = 72
      INFO: Properties on identifier = ['{http://www.contrailsystems.com/vnc_cfg.xsd}id-perms']
      INFO: Links from identifier = ['contrail:domain:default-domain',
      

      The number of result items should be the same on all OpenContrail controller nodes.

    4. If the nodes have a different number of result items, restart the ifmap-server and contrail-config-nodemgr services on these nodes:

      service ifmap-server restart
      service supervisor-config restart
      
  3. Verify the authentication parameters defined in /etc/ifmap-server/basicauthusers.properties. Each IF-MAP client requires a unique user name. All OpenContrail controller nodes must have unique IF-MAP client IDs.

    Example:

    test:test
    test2:test2
    test3:test3
    api-server:api-server
    schema-transformer:schema-transformer
    svc-monitor:svc-monitor
    control-user:control-user-passwd
    control-node-1:control-node-1
    control-node-2:control-node-2
    control-node-3:control-node-3
    dhcp:dhcp
    visual:visual
    sensor:sensor
    
  4. Verify the ifmap-server logs in the following directories:

    • /var/log/contrail/ifmap-server.log

    • /var/log/contrail/ifmap-stdout.log

  5. Verify the introspect of the IF-MAP server over HTTP on the port 8083. Use the following introspect address format: http://<ntw0x_ip_address>:8083/ifmap_server_show.xml.

    1. In the IFMapPeerServerInfoReq section, click Send or open the following address in a browser: http://<ntw0x_ip_address>:8083/Snh_IFMapPeerServerInfoReq.

      The following screen shows an example of the IF-MAP server information:

      ../../../_images/ifmap_introspect_peers.png
    2. In the ds_peer_info and ds_peer_list sections, verify the information about all IF-MAP peers. In the example above, two OpenContrail controller nodes are displayed. The value of one peer node must be true in the In_use column.

  6. Repeat the steps above on the remaining OpenContrail controller nodes.