mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
704d5642f3
Currently there is no `netplan` support in open-vm-tools. Therefore it's nice to have a quick workaround in our documentation Signed-off-by: Christian Rebischke <chris@nullday.de>
113 lines
3.5 KiB
ReStructuredText
113 lines
3.5 KiB
ReStructuredText
.. _vmware_troubleshooting:
|
|
|
|
**********************************
|
|
Troubleshooting Ansible for VMware
|
|
**********************************
|
|
|
|
.. contents:: Topics
|
|
|
|
This section lists things that can go wrong and possible ways to fix them.
|
|
|
|
Debugging
|
|
=========
|
|
|
|
When debugging or creating a new issue, you will need information about your VMware infrastructure. You can get this information using
|
|
`govc <https://github.com/vmware/govmomi/tree/master/govc>`_, For example:
|
|
|
|
|
|
.. code-block:: bash
|
|
|
|
$ export GOVC_USERNAME=ESXI_OR_VCENTER_USERNAME
|
|
$ export GOVC_PASSWORD=ESXI_OR_VCENTER_PASSWORD
|
|
$ export GOVC_URL=https://ESXI_OR_VCENTER_HOSTNAME:443
|
|
$ govc find /
|
|
|
|
Known issues
|
|
============
|
|
|
|
|
|
Network settings with vmware_guest in Ubuntu 18.04
|
|
--------------------------------------------------
|
|
|
|
Setting the network with ``vmware_guest`` in Ubuntu 18.04 is known to be broken, due to missing support for ``netplan`` in the ``open-vm-tools``.
|
|
This issue is tracked via:
|
|
|
|
* https://github.com/vmware/open-vm-tools/issues/240
|
|
* https://github.com/ansible/ansible/issues/41133
|
|
|
|
Potential Workaround
|
|
^^^^^^^^^^^^^^^^^^^^
|
|
|
|
There are several workarounds for this issue.
|
|
|
|
1) Modifying the Ubuntu 18.04 images and installing ``ifupdown`` in them via ``sudo apt install ifupdown``.
|
|
If so you need to remove ``netplan`` via ``sudo apt remove netplan.io`` and you need stop ``systemd-networkd`` via ``sudo systemctl disable systemctl-networkd``.
|
|
|
|
2) You can generate the ``systemd-networkd`` files with a task in your vmware Ansible role:
|
|
|
|
.. code-block:: yaml
|
|
|
|
- name: make sure cache directory exists
|
|
file: path="{{ inventory_dir }}/cache" state=directory
|
|
delegate_to: localhost
|
|
|
|
- name: generate network templates
|
|
template: src=network.j2 dest="{{ inventory_dir }}/cache/{{ inventory_hostname }}.network"
|
|
delegate_to: localhost
|
|
|
|
- name: copy generated files to vm
|
|
vmware_guest_file_operation:
|
|
hostname: "{{ vmware_general.hostname }}"
|
|
username: "{{ vmware_username }}"
|
|
password: "{{ vmware_password }}"
|
|
datacenter: "{{ vmware_general.datacenter }}"
|
|
validate_certs: "{{ vmware_general.validate_certs }}"
|
|
vm_id: "{{ inventory_hostname }}"
|
|
vm_username: root
|
|
vm_password: "{{ template_password }}"
|
|
copy:
|
|
src: "{{ inventory_dir }}/cache/{{ inventory_hostname }}.network"
|
|
dest: "/etc/systemd/network/ens160.network"
|
|
overwrite: False
|
|
delegate_to: localhost
|
|
|
|
- name: restart systemd-networkd
|
|
vmware_vm_shell:
|
|
hostname: "{{ vmware_general.hostname }}"
|
|
username: "{{ vmware_username }}"
|
|
password: "{{ vmware_password }}"
|
|
datacenter: "{{ vmware_general.datacenter }}"
|
|
folder: /vm
|
|
vm_id: "{{ inventory_hostname}}"
|
|
vm_username: root
|
|
vm_password: "{{ template_password }}"
|
|
vm_shell: /bin/systemctl
|
|
vm_shell_args: " restart systemd-networkd"
|
|
delegate_to: localhost
|
|
|
|
- name: restart systemd-resolved
|
|
vmware_vm_shell:
|
|
hostname: "{{ vmware_general.hostname }}"
|
|
username: "{{ vmware_username }}"
|
|
password: "{{ vmware_password }}"
|
|
datacenter: "{{ vmware_general.datacenter }}"
|
|
folder: /vm
|
|
vm_id: "{{ inventory_hostname}}"
|
|
vm_username: root
|
|
vm_password: "{{ template_password }}"
|
|
vm_shell: /bin/systemctl
|
|
vm_shell_args: " restart systemd-resolved"
|
|
delegate_to: localhost
|
|
|
|
3) Wait for ``netplan`` support in ``open-vm-tools``
|
|
|
|
|
|
Troubleshooting Item
|
|
====================
|
|
|
|
Description
|
|
|
|
Potential Workaround
|
|
--------------------
|
|
|
|
How to fix...
|