EnterpriseDB · jperozoa · Mar 9, 2023 · Mar 9, 2023 · Jun 7, 2023 · Jun 7, 2023
@@ -33,5 +33,6 @@
   "slony": true,
   "tde": true,
   "tpa": true,
-  "wait_states": true
+  "wait_states": true,
+  "transporter": true
 }
@@ -102,6 +102,7 @@ const sourceToPluginConfig = {
     name: "wait_states",
     path: "advocacy_docs/pg_extensions/wait_states",
   },
+  transporter: { name: "transporter", path: "product_docs/docs/transporter" },
 };
 
 const externalSourcePlugins = () => {

@@ -514,6 +514,47 @@ products:
       - name: SLES 15
         arch: ppc64le
         supported versions: [41]
+  - name: EDB Transporter
+    platforms:
+      - name: CentOS 7
+        arch: x86_64
+        supported versions: [2_preview]
+      - name: AlmaLinux 8 or Rocky Linux 8
+        arch: x86_64
+        supported versions: [2_preview]
+      - name: RHEL 7 or OL 7
+        arch: x86_64
+        supported versions: [2_preview]
+      - name: RHEL 8 or OL 8
+        arch: x86_64
+        supported versions: [2_preview]
+      - name: Debian 10
+        arch: x86_64
+        supported versions: [2_preview]
+      - name: Debian 11
+        arch: x86_64
+        supported versions: [2_preview]
+      - name: Ubuntu 18.04
+        arch: x86_64
+        supported versions: [2_preview]
+      - name: Ubuntu 20.04
+        arch: x86_64
+        supported versions: [2_preview]
+      - name: Ubuntu 22.04
+        arch: x86_64
+        supported versions: [2_preview]
+      - name: SLES 12
+        arch: x86_64
+        supported versions: [2_preview]
+      - name: SLES 12
+        arch: ppc64le
+        supported versions: [2_preview]
+      - name: SLES 15
+        arch: x86_64
+        supported versions: [2_preview]
+      - name: SLES 15
+        arch: ppc64le
+        supported versions: [2_preview]
   - name: Failover Manager
     platforms:
       - name: CentOS 7
@@ -990,4 +1031,4 @@ products:
         supported versions: [7]
       - name: SLES 15
         arch: ppc64le
-        supported versions: [7]
+        supported versions: [7]
@@ -19,7 +19,7 @@ Before you begin the installation process:
 
   Setting up the repository is a one-time task. If you have already set up your repository, you don't need to perform this step.
 
-  To determine if your repository exists, enter this command: 
+  To determine if your repository exists, enter: 
 
   {%- filter indent(2) -%}
    {% block repocheck %} {# Any changes to this block should be replicated for Debian, Ubuntu, and SLES #}

@@ -0,0 +1,5 @@
+{% extends "products/edb-transporter/base.njk" %}
+{% set platformBaseTemplate = "almalinux-8-or-rocky-linux-8" %}
+{% set packageName %}cdcreader-1.4-1.4766136665.17.1.el8.x86_64{% endset %}
+{% set writerPackageName %}cdcwriter-1.3-1.4766201953.4.1.el8.x86_64{% endset %}
+{% block prerequisites %}{% endblock prerequisites %}
@@ -0,0 +1,24 @@
+{% extends "platformBase/" + platformBaseTemplate + '.njk' %}
+{% set packageName = packageName or 'cdcreader=-1.4-1.4766136665.17.1.jammy' %}
+{% set writerPackageName = writerPackageName or 'cdcwriter=1.3-1.4766201953.4.1.jammy' %}
+{% import "platformBase/_deploymentConstants.njk" as deploy %}
+{% block frontmatter %}
+{# 
+  If you modify deployment path here, please first copy the old expression
+  and add it to the list under "redirects:" below - this ensures we don't 
+  break any existing links.  
+#}
+deployPath: transporter/{{ product.version }}/installing/linux_{{platform.arch}}/transporter_{{deploy.map_platform[platform.name]}}.mdx
+{% endblock frontmatter %}
+
+{% block installCommand %}
+Install CDCReader:
+```shell
+sudo {{packageManager}} install {{ packageName }}
+```
+
+Install CDCWriter:
+```shell
+sudo {{packageManager}} install {{ writerPackageName }}
+```
+{% endblock installCommand %}
@@ -0,0 +1,5 @@
+{% extends "products/edb-transporter/base.njk" %}
+{% set platformBaseTemplate = "centos-7" %}
+{% set packageName %}cdcreader-1.4-1.4766136665.17.1.el8.x86_64{% endset %}
+{% set writerPackageName %}cdcwriter-1.3-1.4766201953.4.1.el8.x86_64{% endset %}
+{% block prerequisites %}{% endblock prerequisites %}
@@ -0,0 +1,2 @@
+{% extends "products/edb-transporter/debian.njk" %}
+{% set platformBaseTemplate = "debian-10" %}
@@ -0,0 +1,2 @@
+{% extends "products/edb-transporter/debian.njk" %}
+{% set platformBaseTemplate = "debian-11" %}
@@ -0,0 +1,2 @@
+{% extends "products/edb-transporter/debian.njk" %}
+{% set platformBaseTemplate = "debian-9" %}
@@ -0,0 +1,4 @@
+{% extends "products/edb-transporter/base.njk" %}
+{% block debian_ubuntu %}This section steps you through getting started with your cluster including logging in, ensuring the installation was successful, connecting to your cluster, and creating the user password.
+
+```shell{% endblock debian_ubuntu %}
@@ -0,0 +1,9 @@
+{% extends "platformBase/index.njk" %}
+{% set productShortname="transporter" %}
+
+{% block frontmatter %}
+{{ super() }}
+{% endblock frontmatter %}
+{% block navigation %}
+- linux_x86_64
+{% endblock navigation %}
@@ -0,0 +1,7 @@
+
+{% extends "platformBase/ppc64le_index.njk" %}
+{% set productShortname="transporter" %}
+
+{% block frontmatter %}
+{{super()}}
+{% endblock frontmatter %}
@@ -0,0 +1,5 @@
+{% extends "products/edb-transporter/base.njk" %}
+{% set platformBaseTemplate = "rhel-7-or-ol-7" %}
+{% set packageName %}cdcreader-1.4-1.4766136665.17.1.el8.x86_64{% endset %}
+{% set writerPackageName %}cdcwriter-1.3-1.4766201953.4.1.el8.x86_64{% endset %}
+{% block prerequisites %}{% endblock prerequisites %}
@@ -0,0 +1,5 @@
+{% extends "products/edb-transporter/base.njk" %}
+{% set platformBaseTemplate = "rhel-8-or-ol-8" %}
+{% set packageName %}cdcreader-1.4-1.4766136665.17.1.el8.x86_64{% endset %}
+{% set writerPackageName %}cdcwriter-1.3-1.4766201953.4.1.el8.x86_64{% endset %}
+{% block prerequisites %}{% endblock prerequisites %}
@@ -0,0 +1,6 @@
+{% extends "products/edb-transporter/base.njk" %}
+{% set platformBaseTemplate = "sles-12" %}
+{% set packageManager = "zypper" %}
+{% set packageName %}cdcreader-1.4-1.4766136665.17.1.el8.x86_64{% endset %}
+{% set writerPackageName %}cdcwriter-1.3-1.4766201953.4.1.el8.x86_64{% endset %}
+
@@ -0,0 +1,5 @@
+{% extends "products/edb-transporter/sles-12.njk" %}
+{% set packageName %}cdcreader-1.4-1.4766136665.17.1.el8.x86_64{% endset %}
+{% set writerPackageName %}cdcwriter-1.3-1.4766201953.4.1.el8.x86_64{% endset %}
+
+
@@ -0,0 +1,5 @@
+{% extends "products/edb-transporter/base.njk" %}
+{% set platformBaseTemplate = "sles-15" %}
+{% set packageManager = "zypper" %}
+{% set packageName %}cdcreader-1.4-1.4766136665.17.1.el8.x86_64{% endset %}
+{% set writerPackageName %}cdcwriter-1.3-1.4766201953.4.1.el8.x86_64{% endset %}
@@ -0,0 +1,4 @@
+{% extends "products/edb-transporter/sles-15.njk" %}
+{% set packageName %}cdcreader-1.4-1.4766136665.17.1.el8.x86_64{% endset %}
+{% set writerPackageName %}cdcwriter-1.3-1.4766201953.4.1.el8.x86_64{% endset %}
+
@@ -0,0 +1,2 @@
+{% extends "products/edb-transporter/ubuntu.njk" %}
+{% set platformBaseTemplate = "ubuntu-18.04" %}
@@ -0,0 +1,2 @@
+{% extends "products/edb-transporter/ubuntu.njk" %}
+{% set platformBaseTemplate = "ubuntu-20.04" %}
@@ -0,0 +1,2 @@
+{% extends "products/edb-transporter/ubuntu.njk" %}
+{% set platformBaseTemplate = "ubuntu-22.04" %}
@@ -0,0 +1 @@
+{% extends "products/edb-transporter/base.njk" %}
@@ -0,0 +1,7 @@
+
+{% extends "platformBase/x86_64_index.njk" %}
+{% set productShortname="transporter" %}
+
+{% block frontmatter %}
+{{ super() }}
+{% endblock frontmatter %}
@@ -35,7 +35,7 @@
     "update-icons": "node scripts/createIconNames.js && prettier --write src/components/icon/iconNames.js"
   },
   "dependencies": {
-    "@enterprisedb/icons": "^1.25.1",
+    "@enterprisedb/icons": "^1.26.1",
     "@mdx-js/mdx": "^1.6.22",
     "@mdx-js/react": "^1.6.22",
     "algoliasearch": "^4.17.2",
@@ -68,6 +68,7 @@
     "globby": "^13.2.2",
     "graceful-fs": "^4.2.11",
     "hast-util-to-string": "^1.0.4",
+    "husky": "^8.0.3",
     "is-absolute-url": "^4.0.1",
     "markdown-to-jsx": "^7.2.1",
     "mdast-util-to-string": "^2.0.0",
@@ -87,7 +88,6 @@
     "fast-glob": "^3.2.12",
     "hast-util-is-element": "^2.1.3",
     "hast-util-to-text": "^3.1.2",
-    "husky": "^7.0.4",
     "prettier": "^2.8.8",
     "pretty-quick": "^3.1.3",
     "react-refresh": "^0.14.0",

@@ -0,0 +1,48 @@
+---
+title: "Getting started"
+---
+
+Setting up an EDB Transporter migration consists of a number of steps.
+
+## Planning: Ensure schema compatibility
+
+Assess Oracle database sources for schema compatibility using the [EDB Migration Portal](https://www.enterprisedb.com/docs/migration_portal/latest/) before starting the data migration process. Address incompatible schemas or exclude them from the migration.
+
+## Preparing source and target databases
+
+Prepare each source and the target databases needed for the migration. To prepare, enable archive log mode and supplemental logging on the Oracle database and create a user. For details, see:
+
+-  [Preparing Oracle source databases](preparing_db/preparing_oracle_source_databases/#preparing_oracle_sources)
+-  [Preparing Postgres source databases](preparing_db/preparing_postgres_source_databases/#preparing_postgres_sources)
+-  [Preparing target databases](preparing_db/preparing_target_databases/#preparing_target_databases)
+
+## Installing
+
+Install and run customer-side EDB Transporter software. For details, see [Installing EDB Transporter software](installing).
+
+EDB manages cloud assets required for the migration, such as Apache Kafka and other services offered by cloud service providers.
+
+## Sharing migration information
+
+Share tables-to-migrate information with EDB (schema, table, and column-name mapping between source and target).
+
+To create the migration, EDB needs to know the schemas and tables needed to migrate to the target database.
+
+If the target table and column names are different from the source, EDB also needs the mapping for each table and column to its new name.
+
+## EDB migration responsibilities
+
+EDB performs the next steps: 
+
+- Deploying infrastructure. EDB deploys cloud infrastructure, which includes control components and a message bus.
+
+- Starting migration. EDB initiates and manages the data migration until complete.
+
+- Validating migration. EDB performs integrity validation and post-migration checks.
+
+## Post-migration steps
+
+After these steps, your migration is up and running and will last as long as required. After your data is across,if you plan to then stop the migration:
+
+ - You can stop and remove customer-side software.
+ - EDB deprovisions cloud infrastructure.
@@ -0,0 +1,29 @@
+---
+title: EDB Transporter
+directoryDefaults:
+  description: "EDB Transporter is a cloud-first migration solution based on Debezium and Kafka. Change-event data streaming enables secure, fault-tolerant, and performant migrations to BigAnimal, on-premise EPAS/Postgres, or other cloud-hosted databases."
+navigation:
+  - rel_notes
+  - known_issues
+  - getting_started
+  - "#Concepts"
+  - terminology
+  - usage_overview
+  - "#Planning"
+  - supported_versions
+  - limitations
+  - "#Installing"
+  - installing
+  - upgrading
+  - "#Using"
+  - preparing_db
+  - migrating_data
+---
+
+EDB Transporter offers you an effective way to migrate database data from one database to another. It does this by using the technique known as change data capture (CDC). This process catches changes in a source database’s rows being made by applications and streams them to a destination database. It reshapes the data to the schema of the destination database.
+
+By streaming the changes from one database to another, the process avoids the traditional “big bang” of exporting, converting, and importing that came with traditional migration.
+
+EDB Transporter is built on Kafka, a data-streaming technology, and Debezium, which uses that technology to move captured data between databases.
+
+When the source or destination database is on premises or in a private cloud, then you need to install EDB Transporter’s CDCReader or CDCWriter. You and EDB’s team can then plan and start your migration.
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		{% extends "products/edb-transporter/debian.njk" %}
		{% set platformBaseTemplate = "debian-10" %}
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		{% extends "products/edb-transporter/debian.njk" %}
		{% set platformBaseTemplate = "debian-11" %}
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		{% extends "products/edb-transporter/debian.njk" %}
		{% set platformBaseTemplate = "debian-9" %}
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		{% extends "products/edb-transporter/ubuntu.njk" %}
		{% set platformBaseTemplate = "ubuntu-18.04" %}
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		{% extends "products/edb-transporter/ubuntu.njk" %}
		{% set platformBaseTemplate = "ubuntu-20.04" %}
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		{% extends "products/edb-transporter/ubuntu.njk" %}
		{% set platformBaseTemplate = "ubuntu-22.04" %}
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		{% extends "products/edb-transporter/base.njk" %}