Perform the following steps to install yb-voyager using apt for Ubuntu:

Note

apt installation is only supported for Ubuntu 22. For other versions such as 18 and 20, use the install script via the Source installation option.

  1. Install the Yugabyte apt repository on your machine using the following command:

    wget https://s3.us-west-2.amazonaws.com/downloads.yugabyte.com/repos/reporpms/yb-apt-repo_1.0.0_all.deb
sudo apt-get install ./yb-apt-repo_1.0.0_all.deb

    This repository contains the yb-voyager Debian package and the dependencies required to run yb-voyager.

  2. Install the postgresql-common repository to fetch PostgreSQL 16 using the following commands:

    sudo apt install -y postgresql-common
sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh

  3. Clean the apt-get cache and package lists using the following commands:

    sudo apt-get clean
sudo apt-get update

  4. Install yb-voyager and its dependencies using the following command:

    sudo apt-get install yb-voyager

    Note: If you see a failure in the install step similar to the following:

    Depends: ora2pg (= 23.2-yb.2) but 24.3-1.pgdg22.04+1 is to be installed

    Try installing ora2pg using the following command:

    sudo apt-get install ora2pg=23.2-yb.2

    Then try installing yb-voyager using the following command:

    sudo apt-get install yb-voyager

  5. Check that yb-voyager is installed using the following command:

    yb-voyager version

Upgrade yb-voyager

Note

If you are upgrading Voyager from version 1.8.0 or earlier, you need to install the postgresql-common repository before the upgrade as follows:

sudo apt install -y postgresql-common
sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh

Upgrade yb-voyager using the following command:

sudo apt-get upgrade yb-voyager