Chapter 7. Configuring a gateway

Procedure

1. Back up the existing network configuration by running the following command:

   $ oc get network.operator cluster -o yaml > network-config-backup.yaml

   Copy to Clipboard Toggle word wrap

2. Set the routingViaHost parameter to true by entering the following command. Egress traffic then gets routed through a specific gateway according to the routes that you configured on the node.

   $ oc patch networks.operator.openshift.io cluster --type=merge -p '{"spec":{"defaultNetwork":{"ovnKubernetesConfig":{"gatewayConfig":{"routingViaHost": true}}}}}'

   Copy to Clipboard Toggle word wrap

3. Verify the correct application of the routingViaHost=true configuration by running the following command:

   $ oc get networks.operator.openshift.io cluster -o yaml | grep -A 5 "gatewayConfig"

   Copy to Clipboard Toggle word wrap

   Example output

   apiVersion: operator.openshift.io/v1
   kind: Network
   metadata:
     name: cluster
   # ...
   gatewayConfig:
           ipv4: {}
           ipv6: {}
           routingViaHost: true 

   1

   
         genevePort: 6081
         ipsecConfig:
   # ...

   Copy to Clipboard Toggle word wrap

   1

   A value of true means that egress traffic gets routed through a specific local gateway on the node that hosts the pod. A value of false for the parameter means that a group of nodes share a single gateway so traffic does not get routed through a single host.

4. Optional: Enable IP forwarding globally by running the following command:

   $ oc patch network.operator cluster --type=merge -p '{"spec":{"defaultNetwork":{"ovnKubernetesConfig":{"gatewayConfig":{"ipForwarding": "Global"}}}}}'

   Copy to Clipboard Toggle word wrap

   1. Verify that the ipForwarding spec has been set to Global by running the following command:

      $ oc get networks.operator.openshift.io cluster -o yaml | grep -A 5 "gatewayConfig"

      Copy to Clipboard Toggle word wrap

      Example output

      apiVersion: operator.openshift.io/v1
      kind: Network
      metadata:
        name: cluster
      # ...
      gatewayConfig:
              ipForwarding: Global
              ipv4: {}
              ipv6: {}
              routingViaHost: true
            genevePort: 6081
      # ...

      Copy to Clipboard Toggle word wrap