Radisys MediaEngine™

NOKIA CBAM INSTALLTION GUIDE

RELEASE V11.0.0

February 2017 007-03970-0000

Revision History
Publication Date Description
February 2017 Initial release.

© 2017 by RadiSys Corporation. All rights reserved.
Radisys is a registered trademark of RadiSys Corporation. MPX‐12000 and vMRF are trademarks of RadiSys Corporation. All other trademarks, 
registered trademarks, service marks, and trade names are the property of their respective owners.
Table of Contents

Preface ....................................................................................................................................................... 4
About this Manual............................................................................................................................................... 4
About Related Radisys Products........................................................................................................................ 4
Technical Support............................................................................................................................................... 4
Notational Conventions ...................................................................................................................................... 5

Chapter 1: About Nokia Cloud Band Application Manager ................................................................... 6

Introduction......................................................................................................................................................... 6

Chapter 2: Deploying and Terminating vMRF Using CBAM .................................................................. 7

vMRF Package Contents.................................................................................................................................... 7
Prerequisites....................................................................................................................................................... 7
Editing the Parameter File .................................................................................................................................. 8
Deploying the vMRF Using CBAM...................................................................................................................... 9
Terminating the vMRF Instance Using CBAM .................................................................................................. 13

Appendix A: Troubleshooting ................................................................................................................ 15

3
Preface
About this Manual
This guide describes the procedure to run vMRF application using Nokia Cloud Band 
Application Manager. 

About Related Radisys Products

This software is part of the Media Resource Function product family. For information on this 
product family and other Radisys products, see the Radisys Web site at www.radisys.com. 

Technical Support
Technical support is available from the Radisys Technical Assistance Center (TAC). Support is 
governed by the terms of your agreement with RadiSys Corporation.
TAC can be reached using the following contact information:
RadiSys Corporation
4190 Still Creek Drive, Suite 300
Vancouver, BC V5C 6C6
Canada
Radisys Technical Assistance Center
Phone: +1‐800‐622‐2235, North America only, toll free
Phone: +1‐604‐918‐6415
E‐mail: [email protected]
To access support for Radisys Media Resource Function from the Radisys website, go to:
http://www.radisys.com/mediaengine‐support‐portal

4
 1

Notational Conventions
This manual uses the following conventions
BoldText A keyword.
ItalicText File, function, and utility names.
MonoText Screen text and syntax strings.
BoldMonoText A command to enter.
ItalicMonoText Variable parameters.
Brackets [  ] Command options.
Curly braces { } A grouped list of parameters. 
Vertical line | An “OR” in the syntax. Indicates a choice of parameters. 

All numbers are decimal unless otherwise stated.

5
 Chapter 1
About Nokia Cloud Band Application Manager
This chapter provides the overview and the system requirements of Nokia Cloud Band 
Application Manager (CBAM).

Introduction
The CBAM is a Virtual Network Function (VNF) manager built according to the architectural 
framework and specifications defined by the ETSI NFV Industry Specification Group. Key 
functionality of CBAM is to perform the life cycle management of the VNFs.

6
 Chapter 2
Deploying and Terminating vMRF Using CBAM
This chapter covers deploying and terminating the vMRF package using CBAM.

vMRF Package Contents

The vMRF package is supplied as a gzip compressed tar format for deployment using CBAM. 
The package contains the following artifacts.
• vMRF disk image (qcow2 format)
• CBAM artifacts (csar format)
• Parameter file (json format)
• README.txt file

Prerequisites
Following are some of the prerequisites before deploying the vMRF using CBAM.
• As a minimum requirement, an administrator must create a flavour in OpenStack with the 
following details. 
• vCPUs = 4
• RAM = 4 GB
• Root disk = 36 GB
• Update metadata of flavour with hw:cpu_sockets=1
• Upload the vMRF disk image to OpenStack.
• Administrator must create three provider networks (non‐NAT) and subnets for the 
management, media, and control interfaces.
NOTE: DHCP must be enabled on all the three subnets, which ensures IP addresses passed 
through the CBAM are available to the vMRF.
• To get the maximum performance of the vMRF, the CPU model detected in the virtual 
machine must be same as that of the host machine. To achieve this, modify the nova 
configuration file as follows:
Set cpu_mode=host‐passthrough in /etc/nova/nova.conf file and restart OpenStack 
services.

7
Deploying and Terminating vMRF Using CBAM 2
• In CBAM template, security group is created and attached to the vMRF instance with 
following rules.
• Following ports and protocols allowed for ingress traffic.
Protocol Port-Range
UDP 32768 - 65534
UDP 161
TCP 22
TCP 80
TCP 32768 - 65534
TCP 5060
UDP 5060
TCP 443
TCP 8080
ICMP ALL

