diff --git a/docs/install/harvester-configuration.md b/docs/install/harvester-configuration.md index 5e1c5f61e5..3c4375ad68 100644 --- a/docs/install/harvester-configuration.md +++ b/docs/install/harvester-configuration.md @@ -73,6 +73,9 @@ install: vip: 10.10.0.19 vip_hw_addr: 52:54:00:ec:0e:0b vip_mode: dhcp + cluster_pod_cidr: 10.52.0.0/16 + cluster_service_cidr: 10.53.0.0/16 + cluster_dns_ip: 10.53.0.10 force_mbr: false addons: harvester_vm_import_controller: @@ -728,6 +731,57 @@ install: vip_hw_addr: 52:54:00:ec:0e:0b ``` +### `install.cluster_pod_cidr` + +**Definition**: CIDR of the Harvester pods. + +Use this field to override the default pod CIDR of 10.52.0.0/16. + +**Example**: + +```yaml +install: + cluster_pod_cidr: 172.16.0.0/16 +``` + +### `install.cluster_service_cidr` + +**Definition**: CIDR of the Harvester services. + +Use this field to override the default service CIDR of 10.53.0.0/16. + +:::info important + +If you change this CIDR, you must ensure that the cluster DNS IP (`install.cluster_dns`) is within this range. + +::: + +**Example**: + +```yaml +install: + cluster_service_cidr: 172.22.0.0/16 +``` + +### `install.cluster_dns` + +**Definition**: IP of the Harvester DNS service. + +Use this field to override the default DNS service IP of 10.53.0.10. + +:::info important + +This IP must be within the range defined by the `cluster_service_cidr` field. + +::: + +**Example**: + +```yaml +install: + cluster_dns: 172.16.0.10 +``` + ### `install.webhooks` **Definition**: Webhooks that allow you to receive notifications for certain installer-related events. diff --git a/docs/install/iso-install.md b/docs/install/iso-install.md index 3f64d1cebb..7c55ba2a60 100644 --- a/docs/install/iso-install.md +++ b/docs/install/iso-install.md @@ -87,6 +87,26 @@ The following [video](https://youtu.be/X0VIGZ_lExQ) shows a quick overview of an For more information, see [DHCP Server Configuration](./pxe-boot-install.md#dhcp-server-configuration). ::: +1. (Optional) Configure the CIDRs for the cluster pods and services. + + If you want to use the default values, leave the fields blank. + + ![config-cluster-cidrs.png](/img/v1.5/install/config-cluster-cidrs.png) + + :::info important + + The CIDR values must not overlap and must be within the private IP address range of 10.0.0.0/8, 172.16.0.0/12, or 192.168.0.0/16. + + The DNS service IP must be within the range defined by the **Service CIDR** field. + + ::: + + Example of a valid CIDR configuration: + + - **Pod CIDR**: 172.16.0.0/16 + - **Service CIDR**: 172.22.0.0/16 + - **Cluster DNS IP**: 172.22.0.10 + 1. (Optional) Configure the `DNS Servers`. Use commas as a delimiter to add more DNS servers. Leave it blank to use the default DNS server. ![config-dns-server.png](/img/v1.2/install/config-dns-server.png) @@ -94,10 +114,10 @@ The following [video](https://youtu.be/X0VIGZ_lExQ) shows a quick overview of an 1. Configure the virtual IP (VIP) by selecting a `VIP Mode`. This VIP is used to access the cluster or for other nodes to join the cluster. :::note - If using DHCP to configure the IP address, you need to configure a static MAC-to-IP address mapping on your DHCP server to have a persistent virtual IP (VIP), and the VIP must be unique. + For DHCP setup with static MAC-to-IP address mappings configured, enter the MAC address in the provided field to fetch the unique persistent virtual IP (VIP). Otherwise, leave it blank. ::: - ![config-virtual-ip.png](/img/v1.2/install/config-virtual-ip.png) + ![config-virtual-ip.png](/img/v1.5/install/config-virtual-ip.png) 1. Configure the `Cluster token`. This token is used for adding other nodes to the cluster. diff --git a/static/img/v1.5/install/config-cluster-cidrs.png b/static/img/v1.5/install/config-cluster-cidrs.png new file mode 100644 index 0000000000..7ed485b750 Binary files /dev/null and b/static/img/v1.5/install/config-cluster-cidrs.png differ diff --git a/static/img/v1.5/install/config-virtual-ip.png b/static/img/v1.5/install/config-virtual-ip.png new file mode 100644 index 0000000000..fdfe26a852 Binary files /dev/null and b/static/img/v1.5/install/config-virtual-ip.png differ