Page History

Panel

In this section:

Table of Contents

maxLevel	4

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.

Info
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):

...

Search for EDIT - VIP PORT CREATION section in the fixed_ips property.

Un-comment the parameter - ip_address:

Note

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]}

...

Search for EDIT - PRIVATE PORT CREATION - ACTIVE section.

Un-comment the - ip_address: parameter in the allowed_address_pairs property.

Note

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]}

Search for EDIT - PRIVATE PORT CREATION - STANDBY section.
Repeat step 3 (b).

...

Search for ADD - ADDITIONAL FLOATING IP CREATION section.

Create floating IP as:

Code Block

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

Note
To automatically assign floating IP, comment `floating_ip_address`.

Info
Ignore Step 4 for IPv6 configuration.

...

Code Block

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]}}

Note
"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

SBC SWe Cloud deployments can be instantiated in an OpenStack environment using standard Heat templates. Refer to OpenStack documentation, or documentation from your OpenStack provider, for information on using Heat templates. A Heat template is a .yaml file that provides essential information to OpenStack that enables it to create the VM resources required by the SBC during orchestration. It also includes parameters needed to customize the SBC deployment and to configure essential networking. The parameters can be populated with default values in the template or the parameter values can be specified when an instance is deployed through user input or in an environment file.

Spacevars

0	company

provides a variety of example Heat templates for different types of SBC deployments. Use these example templates as reference to identify parameter input that is required for different SBC deployment characteristics. For example, different examples determine whether the SBC deployment is HA or standalone, whether the deployment uses DHCP, whether the deployment supports dual stack (IPv4 and IPv6), and other deployment variations. One approach is to select the template that is most similar to your intended deployment and then customize it as needed. It could be necessary to combine sections from more than one example template to develop a template that instantiates the specific deployment you want.

Comment statements within the examples also explain how to implement customizations for optional features such as adding additional IP addresses to ports, enabling SR-IOV on an interface, adding a second management port, or implementing packet port redundancy. Refer to the SBC Core release notes for information on how to download the example template files.

Template Parameters

The exact contents required in a template file differs based on the specific characteristics of the intended deployment, but the following parameter categories appear in any SBC template:

System Settings – these parameters include general system setting such as the flavor, image, SBC personality type, SBC system name, and a security_group name.
Instance-specific Settings – these parameters are specific to the instance being instantiated such as the node name (ceName) and role (ceRole).
External and Private Network Settings – these parameters provide information on the external and private networks the SBC will use, such as the names of the networks and settings for the private network subnets.
EMS settings – these parameters identify the IP address and login credentials for accessing the EMS system that will be used to manage the SBC.
SBC login credentials – These parameters specify login details such as the public key for the admin and linuxadmin users and optional passwords for these accounts.

Refer to the template file examples for more details on the parameters that can be included in a template file.

Metadata and Userdata

The user data and metadata sections of the template contain essential configuration information that the SBC VM requires to initialize. Metadata consists primarily of information related to the SBC interfaces such as IP addresses and gateways. Userdata is comprised of user-specified data such as the system name, instance name, and whether the instance should take the active or standby role.The data is stored by the metadata service and retrieved when the instance boots up.

The values in these sections must be provided in a specific format and syntax. Formatting or syntax errors in the template can prevent the VM from booting properly. Refer to Metadata and Userdata Format for the required metadata and userdata formats and descriptions of the parameters. If necessary after instantiation, metadata and userdata can be updated using nova APIs. However any such changes do not take effect until the instance is rebooted.

Environment Files

OpenStack allows you to specify an environment file along with a template when launching an instance. When included, an environment file provides parameter values that are called for by the template and override defaults specified within the template file. If you want to reuse a template file to deploy multiple instances, an environment file can provide some specific parameter values for the specific instance while the template remains generic. An environment file cannot be used to provide metadata or userdata. Refer to OpenStack documentation for more information on using environment files.

Info

title	Note

In an HA heat template, there are sections to download the Confd CLI config file from local/remote location. By default, this section is commented out. If the Confd CLI config file needs to be downloaded and automatically loaded on the SBC, this section must be uncommented, and a proper file path must be provided in the Heat template.

Heat template section:

#personality:

#"baseConfig.cli": {get_file: "RIBBON_BASE_CONFIG.cli"}

#"baseConfig.cli": {get_file: "http://10.11.12.13/sbcCliFiles/RIBBON_BASE_CONFIG.cli"}

If Confd CLI config file is locally present, use the first option of "get_file" and provide the absolute or relative file path.
For example, "baseConfig.cli": {get_file: "RIBBON_BASE_CONFIG.cli"}
If the file is remotely located, use the second option of "get_file" and provide the URL.
For example, "baseConfig.cli": {get_file: "http://10.11.12.13/sbcCliFiles/RIBBON_BASE_CONFIG.cli"}

...

Repeat step 5 (a and b) for Standby instance.

Note
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:

Code Block

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 }

Caption

0	Table
1	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.

...

Pagebreak

Space shortcuts

Page tree

Versions Compared

Old Version 3

New Version Current

Key

Associating Additional IP to Network Port

Template Parameters

Metadata and Userdata

Environment Files