Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[DOC-479] Voyager 1.8.1 updates #23983

Merged
merged 9 commits into from
Sep 18, 2024
4 changes: 2 additions & 2 deletions docs/content/preview/yugabyte-voyager/airgapped.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down Expand Up @@ -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.
Expand Down
38 changes: 37 additions & 1 deletion docs/content/preview/yugabyte-voyager/install-yb-voyager.md
Original file line number Diff line number Diff line change
Expand Up @@ -106,7 +106,43 @@ Install yb-voyager on a machine which satisfies the [Prerequisites](#prerequisit
</div>
</div>

### Collect diagnostics
## Upgrade yb-voyager

{{< tabpane text=true >}}
aishwarya24 marked this conversation as resolved.
Show resolved Hide resolved

{{% 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.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
```
Expand Down
19 changes: 19 additions & 0 deletions docs/content/preview/yugabyte-voyager/release-notes.md
Original file line number Diff line number Diff line change
Expand Up @@ -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".
aishwarya24 marked this conversation as resolved.
Show resolved Hide resolved
- 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
Expand Down
9 changes: 8 additions & 1 deletion docs/content/preview/yugabyte-voyager/ubuntu.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down