Tutorial: OpenIMSCore Network Service Record in TOSCA

This tutorial shows how to deploy a Network Service Record composed by 5 VNFs, a basic OpenIMSCore.

Compared to the Iperf-Server - Iperf-Client the example provided here is far more complex. So we assume you are fimiliar with the architecture.


In order to execute this scenario, you need to have the following components up and running:

Store the VimInstance

Upload a VimInstance to the NFVO (e.g. this VimInstance).

Prepare the CSAR Package

Download the necessary files from the tosca branch of the github repository and pack the NSD CSAR in the following way:

Example for creating the NSD CSAR

#Go to where you want to save the scripts
git clone -b tosca https://github.com/openbaton/openimscore-packages.git
# Create the .csar file which needs to be uploaded
cd openimscore-packages/TOSCA/ims-nsd
zip -r ims.csar . -x ".*" -x "*/.*"

For this example we assume the network used to interconnect the components is called "mgmt", if you want to modify this example ensure you are naming the network accordingly, the scripts from the github do not handle different network names yet. Also the vimInstanceName may be different to you, depending on your setup. The deployment_flavor is optional but should containg enough RAM for the default configuration of the components to be able to run, else some components may crash on start. This example setup has been successfuly tested on clean Ubuntu14.04 images with 2048 Mb RAM deployed on an Openstack Kilo (2015.1.3). Ensure that the image name defined in the Metadata.yaml of each package is existing.

You can easily onboard the CSAR from the Dashboard. ( Catalogue -> NS Descriptors -> On Board NSD -> Upload CSAR)

Deploy the Network Service Descriptor

Deploy the stored NSD by using the dashboard.

You need to go again to the GUI, go to Catalogue -> NS Descriptors, and open the drop down menu of the openIMSCore NSD by clicking on Action. Afterwards you need to press the Launch button in order to start the deployment of this NSD.

If you go to Orchestrate NS -> NS Records in the menu on the left side, you can follow the deployment process and check the current status of the deploying NSD.


Once the Network Service Record went to "ACTIVE" your OpenIMSCore - Bind9 - FHoSS deployment is finished.


To test your OpenIMSCore you may use a Sip client of your choice. Be sure to use the realm defined in your Bind9 Virtual Network Function Descriptor while testing registration and call. By default the FHoSS conaints 2 users : alice and bob. The user is the same as the password, but you may also alter it to your needs modifying the FHoSS Virtual Network Function Descriptor ( You will find the users in "var_user_data.sql" file under the fhoss folder)

For Benchmarking we can use IMS Bench SIPp but then you should add more users to the FHoSS database since by default it only contains 2 users.