blob: a5398987ad46d9ae750bdf2f482a0a71f20059f5 [file] [log] [blame]
Filip Pytloun27930402015-10-06 16:28:32 +02001============
2OpenContrail
3============
4
5Contrail Controller is an open, standards-based software solution that delivers network virtualization and service automation for federated cloud networks. It provides self-service provisioning, improves network troubleshooting and diagnostics, and enables service chaining for dynamic application environments across enterprise virtual private cloud (VPC), managed Infrastructure as a Service (IaaS), and Networks Functions Virtualization (NFV) use cases.
6
7Sample pillars
8==============
9
Jakub Pavlik735005f2016-02-26 15:54:53 +010010Keystone v3
11-------------
12
13To enable support for keystone v3 in opencontrail, there must be defined version for config and web role.
14
15.. code-block:: yaml
16
17 opencontrail:
18 config:
19 version: 2.2
20 enabled: true
21 ...
22 identity:
23 engine: keystone
24 version: '3'
25 ...
26
27 opencontrail:
28 web:
29 version: 2.2
30 enabled: true
31 ...
32 identity:
33 engine: keystone
34 version: '3'
35 ...
36
Filip Pytloun27930402015-10-06 16:28:32 +020037Usage
38=====
39
40Basic installation
41==================
42
43Add control BGP
44===============
45
46 python /etc/contrail/provision_control.py --api_server_ip 192.168.1.11 --api_server_port 8082 --host_name network1.contrail.domain.com --host_ip 192.168.1.11 --router_asn 64512
47
48Compute node installation
49=========================
50
51.. code-block:: yaml
52
53 yum install contrail-vrouter contrail-openstack-vrouter
54
55 salt-call state.sls nova,opencontrail
56
57Add virtual router
58==================
59
60.. code-block:: yaml
61
62 python /etc/contrail/provision_vrouter.py --host_name hostnode1.intra.domain.com --host_ip 10.0.100.101 --api_server_ip 10.0.100.30 --oper add --admin_user admin --admin_password cloudlab --admin_tenant_name admin
63
64 /etc/sysconfig/network-scripts/ifcfg-bond0 -- comment GATEWAY,NETMASK,IPADDR
65
66 reboot
67
68Service debugging
69=================
70
71Display vhost XMPP connection status
72
73You should see the correct controller_ip and state should be established.
74
75 http://<compute-node>:8085/Snh_AgentXmppConnectionStatusReq?
76
77Display vrouter interface status
78
79When vrf_name = ---ERROR--- then something goes wrong
80
81 http://<compute-node>:8085/Snh_ItfReq?name=
82
83Display IF MAP table
84
85Look for neighbours, if VM has 2, it's ok
86
87 http://<control-node>:8083/Snh_IFMapTableShowReq?table_name=
88
89Trace XMPP requests
90
91 http://<compute-node>:8085/Snh_SandeshTraceRequest?x=XmppMessageTrace
92
93Read more
94=========
95
96* http://opencontrail.org
97* http://juniper.github.io/contrail-vnc/README.html
98* http://www.juniper.net/techpubs/en_US/contrail1.0/information-products/topic-collections/release-notes/index.html
99* http://www.juniper.net/support/downloads/?p=contrail#sw