From a381a6674919b2f7fa330220263f733eb0371dfc Mon Sep 17 00:00:00 2001 From: aishwarya24 Date: Tue, 17 Sep 2024 14:57:04 -0400 Subject: [PATCH 1/7] some changes --- .../preview/yugabyte-voyager/airgapped.md | 4 ++-- .../migrate/assess-migration.md | 12 +++++----- .../preview/yugabyte-voyager/ubuntu.md | 24 ++++++++++++++++++- 3 files changed, 31 insertions(+), 9 deletions(-) diff --git a/docs/content/preview/yugabyte-voyager/airgapped.md b/docs/content/preview/yugabyte-voyager/airgapped.md index c4a348c7975b..748f5ce0b931 100644 --- a/docs/content/preview/yugabyte-voyager/airgapped.md +++ b/docs/content/preview/yugabyte-voyager/airgapped.md @@ -57,7 +57,7 @@ You can perform an airgapped installation on RHEL 8 and CentOS 8. 1. Download the airgapped bundle: ```sh - wget https://s3.us-west-2.amazonaws.com/downloads.yugabyte.com/repos/airgapped/yb-voyager-1.8.0-0-rhel-8-x86_64.tar.gz + wget https://s3.us-west-2.amazonaws.com/downloads.yugabyte.com/repos/airgapped/yb-voyager-1.8.1-0-rhel-8-x86_64.tar.gz ``` 1. Extract the bundle. @@ -171,7 +171,7 @@ You can perform an airgapped installation on Ubuntu 22 and later. 1. Download the airgapped bundle: ```sh - wget https://s3.us-west-2.amazonaws.com/downloads.yugabyte.com/repos/airgapped/yb-voyager-1.8.0_0_debian.tar.gz + wget https://s3.us-west-2.amazonaws.com/downloads.yugabyte.com/repos/airgapped/yb-voyager-1.8.1_0_debian.tar.gz ``` 1. Extract the bundle. diff --git a/docs/content/preview/yugabyte-voyager/migrate/assess-migration.md b/docs/content/preview/yugabyte-voyager/migrate/assess-migration.md index 1e2f27cebbdb..f0b5d81bcaf0 100644 --- a/docs/content/preview/yugabyte-voyager/migrate/assess-migration.md +++ b/docs/content/preview/yugabyte-voyager/migrate/assess-migration.md @@ -190,18 +190,18 @@ After the bulk assessment is completed, the top-level directory specified using ```sh /bulk-assessment-dir/ -├── bulkAssessmentReport.html -├── bulkAssessmentReport.json +├── bulk_assessment_report.html +├── bulk_assessment_report.json ├── DBNAME-SCHEMA1-export-dir/ │ └── assessment/ │ └── reports/ -│ ├── assessmentReport.html -│ └── assessmentReport.json +│ ├── migration_assessment_report.html +│ └── migration_assessment_report.json ├── SID-SCHEMA2-export-dir/ │ └── assessment/ │ └── reports/ -│ ├── assessmentReport.html -│ └── assessmentReport.json +│ ├── migration_assessment_report.html +│ └── migration_assessment_report.json └── logs/ └── yb-voyager-assess-migration-bulk.log ``` diff --git a/docs/content/preview/yugabyte-voyager/ubuntu.md b/docs/content/preview/yugabyte-voyager/ubuntu.md index 7818119bc4d1..1e23d27928c8 100644 --- a/docs/content/preview/yugabyte-voyager/ubuntu.md +++ b/docs/content/preview/yugabyte-voyager/ubuntu.md @@ -19,7 +19,14 @@ Perform the following steps to install yb-voyager using apt for Ubuntu: This repository contains the `yb-voyager` Debian package and the dependencies required to run `yb-voyager`. -1. Clean the `apt-get` cache and package lists using the following commands:: +1. Install the `postgresql-common` repository to fetch postgresql 16 using the following commands: + + ```sh + sudo apt install -y postgresql-common + sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh + ``` + +1. Clean the `apt-get` cache and package lists using the following commands: ```sh sudo apt-get clean @@ -55,3 +62,18 @@ Perform the following steps to install yb-voyager using apt for Ubuntu: ```sh yb-voyager version ``` + +### Upgrade yb-voyager + +1. If you are upgrading Voyager from v1.8.0 or earlier, you need to install the `postgresql-common` repository before the upgrade as follows: + +```sh +sudo apt install -y postgresql-common +sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh +``` + +1. Upgrade yb-voyager using the following command: + + ```sh + sudo apt-get upgrade yb-voyager + ``` From 53425b295c0523d0ffd1781f6fd403f34af7cb54 Mon Sep 17 00:00:00 2001 From: aishwarya24 Date: Tue, 17 Sep 2024 15:13:53 -0400 Subject: [PATCH 2/7] more changes --- .../preview/yugabyte-voyager/release-notes.md | 19 +++++++++++++++++++ docs/content/preview/yugabyte-voyager/rhel.md | 8 ++++++++ .../preview/yugabyte-voyager/ubuntu.md | 10 +++++----- 3 files changed, 32 insertions(+), 5 deletions(-) diff --git a/docs/content/preview/yugabyte-voyager/release-notes.md b/docs/content/preview/yugabyte-voyager/release-notes.md index 16ad813f43f4..f045786cd067 100644 --- a/docs/content/preview/yugabyte-voyager/release-notes.md +++ b/docs/content/preview/yugabyte-voyager/release-notes.md @@ -13,6 +13,25 @@ type: docs What follows are the release notes for the YugabyteDB Voyager v1 release series. Content will be added as new notable features and changes are available in the patch releases of the YugabyteDB v1 series. +## v1.8.1 - September 17, 2024 + +### Enhancements + +- The installation methods (including RHEL, Ubuntu, Brew, and the installer script) now install PostgreSQL 16 instead of PostgreSQL 14. +- Added support in [analyze schema](../reference/schema-migration/analyze-schema/) and [assess-migration](../reference/assess-migration/) to report issues in indexes on columns with complex data types, such as INET, CITEXT, JSONB, TSVECTOR, TSQUERY, and ARRAYs. In assess-migration, these data types are categorized under the common unsupported feature "Index on complex data types". +- Both [analyze schema](../reference/schema-migration/analyze-schema/) and [assess-migration](../reference/assess-migration/) now detect and report UNLOGGED tables, which are unsupported in YugabyteDB. +- Renamed report file names - "assessmentReport" to "migration_assessment_report", and "bulkAssessmentReport" to "bulk_assessment_report" . +- Improved UI output of [assess-migration](../reference/assess-migration/) by removing the progress bar from ora2pg when fetching the assessment report. + +### Bug Fixes + +- Fixed an issue in streaming phase of [import data](../reference/data-migration/import-data/) where conflicts between events that could cause unique constraint errors were not being detected properly. +- Fixed an issue in [analyze schema](../reference/schema-migration/analyze-schema/) where multi-column GIN indexes were incorrectly reported as an issue due to a regex misidentifying expression indexes that combine two columns. +- Fixed an issue in [analyze schema](../reference/schema-migration/analyze-schema/) where table or column names containing the keyword "cluster" were incorrectly reported as issues of the type, `ALTER TABLE CLUSTER ON`. +- Fixed an issue in [export-data-from-target](../reference/data-migration/export-data/#export-data-from-target) involving the new YugabyteDB CDC connector from Oracle sources. +- Fixed a schema registry issue in [import-data](../reference/data-migration/import-data/#import-data) where a "no such file or directory" error occurred. +- Fixed a bug where Voyager was unable to send details to YugabyteDB UI when upgrading from version 1.7.2 to 1.8 using the same yugabyted cluster. + ## v1.8 - September 3, 2024 ### New Features diff --git a/docs/content/preview/yugabyte-voyager/rhel.md b/docs/content/preview/yugabyte-voyager/rhel.md index d2ad2e04eaf6..c6f9df486d39 100644 --- a/docs/content/preview/yugabyte-voyager/rhel.md +++ b/docs/content/preview/yugabyte-voyager/rhel.md @@ -77,3 +77,11 @@ Install a specific version of `yb-voyager` on your machine using the following c ```sh yb-voyager version ``` + +### Upgrade yb-voyager + +Upgrade yb-voyager using the following command: + +```sh +sudo yum update yb-voyager +``` diff --git a/docs/content/preview/yugabyte-voyager/ubuntu.md b/docs/content/preview/yugabyte-voyager/ubuntu.md index 1e23d27928c8..7ec02fe9726a 100644 --- a/docs/content/preview/yugabyte-voyager/ubuntu.md +++ b/docs/content/preview/yugabyte-voyager/ubuntu.md @@ -65,12 +65,12 @@ Perform the following steps to install yb-voyager using apt for Ubuntu: ### Upgrade yb-voyager -1. If you are upgrading Voyager from v1.8.0 or earlier, you need to install the `postgresql-common` repository before the upgrade as follows: +1. 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: -```sh -sudo apt install -y postgresql-common -sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh -``` + ```sh + sudo apt install -y postgresql-common + sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh + ``` 1. Upgrade yb-voyager using the following command: From ef8714ecde61b502a7db45eca4f8c5f1643582f6 Mon Sep 17 00:00:00 2001 From: aishwarya24 Date: Tue, 17 Sep 2024 15:33:29 -0400 Subject: [PATCH 3/7] added tabs for ubuntu and rhel upgrades --- .../yugabyte-voyager/install-yb-voyager.md | 44 +++++++++++++++++++ docs/content/preview/yugabyte-voyager/rhel.md | 8 ---- .../preview/yugabyte-voyager/ubuntu.md | 15 ------- 3 files changed, 44 insertions(+), 23 deletions(-) diff --git a/docs/content/preview/yugabyte-voyager/install-yb-voyager.md b/docs/content/preview/yugabyte-voyager/install-yb-voyager.md index 3fabf3a0e748..b1550c460049 100644 --- a/docs/content/preview/yugabyte-voyager/install-yb-voyager.md +++ b/docs/content/preview/yugabyte-voyager/install-yb-voyager.md @@ -106,6 +106,50 @@ Install yb-voyager on a machine which satisfies the [Prerequisites](#prerequisit +### Upgrade yb-voyager + +Upgrade yb-voyager using the following command: + +```sh +sudo yum update yb-voyager +``` + +## Upgrade yb-voyager + +{{< tabpane text=true >}} + + {{% tab header="RHEL" %}} + +{{< note title="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: + +```sh +sudo apt install -y postgresql-common +sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh +``` + +{{< /note >}} + +Upgrade yb-voyager using the following command: + +```sh +sudo apt-get upgrade yb-voyager +``` + + {{% /tab %}} + + {{% tab header="Ubuntu" %}} + +Upgrade yb-voyager using the following command: + +```sh +sudo apt-get upgrade yb-voyager +``` + + {{% /tab %}} + +{{< /tabpane >}} + ### Collect diagnostics By default, yb-voyager captures a [diagnostics report](../diagnostics-report/) using the YugabyteDB diagnostics service that runs each time you use the yb-voyager command. If you don't want to send diagnostics when you run yb-voyager, set the [--send-diagnostics flag](../diagnostics-report/#configuration-flag) to false. diff --git a/docs/content/preview/yugabyte-voyager/rhel.md b/docs/content/preview/yugabyte-voyager/rhel.md index c6f9df486d39..d2ad2e04eaf6 100644 --- a/docs/content/preview/yugabyte-voyager/rhel.md +++ b/docs/content/preview/yugabyte-voyager/rhel.md @@ -77,11 +77,3 @@ Install a specific version of `yb-voyager` on your machine using the following c ```sh yb-voyager version ``` - -### Upgrade yb-voyager - -Upgrade yb-voyager using the following command: - -```sh -sudo yum update yb-voyager -``` diff --git a/docs/content/preview/yugabyte-voyager/ubuntu.md b/docs/content/preview/yugabyte-voyager/ubuntu.md index 7ec02fe9726a..309619fa2ccb 100644 --- a/docs/content/preview/yugabyte-voyager/ubuntu.md +++ b/docs/content/preview/yugabyte-voyager/ubuntu.md @@ -62,18 +62,3 @@ Perform the following steps to install yb-voyager using apt for Ubuntu: ```sh yb-voyager version ``` - -### Upgrade yb-voyager - -1. 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: - - ```sh - sudo apt install -y postgresql-common - sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh - ``` - -1. Upgrade yb-voyager using the following command: - - ```sh - sudo apt-get upgrade yb-voyager - ``` From e21e4e5bd6d134432912ea7e6b3f27ee4a379667 Mon Sep 17 00:00:00 2001 From: Aishwarya Chakravarthy Date: Tue, 17 Sep 2024 17:57:31 -0400 Subject: [PATCH 4/7] Apply suggestions from code review Co-authored-by: Dwight Hodge <79169168+ddhodge@users.noreply.github.com> --- docs/content/preview/yugabyte-voyager/install-yb-voyager.md | 2 +- docs/content/preview/yugabyte-voyager/release-notes.md | 4 ++-- docs/content/preview/yugabyte-voyager/ubuntu.md | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/content/preview/yugabyte-voyager/install-yb-voyager.md b/docs/content/preview/yugabyte-voyager/install-yb-voyager.md index b1550c460049..0d70d854fe57 100644 --- a/docs/content/preview/yugabyte-voyager/install-yb-voyager.md +++ b/docs/content/preview/yugabyte-voyager/install-yb-voyager.md @@ -150,7 +150,7 @@ sudo apt-get upgrade yb-voyager {{< /tabpane >}} -### Collect diagnostics +## Collect diagnostics By default, yb-voyager captures a [diagnostics report](../diagnostics-report/) using the YugabyteDB diagnostics service that runs each time you use the yb-voyager command. If you don't want to send diagnostics when you run yb-voyager, set the [--send-diagnostics flag](../diagnostics-report/#configuration-flag) to false. diff --git a/docs/content/preview/yugabyte-voyager/release-notes.md b/docs/content/preview/yugabyte-voyager/release-notes.md index f045786cd067..351feafcd8e6 100644 --- a/docs/content/preview/yugabyte-voyager/release-notes.md +++ b/docs/content/preview/yugabyte-voyager/release-notes.md @@ -20,14 +20,14 @@ What follows are the release notes for the YugabyteDB Voyager v1 release series. - The installation methods (including RHEL, Ubuntu, Brew, and the installer script) now install PostgreSQL 16 instead of PostgreSQL 14. - Added support in [analyze schema](../reference/schema-migration/analyze-schema/) and [assess-migration](../reference/assess-migration/) to report issues in indexes on columns with complex data types, such as INET, CITEXT, JSONB, TSVECTOR, TSQUERY, and ARRAYs. In assess-migration, these data types are categorized under the common unsupported feature "Index on complex data types". - Both [analyze schema](../reference/schema-migration/analyze-schema/) and [assess-migration](../reference/assess-migration/) now detect and report UNLOGGED tables, which are unsupported in YugabyteDB. -- Renamed report file names - "assessmentReport" to "migration_assessment_report", and "bulkAssessmentReport" to "bulk_assessment_report" . +- Changed assessment report file names from "assessmentReport" to "migration_assessment_report", and "bulkAssessmentReport" to "bulk_assessment_report" . - Improved UI output of [assess-migration](../reference/assess-migration/) by removing the progress bar from ora2pg when fetching the assessment report. ### Bug Fixes - Fixed an issue in streaming phase of [import data](../reference/data-migration/import-data/) where conflicts between events that could cause unique constraint errors were not being detected properly. - Fixed an issue in [analyze schema](../reference/schema-migration/analyze-schema/) where multi-column GIN indexes were incorrectly reported as an issue due to a regex misidentifying expression indexes that combine two columns. -- Fixed an issue in [analyze schema](../reference/schema-migration/analyze-schema/) where table or column names containing the keyword "cluster" were incorrectly reported as issues of the type, `ALTER TABLE CLUSTER ON`. +- Fixed an issue in [analyze schema](../reference/schema-migration/analyze-schema/) where table or column names containing the keyword "cluster" were incorrectly reported as issues of the type `ALTER TABLE CLUSTER ON`. - Fixed an issue in [export-data-from-target](../reference/data-migration/export-data/#export-data-from-target) involving the new YugabyteDB CDC connector from Oracle sources. - Fixed a schema registry issue in [import-data](../reference/data-migration/import-data/#import-data) where a "no such file or directory" error occurred. - Fixed a bug where Voyager was unable to send details to YugabyteDB UI when upgrading from version 1.7.2 to 1.8 using the same yugabyted cluster. diff --git a/docs/content/preview/yugabyte-voyager/ubuntu.md b/docs/content/preview/yugabyte-voyager/ubuntu.md index 309619fa2ccb..2f7d67593318 100644 --- a/docs/content/preview/yugabyte-voyager/ubuntu.md +++ b/docs/content/preview/yugabyte-voyager/ubuntu.md @@ -19,7 +19,7 @@ Perform the following steps to install yb-voyager using apt for Ubuntu: This repository contains the `yb-voyager` Debian package and the dependencies required to run `yb-voyager`. -1. Install the `postgresql-common` repository to fetch postgresql 16 using the following commands: +1. Install the `postgresql-common` repository to fetch PostgreSQL 16 using the following commands: ```sh sudo apt install -y postgresql-common From 224a20e7a04c9526a9520edcc79c1c3697e4fd4b Mon Sep 17 00:00:00 2001 From: aishwarya24 Date: Tue, 17 Sep 2024 18:04:29 -0400 Subject: [PATCH 5/7] fixes to tabs --- .../yugabyte-voyager/install-yb-voyager.md | 22 ++++++------------- 1 file changed, 7 insertions(+), 15 deletions(-) diff --git a/docs/content/preview/yugabyte-voyager/install-yb-voyager.md b/docs/content/preview/yugabyte-voyager/install-yb-voyager.md index 0d70d854fe57..482fd03048b3 100644 --- a/docs/content/preview/yugabyte-voyager/install-yb-voyager.md +++ b/docs/content/preview/yugabyte-voyager/install-yb-voyager.md @@ -106,7 +106,11 @@ Install yb-voyager on a machine which satisfies the [Prerequisites](#prerequisit -### Upgrade yb-voyager +## Upgrade yb-voyager + +{{< tabpane text=true >}} + + {{% tab header="RHEL" %}} Upgrade yb-voyager using the following command: @@ -114,11 +118,9 @@ Upgrade yb-voyager using the following command: sudo yum update yb-voyager ``` -## Upgrade yb-voyager - -{{< tabpane text=true >}} + {{% /tab %}} - {{% tab header="RHEL" %}} + {{% tab header="Ubuntu" %}} {{< note title="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: @@ -132,16 +134,6 @@ sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh Upgrade yb-voyager using the following command: -```sh -sudo apt-get upgrade yb-voyager -``` - - {{% /tab %}} - - {{% tab header="Ubuntu" %}} - -Upgrade yb-voyager using the following command: - ```sh sudo apt-get upgrade yb-voyager ``` From df5b4544860b1d81192165f7e296bab7f5995295 Mon Sep 17 00:00:00 2001 From: Aishwarya Chakravarthy Date: Wed, 18 Sep 2024 08:32:45 -0400 Subject: [PATCH 6/7] Update docs/content/preview/yugabyte-voyager/release-notes.md Co-authored-by: Dwight Hodge <79169168+ddhodge@users.noreply.github.com> --- docs/content/preview/yugabyte-voyager/release-notes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/content/preview/yugabyte-voyager/release-notes.md b/docs/content/preview/yugabyte-voyager/release-notes.md index 351feafcd8e6..0b1d28614a20 100644 --- a/docs/content/preview/yugabyte-voyager/release-notes.md +++ b/docs/content/preview/yugabyte-voyager/release-notes.md @@ -18,7 +18,7 @@ What follows are the release notes for the YugabyteDB Voyager v1 release series. ### Enhancements - The installation methods (including RHEL, Ubuntu, Brew, and the installer script) now install PostgreSQL 16 instead of PostgreSQL 14. -- Added support in [analyze schema](../reference/schema-migration/analyze-schema/) and [assess-migration](../reference/assess-migration/) to report issues in indexes on columns with complex data types, such as INET, CITEXT, JSONB, TSVECTOR, TSQUERY, and ARRAYs. In assess-migration, these data types are categorized under the common unsupported feature "Index on complex data types". +- Added support in [analyze schema](../reference/schema-migration/analyze-schema/) and [assess-migration](../reference/assess-migration/) to report issues with indexes on columns with complex data types, such as INET, CITEXT, JSONB, TSVECTOR, TSQUERY, and ARRAYs. assess-migration categorizes these issues under the [Index on complex data types](../known-issues/postgresql/#indexes-on-some-complex-data-types-are-not-supported) PostgreSQL unsupported feature. - Both [analyze schema](../reference/schema-migration/analyze-schema/) and [assess-migration](../reference/assess-migration/) now detect and report UNLOGGED tables, which are unsupported in YugabyteDB. - Changed assessment report file names from "assessmentReport" to "migration_assessment_report", and "bulkAssessmentReport" to "bulk_assessment_report" . - Improved UI output of [assess-migration](../reference/assess-migration/) by removing the progress bar from ora2pg when fetching the assessment report. From 4ec4eae685282f747e4ef20be38870d5721db5ee Mon Sep 17 00:00:00 2001 From: aishwarya24 Date: Wed, 18 Sep 2024 11:03:40 -0400 Subject: [PATCH 7/7] changes from review.. removed tabs --- .../yugabyte-voyager/install-yb-voyager.md | 36 ------------------- docs/content/preview/yugabyte-voyager/rhel.md | 8 +++++ .../preview/yugabyte-voyager/ubuntu.md | 18 ++++++++++ 3 files changed, 26 insertions(+), 36 deletions(-) diff --git a/docs/content/preview/yugabyte-voyager/install-yb-voyager.md b/docs/content/preview/yugabyte-voyager/install-yb-voyager.md index 482fd03048b3..a86b509a7903 100644 --- a/docs/content/preview/yugabyte-voyager/install-yb-voyager.md +++ b/docs/content/preview/yugabyte-voyager/install-yb-voyager.md @@ -106,42 +106,6 @@ Install yb-voyager on a machine which satisfies the [Prerequisites](#prerequisit -## Upgrade yb-voyager - -{{< tabpane text=true >}} - - {{% tab header="RHEL" %}} - -Upgrade yb-voyager using the following command: - -```sh -sudo yum update yb-voyager -``` - - {{% /tab %}} - - {{% tab header="Ubuntu" %}} - -{{< note title="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: - -```sh -sudo apt install -y postgresql-common -sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh -``` - -{{< /note >}} - -Upgrade yb-voyager using the following command: - -```sh -sudo apt-get upgrade yb-voyager -``` - - {{% /tab %}} - -{{< /tabpane >}} - ## Collect diagnostics By default, yb-voyager captures a [diagnostics report](../diagnostics-report/) using the YugabyteDB diagnostics service that runs each time you use the yb-voyager command. If you don't want to send diagnostics when you run yb-voyager, set the [--send-diagnostics flag](../diagnostics-report/#configuration-flag) to false. diff --git a/docs/content/preview/yugabyte-voyager/rhel.md b/docs/content/preview/yugabyte-voyager/rhel.md index d2ad2e04eaf6..0efe7f931642 100644 --- a/docs/content/preview/yugabyte-voyager/rhel.md +++ b/docs/content/preview/yugabyte-voyager/rhel.md @@ -77,3 +77,11 @@ Install a specific version of `yb-voyager` on your machine using the following c ```sh yb-voyager version ``` + +### Upgrade yb-voyager + +Upgrade yb-voyager using the following command: + +```sh +sudo yum update yb-voyager +``` \ No newline at end of file diff --git a/docs/content/preview/yugabyte-voyager/ubuntu.md b/docs/content/preview/yugabyte-voyager/ubuntu.md index 2f7d67593318..754e20851f5f 100644 --- a/docs/content/preview/yugabyte-voyager/ubuntu.md +++ b/docs/content/preview/yugabyte-voyager/ubuntu.md @@ -62,3 +62,21 @@ Perform the following steps to install yb-voyager using apt for Ubuntu: ```sh yb-voyager version ``` + +### Upgrade yb-voyager + +{{< note title="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: + +```sh +sudo apt install -y postgresql-common +sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh +``` + +{{< /note >}} + +Upgrade yb-voyager using the following command: + +```sh +sudo apt-get upgrade yb-voyager +```