blob: 43d4c3f54914a659ef668d2f13743641c2e6e246 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
|
Setting up a Node with a Single NIC
===================================
Installing the STN Daemon
-------------------------
The STN (Steal the NIC) daemon must be installed on every node in the
cluster that has only one NIC. The STN daemon installation(*) should be
performed before deployment of the Contiv-VPP plugin.
\* Docker daemon must be present when installing STN. Also, Docker must
be configured to allow shared mount. On CentOS, this may not be the case
by default. You can enable it by following the instructions at
https://docs.portworx.com/knowledgebase/shared-mount-propagation.html.
Run as root (not using sudo):
::
bash <(curl -s https://raw.githubusercontent.com/contiv/vpp/master/k8s/stn-install.sh)
The install script should output the following:
::
Installing Contiv STN daemon.
Starting contiv-stn Docker container:
550334308f85f05b2690f5cfb5dd945bd9c501ab9d074231f15c14d7098ef212
Check that the STN daemon is running:
::
docker ps -a
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
550334308f85 contivvpp/stn "/stn" 33 seconds ago Up 33 seconds contiv-stn
Check that the STN daemon is operational:
::
docker logs contiv-stn
The expected logs would look like the following excerpt:
::
2018/02/23 10:08:34 Starting the STN GRPC server at port 50051
For more details, please read the Go documentation for
`contiv-stn <https://github.com/contiv/vpp/blob/master/cmd/contiv-stn/doc.go>`__
and
`contiv-init <https://github.com/contiv/vpp/blob/master/cmd/contiv-init/doc.go>`__.
Creating a VPP Interface Configuration
--------------------------------------
Create the VPP configuration for the hardware interface as described
`here <https://github.com/contiv/vpp/blob/master/docs/VPP_CONFIG.md#single-nic-configuration>`__.
Configuring STN in Contiv-VPP K8s Deployment Files
--------------------------------------------------
The STN feature is disabled by default. It needs to be enabled either
globally, or individually for every node in the cluster.
Global Configuration:
~~~~~~~~~~~~~~~~~~~~~
Global configuration is used in homogeneous environments where all nodes
in a given cluster have the same hardware configuration, for example
only a single Network Adapter. To enable the STN feature globally, put
the ``StealFirstNIC: True`` stanza into the [``contiv-vpp.yaml``][1]
deployment file, for example:
::
data:
contiv.yaml: |-
TCPstackDisabled: true
...
StealFirstNIC: True
...
IPAMConfig:
Setting ``StealFirstNIC`` to ``True`` will tell the STN Daemon on every
node in the cluster to steal the first NIC from the kernel and assign it
to VPP. Note that the Network Adapters on different nodes do not need to
be of the same type. You still need to create the respective vswitch
configurations on every node in the cluster, as shown
[above](#creating-a-vpp-interface-configuration).
Individual Configuration:
~~~~~~~~~~~~~~~~~~~~~~~~~
Individual configuration is used in heterogeneous environments where
each node in a given cluster may be configured differently. To enable
the STN feature for a specific node in the cluster, put the following
stanza into its Node Configuration in the [``contiv-vpp.yaml``][1]
deployment file, for example:
::
...
NodeConfig:
- NodeName: "ubuntu-1"
StealInterface: "enp0s8"
- NodeName: "ubuntu-2"
StealInterface: "enp0s8"
...
Note that you still have to create the vswitch configuration on the node
as shown `here <#creating-a-vpp-interface-configuration>`__.
Uninstalling the STN Daemon
---------------------------
Run as root (not using sudo):
::
bash <(curl -s https://raw.githubusercontent.com/contiv/vpp/master/k8s/stn-install.sh) --uninstall
The install script should output the following:
::
Uninstalling Contiv STN daemon.
Stopping contiv-stn Docker container:
contiv-stn
contiv-stn
contiv-stn
Make sure that the STN daemon has been uninstalled:
::
docker ps -q -f name=contiv-stn
No containers should be listed.
|
