Using Cloud-init to run the Initial Setup on SBC SWe Lite

In this section:

Overview

Note

When you run the SWe Lite on Azure and see the initial cloud-init Welcome Wizard while logging into the Web UI, wait for two to three minutes to allow cloud-init to finish configuring the node.

The SBC SWe Lite supports the cloud-init function, which allows public clouds (such as Azure and AWS) to support automation. The cloud-init functionality allows the SBC SWe Lite to automatically deploy within an orchestrated environment. Cloud-init enables the user_data file to send the initial setup information to the VM, which creates SBC SWe Lite instances in an orchestrated manner.

The SBC SWe Lite supports only the config-drive and metadata server data sources. When the system initially boots, the SBC SWe Lite searches for block devices (such as a CDROM, hard drive, USB device) with the label config-2.

Note

Cloud-init provides an alternative method to running Initial Setup on the SBC SWe Lite. For details on running Initial setup, refer to Running Initial Setup on SBC SWe Lite.

The cloud-init function is supported on all SWe Lite platforms.

If the SBC SWe Lite finds a block device with the correct label, it attempts to mount with either the vfat or iso9660 file system. The SBC SWe Lite will also process the following files and directories from the config-drive:

openstack/
- 2012-08-10/ or latest/
  - meta_data.json
  - user_data (not mandatory)
- content/
  - 0000 (referenced content files)
  - 0001
ec2
- latest/
  - meta_data.json (not mandatory)

If the SBC SWe Lite does not find a block device with the correct label, it attempts auto configuration on mgt0 and performs a REST query to the metadata server at the 169.254.169.254 IP address.

To create a config-drive image, you must configure the user_data file in the ISO image (see Creating a Config-drive Image). The user_data file contains the initial configuration data that the VNF uses for auto configuration.

Configuration Notes

Both the user_data and user-data file formats are supported.
The cloud-init function
- only triggers when no user logins are configured in the system. The cloud-init function does not impact an already configured system.
- attempts to configure the system with the supported data sources until the initial system is configured with either the cloud-init mechanism or through the WebUI. This function adds a 10 to 15 second delay at boot time.
The ISO file is only required for the initial boot of the SBC SWe Lite.

Creating a Config-drive Image

During the SBC SWe Lite installation, manually create a config-drive image.

To Create a Config-drive Image

Use the following procedure to manually create a config-drive image.

Configuration Notes

If you set up an IP address and netmask on any interface, the interface becomes static.

Log into an external Linux-based system.

Enter the following commands to navigate to the appropriate directory and create the folder structure.

mkdir config_drive
mkdir config_drive/openstack
mkdir config_drive/openstack/<creation date>
cd config_drive/openstack/
ln -s <creation date> latest

Enter the following command to navigate to the appropriate directory.
```
cd config_drive/openstack/latest
```
Enter the uuid information in the meta_data.json file using the following format, where <SBC_SWe_Lite_FQDN> is the FQDN of the node you want configured (for example, instance1.mydomain.com).
```
{
<uuid>: <SBC_SWe_Lite_FQDN>
}
```

Create the user_data file. Use the following example to create the user_data file specific to the system you want configured. For the list of supported user_data file parameters, refer to the User_data File Parameters table.

Example

{
         
    "setup": {
            "admin_account": {
                "adminUserName": "admin",
                "adminUserPassword": "admin"
            },
            "rest_account": {
                "restUserName": "rest_user",
                "restUserPassword": "rest_password"
            },
			"netconfig_account": {
                "netconfigUserPassword": "netconfig_password"
            },
            "dns": {
                "primaryDNSServerIP": "125.62.150.2",
                "secondaryDNSServerIP": "125.62.150.3",
                "hostName": "SWELite-123",
                "domainName": "rbbn.com"
            },
            "staticroute": {
                "defaultGateway": "10.0.1.1",
                "route1": {
                    "ipDestinationAddr1": "176.159.22.32",
                    "ipDestinationMask1": "255.255.255.255",
                    "ipNexthopAddress1": "10.0.0.1",
                    "ipStaticRouteMetric1": "1"
                }
            },
            "syslog": {
                "ServerAddress": "1.1.1.1"
            },
            "ntp": {
                "Ntp1ServerName": "10.253.6.92",
                "IsNtp1AuthEnabled": "1",
                "Ntp1ServerKeyId": "10",
                "Ntp1ServerKey": "10"
            },
            "mgt0": {
                "adminIPAddress": "10.21.150.3",
                "adminNetmask": "255.255.128.0",
                "MACAddress": "52:54:00:51:2E:4C"
            },
            "pkt0": {
                "applicationIPV4Address": "192.168.21.2",
                "applicationIPV4Netmask": "255.255.255.0",
                "MACAddress": "52:54:00:51:47:4D",
                "NextHopIP1": "192.168.21.1"
            },
            "pkt1": {
                "eth2DHCPSuppliedParamUsage": "2",
                "NextHopIP2": "10.0.1.1"
            },
            "pkt2": {
                "eth3DHCPSuppliedParamUsage": "2",
                "NextHopIP3": "10.0.1.1"
            },
            "pkt3": {
                "eth4DHCPSuppliedParamUsage": "2", 
                "NextHopIP4": "10.0.1.1"
			},
			"edgeview": {
  				"EdgeviewFQDNName": "ev.mydomain.com",
				"EdgeviewManagementID": "45:34:56:23:45"
            }
        }
}

