Install Data Migrator

Ready to install? Check the prerequisites and then follow these steps to get up and running with Data Migrator.

Install Data Migrator

1. Download Data Migrator and install it on your chosen host. If you're migrating from Hadoop Distributed File System (HDFS), install Data Migrator on an edge node in the Hadoop cluster. Run the following installation command:

   wget https://wandisco.com/downloads/livedata-migrator.sh

2. Make the installation script executable and install as the root (or sudo) user. These commands assume that the installer is inside your working directory.

   chmod +x livedata-migrator.sh && ./livedata-migrator.sh
   Known issue

   On CentOS 6, start the livedata-migrator, hivemigrator, and livedata-ui services manually. See System service commands.

   Alternative /tmp directory

   The Data Migrator installer extracts its contents to a temporary directory and decompresses them. By default, the temporary directory is a sub-directory of /tmp.

   In some situations, extracting and decompressing in the default temporary directory fails. For example, if there is not enough disk space remaining, or if /tmp is mounted as noexec.

   To avoid these issues, extract the contents to a different temporary directory by adding the --target option when you run the installer:

   Example

   ./livedata-1.21.0-4-full_rpm_installer.sh --target /opt/wandisco/alternate_tmp_dir

   Do not use /opt/wandisco/tmp as the value for --target or the installation will fail.

   You can delete your temporary directory and its contents after installation.

3. Check the status of each service:

   Run the following command for each of the services, listed below

   systemctl status <service name>

   The service names are: livedata-migrator, hivemigrator, and livedata-ui.

   If your system is running without systemd the commands use a different form.

System and custom users for installation

To run the installer using a default user, run the following command:

./livedata-migrator.sh

Component	Default system user	Default system user group
Data Migrator	hdfs	hdfs
WANdisco UI	hdfs	hdfs
Hive Migrator	hive	hadoop

If your source filesystem is a mounted network-attached filesystem (NFS), enter your preferred user and user group to run the installer.

To install the product using a custom user or a custom user group, run the following commands:

Thin installer

./livedata-migrator.sh --user <custom user> --group <custom group>

Fat installer

./livedata-migrator.sh -- --user <custom user> --group <custom group>

This sets the custom user and custom user group for all services and their respective directories.

For more information about configuring custom users, go to Configure system users.

Install Data Migrator components on separate hosts

To install the components on separate hosts, run the following commands:

Install the UI on one host

./livedata-x.x.x-xx-full_rpm_installer.sh --noexec --keep

cd ui_ldm_hvm

rpm -ivh livedata-ui-<version-number>.noarch.rpm

Install Data Migrator, Hive Migrator, and WANdisco CLI on one host

./livedata-x.xx.x-xx-full_rpm_installer.sh --noexec --keep

cd ui_ldm_hvm

rpm -ivh livedata-migrator-<version-number>.noarch.rpm
rpm -ivh hivemigrator-<version-number>.noarch.rpm
rpm -ivh livedata-migrator-cli-<version-number>.noarch.rpm

Next steps

Once you have Data Migrator running, you're ready to get started.