You're viewing documentation for a prior version of Migrate for Compute Engine (formerly Velostrata). You can continue using this version, or use the current version.

Preparing Linux VMs

Linux VMs migrating to Google Cloud with Migrate for Compute Engine need a prep package installed to automatically handle configuration changes.

This page describes how to install the Migrate for Compute Engine prep package on VMs you intend to run on Google Cloud.

This package makes changes at boot after detecting that the VM is running on Google Cloud. It can remain installed while the VM is running on-premises. For more information on the changes made by the package, see VM adaptations.

RHEL / CentOS

How-to: Red Hat Enterprise Linux (RHEL) 6/7 and CentOS 6/7

There are two ways to install the Migrate for Compute Engine RPM package:

Install the velostrata-prep RPM using Yum. This automatically fetches and installs the required prerequisites.
Download and install the prerequisites, and then install the velostrata-prep RPM.

Installing using Yum

Sign in to the workload VM.
From the VM, download the latest velostrata-prep RPM.

Install the prep package using yum:

yum install velostrata-prep-VERSION.redhat.x86_64.rpm

Downloading and installing prerequisites

Log in to the workload VM.
From the VM, download the latest velostrata-prep RPM.
Check for the list of prerequisites by running: rpm -qpR velostrata-prep-VERSION.redhat.x86_64.rpm

For example:

rpm -qpR velostrata-prep-1.8-12.redhat.x86_64.rpm
Install the prerequisites individually.
Install the velostrata-prep RPM (velostrata-prep-VERSION.redhat.x86_64.rpm) using Yum.
```
yum install velostrata-prep-VERSION.redhat.x86_64.rpm
```

If the installation is unsuccessful or if there are any warnings, ensure that you address them prior to executing the run-in-cloud operation.

SuSE SLES

How-to: the SuSE Enterprise Linux Server (SLES) 11/12 Prep for running in GCP

Log in to the SLES virtual machine as the root user.
Install the SLES xen-kmp-default package:

zypper install xen-kmp-default
Reboot.
Install the velostrata-prep package

zypper install velostrata-prep-VERSION.suse.x86_64.rpm

Example:

zypper install velostrata-prep-1.8-12.suse.x86_64.rpm

If the installation is unsuccessful or if there are warnings during installation, address them prior to migrating this VM using Migrate for Compute Engine.

Ubuntu

Installing the Ubuntu 14/16/18 Prep package

Sign in to the Ubuntu virtual machine as a user with sudo privileged access.
Install the velostrata-prep package

sudo dpkg -i velostrata-prep-VERSION.deb

Example:

sudo dpkg -i velostrata-prep-1.8-12.deb
Install all required/missing prerequisites for the velostrata-prep package. sudo apt-get install -f -y

If the installation is unsuccessful or if there are warnings during installation, address them prior to migrating this VM using Migrate for Compute Engine.