The following table outlines the possible parameters of the user_data file.

User_data File Parameters

Parameter Name	Mandatory	Data Type	Default Value	Possible Values	Description
`dns`	N/A	N/A	N/A	N/A	A container that defines the DNS server details.
`hostName`	No	String	None	64 to maximum length	Specifies a hostname for the SBC Edge. The combination of the host and domain names is the FQDN, which must not exceed 255 characters. If the FQDN is not provided then the default hostname is the node serial number.
`domainName`	No	String	None	255 to maximum length	Specifies a domain name for the SBC Edge, which the SBC uses only if the IP addressing is static. The combination of the host and domain names is the FQDN, which must not exceed 255 characters.
`primaryDNSServerIP`	No	String	None	15 to maximum length	Sets the IP address (IPv4 format) of the primary DNS server. This field does not apply if the `ifIpAddrAssignMethod` parameter is set to dynamic. Setting this field to empty (with static addressing) disables the primary DNS server.
`secondaryDNSServerIP`	No	String	None	15 to maximum length	Sets the IP address (IPv4 format) of the secondary DNS server. This field does not apply if the `ifIpAddrAssignMethod` parameter is set to dynamic. Setting this field to empty (with static addressing) disables the secondary DNS server.
`admin_account`	Yes	N/A	N/A	N/A	A container that defines the admin user configurations.
`adminUserName`	Yes	String	None	32 to maximum length	Specifies an administrative username to use in subsequent logins.
`adminUserPassword`	Yes	String	None	128 to maximum length	Specifies an administrative user password to use in subsequent logins.
`netconfig_account`	No	String	None	N/A	A container that defines the netconfig configuration. NOTE: Only Release 8.0.3 and later support the `netconfig_account` configuration.
`netconfigUserPassword`	No	String	None	N/A	Overrides the default netconfig password and allows you to set the system without a hardcoded password.
`rest_account`	N/A	N/A	N/A	N/A	A container that defines the rest account configuration.
`restUserName`	No	String	None	32 to maximum length	Specifies a REST username to use in subsequent authentications. If this parameter and the `restUserPassword` are either empty or not provided, then the SBC does not set up the node for REST access until you create a REST user from the UI.
`restUserPassword`	No	String	None	128 to maximum length	Specifies a REST user password to use in subsequent authentications. If this parameter and the `restUserName` are either empty or not provided, then the SBC does not set up the node for REST access until you create a REST user from the UI.
`mgt0`	Yes	N/A	N/A	N/A	A container that defines the management interface.
`adminIpAddrAssignMethod`	No	Enum	0	0 - static 1 - dynamic	Determines whether the specific mgt0 settings are configured dynamically (through DHCP) or statically.
`adminIPAddress`	No	String	None	15 to maximum length	Sets the admin IP address. This field does not apply if the `adminIpAddrAssignMethod` parameter is set to dynamic. For static addressing, you must use a valid IPv4 address for the `adminIPAddress` parameter.
`adminNetmask`	No	String	None	15 to maximum length	Sets the admin IP subnet. This field does not apply if the `adminIpAddrAssignMethod` parameter is set to dynamic. For static addressing, you must use a valid IPv4 subnet for the `adminNetmask` parameter.
`adminDHCPSuppliedParamUsage`	No	Enum	0	0 - USE_ALL 1 - USE_IP_ONLY 2 - USE_IP_DNS_ONLY	Determines how the SBC uses the parameters that the DHCP server supplies when a logical interface is configured with Dynamic IP addressing. USE_ALL - The SBC uses all supported DHCP parameters. The SBC uses the supplied DNS servers as global DNS servers, which replace the currently configured DNS servers. This configuration does not affect the split-DNS settings. USE_IP_ONLY - The SBC uses only the IP address and netmask. This configuration ignores the DNS server and other settings, and does not affect the current split-DNS settings. USE_IP_DNS_ONLY - The SBC uses only the IP address, domain-name, and DNS server IP addresses. The SBC uses the supplied domain-name and the DNS server IP addresses depending on the value of the `ConfigureSplitDNS` parameter. NOTE: If you add the `adminDHCPSuppliedParamUsage` parameter on any interface, the interface becomes dynamic.
`pkt0`	Yes	N/A	N/A	N/A	A container that defines the first packet network for voice traffic.
`applicationIpAddrAssignMethod`	No	Enum	0	0 - static 1 - dynamic	Determines whether the specific node-level settings are configured dynamically (through DHCP) or statically.
`applicationIPV4Address`	No	String	None	15 to maximum length	Sets the Ethernet 1 IP address. This field does not apply if the `applicationIpAddrAssignMethod` parameter is set to dynamic. For static addressing, you must use a valid IPv4 address for the `applicationIPV4Address` parameter.
`applicationIPV4Netmask`	No	String	None	15 to maximum length	Sets the Ethernet 1 IP subnet. This field does not apply if the `eth1IpAddrAssignMethod` parameter is set to dynamic. For static addressing, you must use a valid IPv4 subnet for the `applicationIPV4Netmask` parameter.
`applicationDHCPSuppliedParamUsage`	No	Enum	0	0 - USE_ALL 1 - USE_IP_ONLY 2 - USE_IP_DNS_ONLY	Determines how the SBC uses the parameters that the DHCP server supplies when a logical interface is configured with Dynamic IP addressing. USE_ALL - The SBC uses all supported DHCP parameters. The SBC uses the supplied DNS servers as global DNS servers, which replace the currently configured DNS servers. This configuration does not affect the split-DNS settings. USE_IP_ONLY - The SBC uses only the IP address and netmask. This configuration ignores the DNS server and other settings, and does not affect the current split-DNS settings. USE_IP_DNS_ONLY - The SBC uses only the IP address, domain-name, and DNS server IP addresses. The SBC uses the supplied domain-name and the DNS server IP addresses depending on the value of the `ConfigureSplitDNS` parameter.
`NextHopIP1`	No	String	None	15 to maximum length	Specifies the Eth1 next hop IP address.
`pkt1`	N/A	N/A	N/A	N/A	Defines the second packet network for voice traffic.
`eth2IpAddrAssignMethod`	No	Enum	0	0 - static 1 - dynamic	Determines whether the specific node-level settings are configured dynamically (through DHCP) or statically.
`eth2IPV4Address`	No	String	None	15 to maximum length	Sets the Ethernet 1 IP address. This field does not apply if the `eth2IpAddrAssignMethod` parameter is set to dynamic. For static addressing, you must use a valid IPv4 address for the `eth2IPV4Address` parameter.
`eth2IPV4Netmask`	No	String	None	15 to maximum length	Sets the Ethernet 1 IP subnet. This field does not apply if the `eth2IpAddrAssignMethod` parameter is set to dynamic. For static addressing, you must use a valid IPv4 subnet for the `eth2IPV4Netmask` parameter.
`eth2DHCPSuppliedParamUsage`	No	Enum	0	0 - USE_ALL 1 - USE_IP_ONLY 2 - USE_IP_DNS_ONLY	Determines how the SBC uses the parameters that the DHCP server supplies when a logical interface is configured with Dynamic IP addressing. USE_ALL - The SBC uses all supported DHCP parameters. The SBC uses the supplied DNS servers as global DNS servers, which replace the currently configured DNS servers. This configuration does not affect the split-DNS settings. USE_IP_ONLY - The SBC uses only the IP address and netmask. This configuration ignores the DNS server and other settings, and does not affect the current split-DNS settings. USE_IP_DNS_ONLY - The SBC uses only the IP address, domain-name, and DNS server IP addresses. The SBC uses the supplied domain-name and the DNS server IP addresses depending on the value of the `ConfigureSplitDNS` parameter.
`NextHopIP2`	No	String	None	15 to maximum length	Specifies the Eth2 next hop IP address.
`pkt2`	N/A	N/A	N/A	N/A	Defines the third packet network for voice traffic.
`eth3IpAddrAssignMethod`	No	Enum	0	0 - static 1 - dynamic	Determines whether the specific node-level settings are configured dynamically (through DHCP) or statically.
`eth3IPV4Address`	No	String	None	15 to maximum length	Sets the Ethernet 1 IP address. This field does not apply if the `eth3IpAddrAssignMethod` parameter is set to dynamic. For static addressing, you must use a valid IPv4 address for the `eth3IPV4Address` parameter.
`eth3IPV4Netmask`	No	String	None	15 to maximum length	Sets the Ethernet 1 IP subnet. This field does not apply if the `eth3IpAddrAssignMethod` parameter is set to dynamic. For static addressing, you must use a valid IPv4 subnet for the `eth3IPV4Netmask` parameter.
`eth3DHCPSuppliedParamUsage`	No	Enum	0	0 - USE_ALL 1 - USE_IP_ONLY 2 - USE_IP_DNS_ONLY	Determines how the SBC uses the parameters that the DHCP server supplies when a logical interface is configured with Dynamic IP addressing. USE_ALL - The SBC uses all supported DHCP parameters. The SBC uses the supplied DNS servers as global DNS servers, which replace the currently configured DNS servers. This configuration does not affect the split-DNS settings. USE_IP_ONLY - The SBC uses only the IP address and netmask. This configuration ignores the DNS server and other settings, and does not affect the current split-DNS settings. USE_IP_DNS_ONLY - The SBC uses only the IP address, domain-name, and DNS server IP addresses. The SBC uses the supplied domain-name and the DNS server IP addresses depending on the value of the `ConfigureSplitDNS` parameter.
`NextHopIP3`	No	String	None	15 to maximum length	Specifies the Eth3 next hop IP address.
`pkt3`	N/A	N/A	N/A	N/A	Defines the fourth packet network for voice traffic.
`eth4IpAddrAssignMethod`	No	Enum	0	0 - static 1 - dynamic	Determines whether the specific node-level settings are configured dynamically (through DHCP) or statically.
`eth4IPV4Address`	No	String	None	15 to maximum length	Sets the Ethernet 1 IP address. This field does not apply if the `eth4IpAddrAssignMethod` parameter is set to dynamic. For static addressing, you must use a valid IPv4 address for the `eth4IPV4Address` parameter.
`eth4IPV4Netmask`	No	String	None	15 to maximum length	Sets the Ethernet 1 IP subnet. This field does not apply if the `eth4IpAddrAssignMethod` parameter is set to dynamic. For static addressing, you must use a valid IPv4 subnet for the `eth4IPV4Netmask` parameter.
`eth4DHCPSuppliedParamUsage`	No	Enum	0	0 - USE_ALL 1 - USE_IP_ONLY 2 - USE_IP_DNS_ONLY	Determines how the SBC uses the parameters that the DHCP server supplies when a logical interface is configured with Dynamic IP addressing. USE_ALL - The SBC uses all supported DHCP parameters. The SBC uses the supplied DNS servers as global DNS servers, which replace the currently configured DNS servers. This configuration does not affect the split-DNS settings. USE_IP_ONLY - The SBC uses only the IP address and netmask. This configuration ignores the DNS server and other settings, and does not affect the current split-DNS settings. USE_IP_DNS_ONLY - The SBC uses only the IP address, domain-name, and DNS server IP addresses. The SBC uses the supplied domain-name and the DNS server IP addresses depending on the value of the `ConfigureSplitDNS` parameter.
`NextHopIP4`	No	String	None	15 to maximum length	Specifies the Eth4 next hop IP address.
`syslog`	N/A	N/A	N/A	N/A	A container that defines the syslog server configuration.
`ServerAddress`	No	String	None	128 to maximum length	Specifies the IP address or FQDN of the Syslog server where the SBC sends log entries. If this field is empty then the SBC does not add a Syslog server.
`ServerPort`	Yes	Integer	514	514 to minimum 65534 to maximum	Specifies the Syslog server port number where the SBC sends log entries.
`ServerTransport`	Yes	Enum	0	0 - stUDP 1 - stTCP	Specifies the protocol that the SBC uses to send log entries to the Syslog server.
`DefaultLevel`	No	Enum	4	0 - llDefault 1 - llTrace 2 - llDebug 3 - llInfo 4 - llWarn 5 - llError 6 - llFatal 7 - llOff	Controls the default minimum severity level of messages sent to this server. You can override this default value on a per-system basis through the Subsystems Configuration. The Informational setting produces the most output and the Fatal setting produces the least output. The more output there is the more the parameter impacts system performance. NOTE: The following are valid values for the DefaultLevel: 3 - Informational 4 - Warning 5 - Error 6 - Fatal
`ntp`	No	N/A	N/A	N/A	A container that defines the NTP server configuration.
`Ntp1ServerName`	No	String	None	255 to maximum length	Configures the hostname, IP, or IPv6 address of the first configured NTP server. If the hostname is supplied, the system uses the DNS to connect to the NTP server. NOTE: The SBC uses this parameter only when the `useDynamicNetSettings` parameter is set to false. If `useDynamicNetSettings` is set to true, the first configured NTP server is in the runtime `rt_NTPServer1` parameter.
`IsNtp1AuthEnabled`	No	Enum	0	0 - btFalse 1 - btTrue	Enables or disables the authentication of the first NTP server. NOTE: The SBC uses this parameter only when the `useDynamicNetSettings` parameter is set to false.
`Ntp1ServerKeyId`	No	Integer	0	0 - Minimum 2147483647 - Maximum	Configures the MD5 Key ID to authenticate the first NTP server 0, which is the system default value when the NTP server is not configured. If you configure the NTP server you must use a value higher than 0. NOTE: The SBC uses this parameter only when the `useDynamicNetSettings` parameter is set to false.
`Ntp1ServerKey`	No	String	None	64 to maximum length	Configures the MD5 key to authenticate the first NTP server. NOTE: The SBC uses this parameter only when the `useDynamicNetSettings` parameter is set to false.
`staticroute`	No	N/A	N/A	N/A	A container that defines the defaultgateway and route1 configurations.
`defaultGateway`	No	String	None	15 to maximum length	Specifies the gateway IP address. This parameter is a member of the staticroute container.
`route1`	No	N/A	N/A	N/A	A container that defines the route configurations. This container is a member of the staticroute container.
`ipDestinationAddr1`	No	String	None	15 to maximum length	Specifies the destination IP address. This parameter is a member of the route1 container.
`ipDestinationMask1`	No	String	None	15 to maximum length	Sets the subnet mask for the `ipDestinationAddr1` parameter. This parameter is a member of the route1 container.
`ipNexthopAddress1`	No	String	None	15 to maximum length	Specifies the next hop IP address. This parameter is a member of the route1 container.
`ipStaticRouteMetric1`	No	String	None	15 to maximum length	Specifies the route cost metric value. This parameter is a member of the route1 container.
`edgeview`	No	Boolean	0	0 - Disable 1- Enable	Enable or disable the configuration. NOTE: When you enable this parameter, the `EdgeviewFQDNName` and `EdgeviewManagementID` parameters are mandatory.
`EdgeviewFQDNName`	Yes	String	None	15 to 255 characters	The EdgeView server address (IP address or FQDN).
`EdgeviewManagementID`	Yes	String	None	N/A	CAUTION: When you enter the EdgeView Management ID, you must insert a colon every two characters (00:00:00). Otherwise, the SBC SWe Lite cannot connect to the EdgeView. The EdgeView Management ID. For information about retrieving the EdgeView Management ID, refer to Obtaining and Installing an SBC SWe Lite Production License.
`MACAddress`	No	String	None	N/A	It is optional to enter the MACAddress information of the interface objects (mgt0, pkt0, pkt1, pkt2, and pkt3). If you provide this information, the cloud-init function performs the interface mapping based on the supplied MAC addresses. If you do not provide this information, the interface mapping is performed using the default PCI order. NOTE: You must include the MACAddress information to perform interface mapping.

Enter the following command to save the ISO file.

mkisofs -R -V config-2 -o vendorconfig.iso config_drive

After you create the ISO file, you must mount the file.

Mounting a Config-drive Image

You must mount the ISO file created in the Creating a Config-drive Image procedure.

To Mount a Config-drive Image

Use the following procedure to mount a config-drive image.

Modify the XML definition of the VM to attach the ISO file as a read only drive.

Note

Alter the vendorconfig.iso filename so it identifies the vendor and VNF name.

 <disk type="file" device="cdrom">
      <driver name="qemu" type="raw" cache="none" />
      <source file="/var/third-party/vendorname/vendorconfig.iso" />
      <readonly />
      <target dev="vdc" />
  </disk>

Boot the SBC SWe Lite. The SBC SWe Lite performs auto configuration, and then opens the main WebUI.

Space shortcuts

Page tree

Overview

Creating a Config-drive Image

To Create a Config-drive Image

Mounting a Config-drive Image

To Mount a Config-drive Image