Planning for the procedure
Background knowledge
This procedure assumes that:
-
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
-
you have deployed a SIMPL VM, unpacked the CSAR, and prepared an SDF.
Method of procedure
|
Refer to the SIMPL VM Documentation for details on the commands mentioned in the procedure. |
Deployments using SIMPL 6.7.3
Step 1 - Deploy the OVA
Run csar deploy --vnf tsn --sdf <path to SDF>.
This will validate the SDF, and generate the terraform template. After successful validation, this will upload the image, and deploy the number of TSN nodes specified in the SDF.
|
Only one node type should be deployed at the same time. I.e. when deploying these TSN nodes, don’t deploy other node types at the same time in parallel. |
Step 2 - Upload TSN RVT configuration
Upload the configuration for the TSN nodes to the CDS. This will enable each TSN node to self-configure.
To upload configuration after creating and validating the yaml files as described in the above, run
rvtconfig upload-config -c <cds-mgmt-addresses> -t tsn -i ~/yamls (--vm-version-source this-rvtconfig | --vm-version <version>)
on the SIMPL node from the resources subdirectory of the TSN CSAR.
You can find the configuration examples here and how to do this on the configuration page.
An in-depth description of RVT YAML configuration can be found in the Rhino VoLTE TAS Configuration and Management Guide.
Backout procedure
To delete the deployed VMs, run
csar delete --vnf tsn --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 TSN 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.
Deployments using SIMPL 6.6.x
Step 1 - Validate the SDF
Run csar validate-vsphere --sdf <path to SDF>.
This will validate the SDF.
Step 2 - Generate the Terraform Template
Run csar generate --vnf tsn --sdf <path to SDF>.
This will generate the terraform template.
Step 3 - Deploy the OVA
Run csar deploy --vnf tsn.
This will upload the image, and deploy the number of TSN nodes specified in the SDF.
|
|
Only one node type should be deployed at the same time. I.e. when deploying these TSN nodes, don’t deploy other node types at the same time in parallel. |
Step 4 - Upload TSN RVT configuration
Upload the configuration for the TSN nodes to the CDS. This will enable each TSN node to self-configure.
To upload configuration after creating and validating the yaml files as described in the above, run
rvtconfig upload-config -c <cds-mgmt-addresses> -t tsn -i ~/yamls (--vm-version-source this-rvtconfig | --vm-version <version>)
on the SIMPL node from the resources subdirectory of the TSN CSAR.
You can find the configuration examples here and how to do this on the configuration page.
An in-depth description of RVT YAML configuration can be found in the Rhino VoLTE TAS Configuration and Management Guide.
Backout procedure
To delete the deployed VMs, run
csar deploy --vnf tsn --delete.
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 TSN 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.
Next Step
If you are upgrading a full set of VMs, go to Deploy ShCM nodes on VMware vSphere, otherwise follow the verification instructions here: Verify the state of the nodes and processes
