1
0
mirror of https://github.com/openshift/installer.git synced 2026-02-05 15:47:14 +01:00
Commit Graph

32 Commits

Author SHA1 Message Date
OpenShift Merge Robot
3b7e9f4911 Merge pull request #4930 from timhansendev/feature/libvirt-add-load-balancer-docs
libvirt: add doc on a default load balancer configuration for libvirt
2021-12-02 18:14:49 +01:00
Vladimir Belousov
51a40345a7 docs: correct spelling in docs
Correct spelling to improve the readability of the documentation
2021-11-01 09:54:42 +03:00
Julian Wiedmann
bc3dee714a docs: libvirt: fix typo
s/resovectl/resolvectl

Signed-off-by: Julian Wiedmann <jwi@linux.ibm.com>
2021-09-27 15:53:05 +02:00
Rick
4399956ede Typo fixing from Github to GitHub 2021-09-11 00:03:59 +08:00
Tim Hansen
529c8a78ae libvirt: add doc on a default load balancer configuration for libvirt
The installer for the development libvirt target does not launch a load balancer by default.
A default configuration of a basic HAProxy config is given here as a guideline for developers.

Signed-off-by: Tim Hansen <tihansen@redhat.com>
2021-08-09 09:18:35 -04:00
Tim Hansen
13d95bec67 docs: libvirt: Mention that resolvectl changes are not persistent 2021-08-04 11:21:26 +02:00
Kevin Wiesmueller
45db840972 docs: libvirt: Add systemd-resolved section
Signed-off-by: Kevin Wiesmueller <kwiesmul@redhat.com>
2021-08-04 11:19:08 +02:00
OpenShift Merge Robot
c6915a3337 Merge pull request #4623 from sallyom/libvirt-update-md
update iptables call with sudo
2021-02-16 14:45:28 -05:00
Sally O'Malley
8c4bc18be3 update iptables call with sudo 2021-02-06 08:45:36 -05:00
Prashanth Sundararaman
a6ef6c7d04 libvirt: support setting network dnsmasq options through the install config
Since libvirt 5.6.0, there is an option to pass in dnsmasq options through the libvirt network [1]. This addresses the following problems:

- eliminate the need for hacking routes in the cluster (the workaround mentioned in [3]) so that libvirt's dnsmasq does not manage the domain (and so the requests from inside the cluster will go up the chain to the host itself).
- eliminate the hacky workaround used in the multi-arch CI automation to inject `*.apps` entries in the libvirt network that point to a single worker node [2]. Instead of waiting for the libvirt networks to come up and update entries, we can set this before the installation itself through the install config.
- another issue this solves - with the above mentioned workaround, having multiple worker nodes becomes problematic when running upgrade tests. Having the route to just one worker node would fail the upgrade when that worker node is down. With this change, we could now point to the .1 address and have a load balancer forward traffic to any worker node.

With this change, the option can be specified through the install config yaml in the network section as pairs of option name and values. An example:
```
platform:
  libvirt:
    network:
      dnsmasqOptions:
      - name: "address"
        value: "/.apps.tt.testing/192.168.126.51"
      if: tt0
```
The terraform provider supports rendering these options through a datasource and injecting them into the network xml.
Since this config is optional, not specifying it will continue to work as before without issues.

[1] https://libvirt.org/formatnetwork.html#elementsNamespaces
[2] https://github.com/openshift/release/blob/master/ci-operator/templates/openshift/installer/cluster-launch-installer-remote-libvirt-e2e.yaml#L532-L554
[2] https://github.com/openshift/installer/issues/1007
2021-01-11 16:18:20 -05:00
Timothée Ravier
5d7e32fa76 docs/dev/libvirt: update libvirt TCP socket setup instructions 2020-06-15 11:20:16 +02:00
Timothée Ravier
64260733c5 docs/dev/libvirt: update firewalld setup instructions 2020-06-15 11:20:16 +02:00
Timothée Ravier
c91e2b1002 docs/dev/libvirt: minor Markdown styling fixes 2020-06-15 11:20:16 +02:00
Daniel P. Berrangé
5253966181 docs: the --listen arg to libvirtd is obsolete with socket activation
In newer libvirtd that ships the "libvirt-tcp.socket" unit files for
socket activation, the --listen argument to libvirtd should not be
used. Enabling both socket activation and the --listen argument will
cause libvirtd to exit with an error about mutually exclusive
configuration options.

Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
2020-05-22 10:08:45 +01:00
Daniel P. Berrangé
b671ce60b5 docs: add stronger warning about impact of disabling auth in libvirtd
A connection to libvirtd gives the client application privileges that
are equivalent to those of a root shell. IOW, disabling authentication
and encryption in libvirtd is akin to running a telnet server with no
root password. This implication is not obvious to users following the
guide, so should be spelt out explicitly, so they understand it is
critical to correctly apply the firewall rules listed later in the
install guide.

Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
2020-05-22 10:08:45 +01:00
Daniel P. Berrangé
3170204e00 docs: simplify libvirt install package set
The "libvirt" RPM is a meta package which depends on every single other
libvirt RPM. It is undesirable to install this because it pulls in a
huge chain of dependencies, which are irrelevant for accomplishing the
steps described in this document. The main interesting thing it was
likely needed for is the "virsh" client, and can thus be replaced by
the "libvirt-client" RPM

