--- title: "" url: "https://docs.yugabyte.com/stable/yugabyte-voyager/rhel/" --- # - RHEL 8 - RHEL 9 Perform the following steps to install yb-voyager using yum for RHEL 8 and CentOS 8: 01. Update the yum package manager, and all the packages and repositories installed on your machine using the following command: ```sh sudo yum update ``` 02. Install the `yugabyte` yum repository using the following command: ```sh sudo yum install https://software.yugabyte.com/repos/reporpms/rhel-8/yb-yum-repo-1.1-0.noarch.rpm ``` This repository contains the yb-voyager rpm and other dependencies required to run `yb-voyager`. 03. Install the `epel-release` repository using the following command: ```sh sudo yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm ``` 04. Install the Oracle instant client repositories using the following command: ```sh sudo yum install oracle-instant-clients-repo ``` 05. Install the PostgreSQL repositories using the following command: ```sh sudo yum --disablerepo=* -y install https://download.postgresql.org/pub/repos/yum/reporpms/EL-8-x86_64/pgdg-redhat-repo-latest.noarch.rpm ``` These repositories contain the rest of the dependencies required to run `yb-voyager`. 06. Disable the default `PostgreSQL` yum module on your machine using the following command: ```sh sudo dnf -qy module disable postgresql ``` 07. Install `perl-open` on your machine using the following command: ```sh sudo yum install perl-open.noarch ``` 08. Update the yum package manager and all the packages and repositories installed on your machine using the following command: ```sh sudo yum update ``` 09. Install `yb-voyager` and its dependencies using the following command: ```sh sudo yum install yb-voyager ``` To install a specific version of `yb-voyager` on your machine, use the following command: ```sh sudo yum install yb-voyager- ``` 10. Check that yb-voyager is installed using the following command: ```sh 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 | | postgresql18 | – | | sqlite | – | ### Upgrade yb-voyager Upgrade yb-voyager using the following command: ```sh sudo yum update yb-voyager ``` Perform the following steps to install yb-voyager using yum for RHEL 9 and CentOS 9: 01. Update the yum package manager, and all the packages and repositories installed on your machine using the following command: ```sh sudo dnf update ``` 02. Install the `yugabyte` yum repository using the following command: ```sh sudo dnf install https://software.yugabyte.com/repos/reporpms/rhel-9/yb-yum-repo-1.1-0.noarch.rpm -y ``` 03. Install the `epel-release` repository using the following command: ```sh sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm -y ``` 04. Install `mysql-community-release` repository using the following command: ```sh sudo dnf install https://dev.mysql.com/get/mysql84-community-release-el9-2.noarch.rpm -y ``` 05. Install the PostgreSQL repositories using the following command: ```sh sudo dnf --disablerepo=* install https://download.postgresql.org/pub/repos/yum/reporpms/EL-9-x86_64/pgdg-redhat-repo-latest.noarch.rpm -y ``` These repositories contain the rest of the dependencies required to run `yb-voyager`. 06. Disable the default `PostgreSQL` yum module on your machine using the following command: ```sh sudo dnf -qy module disable postgresql ``` 07. Install `perl-open` on your machine using the following command: ```sh sudo dnf install perl-open.noarch -y ``` 08. Install Oracle Instant Clients using the following command: ```sh 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 ``` 09. Update the yum package manager and all the packages and repositories installed on your machine using the following command: ```sh sudo dnf update ``` 10. Install `yb-voyager` and its dependencies using the following command: ```sh sudo dnf install yb-voyager ``` To install a specific version of `yb-voyager` on your machine, use the following command: ```sh sudo dnf install yb-voyager- ``` 11. Check that yb-voyager is installed using the following command: ```sh 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 | | postgresql18 | – | | sqlite | – | ### Upgrade yb-voyager Upgrade yb-voyager using the following command: ```sh sudo yum update yb-voyager ```