Contrail Controller
C++ Python HTML Java C Shell Other


Contrail Virtual Network Controller

This software is licensed under the Apache License, Version 2.0 (the "License"); you may not use this software except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.


The Contrail Controller repository contains the code for the configuration management, analytics and control-plane components of the Contrail network virtualization solution.

The data-plane component (aka vrouter) is avaialable in a separate code repository (

The configuration management component is located under 'src/config'. It provides a REST API to an orchestration system and translates the system configuration as an IF-MAP database.

The configuration schema used by the contrail controller is defined under src/schema. A code generation tool is used to convert the schema into accessor methods used by the API clients (src/api-lib), the API server as well as the control-plane components.

The control-node daemon code is located under (src/{bgp,control-node,ifmap,xmpp}). It implements the operational state database and iteroperates with networking equipment as well as the compute-node agents. The protocol used between the control-node and the compute-node agents is documented as an IETF draft. This component contains the network reachability (a.k.a. routing) information in the system which is transient and can potentially have a higher rate of change than the configuration state.

The compute-node agent (src/vnsw) is a deamon than runs on every compute node and programs the data-plane in the host operating system.

Data gathered from all these components is collected into a logically centralized database (src/{analytics,opserver}).

Contributing code