Page History
Add_workflow_for_techpubs | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Panel | ||||
---|---|---|---|---|
In this section:
|
SBC SWe deployments can be instantiated in an OpenStack environment using standard Heat templatesTemplates. A Heat template Template is a .yaml
file that provides essential information to OpenStack that enables creating the VM resources the SBC requires during the orchestration process. An SBC template also includes parameters needed to customize the deployment and to configure essential networking. Parameters can be populated with default values directly in the template or parameter values can be specified when an instance is deployed through user input or in an environment fileEnvironment File. Refer to OpenStack documentation, or documentation from your OpenStack provider, for information on using Heat templatesTemplates.
Spacevars | ||
---|---|---|
|
Comment statements within the examples 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 sample template files.
Heat 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 SBC templates:
- 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), role (ceRole), and cluster configuration mode (ceMode).
- 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.
- OAM settings – if an SBC node is going to be part of a cluster that will use OAM node configuration mode, these parameters identify the IP addresses of the OAM nodes. Refer to SBC SWe Configuration Management.
- Node 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 sample template file examples files for more details on the parameters that can be included in a template file.
Metadata and Userdata
The user data metadata and metadata userdata 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 on OpenStack 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 Environment File along with a template when launching an instance. When included, an environment file 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 Environment File can provide some specific parameter values for the specific instance while the template remains generic. An environment file Environment File cannot be used to provide metadata or userdata. Refer to OpenStack documentation for more information on using environment filesEnvironment Files.
Info | ||
---|---|---|
| ||
In an An HA Heat template, there are Template includes sections to download the Confd CLI config configuration file from a local/remote location. By default, this section is commented out. If the Confd CLI config file needs to be downloaded and automatically loaded CLI is not locally present and you need to download and automatically load the Confd CLI configuration file on the SBC, ensure to uncomment this section must be uncommented, and provide a proper file path must be provided in the Heat templateTemplate. Heat template Template section:
|
Pagebreak |
---|