Create a VM Migration Assistant Profile
Follow these steps to create a new add-on profile that will be applied to your existing VMO cluster.
Prerequisites
- Your Palette account role must have the
clusterProfile.create
permission to create a cluster profile. Refer to the Permissions documentation for more information. - A healthy VMO cluster. Refer to the Create a VMO Profile for further guidance.
- The VMO cluster must have network connectivity to vCenter and ESXi hosts, and the VMs you want to migrate.
Create the Profile
-
Log in to Palette.
-
From the left Main Menu click Profiles.
-
Click on the Add Cluster Profile button.
-
Fill out the basic information and ensure you select Add-on for the type. Click on Next to continue.
-
Select Add New Pack. In the next window that displays, enter Virtual Machine Migration Assistant in the Filter by name search bar. The pack is in the Spectro Addon Repo registry. Select the pack when it appears.
-
Palette displays the YAML file in the editor on the right. You can edit the YAML as needed. Review the following service console parameters and adjust to your requirements as needed.
Parameter Description Default Value vm-migration-assistant-ui.console.service.type
Choose how to expose the service console: NodePort
/LoadBalancer
/ClusterIP
. Refer to Service type for guidance on Kubernetes service types."LoadBalancer"
vm-migration-assistant-ui.console.service.loadBalancerPort
Choose the external port to expose the service console when LoadBalancer is selected. "443"
vm-migration-assistant-ui.console.service.nodePort
Choose the external port to expose the service console when nodePort is selected. "30443"
vm-migration-assistant-ui.console.deployment.env.userAuth
If you want to enable OIDC for the service console, set the value to oidc
. The OIDC configuration is inherited from your Kubernetes pack configuration, and the service console only supports OIDC when Palette is configured as the Identity Provider. Refer to SAML and OIDC SSO for details.disabled
vm-migration-assistant-ui.console.ingress.enabled
Choose whether to enable Ingress access to the VM Migration Assistant service console. If enabled, the Ingress provides external connectivity to the service console. You can still access the service console through the cluster services list in Palette if vm-migration-assistant-ui.console.service.type
is set toLoadBalancer
orNodePort
.false
vm-migration-assistant-ui.console.ingress.host
Specify the domain name that the Ingress resource will use to expose the VM Migration Assistant service console. vm-migration-assistant-ui.console.ingress.tls
If providing your own TLS certificates, define the TLS configuration for the Ingress within this parameter. If you need to secure multiple domains or subdomains with different certificates, you can add multiple entries. Each array must contain the secretName
,hosts
,crt
, andkey
parameters.vm-migration-assistant-ui.console.ingress.tls.secretName
The name for the Kubernetes Secret where the TLS certificate and key will be stored. vm-migration-assistant-ui.console.ingress.tls.hosts
One or more hostnames that the certificate should secure. vm-migration-assistant-ui.console.ingress.tls.crt
The CA-issued TLS certificate. vm-migration-assistant-ui.console.ingress.tls.key
The private key corresponding to the certificate. vm-migration-assistant-ui.console.ingress.selfSignedIssuer.enabled
When set to true
, cert-manager will automatically issue a self-signed TLS certificate based on theingress.tls.hosts
andingress.tls.secretName
values. This allows you to omit the manual certificate and key parameters beingingress.tls.crt
andingress.tls.key
respectively.false
-
Click on Confirm & Create.
-
In the following screen, click Next.
-
Click Finish Configuration.
-
From the Main Menu, choose Clusters and select your VMO cluster.
-
In the Profile tab, click Add add-on profile (+) and select the newly created profile. Click Confirm.
-
Click Save to deploy the VM Migration Assistant to your cluster.
Validate
-
Log in to Palette.
-
Navigate to Profiles from the left Main Menu.
-
Locate the newly created profile in the list.
-
From the left Main Menu, click Clusters and select your cluster.
-
In the Overview tab, ensure that the cluster status and health is Running and Healthy.
-
In the Overview tab, the Services list displays the vm-migration service with a clickable port. Click the port to access the VM Migration Assistant service console. The port number is based on your service console configuration.
Access the VM Migration Assistant Service Console
You can access the service console based on how you configured the VM Migration Assistant YAML manifest when creating the cluster profile.
The following examples are for each console.service.type
:
-
If you configured an
Ingress
with adomain
ofvm-migration.mycompany.dev
, you can access the service console athttps://vm-migration.mycompany.dev
. -
If you configured a
NodePort
with anodePort
of30443
, you can access the service console athttps://<NODE_IP>:30443
.
- If you configured a
LoadBalancer
with aloadBalancerPort
of443
, you can access the service console athttps://<LOAD_BALANCER_IP>
, where the load balancer IP address is provided by your load balancer solution (such as MetalLB).
Next Steps
You can now use the VM Migration Assistant to migrate your VMs. Refer to the Create Source Providers guide to start creating your source providers.