The "libvirt-daemon-kvm" RPM pulls in everything needed for a typical
libvirt installation that will be used for running KVM guests, and is
the recommended option for scenarios that don't need to go to extreme
to minimize features installed.

The "qemu-kvm" RPM does not need to be listed explicitly, since it is
already a dependancy of "libvirt-daemon-kvm".

Further information to help understand the libvirt RPM choices is
present at https://libvirt.org/kbase/rpm-deployment.html

Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
2020-05-22 10:08:39 +01:00
Robert Krawitz
ae80a11d01 Update instructions for Fedora 31 for libvirt 2019-11-21 10:47:27 -05:00
Chris Suszyński
64b61348b5 Adding docs on running via libvirt on Dobian/Ubuntu
Issue: https://github.com/code-ready/snc/issues/112 have been raised. It
is for permission denied errors that was caused by selinux. Selinux
isn't available on Debian/Ubuntu, and should be disabled in `qemu.conf`.
2019-10-21 15:46:19 +02:00
Robert Fairley
b150e435ec docs/dev/libvirt: update links in customizing install note
Fix relative links for the new directory layout.
2019-09-04 14:43:06 -04:00
Eduardo Minguez Perez
540e768e93 Started customization libvirt doc wit tt0
Fixes #708
2019-07-23 16:17:30 +02:00
Zeeshan Ali
cfcd2f4eab docs,libvirt: Drop storage pool related info
Installer now manages and uses its own storage pool so this info is now
redundant.
2019-07-10 16:23:36 +02:00
Zeeshan Ali
b785c6ece8 libvirt,docs: Make console workaround a bit easier
Instead of telling what the content of a manifest should be like, provide
a command to modify it as needed.
2019-06-11 16:55:04 +02:00
OpenShift Merge Robot
85323d6d23 Merge pull request #1776 from cfergeau/docs
Doc changes for libvirt backend
2019-05-23 15:27:13 +02:00
Christophe Fergeau
be4e24a122 docs/libvirt: Rework firewalld section
There are some significant firewalld zone differences between Fedora
Workstation and RHEL8. This commit takes this into account, and adjusts
the Fedora instructions so that the libvirt port does not get exposed
externally.
2019-05-22 09:27:21 +02:00
Christophe Fergeau
869f9e9248 docs/libvirt: Remove policykit configuration
Since by default the installer uses qemu+tcp://192.168.122.1 and we
document to disable auth on tcp connections, the policykit step is not
required for the installer.

Signed-off-by: Christophe Fergeau <cfergeau@redhat.com>
2019-05-22 09:27:13 +02:00
Christophe Fergeau
5dc17caee4 docs/libvirt: Use 192.168.122.0 as default subnet
Commit 30b1ae8e4 changed the subnet the cluster will use from
192.168.124.0 to 192.168.126.0. However, it also changed mentions of the default
libvirt from 192.168.122.0 to 192.168.124.0.
This commit revert the last part of the change as 192.168.122.0 is more
likely to be used as it's the upstream libvirt default.

Signed-off-by: Christophe Fergeau <cfergeau@redhat.com>
2019-05-22 09:27:04 +02:00
Praveen Kumar
90b0d4558e docs/dev/libvirt/README.md: Add troubleshooting docs for libvirt console issue.
Currently cluster created by libvirt not able to resolve the auth route
and because of that console doesn't comeup. This troubleshooting doc entry
direct users to make some modification before running the cluster so that
auth route can be resolved by the cluster. Fix #1007
2019-05-06 15:37:20 +05:30
Patrick Dillon
12ec7e0c6f Fix broken link in libvirt doc. 2019-05-02 16:42:38 -04:00
OpenShift Merge Robot
f55b4f259b Merge pull request #1675 from vbatts/broken_links
libvirt/README: fix broken links due to doc move
2019-04-26 23:46:39 -07:00
Vincent Batts
dfcd3ac5ad libvirt/README: fix broken links due to doc move
Signed-off-by: Vincent Batts <vbatts@hashbangbash.com>
2019-04-25 08:43:35 -04:00
Zeeshan Ali
360b5781b6 OWNERS: Setup ownership of libvirt code
This is to give ownership of libvirt backend of Installer to CRC team. For
now I've only added two members from CRC team (myself and Praveen). I also
added two members of Installer team who seem to have been the most active
devs developing the relevant code.

We don't add `libvirt-approvers` for `pkg/types/libvirt`. For reasons:

https://github.com/openshift/installer/pull/1662#issuecomment-485895942
2019-04-24 12:19:18 +02:00
W. Trevor King
5ec2433025 docs: Stronger per-platform isolation
Punt per-platform docs down into platform-specific subdirectories so
we can apply platform-specific OWNERS files.
2019-04-10 12:41:01 -07:00