Skip to content

Commit

Permalink
links
Browse files Browse the repository at this point in the history
  • Loading branch information
ddhodge committed Aug 12, 2024
1 parent b55fd40 commit a1b55f1
Show file tree
Hide file tree
Showing 8 changed files with 36 additions and 36 deletions.
6 changes: 3 additions & 3 deletions docs/content/preview/manage/data-migration/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,10 +17,10 @@ Migrating to YugabyteDB, a high-performance distributed SQL database, involves a

## YugabyteDB Voyager

Yugabyte ships [YugabyteDB Voyager](../../yugabyte-voyager/), a comprehensive data migration tool designed specifically to help users migrate from traditional databases like PostgreSQL, Oracle, MySQL, and others to YugabyteDB. It offers a variety of features that make the migration process smoother, more reliable, and less error-prone.
Yugabyte ships [YugabyteDB Voyager](/preview/yugabyte-voyager/), a comprehensive data migration tool designed specifically to help users migrate from traditional databases like PostgreSQL, Oracle, MySQL, and others to YugabyteDB. It offers a variety of features that make the migration process smoother, more reliable, and less error-prone.

{{<lead link="../../yugabyte-voyager/migrate/">}}
To learn more about how to methodically export using YB Voyager, see [Migrate](../../yugabyte-voyager/migrate/).
{{<lead link="/preview/yugabyte-voyager/migrate/">}}
To learn more about how to methodically export using YB Voyager, see [Migrate](/preview/yugabyte-voyager/migrate/).
{{</lead>}}

## Export your data
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ The recommended way to export data from PostgreSQL for purposes of importing it
To export an entire database that consists of smaller datasets, you can also use the YugabyteDB [ysql_dump](../../../admin/ysql-dump/) utility.

