This procedure assumes that:
you are installing into an existing OpenStack deployment
The OpenStack deployment must be set up with support for Heat templates.
you are using an OpenStack version from Icehouse through to Train inclusive
you are thoroughly familiar with working with OpenStack machines and know how to set up tenants, users, roles, client environment scripts, and so on.
(For more information, refer to the appropriate OpenStack installation guide for the version that you are using here.)
you have deployed a SIMPL VM, unpacked the CSAR, and prepared an SDF.
This procedure does not require a maintenance period. However, if you are integrating into a live network, it is recommended to implement measures to mitigate any unforeseen events.
|Refer to the SIMPL VM Documentation for details on the commands mentioned in the procedure.|
The SIMPL VM creates one server group per VM, and one security group per interface on each VM. OpenStack sets limits on the number of server groups and security groups through quotas.
View the quota by running
openstack quota show <project id> on OpenStack Controller node.
This shows the maximum number of various resources.
You can view the existing server groups by running
openstack server group list.
Similarly, you can find the security groups by running
openstack security group list
If the quota is too small to accommodate the new VMs that will be deployed,
increase it by running
openstack quota set --<quota field to increase> <new quota value> <project ID>. For example:
openstack quota set --server-groups 100 125610b8bf424e61ad2aa5be27ad73bb
Upload the configuration for the SMO nodes to the CDS. This will enable each SMO node to self-configure when they are deployed in the next step.
To upload configuration after creating and validating the yaml files as described in the above, run
rvtconfig upload-config -c <cds-mgmt-addresses> -t smo -i ~/yamls (--vm-version-source this-rvtconfig | --vm-version <version>)
on the SIMPL node from the
resources subdirectory of the SMO CSAR.
An in-depth description of RVT YAML configuration can be found in the Rhino VoLTE TAS Configuration and Management Guide.
csar deploy --vnf smo --sdf <path to SDF>.
This will validate the SDF, and generate the heat template. After successful validation, this will upload the image, and deploy the number of SMO nodes specified in the SDF.
|Only one node type should be deployed at the same time. I.e. when deploying these SMO nodes, don’t deploy other node types at the same time in parallel.|
To delete the deployed VMs, run
csar delete --vnf smo --sdf <path to SDF>.
You must also delete the MDM state for each VM.
To do this, you must first SSH into one of the MDM VMs.
Get the instance IDs by running:
mdmhelper --deployment-id <deployment ID> instance list.
Then for each SMO VM, run the following command:
curl -X DELETE -k \ --cert /etc/certs-agent/upload/mdm-cert.crt \ --cacert /etc/certs-agent/upload/mdm-cas.crt \ --key /etc/certs-agent/upload/mdm-key.key \ https://127.0.0.1:4000/api/v1/deployments/<deployment ID>/instances/<instance ID>
Verify that the deletion worked by running
mdmhelper --deployment-id <deployment ID> instance list again.
You may now log out of the MDM VM.
You must also delete state for this node type and version from the CDS prior to re-deploying the VMs.
To delete the state, run
rvtconfig delete-node-type --cassandra-contact-point <any CDS IP> --deployment-id <deployment ID>.
--site-id <site ID> --node-type smo
(--vm-version-source [this-vm | this-rvtconfig] | --vm-version <vm_version>)
Verify your SMO deployment here: Verify the state of the nodes and processes.