Chapter 5. Additional Overcloud Configuration Parameters

Version 7.0 A2 of the director includes support for static Provisioning IPs. The systems boot via DHCP during deployment, and the DHCP address assigned converts to a static IP. The following parameters have been added to support static IP addressing on the provisioning network:
  • ControlPlaneIp
  • ControlPlaneSubnetCidr
  • DnsServers
  • EC2MetadataIp
These changes require additional parameters for setting static IPs, routes, and DNS servers. When using static Provisioning IPs, the network environment file now needs to contain additional resource defaults, which you customize to match your environment. For example: 
  parameter_defaults:
    # CIDR subnet mask length for provisioning network
    ControlPlaneSubnetCidr: 24
    # Gateway router for the provisioning network (or Undercloud IP)
    ControlPlaneDefaultRoute:10.8.146.254
    # Generally the IP of the Undercloud
    EC2MetadataIp: 10.8.146.1
    # Define the DNS servers (maximum 2) for the overcloud nodes
    DnsServers:['8.8.8.8','8.8.4.4']
The NIC configuration templates for each role now include additional parameters in the parameters section. Regardless of whether the Provisioning interface uses DHCP or static IPs, these parameters are needed in any case: 
  parameters:
    ControlPlaneIp:
      default: ''
      description: IP address/subnet on the ctlplane network
      type: string
    ControlPlaneSubnetCidr: # Override this via parameter_defaults
      default: '24'
      description: The subnet CIDR of the control plane network.
      type: string
    DnsServers: # Override this via parameter_defaults
      default: []
      description: A list of DNS servers (2 max) to add to resolv.conf.
      type: json
    EC2MetadataIp: # Override this via parameter_defaults
      description: The IP address of the EC2 metadata server.
      type: string
If customizing the templates in the network/config subdirectory of the director's Heat template collection, note that these files are updated with these new parameters. If you have NIC configuration templates from an older version of the director's Heat templates collection, add these new parameters and modify the provisioning network to take advantage of static IP addresses.
For more information, see: