Skip to content

Commit 9dbbe62

Browse files
TxEventQ Migration TOC (#1022)
Signed-off-by: Anders Swanson <anders.swanson@oracle.com>
1 parent 3afc612 commit 9dbbe62

File tree

1 file changed

+12
-7
lines changed
  • docs-source/transactional-event-queues/content/aq-migration

1 file changed

+12
-7
lines changed

docs-source/transactional-event-queues/content/aq-migration/migration.md

Lines changed: 12 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,24 @@
11
+++
22
archetype = "page"
3-
title = "AQ Migration
3+
title = "AQ Migration"
44
weight = 1
55
+++
66

77
This section covers the use of the [DBMS_AQMIGTOOL](https://docs.oracle.com/en/database/oracle/oracle-database/23/arpls/DBMS_AQMIGTOOL.html) package for migrating Advanced Queuing (AQ) classic queues to TxEventQ.
88

99
Users of AQ are recommended to migrate to TxEventQ for increased support, performance, and access to new database features. It is recommended to read through the document fully before attempting migration.
1010

11+
* [DBMS_AQMIGTOOL Overview](#dbms_aqmigtool-overview)
12+
* [Migration Workflow](#migration-workflow)
13+
* [Checking Compatibility](#checking-compatibility)
14+
* [Initiating Migration](#initiating-migration)
15+
* [Checking Migration Status](#checking-migration-status)
16+
* [Commit the Migration](#commit-the-migration)
17+
* [Checking and Handling Migration Errors](#checking-and-handling-migration-errors)
18+
* [Cancelling and Recovering Migration](#cancelling-and-recovering-migration)
19+
* [Limitations and Workarounds](#limitations-and-workarounds)
20+
21+
1122
## DBMS_AQMIGTOOL Overview
1223

1324
The migration tool interface provides the following functionalities:
@@ -17,17 +28,11 @@ The migration tool interface provides the following functionalities:
1728
- DBMS_AQMIGTOOL.INTERACTIVE (Default): Enqueue and dequeue operations are allowed, and the user must commit the migration.
1829
- DBMS_AQMIGTOOL.OFFLINE: Only dequeue operations are allowed during migration, which can help in draining the AQ.
1930
- DBMS_AQMIGTOOL.ONLY_DEFINITION: A TxEventQ copy is made from the AQ configuration, and messages are not migrated. Both the AQ and TxEventQ remain in the system after migration is committed with separate message streams. This option is recommended for users who prefer a more manual or custom migration.
20-
2131
- Users may decide to commit the migration or revert to AQ via the migration interface.
22-
2332
- During migration, in-flight messages can be tracked by viewing messages not in the PROCESSED state for both the AQ and TxEventQ.
24-
2533
- A migration history is recorded for all queues.
26-
2734
- Users may optionally purge old AQ messages if they wish to discard the data after migration.
28-
2935
- AQ Migration supports both rolling upgrades and Oracle GoldenGate (OGG) replication.
30-
3136
- During online migrations, it is safe for applications to continue enqueue/dequeue operations as normal.
3237

3338
## Migration Workflow

0 commit comments

Comments
 (0)