This document focuses on the use of VMWare Cloud Director as the VIM for MobiledgeX VM Pool Deployment Model.
Scope and Constraints
Only cloud-native containerized workloads are currently supported; this includes docker and Kubernetes deployments.
Deployment of native virtual machines is not supported.
Specialized device/GPU support is limited, and may require the MobiledgeX DevOps team to assist in the deployment process.
The use of VIM level health checks and re-assignment based on machine policies is not supported.
MobiledgeX only controls resource management within the scope of the MobiledgeX platform; VIM Operators have control over resource management beyond the platform. However, all changes must be done in coordination with MobiledgeX.
Platform and Pool VMs
The MobiledgeX platform requires a dedicated instance to manage the deployment, communicate back to the MobiledgeX services, and orchestrate workloads. The dedicated instance is separate from the Pool VMs; these instances provide the compute capability for workloads deployed to the cloudlet.
Step 1: Determine the correct version/format required.
Step 2: Download artifacts from the MobiledgeX repository.
Step 3: Verify the SHA256 Checksums.
Step 4: Load the resources into the VCD Catalog
Step 5: Validate Network Configuration
Step 6: Provide deployment information to MobiledgeX.
XML file that contains metadata for the VM, Template, or App Template.
A manifest file containing all SHA1 checksums for all files in the VMWare deployment package.
MobiledgeX will direct you to download the correct format for your environment.
These files can be downloaded in one of two ways:
Directly from Artifactory GUI
You can use your console username/password to log into the MobiledgeX Artifactory installation and download the artifacts using the web browser of your choice. The files are under the Base images folder and are further broken down by format/type.
From the CLI
The files can also be downloaded directly from the command line using cURL.
For example, the following commands would be provided for the download of the vSphere format of version 3.1.5 of the software:
It is vital to ensure that the artifacts are not corrupted in the file transfer. Artifactory computes a SHA256 Checksum for each file it serves. You will need to generate the SHA256 checksum on the downloaded file and then compare it to the checksum in Artifactory.
Computing the SHA256
The process of computing the SHA256 varies by platform; for both Linux you can use the sha256sum utility (you may need to install this using your package manager):
Under Windows, you can use the Get-FileHash commandlet in PowerShell to calculate the SHA256:
If the SHA256 calculated locally does not match the value provided in Artifactory, delete the file and retry the download. If this still does not match, please contact MobiledgeX support.
Step 4: Load Resources to VCD
The specific steps required to load the VCD catalog resources will vary depending on the software's version and the user's permissions. The examples below should work for all software versions; however, the screenshots/names may not match up directly with newer versions.
Connect to the VCD portal.
Navigate to Libraries → App Templates
Select Source and upload OVF and VMDK files downloaded in step #2.
The Review Details option screen will display.
Under Select vApp Template Name, select the catalog to which you are deploying the vAPP.
Wait for the template to complete uploading and processing.
If any errors are returned, please check your permissions. Most load failures are due to the user not having the correct permissions.
Appropriate user permissions will be required to upload media and other resources to the Catalog. If your permissions do not allow you to upload, please see your VCD Administrator.
Once the artifacts have been loaded into the catalog, the required virtual machines can be created for the installation process. At a minimum, the values provided below in the VM Configuration table should be met.
At a minimum, four VMs will be required per datacenter to fully standup the environment.
Operators will define the size of VMs within the VMPool based on our request and upload it to their data store.
Operators will host us as a tenant and offer standard RBAC methods to consume VMPool created in this process.
Operators will create required VMs and create a flat network binding across all VMs within a Pool and attach an IP address and name them.
Operators will assign specific VMs external access to the internet and create routes to ingress internal VMs within Pool and egress to external network internet or mobile network.
Step 5: Validate Network Configuration
All virtual machines created as part of this deployment will require full access to the full complement of deployed virtual machines.
Additionally, the network, firewall, and security groups need to be configured to provide the detailed ingress and egress access noted in the following tables:
An assumption is made that mobile and internet access are external networks, and devices have ingress access into the workloads orchestrated on the deployment.
By default, all ports should be opened on the mobile network side for ingress to the deployment.
The MobiledgeX front-end load balancers will not be included in any security groups that would prevent the opening of any application-specific ports.
All VMPool VMs, including those with internal-network access only, should have egress access to the internet.
All VMPool VMs must have their system time synchronized with the NTP server.
Step 6: Provide Deployment Information
The following should be provided for each VM that has been deployed.
Step 7: Cloudlet Deployment
The MobiledgeX DevOps team will use the information above to deploy the cloudlet and confirm that it communicates with all necessary services and works correctly. During this process, MobiledgeX requests that the operator has a defined contact point if there are any issues with the deployed VMS, network, firewall, or other problems.
Step 8: Handover Testing
After completing the cloudlet deployment, the MobiledgeX DevOps team will run through the deployment test process to validate the configuration. Once this is complete, the customer will deploy workloads to the cloudlet. Simultaneously, the MobiledgeX support team monitors the deployment and management until both MobiledgeX and the Operator agree that the cloudlet is working correctly.