[DOC-479] Voyager 1.8.1 updates (#23983)

* some changes * more changes * added tabs for ubuntu and rhel upgrades * Apply suggestions from code review Co-authored-by: Dwight Hodge <[email protected]> * fixes to tabs * Update docs/content/preview/yugabyte-voyager/release-notes.md Co-authored-by: Dwight Hodge <[email protected]> * changes from review.. removed tabs --------- Co-authored-by: Dwight Hodge <[email protected]>
yugabyte · Sep 18, 2024 · 7659151 · 7659151
1 parent 7995311
commit 7659151
Show file tree

Hide file tree

Showing 6 changed files with 62 additions and 10 deletions.
diff --git 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
@@ -106,7 +106,7 @@ Install yb-voyager on a machine which satisfies the [Prerequisites](#prerequisit
   </div>
 </div>
 
-### 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
@@ -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
@@ -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
@@ -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
@@ -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
+```
-Original file line number
+Diff line change
@@ Expand Up @@
       </div>
     </div>
-    ### 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.
@@ Expand Down @@