{{< tip title="Migrate using YugabyteDB Voyager" >}}
To automate your migration from PostgreSQL to YugabyteDB, use [YugabyteDB Voyager](../../../yugabyte-voyager/). To learn more, refer to the [export schema](../../../yugabyte-voyager/migrate/migrate-steps/#export-schema) and [export data](../../../yugabyte-voyager/migrate/migrate-steps/#export-data) steps.
To automate your migration from PostgreSQL to YugabyteDB, use [YugabyteDB Voyager](/preview/yugabyte-voyager/). To learn more, refer to the [export schema](/preview/yugabyte-voyager/migrate/migrate-steps/#export-schema) and [export data](/preview/yugabyte-voyager/migrate/migrate-steps/#export-data) steps.
{{< /tip >}}

## Export data into CSV files using the COPY command
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,7 @@ While loading data that is exported from another RDBMS, the source data set may
## Import PostgreSQL data

{{< tip title="Migrate using YugabyteDB Voyager" >}}
To automate your migration from PostgreSQL to YugabyteDB, use [YugabyteDB Voyager](../../../yugabyte-voyager/). To learn more, refer to the [import schema](../../../yugabyte-voyager/migrate/migrate-steps/#import-schema) and [import data](../../../yugabyte-voyager/migrate/migrate-steps/#import-data) steps.
To automate your migration from PostgreSQL to YugabyteDB, use [YugabyteDB Voyager](/preview/yugabyte-voyager/). To learn more, refer to the [import schema](/preview/yugabyte-voyager/migrate/migrate-steps/#import-schema) and [import data](/preview/yugabyte-voyager/migrate/migrate-steps/#import-data) steps.
{{< /tip >}}

### Import data from CSV files
Expand Down
26 changes: 13 additions & 13 deletions docs/content/preview/manage/data-migration/migrate-from-postgres.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ rightNav:
The following guide is designed to help you smoothly transition your data and applications from a monolithic PostgreSQL database to YugabyteDB's distributed architecture. The guide walks you through the essential steps and best practices for migrating your data, including planning the migration, transforming your schema, migrating your data, and optimizing your applications for a distributed environment. By following these steps, you can minimize downtime, preserve data integrity, and leverage YugabyteDB's advanced features to meet your evolving business needs.

{{<tip title="Migrate using YugabyteDB Voyager">}}
Manage end-to-end database migration, including cluster preparation, schema migration, and data migration, using [YugabyteDB Voyager](../../../yugabyte-voyager/). Voyager is designed to handle various corner cases correctly to minimize errors and achieve faster migration.
Manage end-to-end database migration, including cluster preparation, schema migration, and data migration, using [YugabyteDB Voyager](/preview/yugabyte-voyager/). Voyager is designed to handle various corner cases correctly to minimize errors and achieve faster migration.
{{</tip>}}

## PostgreSQL compatibility
Expand Down Expand Up @@ -125,11 +125,11 @@ You can use the [ysql_dump](../../../admin/ysql-dump/) utility to export a Yugab
ysql_dump --schema-only -h source_host -U source_user source_db > schema.sql
```

If you are using YubabyteDB Voyager, use the [yb-voyager export schema](../../../yugabyte-voyager/reference/schema-migration/export-schema/) command.
If you are using YubabyteDB Voyager, use the [yb-voyager export schema](/preview/yugabyte-voyager/reference/schema-migration/export-schema/) command.

### Changes to schema

Depending on the use case, your schema may require the following changes. You can also use [yb-voyager analyze schema](../../../yugabyte-voyager/reference/schema-migration/analyze-schema/) command to analyze the schema and get suggestions for modifications.
Depending on the use case, your schema may require the following changes. You can also use [yb-voyager analyze schema](/preview/yugabyte-voyager/reference/schema-migration/analyze-schema/) command to analyze the schema and get suggestions for modifications.

#### Specify `PRIMARY KEY` inline

Expand Down Expand Up @@ -185,7 +185,7 @@ After completing your schema changes, you can use ysqlsh to import the modified
ysqlsh -h yugabyte_host -U yugabyte_user -d yugabyte_db -f schema.sql
```

If you are using YubabyteDB Voyager, use the [yb-voyage import schema](../../../yugabyte-voyager/reference/schema-migration/import-schema/) command.
If you are using YubabyteDB Voyager, use the [yb-voyage import schema](/preview/yugabyte-voyager/reference/schema-migration/import-schema/) command.

## Data migration

Expand All @@ -195,15 +195,15 @@ The data from the source PostgreSQL database can be exported either using the [C
ysql_dump --data-only --disable-triggers -h source_host -U source_user source_db > data.sql
```

If you are using YubabyteDB Voyager, use the [yb-voyager export data](../../../yugabyte-voyager/reference/data-migration/export-data/) command (recommended).
If you are using YubabyteDB Voyager, use the [yb-voyager export data](/preview/yugabyte-voyager/reference/data-migration/export-data/) command (recommended).

Import the exported data into YugabyteDB using [COPY FROM](../../../manage/data-migration/bulk-import-ysql/#import-data-from-csv-files) command or using ysqlsh as follows:

```bash
ysqlsh -h yugabyte_host -U yugabyte_user -d yugabyte_db -f data.sql
```

If you are using YubabyteDB Voyager, use the [yb-voyager import data](../../../yugabyte-voyager/reference/data-migration/import-data/) command.
If you are using YubabyteDB Voyager, use the [yb-voyager import data](/preview/yugabyte-voyager/reference/data-migration/import-data/) command.

### What to migrate

Expand All @@ -221,26 +221,26 @@ Regardless of how much data you decide to migrate, you can choose from the follo

**Offline migration**: You can take down the system and import the exported data. This approach is typically used when downtime is acceptable or the system is not required to be available during the migration.

{{<lead link="../../../yugabyte-voyager/migrate/migrate-steps/">}}
For more details, see [Offline migration](../../../yugabyte-voyager/migrate/migrate-steps/).
{{<lead link="/preview/yugabyte-voyager/migrate/migrate-steps/">}}
For more details, see [Offline migration](/preview/yugabyte-voyager/migrate/migrate-steps/).
{{</lead>}}

**Live migration**: Live migration aims to minimize downtime by keeping the application running during the migration process. Data is copied from the source database to the target database while the application is still live, and a final switchover is made after the migration is complete.

{{<lead link="../../../yugabyte-voyager/migrate/live-migrate/">}}
For more details, see [Live migration](../../../yugabyte-voyager/migrate/live-migrate/).
{{<lead link="/preview/yugabyte-voyager/migrate/live-migrate/">}}
For more details, see [Live migration](/preview/yugabyte-voyager/migrate/live-migrate/).
{{</lead>}}

**Live migration with fall-forward**: Live migration with fall-forward is a variant of live migration where, after the application has switched to the new database, there is no option to revert to the old database. This strategy is typically used when the new database is considered stable and there is confidence in the migration process.

{{<lead link="../../../yugabyte-voyager/migrate/live-fall-forward/">}}
For more details, see [Live migration with fall-forward](../../../yugabyte-voyager/migrate/live-fall-forward/).
{{<lead link="/preview/yugabyte-voyager/migrate/live-fall-forward/">}}
For more details, see [Live migration with fall-forward](/preview/yugabyte-voyager/migrate/live-fall-forward/).
{{</lead>}}

**Live migration with fall-back**: Live migration with fall-back provides a safety net by allowing a return to the original database if issues are encountered after the cutover to the new database. This strategy involves maintaining bidirectional synchronization between the source and target databases for a period after the migration.

{{<lead link="">}}
For more details, see [Live migration with fall-back](../../../yugabyte-voyager/migrate/live-fall-back/).
For more details, see [Live migration with fall-back](/preview/yugabyte-voyager/migrate/live-fall-back/).
{{</lead>}}

## Application migration
Expand Down
6 changes: 3 additions & 3 deletions docs/content/stable/manage/data-migration/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,10 +17,10 @@ Migrating to YugabyteDB, a high-performance distributed SQL database, involves a

## YugabyteDB Voyager

Yugabyte ships [YugabyteDB Voyager](../../yugabyte-voyager/), a comprehensive data migration tool designed specifically to help users migrate from traditional databases like PostgreSQL, Oracle, MySQL, and others to YugabyteDB. It offers a variety of features that make the migration process smoother, more reliable, and less error-prone.
Yugabyte ships [YugabyteDB Voyager](/preview/yugabyte-voyager/), a comprehensive data migration tool designed specifically to help users migrate from traditional databases like PostgreSQL, Oracle, MySQL, and others to YugabyteDB. It offers a variety of features that make the migration process smoother, more reliable, and less error-prone.

{{<lead link="../../yugabyte-voyager/migrate/">}}
To learn more about how to methodically export using YB Voyager, see [Migrate](../../yugabyte-voyager/migrate/).
{{<lead link="/preview/yugabyte-voyager/migrate/">}}
To learn more about how to methodically export using YB Voyager, see [Migrate](/preview/yugabyte-voyager/migrate/).
{{</lead>}}

## Export your data
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ The recommended way to export data from PostgreSQL for purposes of importing it
To export an entire database that consists of smaller datasets, you can also use the YugabyteDB [ysql_dump](../../../admin/ysql-dump/) utility.

{{< tip title="Migrate using YugabyteDB Voyager" >}}
To automate your migration from PostgreSQL to YugabyteDB, use [YugabyteDB Voyager](../../../yugabyte-voyager/). To learn more, refer to the [export schema](../../../yugabyte-voyager/migrate/migrate-steps/#export-schema) and [export data](../../../yugabyte-voyager/migrate/migrate-steps/#export-data) steps.
To automate your migration from PostgreSQL to YugabyteDB, use [YugabyteDB Voyager](/preview/yugabyte-voyager/). To learn more, refer to the [export schema](/preview/yugabyte-voyager/migrate/migrate-steps/#export-schema) and [export data](/preview/yugabyte-voyager/migrate/migrate-steps/#export-data) steps.
{{< /tip >}}

## Export data into CSV files using the COPY command
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,7 @@ While loading data that is exported from another RDBMS, the source data set may
## Import PostgreSQL data

{{< tip title="Migrate using YugabyteDB Voyager" >}}
To automate your migration from PostgreSQL to YugabyteDB, use [YugabyteDB Voyager](../../../yugabyte-voyager/). To learn more, refer to the [import schema](../../../yugabyte-voyager/migrate/migrate-steps/#import-schema) and [import data](../../../yugabyte-voyager/migrate/migrate-steps/#import-data) steps.
To automate your migration from PostgreSQL to YugabyteDB, use [YugabyteDB Voyager](/preview/yugabyte-voyager/). To learn more, refer to the [import schema](/preview/yugabyte-voyager/migrate/migrate-steps/#import-schema) and [import data](/preview/yugabyte-voyager/migrate/migrate-steps/#import-data) steps.
{{< /tip >}}

### Import data from CSV files
Expand Down
26 changes: 13 additions & 13 deletions docs/content/stable/manage/data-migration/migrate-from-postgres.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ rightNav:
The following guide is designed to help you smoothly transition your data and applications from a monolithic PostgreSQL database to YugabyteDB's distributed architecture. The guide walks you through the essential steps and best practices for migrating your data, including planning the migration, transforming your schema, migrating your data, and optimizing your applications for a distributed environment. By following these steps, you can minimize downtime, preserve data integrity, and leverage YugabyteDB's advanced features to meet your evolving business needs.

{{<tip title="Migrate using YugabyteDB Voyager">}}
Manage end-to-end database migration, including cluster preparation, schema migration, and data migration, using [YugabyteDB Voyager](../../../yugabyte-voyager/). Voyager is designed to handle various corner cases correctly to minimize errors and achieve faster migration.
Manage end-to-end database migration, including cluster preparation, schema migration, and data migration, using [YugabyteDB Voyager](/preview/yugabyte-voyager/). Voyager is designed to handle various corner cases correctly to minimize errors and achieve faster migration.
{{</tip>}}

## PostgreSQL compatibility
Expand Down Expand Up @@ -125,11 +125,11 @@ You can use the [ysql_dump](../../../admin/ysql-dump/) utility to export a Yugab
ysql_dump --schema-only -h source_host -U source_user source_db > schema.sql
```

If you are using YubabyteDB Voyager, use the [yb-voyager export schema](../../../yugabyte-voyager/reference/schema-migration/export-schema/) command.
If you are using YubabyteDB Voyager, use the [yb-voyager export schema](/preview/yugabyte-voyager/reference/schema-migration/export-schema/) command.

### Changes to schema

Depending on the use case, your schema may require the following changes. You can also use [yb-voyager analyze schema](../../../yugabyte-voyager/reference/schema-migration/analyze-schema/) command to analyze the schema and get suggestions for modifications.
Depending on the use case, your schema may require the following changes. You can also use [yb-voyager analyze schema](/preview/yugabyte-voyager/reference/schema-migration/analyze-schema/) command to analyze the schema and get suggestions for modifications.

#### Specify `PRIMARY KEY` inline

Expand Down Expand Up @@ -185,7 +185,7 @@ After completing your schema changes, you can use ysqlsh to import the modified
ysqlsh -h yugabyte_host -U yugabyte_user -d yugabyte_db -f schema.sql
```

If you are using YubabyteDB Voyager, use the [yb-voyage import schema](../../../yugabyte-voyager/reference/schema-migration/import-schema/) command.
If you are using YubabyteDB Voyager, use the [yb-voyage import schema](/preview/yugabyte-voyager/reference/schema-migration/import-schema/) command.

## Data migration

Expand All @@ -195,15 +195,15 @@ The data from the source PostgreSQL database can be exported either using the [C
ysql_dump --data-only --disable-triggers -h source_host -U source_user source_db > data.sql
```

If you are using YubabyteDB Voyager, use the [yb-voyager export data](../../../yugabyte-voyager/reference/data-migration/export-data/) command (recommended).
If you are using YubabyteDB Voyager, use the [yb-voyager export data](/preview/yugabyte-voyager/reference/data-migration/export-data/) command (recommended).

Import the exported data into YugabyteDB using [COPY FROM](../../../manage/data-migration/bulk-import-ysql/#import-data-from-csv-files) command or using ysqlsh as follows:

```bash
ysqlsh -h yugabyte_host -U yugabyte_user -d yugabyte_db -f data.sql
```

If you are using YubabyteDB Voyager, use the [yb-voyager import data](../../../yugabyte-voyager/reference/data-migration/import-data/) command.
If you are using YubabyteDB Voyager, use the [yb-voyager import data](/preview/yugabyte-voyager/reference/data-migration/import-data/) command.

### What to migrate

Expand All @@ -221,26 +221,26 @@ Regardless of how much data you decide to migrate, you can choose from the follo

**Offline migration**: You can take down the system and import the exported data. This approach is typically used when downtime is acceptable or the system is not required to be available during the migration.

{{<lead link="../../../yugabyte-voyager/migrate/migrate-steps/">}}
For more details, see [Offline migration](../../../yugabyte-voyager/migrate/migrate-steps/).
{{<lead link="/preview/yugabyte-voyager/migrate/migrate-steps/">}}
For more details, see [Offline migration](/preview/yugabyte-voyager/migrate/migrate-steps/).
{{</lead>}}

**Live migration**: Live migration aims to minimize downtime by keeping the application running during the migration process. Data is copied from the source database to the target database while the application is still live, and a final switchover is made after the migration is complete.

{{<lead link="../../../yugabyte-voyager/migrate/live-migrate/">}}
For more details, see [Live migration](../../../yugabyte-voyager/migrate/live-migrate/).
{{<lead link="/preview/yugabyte-voyager/migrate/live-migrate/">}}
For more details, see [Live migration](/preview/yugabyte-voyager/migrate/live-migrate/).
{{</lead>}}

**Live migration with fall-forward**: Live migration with fall-forward is a variant of live migration where, after the application has switched to the new database, there is no option to revert to the old database. This strategy is typically used when the new database is considered stable and there is confidence in the migration process.

{{<lead link="../../../yugabyte-voyager/migrate/live-fall-forward/">}}
For more details, see [Live migration with fall-forward](../../../yugabyte-voyager/migrate/live-fall-forward/).
{{<lead link="/preview/yugabyte-voyager/migrate/live-fall-forward/">}}
For more details, see [Live migration with fall-forward](/preview/yugabyte-voyager/migrate/live-fall-forward/).
{{</lead>}}

**Live migration with fall-back**: Live migration with fall-back provides a safety net by allowing a return to the original database if issues are encountered after the cutover to the new database. This strategy involves maintaining bidirectional synchronization between the source and target databases for a period after the migration.

{{<lead link="">}}
For more details, see [Live migration with fall-back](../../../yugabyte-voyager/migrate/live-fall-back/).
For more details, see [Live migration with fall-back](/preview/yugabyte-voyager/migrate/live-fall-back/).
{{</lead>}}

## Application migration
Expand Down

0 comments on commit a1b55f1

Please sign in to comment.