Planning for the procedure
Background knowledge
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 have some knowledge of VMs and familiarity with OpenStack’s host software
-
if you require information on deploying on OpenStack, see Manually installing the custom VMs on OpenStack for links to OpenStack documentation
-
-
You have deployed a SIMPL VM, unpacked the CSAR, and prepared an SDF.
Method of procedure
Step 1 - Check OpenStack quotas
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>
.
This shows the maximum number of various resources.
The existing server groups can be seen by running openstack server group list
Similarly, the security groups can be found by running openstack security group list
If the quotas are 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
Step 2 - Upload your CSAR to the SIMPL VM
If not already done, transfer the CSAR onto the SIMPL VM and run
csar unpack <path to CSAR>
, where <path to CSAR>
is the full path to the transferred CSAR.
This will unpack the CSAR to ~/.local/share/csar/
.
Step 3 - Upload your SDF to the SIMPL VM
If the SDF was not created on the SIMPL VM, transfer the previously written SDF onto the SIMPL VM.
Step 4 - Generate the Heat template
Run csar generate --vnf [image name] --sdf <path to SDF> --orchestrator heat
.
This will validate the SDF, and generate the Heat template.
If any errors occur, check the documentation on preparing the SDF and fix the SDF.
Next steps
Once all custom VMs have been created using the procedure above, configure them by uploading configuration to CDS. How to do this can be found on the Initial configuration page.
Backout procedure
If you want to delete the deployed VMs, run
csar deploy --vnf [image name] --delete --orchestrator heat
.