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, VMware vSphere, or VMware vCloud.
The supported versions for the platforms are listed below:
| Platform | Supported versions |
|---|---|
OpenStack |
Newton to Wallaby |
VMware vSphere |
6.7 and 7.0 |
VMware vCloud |
10.2 |
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.
Notes on parallel vs sequential upgrade
If your custom VM type supports parallel upgrade, SIMPL VM can upgrade multiple VMs simultaneously. This can save a lot of time when you upgrade large deployments.
The node-parameters.yaml that was used to build the VM specifies whether parallel upgrade is supported.
It specifies a proportion ("factor") of the deployment size that can be upgraded simultaneously
and a maximum for that proportion.
You can calculate the number of nodes that are upgraded at once
by multiplying the deployment size by the factor, rounding down to a whole number,
then taking the smaller of the result and the configured maximum number of nodes.
For example, node-parameters.yaml might specify a factor of 0.25 and maximum of 10 nodes.
In a deployment with 26 nodes that were built with those settings,
SIMPL VM upgrades the first six nodes simultaneously,
then six more, then six more, then six more and finally the last two.
Preparing for a new installation or an upgrade
| Task | More information |
|---|---|
Set up and/or verify your OpenStack, VMware vSphere, or VMware vCloud deployment |
The installation procedures assume that you are installing the VMs into, or upgrading VMs on, an existing OpenStack, VMware vSphere, or VMware vCloud 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. |
Set up your CDS deployment |
The installation procedures assume that CDS has been set up, as instructed in the Setting up CDS section. |
Prepare service configuration |
VM configuration information can be found at VM Configuration. |
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 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 custom nodes on VMware vSphere |
||
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 custom nodes on OpenStack |
||
Installation (on VMware vCloud) |
Prepare the SDF for the deployment |
|
Deploy SIMPL VM into VMware vCloud |
||
Prepare configuration files for the deployment |
||
Install MDM |
||
Prepare SIMPL VM for deployment |
||
Deploy custom nodes on VMware vCloud |
||
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 |
Rolling upgrade of custom nodes |
|
Post-acceptance tasks |
