Planning for the procedure

Background knowledge

This procedure assumes that:

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

  2. You have prepared an SDF and deployed a Commissioning VM.

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 Commissioning VM, and the Commissioning VM must have the right permissions on the VMware deployment.

Installation Questions

Question More information

Do you have the correct ShCM CSAR?

All ShCM virtual appliances use the naming convention - shcm-<full-version>-vmware-csar.zip. For example, shcm-1.0.0-vmware-csar.zip where 1.0.0 is the software version. In particular, ensure you have the VMware CSAR.

Method of procedure

Step 1 - Upload your CSAR to the Commissioning VM

Transfer the CSAR onto the Commissioning 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 Commissioning VM

Transfer the previously written SDF onto the Commissioning VM.

Step 3 - Generate the Terraform template

Run csar generate --vnf shcm --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 shcm --orchestrator terraform. This will upload the image, and deploy the number of ShCM nodes specified in the SDF.

Next steps

Once all ShCM 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 shcm --delete --orchestrator terraform.

Previous page Next page