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/install-yb-voyager.md b/docs/content/preview/yugabyte-voyager/install-yb-voyager.md index 3fabf3a0e748..a86b509a7903 100644 --- a/docs/content/preview/yugabyte-voyager/install-yb-voyager.md +++ b/docs/content/preview/yugabyte-voyager/install-yb-voyager.md @@ -106,7 +106,7 @@ Install yb-voyager on a machine which satisfies the [Prerequisites](#prerequisit -### 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/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/release-notes.md b/docs/content/preview/yugabyte-voyager/release-notes.md index 16ad813f43f4..0b1d28614a20 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 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. + +### 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..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 7818119bc4d1..754e20851f5f 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,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 +```