A Solution Definition File (SDF) contains information about all Metaswitch products in your deployment. It is a plain-text file in YAML format.
The deployment is split into
sites. Note that multiple sites act as independent deployments, e.g. there is no automatic georedundancy.
Within each site you define one or more
service groupsof virtual machines. A service group is a collection of virtual machines (nodes) of the same type.
The collection of all virtual machines of the same type is known as a
VNFC(Virtual Network Function Component). For example, you may have a SAS VNFC and a MDM VNFC.
The VMs in a VNFC are also known as
VNFCIs(Virtual Network Function Component Instances), or just
Some products may support a VNFC being split into multiple service groups. However, for Rhino VoLTE TAS VMs, all VMs of a particular type must be in a single service group.
The format of the SDF is common to all Metaswitch products, and in general it is expected that you will have a single SDF containing information about all Metaswitch products in your deployment.
This section describes how to write the parts of the SDF specific to the Rhino VoLTE TAS solution. It includes how to configure the MDM and RVT VNFCs, how to configure subnets and traffic schemes, and some example SDF files to use as a starting point for writing your SDF.
Further documentation on how to write an SDF is available in the 'Creating an SDF' section of the SIMPL VM Documentation.
For the Rhino VoLTE TAS solution, the SDF must be named
Each site in the SDF has a
namecan be any unique human-readable name.
site-parametershas multiple sub-sections and sub-fields. Only some are described here.
vnfcsis where you list your service groups.
site-parameters, all of the following are required for the Rhino VoLTE TAS solution:
deployment-id: The common identifier for a SDF and set of YAML configuration files. It can be any name consisting of up to 20 characters. Valid characters are alphanumeric characters and underscores.
site-id: The identifier for this site. Must be in the form
fixed-ips: Must be set to
vim-configuration: VNFI-specific configuration (see below) that describes how to connect to your VNFI and the backing resources for the VMs.
ntp-serversmust be a list of NTP servers. At least one NTP server is required; at least two is recommended. These must be specified as IP addresses, not hostnames.
networking: Subnet definitions. See Subnets and traffic schemes.
timezone: Timezone, in POSIX format such as
mdm: MDM options. See MDM service group.
vnfcs section in each site, you list that site’s service groups.
For RVT VMs, each service group consists of the following fields:
name: A unique human-readable name for the service group.
type: Must be one of
version: Must be set to the version of the CSAR.
The version can be found in the CSAR filename, e.g. if the filename is
tsn-4.0.0-12-1.0.0-vsphere-csar.zipthen the version is
4.0.0-12-1.0.0. Alternatively, inside each CSAR is a manifest file with a
.mfextension, whose content lists the version under the key
vnf_package_version, for example
Specifying the version in the SDF is mandatory for Rhino VoLTE TAS service groups, and strongly recommended for other products in order to disambiguate between CSARs in the case of performing an upgrade.
count: The number of VMs in this service group.
instances: A list of instances. Each instance has a
name(the VM’s hostname) and, on VMware vSphere, a list of
networks: A list of networks used by this service group. See Subnets and traffic schemes.
vim-configuration: The VNFI-specific configuration for this service group (see below).
The SDF includes VNFI-specific options at both the site and service group levels. At the site level, you specify how to connect to your VNFI and give the top-level information about the deployment’s backing resources, such as datastore locations on vSphere, or availability zone on OpenStack. At the VNFC level, you can assign the VMs to particular sub-hosts or storage devices (for example vSphere hosts within a vCenter), and specify the flavor of each VM.
For each service group, include a
vim-configuration section with the flavor information,
which varies according to the target VNFI type:
deployment-size: <flavor name>
flavor: <flavor name>
When deploying to VMware vSphere, include a
vnfci-vim-options section for each instance
with the following fields set:
May be any valid folder name on the VMware vSphere instance, or
""(i.e. an empty string) if the VMs are not organised into folders.
vnfcs: - name: tsn cluster-configuration: count: 3 instances: - name: tsn-1 vnfci-vim-options: folder: production datastore: datastore1 host: esxi1 resource-pool-name: Resources - name: tsn-2 ... vim-configuration: vsphere: deployment-size: medium
vnfci-vim-options section is required.