Skip to content

Commit

Permalink
Wrap lines in networking documentation at 80 characters
Browse files Browse the repository at this point in the history
  • Loading branch information
Martchus committed Dec 12, 2023
1 parent 96783ee commit 805fb25
Showing 1 changed file with 20 additions and 14 deletions.
34 changes: 20 additions & 14 deletions docs/Networking.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -67,12 +67,15 @@ versions) for NAT and _wicked_ or _NetworkManager_ as network manager. Keep in
mind that a firewall is not strictly necessary for operation. The operation
without firewall is not covered in all necessary details in this documentation.

NOTE: Another way to setup the environment with _iptables_ and _firewalld_ is described
on the link:https://fedoraproject.org/wiki/OpenQA_advanced_network_guide[Fedora wiki].
NOTE: Another way to setup the environment with _iptables_ and _firewalld_ is
described on the
link:https://fedoraproject.org/wiki/OpenQA_advanced_network_guide[Fedora wiki].

NOTE: Alternatively https://github.com/os-autoinst/salt-states-openqa[salt-states-openqa] contains
necessities to establish such a setup and configure it for all workers with the `tap`
worker class. They also cover GRE tunnels (that are explained in the next section).
NOTE: Alternatively
https://github.com/os-autoinst/salt-states-openqa[salt-states-openqa] contains
necessities to establish such a setup and configure it for all workers with the
`tap` worker class. They also cover GRE tunnels (that are explained in the next
section).

The script `os-autoinst-setup-multi-machine` can be run like this:

Expand Down Expand Up @@ -186,10 +189,10 @@ systemctl enable openqa-worker@{1..3}


=== Verify the setup
Simply run a MM test scenario. For openSUSE, you can find many relevant tests
on https://openqa.opensuse.org[o3], e.g. look for networking-related tests like
wicked-tests. To test GRE tunnels, you may want to change the jobs worker classes
so the different jobs are executed on different workers.
Simply run a MM test scenario. For openSUSE, you can find many relevant tests on
https://openqa.opensuse.org[o3], e.g. look for networking-related tests like
wicked-tests. To test GRE tunnels, you may want to change the jobs worker
classes so the different jobs are executed on different workers.

So you could call `openqa-clone-job` like this:
```
Expand All @@ -201,10 +204,11 @@ openqa-clone-job \
_GROUP=0 BUILD+=test-mm-setup # avoid interfering with production jobs
```

It will print an `openqa-cli` call. You can modify it to change the worker classes of
the jobs individually and then invoke it.
It will print an `openqa-cli` call. You can modify it to change the worker
classes of the jobs individually and then invoke it.

Also be sure to reboot the worker host to make sure the setup is actually persistent.
Also be sure to reboot the worker host to make sure the setup is actually
persistent.

==== Start test VMs manually
You may also start VMs manually to verify the setup.
Expand Down Expand Up @@ -245,7 +249,8 @@ VM to see whether the VMs can talk to each other.
Boot sequence with wicked (version 0.6.23 and newer):

1. openvswitch (as above)
2. wicked - creates the bridge `br1` and tap devices, adds tap devices to the bridge,
2. wicked - creates the bridge `br1` and tap devices, adds tap devices to the
bridge,
3. firewalld (or SuSEfirewall2 in older setups)
4. os-autoinst-openvswitch - installs openflow rules, handles vlan assignment

Expand Down Expand Up @@ -310,7 +315,8 @@ Check the flow of packets over the network:
* packets from tapX to br1 create additional rules in table=1
* packets from br1 to tapX increase packet counts in table=1
* empty output indicates a problem with os-autoinst-openvswitch service
* zero packet count or missing rules in table=1 indicate problem with tap devices
* zero packet count or missing rules in table=1 indicate problem with tap
devices

As long as the SUT has access to external network, there should be a non-zero
packet count in the forward chain between the br1 and external interface.
Expand Down

0 comments on commit 805fb25

Please sign in to comment.