The steps below describe how to install or upgrade the nodes that make up your deployment. Select the steps that are appropriate for your VM host: OpenStack or VMware vSphere.
The supported versions for the platforms are listed below:
| Platform | Supported versions |
|---|---|
OpenStack |
Newton to Wallaby |
VMware vSphere |
6.7 and 7.0 |
Live migration of a node to a new VMware vSphere host or a new OpenStack compute node is not supported. To move such a node to a new host, remove it from the old host and add it again to the new host.
Note that after completing an upgrade or CSAR EFIX patch of only a subset of the nodes that does not include the MAG node, you will need to re-upload the existing configuration set for the MAG nodes, but with the SDF updated to specify the correct version of the upgraded or patched nodes. This ensures that the MAG node can populate connection settings for the other nodes in REM.
Preparing for a new installation or an upgrade
| Task | More information |
|---|---|
Set up and/or verify your OpenStack or VMware vSphere deployment |
The installation procedures assume that you are installing the VMs into, or upgrading VMs on, an existing OpenStack or VMware vSphere host(s). If you do not yet have a host system set up, then complete the setup of your host in its entirety before proceeding with installing the VMs. Ensure the host(s) have sufficient vCPU, RAM and disk space capacity for the VMs. Note that for upgrades, you will temporarily need approximately one more VM’s worth of vCPU and RAM, and potentially more than double the disk space, than your existing deployment currently uses. You can later clean up older images to save disk space once you are happy that the upgrade was successful. Perform health checks on your host(s), such as checking for active alarms, to ensure they are in a suitable state to perform VM lifecycle operations. Ensure the VM host credentials that you will use in your SDF are valid and have sufficient permission to create/destroy VMs, power them on and off, change their properties, and access a VM’s terminal via the console. |
Prepare service configuration |
VM configuration information can be found at VM Configuration. An in-depth description of RVT YAML configuration can be found in the Rhino VoLTE TAS Configuration and Management Guide. |
Installation
The following table sets out the steps you need to take to install and commission your VM deployment.
Be sure you know the number of VMs you need in your deployment. At present it is not possible to change the size of your deployment after it has been created.
| Step | Task | Link |
|---|---|---|
Installation (on OpenStack) |
Prepare the SDF for the deployment |
|
Deploy SIMPL VM into OpenStack |
||
Prepare configuration files for the deployment |
||
Create the OpenStack flavors |
||
Install MDM |
||
Prepare SIMPL VM for deployment |
||
Deploy TSN nodes on OpenStack |
||
Deploy ShCM nodes on OpenStack |
||
Deploy MAG nodes on OpenStack |
||
Deploy MMT CDMA nodes on OpenStack |
||
Deploy SMO nodes on OpenStack |
||
Installation (on VMware vSphere) |
Prepare the SDF for the deployment |
|
Deploy SIMPL VM into VMware vSphere |
||
Prepare configuration files for the deployment |
||
Install MDM |
||
Prepare SIMPL VM for deployment |
||
Deploy TSN nodes on VMware vSphere |
||
Deploy ShCM nodes on VMware vSphere |
||
Deploy MAG nodes on VMware vSphere |
||
Deploy MMT CDMA nodes on VMware vSphere |
||
Deploy SMO nodes on VMware vSphere |
||
Verification |
Run some simple tests to verify that your VMs are working as expected |
Upgrades
The following table sets out the steps you need to execute a rolling upgrade of an existing VM deployment.
| Step | Task | Link |
|---|---|---|
Rolling upgrade (on OpenStack) |
Setting up for a rolling upgrade |
|
Rolling upgrade TSN nodes on OpenStack |
||
Rolling upgrade ShCM nodes on OpenStack |
||
Rolling upgrade MAG nodes on OpenStack |
||
Rolling upgrade MMT CDMA nodes on OpenStack |
||
Rolling upgrade SMO nodes on OpenStack |
||
Rolling upgrade (on OpenStack) |
Post rolling upgrade steps |
|
Rolling upgrade (on VMware vSphere) |
Setting up for a rolling upgrade |
|
Rolling upgrade TSN nodes on VMware vSphere |
||
Rolling upgrade ShCM nodes on VMware vSphere |
||
Rolling upgrade MAG nodes on VMware vSphere |
||
Rolling upgrade MMT CDMA nodes on VMware vSphere |
||
Rolling upgrade SMO nodes on VMware vSphere |
||
Rolling upgrade (on VMware vSphere) |
Post rolling upgrade steps |
|
Verification |
Run some simple tests to verify that your VMs are working as expected |
Patches
The following table sets out the steps you need to execute a patch of an existing VM deployment.
| Step | Task | Link |
|---|---|---|
Rolling upgrade using CSAR EFIX patch (on OpenStack) |
Setting up for a rolling upgrade using CSAR EFIX patch |
|
Rolling CSAR EFIX patch TSN nodes on OpenStack |
||
Rolling CSAR EFIX patch ShCM nodes on OpenStack |
||
Rolling CSAR EFIX patch MAG nodes on OpenStack |
||
Rolling CSAR EFIX patch MMT CDMA nodes on OpenStack |
||
Rolling CSAR EFIX patch SMO nodes on OpenStack |
||
Rolling upgrade using CSAR EFIX patch (on OpenStack) |
Post rolling upgrade using CSAR EFIX patch steps |
|
Rolling upgrade using CSAR EFIX patch (on VMware vSphere) |
Setting up for a rolling upgrade using CSAR EFIX patch |
|
Rolling CSAR EFIX patch TSN nodes on VMware vSphere |
||
Rolling CSAR EFIX patch ShCM nodes on VMware vSphere |
||
Rolling CSAR EFIX patch MAG nodes on VMware vSphere |
||
Rolling CSAR EFIX patch MMT CDMA nodes on VMware vSphere |
||
Rolling CSAR EFIX patch SMO nodes on VMware vSphere |
||
Rolling upgrade using CSAR EFIX patch (on VMware vSphere) |
Post rolling upgrade using CSAR EFIX patch steps |
|
