Skip to content

Commit 92c8b79

Browse files
committed
OSDOCS-4926: Doc node port issue workaround procedure
1 parent 6953f0d commit 92c8b79

File tree

5 files changed

+49
-3
lines changed

5 files changed

+49
-3
lines changed

microshift_troubleshooting/microshift-troubleshooting.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,3 +11,5 @@ Read about troubleshooting and possible solutions for known issues.
1111
include::modules/microshift-ki-cni-iptables-deleted.adoc[leveloffset=+1]
1212

1313
include::modules/microshift-troubleshooting-nodeport.adoc[leveloffset=+1]
14+
15+
include::modules/microshift-nodeport-unreachable-workaround.adoc[leveloffset=+1]

modules/microshift-about.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77

88
Working with resource-constrained field environments and hardware presents many challenges not experienced with cloud computing. {product-title} enables you to solve problems for edge devices by:
99

10-
* Overcoming the operational challenge of minimal system resources, for example, a {op-system-chip}.
10+
* Overcoming the operational challenge of minimal system resources, for example, a dual-core processor.
1111
* Addressing the environmental challenges of severe networking constraints such as low or no connectivity.
1212
* Meeting the physical constraint of hard-to-access locations by installing your system images directly on edge devices.
1313
* Building on and integrating with edge-optimized operating systems such as {op-system-first}.

modules/microshift-installing-from-rpm.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ Use the following procedure to install {product-title} from an RPM package.
1111
.Prerequisites
1212

1313
* The system requirements for installing {product-title} have been met.
14-
* You have completed the steps of preparing to install {product-title}from an RPM package.
14+
* You have completed the steps of preparing to install {product-title} from an RPM package.
1515
1616
.Procedure
1717

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
// Module included in the following assemblies:
2+
//
3+
// * microshift_troubleshooting/microshift-known-issues.adoc
4+
:_content-type: PROCEDURE
5+
[id="microshift-nodeport-unreachable-workaround_{context}"]
6+
= Manually restarting the `ovnkube-master` pod to resume node port traffic
7+
8+
After you install {product-title}, NodePort service traffic might stop. To troubleshoot this issue, manually restart the `ovnkube-master` pod in the `openshift-ovn-kubernetes` namespace.
9+
10+
.Prerequisites
11+
12+
* The OpenShift CLI (`oc`) is installed.
13+
* A cluster installed on infrastructure configured with the Open Virtual Network (OVN)-Kubernetes network plugin.
14+
* Access to the `kubeconfig` file.
15+
* The KUBECONFIG environment variable is set.
16+
17+
.Procedure
18+
19+
Run the commands listed in each step that follows to restore the `NodePort` service traffic after you install{product-title}:
20+
21+
. Find the name of the ovn-master pod that you want to restart by running the following command:
22+
+
23+
[source, terminal]
24+
----
25+
$ pod=$(oc get pods -n openshift-ovn-kubernetes | grep ovnkube-master | awk -F " " '{print $1}')
26+
----
27+
28+
. Force a restart of the of the ovnkube-master pod by running the following command:
29+
+
30+
[source, terminal]
31+
----
32+
$ oc -n openshift-ovn-kubernetes delete pod $pod
33+
----
34+
35+
. Optional: To confirm that the ovnkube-master pod restarted, run the following command:
36+
+
37+
[source, terminal]
38+
----
39+
$ oc get pods -n openshift-ovn-kubernetes
40+
----
41+
If the pod restarted, the listing of the running pods shows a different ovnkube-master pod name and age consistent with the procedure you just completed.
42+
43+
. Verify that the `NodePort` service can now be reached.
44+

modules/microshift-troubleshooting-nodeport.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
:_content-type: PROCEDURE
66
[id="microshift-troubleshooting-nodeport_{context}"]
7-
= Troubleshooting the NodePort service
7+
= Troubleshooting the NodePort service iptable rules
88

99
OVN-Kubernetes sets up an iptable chain in the NAT table to handle incoming traffic to the NodePort service. When the NodePort service is not reachable or the connection is refused, check the iptable rules on the host to make sure the relevant rules are properly inserted.
1010
//procedure here

0 commit comments

Comments
 (0)