diff options
| author | Michal Nasiadka <mnasiadka@gmail.com> | 2025-08-07 14:11:55 +0200 |
|---|---|---|
| committer | Michal Nasiadka <mnasiadka@gmail.com> | 2025-08-07 14:42:57 +0000 |
| commit | 8ed9d1511b5ed86c63cd8fbc679a4fd9484b5be7 (patch) | |
| tree | 836bc8a8520d051f4a36489fed886f00aca01293 /doc | |
| parent | 249c33fff1cbc641528c42bc12412cec050c8640 (diff) | |
| download | kolla-ansible-8ed9d1511b5ed86c63cd8fbc679a4fd9484b5be7.tar.gz kolla-ansible-8ed9d1511b5ed86c63cd8fbc679a4fd9484b5be7.zip | |
Drop VMware support
Change-Id: I20a669bf7796285df04723a9110f9c74788600e1
Signed-off-by: Michal Nasiadka <mnasiadka@gmail.com>
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/source/reference/compute/index.rst | 1 | ||||
| -rw-r--r-- | doc/source/reference/compute/nova-guide.rst | 8 | ||||
| -rw-r--r-- | doc/source/reference/compute/vmware-guide.rst | 488 | ||||
| -rw-r--r-- | doc/source/reference/shared-services/glance-guide.rst | 14 | ||||
| -rw-r--r-- | doc/source/reference/storage/cinder-guide.rst | 6 |
5 files changed, 1 insertions, 516 deletions
diff --git a/doc/source/reference/compute/index.rst b/doc/source/reference/compute/index.rst index 822f09b27..d155ffa69 100644 --- a/doc/source/reference/compute/index.rst +++ b/doc/source/reference/compute/index.rst @@ -13,5 +13,4 @@ compute services. nova-cells-guide nova-fake-driver nova-guide - vmware-guide zun-guide diff --git a/doc/source/reference/compute/nova-guide.rst b/doc/source/reference/compute/nova-guide.rst index 464e84abd..3cf5848d4 100644 --- a/doc/source/reference/compute/nova-guide.rst +++ b/doc/source/reference/compute/nova-guide.rst @@ -13,7 +13,7 @@ Virtualisation Drivers ====================== The virtualisation driver may be selected via ``nova_compute_virt_type`` in -``globals.yml``. Supported options are ``qemu``, ``kvm``, and ``vmware``. +``globals.yml``. Supported options are ``qemu`` and ``kvm``. The default is ``kvm``. Libvirt @@ -22,12 +22,6 @@ Libvirt Information on the libvirt-based drivers ``kvm`` and ``qemu`` can be found in :doc:`libvirt-guide`. -VMware ------- - -Information on the VMware-based driver ``vmware`` can be found in -:doc:`vmware-guide`. - Bare Metal ---------- diff --git a/doc/source/reference/compute/vmware-guide.rst b/doc/source/reference/compute/vmware-guide.rst deleted file mode 100644 index a0c162b2c..000000000 --- a/doc/source/reference/compute/vmware-guide.rst +++ /dev/null @@ -1,488 +0,0 @@ -.. _vmware-guide: - -=================================== -VMware - Nova Virtualisation Driver -=================================== - -Overview -~~~~~~~~ - -Kolla can deploy the Nova and Neutron Service(s) for VMware vSphere. -Depending on the network architecture (NsxT, NsxV or DVS) you choose, -Kolla deploys the following OpenStack services for VMware vSphere: - -For VMware NsxT: - -* nova-compute -* neutron-server - -For VMware NsxV: - -* nova-compute -* neutron-server - -For VMware DVS: - -* nova-compute -* neutron-server -* neutron-dhcp-agent -* neutron-metadata-agent - -Kolla can deploy the Glance and Cinder services using VMware datastore as their -backend. -You can create Cinder volumes as VMDKs or as First Class Disks (FCDs). - -An FCD, also known as an Improved Virtual Disk (IVD) or Managed Virtual Disk, -is a named virtual disk independent of a virtual machine. -Using FCDs for Cinder volumes eliminates the need for shadow virtual machines. - -The FCD backend is offered in addition to the default VMDK backend. -If you use FCD as the backend driver for Cinder, you can use both FCD and -VMDK volumes in the same deployment. - -Ceilometer metering for vSphere is also supported. - -Because the `vmware-nsx <https://github.com/openstack/vmware-nsx>`__ drivers for -neutron use completely different architecture than other types of -virtualization, vmware-nsx drivers cannot coexist with other type -of virtualization in one region. In neutron vmware-nsx drivers, -neutron-server acts like an agent to translate OpenStack actions -into what vSphere/NSX Manager API can understand. Neutron does -not directly takes control of the Open vSwitch inside the VMware -environment but through the API exposed by vSphere/NSX Manager. - -.. note:: - - VMware NSX plugin is not in the kolla image by default. - VMware NSX plugin has to be added in the neutron image and - if you are using vmware_dvs also in neutron-dhcp-agent image. - -For VMware DVS, the Neutron DHCP agent does not attaches to Open vSwitch inside -VMware environment, but attach to the Open vSwitch bridge called ``br-dvs`` on -the OpenStack side and replies to/receives DHCP packets through VLAN. Similar -to what the DHCP agent does, Neutron metadata agent attaches to ``br-dvs`` -bridge and works through VLAN. - -.. note:: - - VMware NSX-DVS plugin does not support tenant networks, so all VMs should - attach to Provider VLAN/Flat networks. - -VMware NSX-T -~~~~~~~~~~~~ - -Preparation ------------ - -You should have a working NSX-T environment, this part is out of scope -of Kolla. For more information, please see -`VMware NSX-T documentation <https://docs.vmware.com/en/VMware-NSX-T-Data-Center/index.html/>`__. -The NSX Manager provides a web-based user interface where you can manage -your NSX-T environment. -It also hosts the API server that processes API calls. -The NSX Manager interface provides two modes for configuring resources: - -* Policy mode -* Manager mode - -In Kolla you will have the choice between both with neutron plugin -vmware_nsxv3 for Manager mode and vmware_nsxp for Policy Mode. -For more information, please see -`documentation <https://docs.vmware.com/en/VMware-NSX-T-Data-Center/3.1/installation/GUID-BB26CDC8-2A90-4C7E-9331-643D13FEEC4A.html/>`__. - ------------------------------------------------------------------------------- - -In addition, it is important to modify the firewall rule of vSphere to make -sure that VNC is accessible from outside VMware environment. - -On every VMware host, edit ``/etc/vmware/firewall/vnc.xml`` as below: - -.. code-block:: xml - - <!-- FirewallRule for VNC Console --> - <ConfigRoot> - <service> - <id>VNC</id> - <rule id = '0000'> - <direction>inbound</direction> - <protocol>tcp</protocol> - <porttype>dst</porttype> - <port> - <begin>5900</begin> - <end>5999</end> - </port> - </rule> - <rule id = '0001'> - <direction>outbound</direction> - <protocol>tcp</protocol> - <porttype>dst</porttype> - <port> - <begin>0</begin> - <end>65535</end> - </port> - </rule> - <enabled>true</enabled> - <required>false</required> - </service> - </ConfigRoot> - -Then refresh the firewall config by: - -.. code-block:: console - - # esxcli network firewall refresh - -Verify that the firewall config is applied: - -.. code-block:: console - - # esxcli network firewall ruleset list - ------------------------------------------------------------------------------- - -Deployment ----------- - -The deployment below covers the Policy mode (vmware_nsxp) - -Enable VMware nova-compute plugin and NSX-T neutron-server plugin in -``/etc/kolla/globals.yml``: - -.. code-block:: yaml - - enable_openvswitch: no - nova_compute_virt_type: "vmware" - neutron_plugin_agent: "vmware_nsxp" - -If you want to set VMware datastore as cinder backend, enable it in -``/etc/kolla/globals.yml``: - -.. code-block:: yaml - - enable_cinder: "yes" - cinder_backend_vmwarevc_vmdk: "yes" - vmware_datastore_name: "TestDatastore" - -If you want to set VMware First Class Disk (FCD) datastore -as VMware vStorage Object backend, enable it in -``/etc/kolla/globals.yml``: - -.. code-block:: yaml - - enable_cinder: "yes" - cinder_backend_vmware_vstorage_object: "yes" - vmware_datastore_name: "TestDatastore" - -If you want to set VMware datastore as glance backend, enable it in -``/etc/kolla/globals.yml``: - -.. code-block:: yaml - - glance_backend_vmware: "yes" - vmware_vcenter_name: "TestDatacenter" - vmware_datastore_name: "TestDatastore" - -VMware options are required in ``/etc/kolla/globals.yml``, these options should -be configured correctly according to your NSX-T environment. - -Options for ``nova-compute`` and ``ceilometer``: - -.. code-block:: yaml - - vmware_vcenter_host_ip: "127.0.0.1" - vmware_vcenter_host_username: "admin" - vmware_vcenter_cluster_name: "cluster-1" - vmware_vcenter_insecure: "True" - vmware_vcenter_datastore_regex: ".*" - -.. note:: - - The VMware vCenter password has to be set in ``/etc/kolla/passwords.yml``. - - .. code-block:: yaml - - vmware_vcenter_host_password: "admin" - -Options for Neutron NSX-T support: - -.. code-block:: yaml - - vmware_nsxp_api_user: "admin" - vmware_nsxp_insecure: true - vmware_nsxp_default_tier0_router: "T0-Example" - vmware_nsxp_dhcp_profile: "dhcp-profile-example" - vmware_nsxp_metadata_proxy: "metadata_proxy-example" - vmware_nsxp_api_managers: "nsx-manager.local" - vmware_nsxp_default_vlan_tz: "vlan-tz-example" - vmware_nsxp_default_overlay_tz: "overlay-tz-example" - -.. yaml - -.. note:: - - If you want to set secure connections to VMware, set ``vmware_vcenter_insecure`` - to false. - Secure connections to vCenter requires a CA file, copy the vCenter CA file to - ``/etc/kolla/config/vmware_ca``. - -.. note:: - - The VMware NSX-T password has to be set in ``/etc/kolla/passwords.yml``. - - .. code-block:: yaml - - vmware_nsxp_api_password: "xxxxx" - vmware_nsxp_metadata_proxy_shared_secret: "xxxxx" - -Then you should start :command:`kolla-ansible` deployment normally as -KVM/QEMU deployment. - -VMware NSX-V -~~~~~~~~~~~~ - -Preparation ------------ - -You should have a working NSX-V environment, this part is out of scope -of Kolla. -For more information, please see -`VMware NSX-V documentation <https://docs.vmware.com/en/VMware-NSX-for-vSphere/>`__. - ------------------------------------------------------------------------------- - -In addition, it is important to modify the firewall rule of vSphere to make -sure that VNC is accessible from outside VMware environment. - -On every VMware host, edit ``/etc/vmware/firewall/vnc.xml`` as below: - -.. code-block:: xml - - <!-- FirewallRule for VNC Console --> - <ConfigRoot> - <service> - <id>VNC</id> - <rule id = '0000'> - <direction>inbound</direction> - <protocol>tcp</protocol> - <porttype>dst</porttype> - <port> - <begin>5900</begin> - <end>5999</end> - </port> - </rule> - <rule id = '0001'> - <direction>outbound</direction> - <protocol>tcp</protocol> - <porttype>dst</porttype> - <port> - <begin>0</begin> - <end>65535</end> - </port> - </rule> - <enabled>true</enabled> <required>false</required> - </service> - </ConfigRoot> - -Then refresh the firewall config by: - -.. code-block:: console - - # esxcli network firewall refresh - -Verify that the firewall config is applied: - -.. code-block:: console - - # esxcli network firewall ruleset list - ------------------------------------------------------------------------------- - -Deployment ----------- - -Enable VMware nova-compute plugin and NSX-V neutron-server plugin in -``/etc/kolla/globals.yml``: - -.. code-block:: yaml - - nova_compute_virt_type: "vmware" - neutron_plugin_agent: "vmware_nsxv" - -.. note:: - - VMware NSX-V also supports Neutron FWaaS and VPNaaS services, you can enable - them by setting these options in ``globals.yml``: - - * enable_neutron_vpnaas: "yes" - * enable_neutron_fwaas: "yes" - -If you want to set VMware VMDK datastore as cinder backend, enable it in -``/etc/kolla/globals.yml``: - -.. code-block:: yaml - - enable_cinder: "yes" - cinder_backend_vmwarevc_vmdk: "yes" - vmware_datastore_name: "TestDatastore" - -If you want to set VMware First Class Disk (FCD) datastore -as VMware vStorage Object backend, enable it in -``/etc/kolla/globals.yml``: - -.. code-block:: yaml - - enable_cinder: "yes" - cinder_backend_vmware_vstorage_object: "yes" - vmware_datastore_name: "TestDatastore" - -If you want to set VMware datastore as glance backend, enable it in -``/etc/kolla/globals.yml``: - -.. code-block:: yaml - - glance_backend_vmware: "yes" - vmware_vcenter_name: "TestDatacenter" - vmware_datastore_name: "TestDatastore" - -VMware options are required in ``/etc/kolla/globals.yml``, these options should -be configured correctly according to your NSX-V environment. - -Options for ``nova-compute`` and ``ceilometer``: - -.. code-block:: yaml - - vmware_vcenter_host_ip: "127.0.0.1" - vmware_vcenter_host_username: "admin" - vmware_vcenter_cluster_name: "cluster-1" - vmware_vcenter_insecure: "True" - vmware_vcenter_datastore_regex: ".*" - -.. note:: - - The VMware vCenter password has to be set in ``/etc/kolla/passwords.yml``. - - .. code-block:: yaml - - vmware_vcenter_host_password: "admin" - -Options for Neutron NSX-V support: - -.. code-block:: yaml - - vmware_nsxv_user: "nsx_manager_user" - vmware_nsxv_manager_uri: "https://127.0.0.1" - vmware_nsxv_cluster_moid: "TestCluster" - vmware_nsxv_datacenter_moid: "TestDataCeter" - vmware_nsxv_resource_pool_id: "TestRSGroup" - vmware_nsxv_datastore_id: "TestDataStore" - vmware_nsxv_external_network: "TestDVSPort-Ext" - vmware_nsxv_vdn_scope_id: "TestVDNScope" - vmware_nsxv_dvs_id: "TestDVS" - vmware_nsxv_backup_edge_pool: "service:compact:1:2" - vmware_nsxv_spoofguard_enabled: "false" - vmware_nsxv_metadata_initializer: "false" - vmware_nsxv_edge_ha: "false" - -.. yaml - -.. note:: - - If you want to set secure connections to VMware, set ``vmware_vcenter_insecure`` - to false. - Secure connections to vCenter requires a CA file, copy the vCenter CA file to - ``/etc/kolla/config/vmware_ca``. - -.. note:: - - The VMware NSX-V password has to be set in ``/etc/kolla/passwords.yml``. - - .. code-block:: yaml - - vmware_nsxv_password: "nsx_manager_password" - -Then you should start :command:`kolla-ansible` deployment normally as -KVM/QEMU deployment. - - -VMware NSX-DVS -~~~~~~~~~~~~~~ - -Preparation ------------ - -Before deployment, you should have a working VMware vSphere environment. -Create a cluster and a vSphere Distributed Switch with all the host in the -cluster attached to it. - -For more information, please see -`Setting Up Networking with vSphere Distributed Switches <http://pubs.vmware.com/vsphere-51/index.jsp#com.vmware.vsphere.networking.doc/GUID-375B45C7-684C-4C51-BA3C-70E48DFABF04.html>`__. - -Deployment ----------- - -Enable VMware nova-compute plugin and NSX-V neutron-server plugin in -``/etc/kolla/globals.yml``: - -.. code-block:: yaml - - nova_compute_virt_type: "vmware" - neutron_plugin_agent: "vmware_dvs" - -If you want to set VMware VMDK datastore as cinder backend, enable it in -``/etc/kolla/globals.yml``: - -.. code-block:: yaml - - enable_cinder: "yes" - cinder_backend_vmwarevc_vmdk: "yes" - vmware_datastore_name: "TestDatastore" - -If you want to set VMware First Class Disk (FCD) datastore -as VMware vStorage Object backend, enable it in -``/etc/kolla/globals.yml``: - -.. code-block:: yaml - - enable_cinder: "yes" - cinder_backend_vmware_vstorage_object: "yes" - vmware_datastore_name: "TestDatastore" - -If you want to set VMware datastore as Glance backend, enable it in -``/etc/kolla/globals.yml``: - -.. code-block:: yaml - - glance_backend_vmware: "yes" - vmware_vcenter_name: "TestDatacenter" - vmware_datastore_name: "TestDatastore" - -VMware options are required in ``/etc/kolla/globals.yml``, these options should -be configured correctly according to the vSphere environment you installed -before. All option for nova, cinder, glance are the same as VMware-NSX, except -the following options. - -Options for Neutron NSX-DVS support: - -.. code-block:: yaml - - vmware_dvs_host_ip: "192.168.1.1" - vmware_dvs_host_port: "443" - vmware_dvs_host_username: "admin" - vmware_dvs_dvs_name: "VDS-1" - vmware_dvs_dhcp_override_mac: "" - -.. note:: - - The VMware NSX-DVS password has to be set in ``/etc/kolla/passwords.yml``. - - .. code-block:: yaml - - vmware_dvs_host_password: "password" - -Then you should start :command:`kolla-ansible` deployment normally as -KVM/QEMU deployment. - -For more information on OpenStack vSphere, see -:nova-doc:`VMware vSphere -<admin/configuration/hypervisor-vmware.html>`, -`VMware-NSX package <https://github.com/openstack/vmware-nsx>`_. diff --git a/doc/source/reference/shared-services/glance-guide.rst b/doc/source/reference/shared-services/glance-guide.rst index 03b4c7406..082bd40c6 100644 --- a/doc/source/reference/shared-services/glance-guide.rst +++ b/doc/source/reference/shared-services/glance-guide.rst @@ -15,7 +15,6 @@ backends: * file * ceph -* vmware File backend ~~~~~~~~~~~~ @@ -49,19 +48,6 @@ To enable the ceph backend manually: glance_backend_ceph: "yes" -VMware backend -~~~~~~~~~~~~~~ - -To make use of VMware datastores as a glance backend, -enable `glance_backend_vmware` and refer to :doc:`../compute/vmware-guide` for -further VMware configuration. - -To enable the vmware backend manually: - -.. code-block:: yaml - - glance_backend_vmware: "yes" - Glance with S3 Backend ~~~~~~~~~~~~~~~~~~~~~~ diff --git a/doc/source/reference/storage/cinder-guide.rst b/doc/source/reference/storage/cinder-guide.rst index 5570944a4..9f8a5bf2a 100644 --- a/doc/source/reference/storage/cinder-guide.rst +++ b/doc/source/reference/storage/cinder-guide.rst @@ -275,12 +275,6 @@ that appears in cinder.conf: * - Network File System (NFS) - cinder_backend_nfs_name - nfs-1 - * - VMware Virtual Machine Disk File - - cinder_backend_vmwarevc_vmdk_name - - vmwarevc-vmdk - * - VMware VStorage (Object Storage) - - cinder_backend_vmware_vstorage_object_name - - vmware-vstorage-object * - Quobyte Storage for OpenStack - cinder_backend_quobyte_name - QuobyteHD |
