Editing Heat Template and Meta Data

In this section:

The Heat template queries additional private IP and floating IP when launched as a comma-separated input. The comma-separated IP address list must not have any spaces between the IP addresses as it leads to template-load error.

Associating an additional IP to a network port includes:

Virtual port creation
Private port creation
Floating IP creation (Optional)
Updating Meta data
Enabling SR-IOV on Packet Ports (Pkt0 and Pkt1)

This section lists the steps required to edit the template file to associate additional IP for a port and to assign floating IP.

The template file also lists the steps to edit for multiple IP support.

Associating Additional IP to Network Port

To associate an additional IP to a network port (PKT0 or PKT1):

Open the template file in vi editor.
To create virtual ports:
1. Search for EDIT - VIP PORT CREATION section in the fixed_ips property.
2. Un-comment the parameter - ip_address:
  
  The number of - IP address parameters depends on the number of IP address. For example, to add four IP address to PKT0 you must have four - IP address parameters such as:
  - ip_address: {get_param: [pkt0_vips,0]}
  - ip_address: {get_param: [pkt0_vips,1]}
  - ip_address: {get_param: [pkt0_vips,2]}
  - ip_address: {get_param: [pkt0_vips,3]}
To create allowed address pairs for fixed IPs:
1. Search for EDIT - PRIVATE PORT CREATION - ACTIVE section.
2. Un-comment the - ip_address: parameter in the allowed_address_pairs property.
  
  The number of - IP address parameters depends on the number of IP address. For example, to add four IP address for PKT0 you must have four - IP address parameters such as:
  - ip_address: {get_param: [pkt0_vips,0]}
  - ip_address: {get_param: [pkt0_vips,1]}
  - ip_address: {get_param: [pkt0_vips,2]}
  - ip_address: {get_param: [pkt0_vips,3]}
3. Search for EDIT - PRIVATE PORT CREATION - STANDBY section.
4. Repeat step 3 (b).
To associate floating IP for fixed IP (Optional):
1. Search for ADD - ADDITIONAL FLOATING IP CREATION section.
2. Create floating IP as:
```
pktX_floating_ip_A:
            type: OS::Neutron::FloatingIP
            properties:
              floating_network: { get_param: pktX_ext_network }
              port_id: { get_resource: pktX_vip_port }
              fixed_ip_address: {get_param: [pktX_vips,Y]}
              floating_ip_address: {get_param: [additional_Fips_pktX,Z]}
```
  where X is set to 0 for PKT0 and 1 for PKT1
  Y is set to 0 to (n-1) where, n is the number of PKT IP address
  Z is set to 0 to (m-1) where, m is the number of floating IP address
  
  To automatically assign floating IP, comment floating_ip_address.
  
  Ignore Step 4 for IPv6 configuration.
To update meta data:
1. Search for METADATA_APPEND_ABOVE section.
2. Append With Floating IP Format and Without Floating IP Format sections in METADATA_APPEND_ABOVE section:
```
With Floating IP Format:
ALT_PKTX_01: { "IFName": "YYY", "IP": {get_param: [pktX_vips,0]}, "FIPV4": { get_attr: [pktX_floating_ip_A, floating_ip_address] } }
 
Without Floating IP Format:
ALT_PKTX_01: { "IFName": "YYY", "IP": {get_param: [pktX_vips,0]}}
```
```
"With Floating IP Format" is not applicable for IPv6.
```
  where X is set to 0 or 1 for PKT
  ALT_PKTX_01 is the alternate IP name or meta key name
  YYY is IF name of PKT ports for example, IF2 for PKT0
  pktX_floating_ip_A is the IP names created earlier
3. Repeat step 5 (a and b) for Standby instance.
  
  The maximum length of the alternate IP name or meta key name is 23 characters.

To enable SR-IOV on packet ports:

Search for PKT0 and PKT1 interface ports. Edit the ports information section:

pkt0_port1:
    type: OS::Neutron::Port
    properties:
      network: { get_param : private_network_pkt0 }
      fixed_ips:
        # pkt0 EDIT: uncomment below line to DISABLE DHCP or comment to ENABLE DHCP
        - ip_address: { get_param: PKT0IPv4}
        #- ip_address: { get_param: PKT1IPv4}        
        #- ip_address: {get_param: [pkt0_alt_ips,0]}
        #- ip_address: {get_param: [pkt0_alt_ips,1]}
 
        # pkt1 EDIT: uncomment below line to ENABLE DHCP or comment to DISABLE DHCP
        #- subnet: { get_param: private_subnet_pkt0}
 
      #binding:vnic_type: direct
 
      security_groups:
        - { get_param: security_group }

Input Parameter Details for createPorts Function

Parameter	Type	Mandatory (Yes/No)	Description
network	string	No	The network ID.
subnet	string	No	The subnet Id on the "network".
security_group	List of string	No	The IDs of the security group.
allowed_address_pairs	List<Map<String,String>>	No	A set of zero or more allowed address pairs, map keys are "ip_address" and "mac_address". Example: allowed_address_pairs: [{ip_address: "10.2.0.1"}]
vnic_type	string	No	Indicates the vNIC type to be bound on the neutron port. Default value - Normal Values: Normal Direct If you are using SR-IOV and PCI-Passthrough, select Direct. Change the `virtualNICType` to direct. It only works for Neutron deployments that support the bindings extension.

The "binding:vnic_type" must be same for all packet ports.

Space shortcuts

Page tree

Associating Additional IP to Network Port