Host network requirements
Review the following requirements that relate to the network setup of host machines.
You can verify your host setup with the satellite-host-check
script. For more information, see Checking your host setup.
Networking configurations
In general, do not set any custom networking configurations on your hosts, such as network manager scripts, dnsmasq
setups, custom IP table rules, or custom MTU settings like jumbo frames.
All hosts must meet the following network requirements:
-
The
localhost
value must resolve to a valid local host IP address, typically127.0.0.1
. -
You cannot use custom iptables to route traffic to the public or private network, because default Satellite and Calico policies override custom iptables.
-
The following IP address ranges are reserved, and must not be used in any of the networks that you want to use in IBM Cloud Satellite, including the host networks.
Non-CoreOS enabled locations:
172.16.0.0/16, 172.18.0.0/16, 172.19.0.0/16, 172.20.0.0/16, and 192.168.255.0/24
CoreOS enabled locations:
172.20.0.0/16 and 172.16.0.0/16
-
Host IP addresses must remain static and cannot change over time, such as due to a reboot or other potential infrastructure updates.
-
If you are provisioning your host on-prem, you must configure your host to use a public DNS server, such as
8.8.8.8
. You can use a private DNS server, but it must be able to resolve hostnames on the public Internet.
Hosts assigned to a specific Red Hat OpenShift cluster or to the control plane must share some properties, which can be different across clusters.
- All Satellite hosts must have the same MTU values.
- Hosts must have TCP/UDP/ICMP Layer 3 connectivity for all ports across hosts. You cannot block certain ports that might block communication across hosts.
Host network bandwidth
- The hosts must have minimum network bandwidth connectivity of 100 Mbps, with 1 Gbps preferred.
- The bandwidth required between hosts varies with the number of clusters in the location, and the workloads that run in the cluster. Insufficient network bandwidth can lead to network performance problems.
Network gateways and interfaces
- Satellite does not support IPv6.
- All Satellite hosts must have an IPv4 address that can access
containers.cloud.ibm.com
and must have full IPv4 backend connectivity to the other hosts in the same cluster in the location. - Hosts can use gateways to connect to the location control plane.
Inbound connectivity requirements for Satellite hosts
Hosts must have inbound connectivity on the primary network interface through the default gateway or firewall the system. Hosts that are assigned to the same service; for example, the same cluster, must be able to talk to each other and with the Satellite control plane.
For example, if the primary network interface for a host is eth0
, you must open the following required IP addresses and ports on the default gateway or firewall on the eth0
private network interface.
Description | Source IP | Destination IP | Protocol and ports |
---|---|---|---|
Allow hosts that are assigned to the same service in your location to communicate with each other and with the Satellite control plane | All Satellite hosts | All Satellite hosts | All ports and protocols |
Access the API to make changes in a Red Hat OpenShift cluster and access the Red Hat OpenShift web console or through the Red Hat OpenShift router | Clients or authorized users | Control plane hosts | TCP 30000 - 32767 |
Access the web console for a Red Hat OpenShift cluster through the Red Hat OpenShift router | Clients or authorized users | Red Hat OpenShift cluster hosts | TCP 443 |
Outbound connectivity requirements for Satellite Connector
For Satellite Connector outbound connectivity requirements, see Network requirements.