NOTE: Based on the deployment requirements, any change required in the ports must be 
updated manually in swmrf.hot.yaml file.
• All ports and protocols are allowed for egress traffic.

Editing the Parameter File

The swmrf.vnfd.parameter.json parameter file must be edited to reflect the following 
resource names created in the OpenStack.
• VIM Zone Name
• MRF Image Name
• Management Network Name
• Management Subnet Name
• Management IP Address
• Control Network Name
• Control Subnet Name
• Control IP Address
• Media Network Name
• Media Subnet Name
• Media IP Address
• Flavor Name
• VIM Region Name
• VIM Interface Endpoint
• VIM Tenant Name
• VIM User Name

8
Deploying and Terminating vMRF Using CBAM 2
For example if the vMRF image is created in OpenStack with the name SWMRFimg, modify 
the file contents as follows:
“softwareImages”: 
[
{
“resourceId”: “<MRF Image Name>”,
“vnfdsoftwareImageId”: “swmrf_image”
}
],

“softwareImages”: 
[
{
“resourceId”: “SWMRFimg”,
“vnfdsoftwareImageId”: “swmrf_image”
}
],
NOTE: In the default parameter file supplied with the vMRF package, all the fields that needs 
to be updated are marked with <.>.

Deploying the vMRF Using CBAM

CBAM version used: 17
vMRF version used: V11.0.0.1.B

To upload VNF package to the CBAM:
1. Login to the CBAM using required credentials.
2. In CBAM GUI, Click Catalog > Upload VNF Package... option.

9
Deploying and Terminating vMRF Using CBAM 2
3. Browse for the .csar file extracted from the vMRF package provided by Radisys for the 
CBAM and click Upload.

4. After successful upload, the vMRF package appears in the Catalog.
5. Click VNFs. Fill the required details for creating new Virtual Network Function (VNF) and 
click Create.

6. Once the VNF is created, it appears in the VNF list.

10
Deploying and Terminating vMRF Using CBAM 2
7. Select the created VNF.

8. Select Extensions Show. Edit the MRF VM name to be used and click Modify.

9. Select the VNF and select Operations > Instantiate. Enter the required details for the 
following fields:
• Deployment Flavour Id. Enter the deployment flavour Id as default.
• Instantiation Level Id. Enter the instantiation level Id as default.
• Parameter File. Updated swmrf.vnfd.parameter.json file based on the resource names 
of OpenStack resources created for vMRF. Click Browse.
• VIM Password. Enter the VIM password.

11
Deploying and Terminating vMRF Using CBAM 2
 

10. To view the progress, click Operation executions.

11. Once the instantiation is successful, change of vMRF configurations can be done through 
the Web GUI, SNMP, or SSH interface. 
NOTE: To provision the required license, refer to the vMRF User Guide.

12
Deploying and Terminating vMRF Using CBAM 2

Terminating the vMRF Instance Using CBAM

To terminate the vMRF instance:
1. Login to the CBAM using required credentials.
2. In CBAM GUI, select the VNF and click Terminate.

13
Deploying and Terminating vMRF Using CBAM 2
3. From the Termination Type drop down list, select Forceful. 

4. To view the progress, click Operation executions.

14
 Appendix A
Troubleshooting
The following table lists potential problems, together with causes, and possible remedies.
Table 1. Potential Problems and Remedies
Problem Remedy
vMRF VM does not get IP address passed from CBAM Check if the DHCP server is enabled in the subnets attached to
vMRF.
Management or control interfaces are not reachable • By default vMRF sets the default gateway on media interface.
from different subnets • Based on the firewalls or iptable rules configured in Open-
Stack, management or control interfaces may not be able to
communicate with different subnets.
• Custom routes can be added on management or control inter-
face to enable external connectivity.
• Source routing can be enabled on management or control
interface to enable external connectivity.
Example to enable source routing on management and control
interface is as follows:
iptables ‐A OUTPUT ‐t mangle ‐s 
<Management Interface IP> ‐j MARK ‐‐
set‐mark 1
ip rule add fwmark 1 table 1
ip route add 0.0.0.0/0 via <Gateway in 
Management network> dev <Management 
Interface name> table 1
iptables ‐A OUTPUT ‐t mangle ‐s <Control 
Interface IP> ‐j MARK ‐‐set‐mark 2
ip rule add fwmark 2 table 2
ip route add 0.0.0.0/0 via <Gateway in 
Control network> dev <Control Interface 
name> table 2

15