Skip to content

vmware/esxi-version-vendor-map

Set the ESXi software install acceptance level.

This Param is used by setting the control Param vmware/esxi-version to select-vendor. The template vmware-esxi-selector.tmpl will then use this map to determine the best Vendor specific BootEnv/ISO to install on the system.

The operator can also choose to override this map Param with a set of values specific to use requirements. However, the structure must remain the same, and vendor Manufacturer information must be supported in the vmware-esxi-selector.tmpl template.

To create a unique Param mapping to override these values, set this Param on a Machine object (either via profile or directly), using the following examples:

{
  "generic": {
    "bootenv": "esxi_670u2-13006603_vmware",
    "mfg": "generic"
  },
  "cisco": {
    "bootenv": "esxi_670u1-10302608_cisco",
    "mfg": "cisco"
  }
}

The equivalent YAML format would look like:

generic:
  bootenv: esxi_670u2-13006603_vmware
  mfg: generic
cisco:
  bootenv: esxi_670u1-10302608_cisco
  mfg: cisco

The operator can additionally take advantage of the esxi-install and esxi8-install customizable override bootenvs. The bootenvs all of a more dynamic replacement of iso components.

You can do this:

generic:
  bootenv: esxi8-install
  mfg: generic
  customize:
    OS:
      Version: '8.0.1-0.25.22088125'
      SupportedArchitectures:
        amd64:
          IsoFile: RKN-ESXi-8.0U1c-22088125.iso
          Sha256: 955b9b737cedf6c6a3e022eb05e9207733a8e8f9e8ec008550c2192faa57d5d7
dell:
  bootenv: esxi8-install
  mfg: dell
  customize:
    OS:
      Version: '8.0.1-0.25.22088125'
      SupportedArchitectures:
        amd64:
          IsoFile: RKN-DEL-ESXi_801.22088125-A04.iso
          Sha256: 8abeec6170e8d1b22aed512837b9dd24a4a09a54977388ddfbebe651523ded35

An example of applying this map to a specific Machine as a Param, would be:

# assumes target machine is named just "esxi"
# assumes your map data is in the file named "map.yaml"
drpcli machines set Name:esxi param vmware/esxi-version-vendor-map to map.yaml