Perform the following steps to install yb-voyager using yum for RHEL 8 and CentOS 8:
-
Update the yum package manager, and all the packages and repositories installed on your machine using the following command:
sudo yum update -
Install the
yugabyteyum repository using the following command:sudo yum install https://software.yugabyte.com/repos/reporpms/rhel-8/yb-yum-repo-1.1-0.noarch.rpmThis repository contains the yb-voyager rpm and other dependencies required to run
yb-voyager. -
Install the
epel-releaserepository using the following command:sudo yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm -
Install the Oracle instant client repositories using the following command:
sudo yum install oracle-instant-clients-repo -
Install the PostgreSQL repositories using the following command:
sudo yum --disablerepo=* -y install https://download.postgresql.org/pub/repos/yum/reporpms/EL-8-x86_64/pgdg-redhat-repo-latest.noarch.rpmThese repositories contain the rest of the dependencies required to run
yb-voyager. -
Disable the default
PostgreSQLyum module on your machine using the following command:sudo dnf -qy module disable postgresql -
Install
perl-openon your machine using the following command:sudo yum install perl-open.noarch -
Update the yum package manager and all the packages and repositories installed on your machine using the following command:
sudo yum update -
Install
yb-voyagerand its dependencies using the following command:sudo yum install yb-voyagerTo install a specific version of
yb-voyageron your machine, use the following command:sudo yum install yb-voyager-<VERSION> -
Check that yb-voyager is installed using the following command:
yb-voyager version
Dependencies
YugabyteDB Voyager relies on the following dependencies on RHEL 8 and RHEL 9 systems, which are automatically installed or resolved when you install Voyager using the official RPM package.
| Dependency | Version / Constraint |
|---|---|
| bash | – |
| binutils | > 2.25 |
| debezium | = 2.5.2-<voyager_version> |
| mysql-devel | – |
| oracle-instantclient-basic | = 21.5.0.0.0-1 |
| oracle-instantclient-devel | = 21.5.0.0.0-1 |
| oracle-instantclient-jdbc | = 21.5.0.0.0-1 |
| oracle-instantclient-sqlplus | = 21.5.0.0.0-1 |
| oracle-instantclient-tools | = 21.5.0.0.0-1 |
| ora2pg | = 23.2-yb.2 |
| postgresql17 | – |
| sqlite | – |
Upgrade yb-voyager
Upgrade yb-voyager using the following command:
sudo yum update yb-voyager
Perform the following steps to install yb-voyager using yum for RHEL 9 and CentOS 9:
-
Update the yum package manager, and all the packages and repositories installed on your machine using the following command:
sudo dnf update -
Install the
yugabyteyum repository using the following command:sudo dnf install https://software.yugabyte.com/repos/reporpms/rhel-9/yb-yum-repo-1.1-0.noarch.rpm -y -
Install the
epel-releaserepository using the following command:sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm -y -
Install
mysql-community-releaserepository using the following command:sudo dnf install https://dev.mysql.com/get/mysql84-community-release-el9-2.noarch.rpm -y -
Install the PostgreSQL repositories using the following command:
sudo dnf --disablerepo=* install https://download.postgresql.org/pub/repos/yum/reporpms/EL-9-x86_64/pgdg-redhat-repo-latest.noarch.rpm -yThese repositories contain the rest of the dependencies required to run
yb-voyager. -
Disable the default
PostgreSQLyum module on your machine using the following command:sudo dnf -qy module disable postgresql -
Install
perl-openon your machine using the following command:sudo dnf install perl-open.noarch -y -
Install Oracle Instant Clients using the following command:
OIC_URL="https://download.oracle.com/otn_software/linux/instantclient/215000" && \ sudo dnf install -y \ ${OIC_URL}/oracle-instantclient-tools-21.5.0.0.0-1.x86_64.rpm \ ${OIC_URL}/oracle-instantclient-basic-21.5.0.0.0-1.x86_64.rpm \ ${OIC_URL}/oracle-instantclient-devel-21.5.0.0.0-1.x86_64.rpm \ ${OIC_URL}/oracle-instantclient-jdbc-21.5.0.0.0-1.x86_64.rpm \ ${OIC_URL}/oracle-instantclient-sqlplus-21.5.0.0.0-1.x86_64.rpm -
Update the yum package manager and all the packages and repositories installed on your machine using the following command:
sudo dnf update -
Install
yb-voyagerand its dependencies using the following command:sudo dnf install yb-voyagerTo install a specific version of
yb-voyageron your machine, use the following command:sudo dnf install yb-voyager-<VERSION> -
Check that yb-voyager is installed using the following command:
yb-voyager version
Dependencies
YugabyteDB Voyager relies on the following dependencies on RHEL 8 and RHEL 9 systems, which are automatically installed or resolved when you install Voyager using the official RPM package.
| Dependency | Version / Constraint |
|---|---|
| bash | – |
| binutils | > 2.25 |
| debezium | = 2.5.2-<voyager_version> |
| mysql-devel | – |
| oracle-instantclient-basic | = 21.5.0.0.0-1 |
| oracle-instantclient-devel | = 21.5.0.0.0-1 |
| oracle-instantclient-jdbc | = 21.5.0.0.0-1 |
| oracle-instantclient-sqlplus | = 21.5.0.0.0-1 |
| oracle-instantclient-tools | = 21.5.0.0.0-1 |
| ora2pg | = 23.2-yb.2 |
| postgresql17 | – |
| sqlite | – |
Upgrade yb-voyager
Upgrade yb-voyager using the following command:
sudo yum update yb-voyager