Syntax
kubectl contrailstatus deployment --plane { config | control | data [--wide] }
kubectl contrailstatus resource { bgprouter [BGP | XMPP] | globalsystemconfig | routinginstance | virtualnetwork [--wide] }
kubectl contrailstatus cresource all [detail]
kubectl contrailstatus configdump
kubectl contrailstatus --all [--wide]
kubectl contrailstatus version
Description
This command displays the status' of various CN2 components. You can display the status' of
the Configuration plane components, the Control plane components, the Data plane components,
and the BGP routers and other resources.
Options
kubectl contrailstatus deployment --plane config |
Displays the status of the Configuration plane components:
- contrail-k8s-apiserver
- contrail-k8s-controller
- contrail-k8s-kubemanager
|
kubectl contrailstatus deployment --plane control |
Displays the status of the Control plane components:
|
kubectl contrailstatus deployment --plane data |
Displays the status of the Data plane components:
- contrail-vrouter-masters
- contrail-vrouter-nodes
|
kubectl contrailstatus resource bgprouter |
Displays the status' of the various BGP and XMPP neighbor relationships. |
kubectl contrailstatus resource globalsystemconfig |
Displays the status of the GlobalSystemConfig. |
kubectl contrailstatus resource routinginstance |
Displays the status' of the various RoutingInstances in CN2. |
kubectl contrailstatus resource virtualnetwork |
Displays the status' of the various VirtualNetworks in CN2. |
kubectl contrailstatus cresource all |
Displays all information about all resources (useful for displaying all information in
a single command for debugging). If the detail option is used, the
output is displayed in JSON format. |
kubectl contrailstatus configdump |
Lists the resources and their quantities. |
kubectl contrailstatus --all |
Displays the status' of the Configuration/Control/Data planes and the BGP and XMPP
relationships. |
kubectl contrailstatus version |
Displays the versions of the various container images. |
Additional Information
The --wide
qualifier displays more information (if available) on the
queried component.
Use the --help
qualifier to display the help at any point in the
command.
This command looks for the kubeconfig file in the default ~/.kube/config
location. You can't use the kubectl --kubeconfig option to
specify the location of the kubeconfig file.
Output Fields
Table 1
lists some of the output fields for the kubectl contrailstatus
command.
Table 1: kubectl contrailstatus Output Fields
Field Name
|
Field Description
|
NAME |
The name of the pod or resource. |
STATUS |
The status of the pod or resource. |
NODE |
The name of the node on which the pod is running. |
IP |
The (machine) IP address of the node on which the pod is
running. |
MESSAGE |
Not used. |
LOCAL BGPROUTER |
The name of the node on which the local BGP router is
running. |
NEIGHBOR BGPROUTER |
The name of the node on which the neighbor BGP router is
running. |
ENCODING |
Whether this connection is XMPP or BGP. |
STATE |
The state of this connection. |
POD |
The name of the pod on which the local BGP router is
running. |
Sample Output
kubectl contrail-status --all
user@host> kubectl contrail-status --all
NAME(CONFIG) STATUS NODE IP MESSAGE
contrail-k8s-apiserver-6d79c8598d-8lfnm ok ocp1 172.16.0.11
contrail-k8s-apiserver-6d79c8598d-q7klk ok ocp3 172.16.0.13
contrail-k8s-apiserver-6d79c8598d-szdzf ok ocp2 172.16.0.12
contrail-k8s-controller-96964f568-csk2k ok ocp1 172.16.0.11
contrail-k8s-controller-96964f568-dshn6 ok ocp3 172.16.0.13
contrail-k8s-controller-96964f568-hfrpl ok ocp2 172.16.0.12
contrail-k8s-kubemanager-79b577ff86-6v8qt ok ocp3 172.16.0.13
contrail-k8s-kubemanager-79b577ff86-cbh5n ok ocp1 172.16.0.11
contrail-k8s-kubemanager-79b577ff86-vmckw ok ocp2 172.16.0.12
NAME(CONTROL) STATUS NODE IP MESSAGE
contrail-control-0 ok ocp1 172.16.0.11
contrail-control-1 ok ocp2 172.16.0.12
contrail-control-2 ok ocp3 172.16.0.13
LOCAL BGPROUTER NEIGHBOR BGPROUTER ENCODING STATE POD
ocp1 ocp2 BGP Established ok contrail-control-0
ocp1 ocp3 BGP Established ok contrail-control-0
ocp1 ocp1 XMPP Established ok contrail-control-0
ocp1 ocp2 XMPP Established ok contrail-control-0
ocp1 ocp3 XMPP Established ok contrail-control-0
ocp1 ocp4 XMPP Established ok contrail-control-0
ocp1 ocp5 XMPP Established ok contrail-control-0
ocp2 ocp3 BGP Established ok contrail-control-1
ocp2 ocp1 BGP Established ok contrail-control-1
ocp2 ocp2 XMPP Established ok contrail-control-1
ocp2 ocp3 XMPP Established ok contrail-control-1
ocp2 ocp4 XMPP Established ok contrail-control-1
ocp2 ocp5 XMPP Established ok contrail-control-1
ocp3 ocp1 BGP Established ok contrail-control-2
ocp3 ocp2 BGP Established ok contrail-control-2
ocp3 ocp1 XMPP Established ok contrail-control-2
NAME(DATA) STATUS NODE IP MESSAGE
contrail-vrouter-masters-dspzb ok ocp3 172.16.0.13
contrail-vrouter-masters-ks249 ok ocp2 172.16.0.12
contrail-vrouter-masters-tn6jz ok ocp1 172.16.0.11
contrail-vrouter-nodes-mjwt2 ok ocp4 172.16.0.14
contrail-vrouter-nodes-rp5np ok ocp5 172.16.0.15
Release Information
Table 2: Summary of Changes
Release |
Changes |
22.1 |
Initial release. |
22.4 |
Updated version command to include image versions. Added
cresource and configdump commands. |