Planning for the procedure

Background knowledge

This procedure assumes that:

  1. You are installing into an existing VMware vSphere deployment which has pre-configured networks and VLANs; this procedure does not cover setting up a VMware vSphere deployment from scratch.

  2. You have deployed a SIMPL VM, unpacked the CSAR, and prepared an SDF.

Reserve maintenance period

This procedure does not require a maintenance period. However if you are integrating into a live network then it is recommended to implement measures to mitigate any unforeseen events.

Plan for service impact

This procedure does not impact service.

People

You must be a system operator to perform the MOP steps.

Tools and access

You must have access to the SIMPL VM, and the SIMPL VM must have the right permissions on the VMware vSphere deployment.

Method of procedure

Step 1 - 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 2 - 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 3 - Generate the Terraform template

Run csar generate --vnf [image name] --sdf <path to SDF> --orchestrator terraform. This will validate the SDF, and generate the Terraform template. If any errors occur, check the documentation on preparing the SDF and fix the SDF.

Step 4 - Deploy the OVA using the Terraform template

Run csar deploy --vnf [image name] --orchestrator terraform. This will upload the image, and deploy the number of custom nodes specified in 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 terraform.

Previous page Next page
VM Build Container Version 1.0.0