Skip to content

Commit 0bb93cc

Browse files
ShaunaDiazShaunaDiaz
committed
OSDOCS-4564 renaming troubleshooting book and adding known issue
1 parent 1932f8e commit 0bb93cc

File tree

10 files changed

+94
-11
lines changed

10 files changed

+94
-11
lines changed

‎_topic_maps/_topic_map_ms.yml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -149,7 +149,7 @@ Topics:
149149
# File: TBD
150150
---
151151
Name: Troubleshooting
152-
Dir: microshift_support
152+
Dir: microshift_troubleshooting
153153
Distros: microshift
154154
Topics:
155155
- Name: MicroShift Troubleshooting

‎microshift_support/_attributes‎ renamed to ‎microshift_troubleshooting/_attributes‎

File renamed without changes.

‎microshift_support/images‎ renamed to ‎microshift_troubleshooting/images‎

File renamed without changes.

‎microshift_support/microshift-troubleshooting.adoc‎ renamed to ‎microshift_troubleshooting/microshift-troubleshooting.adoc‎

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,15 @@
11
:_content-type: ASSEMBLY
22
[id="microshift-troubleshooting"]
3-
= MicroShift Troubleshooting
3+
= Check your version and known issues
44
include::_attributes/attributes-microshift.adoc[]
55
:context: microshift-troubleshooting
66
toc::[]
77

8-
Determine which version of {product-title} you have, find out about known issues, and troubleshoot common problems.
8+
Determine which version of {product-title} you have, find out about known issues, and troubleshoot problems.
99

1010
include::modules/microshift-version-cli.adoc[leveloffset=+1]
1111

12-
include::modules/microshift-version-api.adoc[leveloffset=+1]
12+
include::modules/microshift-version-api.adoc[leveloffset=+1]
13+
14+
include::modules/microshift-ki-cni-iptables-deleted.adoc[leveloffset=+1]
15+

‎microshift_support/modules‎ renamed to ‎microshift_troubleshooting/modules‎

File renamed without changes.

‎microshift_support/snippets‎ renamed to ‎microshift_troubleshooting/snippets‎

File renamed without changes.

‎modules/microshift-k8s-apis.adoc‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
// Module included in the following assemblies:
22
//
3-
// * microshift_support/microshift-version.adoc
3+
// * microshift_troubleshooting/microshift-version.adoc
44

55
:_content-type: CONCEPT
66
[id="microshift-k8s-apis_{context}"]
7-
= MicroShift Kubernetes APIs
7+
= {product-title} Kubernetes APIs
88

9-
{product-title} supports the following standard Kubernetes APIs:
9+
{product-title} supports the following standard Kubernetes APIs:
1010

1111
NOTE: TABLE IS FOR PLACEMENT ONLY (FPO)
1212

‎modules/microshift-ki-cni-iptables-deleted.adoc‎

Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
// Module included in the following assemblies:
2+
//
3+
// * microshift_support/microshift-version.adoc
4+
5+
[id="microshift-ki-cni-iptables-deleted_{context}"]
6+
= Reloading the firewall deletes iptable rules
7+
8+
OVN-Kubernetes handles incoming NodePort traffic by using iptable rules. When you reload firewall rules with the `firewall-cmd --reload` command, the iptable rules are deleted. This stops the NodePort service traffic and any other host traffic that uses iptable rules.
9+
10+
[id="microshift-ki-cni-iptables-deleted-workaround_{context}"]
11+
== Restarting the daemon set pod as a workaround
12+
To troubleshoot this issue, delete the ovnkube-master pod to restart the ovnkube daemon set pod. Restarting the ovnkube daemon set pod will trigger a reconciliation of the iptable rules.
13+
14+
.Prerequisites
15+
16+
* The OpenShift CLI (`oc`) is installed.
17+
* Access to the cluster as a user with the `cluster-admin` role.
18+
* A cluster installed on infrastructure configured with the OVN-Kubernetes CNI cluster network provider.
19+
* The KUBECONFIG environment variable is set.
20+
21+
.Procedure
22+
23+
Run the commands listed in each step that follows to restore the iptable rules.
24+
25+
. Stop the ovn-master application:
26+
+
27+
[source, terminal]
28+
----
29+
$ pod=$(oc get pods -n openshift-ovn-kubernetes | grep ovnkube-master | awk -F " " '{print $1}')
30+
----
31+
32+
. Delete the ovnkube-master pod:
33+
+
34+
[source, terminal]
35+
----
36+
$ oc -n openshift-ovn-kubernetes delete pod $pod
37+
----
38+
+
39+
This command causes the daemon set pod to be automatically restarted, causing a reconciliation of the iptable rules.
40+
41+
. Confirm that the iptables have reconciled by running the following command:
42+
+
43+
[source, terminal]
44+
----
45+
$ sudo iptables-save | grep NODEPORT
46+
:OVN-KUBE-NODEPORT - [0:0]
47+
-A PREROUTING -j OVN-KUBE-NODEPORT
48+
-A OUTPUT -j OVN-KUBE-NODEPORT
49+
-A OVN-KUBE-NODEPORT -p tcp -m addrtype --dst-type LOCAL -m tcp --dport 30768 -j DNAT --to-destination 10.43.17.173:443
50+
-A OVN-KUBE-NODEPORT -p tcp -m addrtype --dst-type LOCAL -m tcp --dport 32122 -j DNAT --to-destination 10.43.17.173:80
51+
----
52+
53+
You can also confirm that a new ovnkube-master pod has been started by running the following command:
54+
55+
[source, terminal]
56+
----
57+
$ oc get pods -n openshift-ovn-kubernetes
58+
----
59+
The listing of the running pods shows a new ovnkube-master pod name and age. For example:
60+
61+
[cols="5",options="header"]
62+
|===
63+
|NAME
64+
|READY
65+
|STATUS
66+
|RESTARTS
67+
|AGE
68+
69+
|ovnkube-master-kg7ms
70+
|4/4
71+
|Running
72+
|0
73+
|11s
74+
75+
|ovnkube-node-84gxn
76+
|1/1
77+
|Running
78+
|0
79+
|4d22h
80+
|===

‎modules/microshift-version-api.adoc‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,12 +5,12 @@
55
:_content-type: CONCEPT
66
[id="microshift-version-api_{context}"]
77

8-
= Checking the {product-title} Version via the API
8+
= Checking the {product-title} version using the API
99

1010
.Procedure
1111

1212
* To get the version number using the OpenShift CLI (`oc`), view the `kube-public/microshift-version` config map by running the following command:
13-
13+
+
1414
[source,terminal]
1515
----
1616
$ oc get configmap -n kube-public microshift-version -o yaml

‎modules/microshift-version-cli.adoc‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,12 @@
33
// * microshift_support/microshift-version.adoc
44

55
[id="microshift-version-cli_{context}"]
6-
= Checking the {product-title} Version from the command-line
6+
= Checking the {product-title} version using the command-line interface
77

88
.Procedure
99

1010
* Run the following command to check the version information:
11-
11+
+
1212
[source,terminal]
1313
----
1414
$ microshift version

0 commit comments

Comments
 (0)