10.18.2. Customizing the MAC pool range


KubeMacPool works by allocating MAC addresses to VMs from a range. The rangeStart and rangeEnd parameters in the HyperConverged custom resource (CR) define the MAC pool range.

As a cluster administrator, you can configure this range to ensure that MAC addresses for VMs hosted on OpenShift Virtualization do not conflict with other virtualization solutions on the same network.

Prerequisites

  • You have cluster administrator access on an OpenShift Container Platform cluster.
  • You have installed the OpenShift CLI (oc).

Procedure

  1. Edit the HyperConverged CR by running the following command:

    $ oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnv
  2. Update the HyperConverged CR to configure the rangeStart and rangeEnd parameters that define your required MAC address range:

    apiVersion: hco.kubevirt.io/v1beta1
    kind: HyperConverged
    metadata:
      name: kubevirt-hyperconverged
    spec:
      kubeMacPoolConfiguration:
        rangeStart: "AA:00:00:00:00:00"
        rangeEnd: "FD:FF:FF:FF:FF:FF"
    # ...

Verification

  1. Run the following command and observe the output:

    $ oc get hco kubevirt-hyperconverged -n openshift-cnv -o=jsonpath='{.spec.kubeMacPoolConfiguration}'

    If you have successfully applied the configuration changes, the output shows the new MAC pool range you have configured:

    Example output:

    {
      "rangeStart": "AA:00:00:00:00:00",
      "rangeEnd": "FD:FF:FF:FF:FF:FF"
    }
  2. Optional. Create a new VM and run the following command to check the MAC address of the VM’s network interface:

    $ oc get vmi <vm-name> -o=jsonpath='{.status.interfaces[0].macAddress}'

    Example output:

    macAddress: AA:00:00:00:00:04

    If you have successfully applied the configuration changes, the macAddress field in the VM interface is within the range you specified in your kubeMacPoolConfiguration, between the value of rangeStart and rangeEnd.

Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

Red Hat ドキュメントについて

Legal Notice

Theme

© 2026 Red Hat
トップに戻る