Skip to content

Commit 7196929

Browse files
committed
Added tabs for Compass and the Atlas UI on the Monitoring a Continous Migration page. Also updated image fiel names to be consistent with the docs naming.
1 parent 3b31db6 commit 7196929

14 files changed

+50
-12
lines changed

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,3 +19,4 @@ npm-debug.log*
1919
yarn-debug.log*
2020
yarn-error.log*
2121
issue_demo.sql
22+
docker/kafka/docker-compose-migrator-kafka.yml

docs/220-Migrate Data/20-view-migrated-data.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,4 +11,4 @@ MongoDB Compass, or MongoDB Atlas. This topic assumes you have migrated your dat
1111
- Select the database you migrated data to
1212
- Select each of the collections and view the documents, confirming they conform to the schema you created.
1313

14-
<Screenshot url="http://127.0.0.1:8278" src="img/view-migrated-data-atlas.png" alt="Screenshot of the connect modal" />
14+
<Screenshot url="https://cloud.mongodb.com" src="img/view-migrated-data-atlas.png" alt="Screenshot of the Atlas UI" />

docs/220-Migrate Data/30-cdc-migration.mdx

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -8,32 +8,32 @@ Change Data Capture synchronization will continue until you explicitly complete
88

99
To start a continuous migration job, switch to the `Data Migration` tab:
1010

11-
<Screenshot url="http://127.0.0.1:8278" src="img/210-image-006.png" alt="Screenshot of the connect modal" />
11+
<Screenshot url="http://127.0.0.1:8278" src="img/220-image-006.png" alt="Screenshot of the connect modal" />
1212

1313
- Click `Create migration job`
1414
- Specify the source DB connection details
1515
- If you previously saved your connection details, you will be able to select those without needing to re-enter any details
1616

17-
<Screenshot url="http://127.0.0.1:8278" src="img/210-image-007.png" alt="Screenshot of the connect modal" />
17+
<Screenshot url="http://127.0.0.1:8278" src="img/220-image-007.png" alt="Screenshot of the connect modal" />
1818

1919
- Specify MongoDB connection details
2020
- Enter the URI, database, username and password for your MongoDB cluster
2121
- If you are using Atlas, you can retrieve the details from the [Atlas portal](https://cloud.mongodb.com)
2222
- If you saved your MongoDB connection details during a previous migration, you will be able to select those without needing to re-enter any details
2323

24-
<Screenshot url="http://127.0.0.1:8278" src="img/210-image-008.png" alt="Screenshot of the connect modal" />
24+
<Screenshot url="http://127.0.0.1:8278" src="img/220-image-008.png" alt="Screenshot of the connect modal" />
2525

2626
- Specify migration options
2727
- Set Mode to `Continous`
2828
- Choose the `Drop destination collections before migration` option
2929

30-
<Screenshot url="http://127.0.0.1:8278" src="img/210-image-009.png" alt="Screenshot of the connect modal" />
30+
<Screenshot url="http://127.0.0.1:8278" src="img/220-image-009.png" alt="Screenshot of the connect modal" />
3131

3232
- If you get a message warning you the source database is not configured for continous migration jobs
3333
- Click the `Generate Script` button to generate and download the SQL script to configure the database
3434
- Use pgAdmin or psql to run the script against the library database
3535

36-
<Screenshot url="http://127.0.0.1:8278" src="img/210-image-010.png" alt="Screenshot of the connect modal" />
36+
<Screenshot url="http://127.0.0.1:8278" src="img/220-image-010.png" alt="Screenshot of the connect modal" />
3737

3838
:::info
3939
In an intructor-led lab, the provisioned PostgreSQL database will already be configured for continous migration.
@@ -47,4 +47,4 @@ If you need to install pgAdmin, it can be downloaded from [here](https://www.pga
4747
- If everything looks good, click `Start`
4848
- Monitor the progress of the job
4949

50-
<Screenshot url="http://127.0.0.1:8278" src="img/210-image-011.png" alt="Screenshot of the connect modal" />
50+
<Screenshot url="http://127.0.0.1:8278" src="img/220-image-011.png" alt="Screenshot of the connect modal" />

docs/220-Migrate Data/40-monitor-cdc-migration.mdx

Lines changed: 42 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,13 @@
11
import Screenshot from "@site/src/components/Screenshot";
2+
import Tabs from '@theme/Tabs';
3+
import TabItem from '@theme/TabItem';
24

35
# 👐 Monitor a Continuous Migration Job
46

57
When a continuous migration job has completed its initial synchronization stage, it enters the Change-Data-Capture (CDC) stage.
68
In this stage, the source database is monitored for changes, and these changes are applied to the target MongoDB database.
79

8-
<Screenshot url="http://127.0.0.1:8278" src="img/210-image-012.png" alt="Screenshot of the Data Migration monitoring page" />
10+
<Screenshot url="http://127.0.0.1:8278" src="img/220-image-012.png" alt="Screenshot of the Data Migration monitoring page" />
911

1012
To verify changes are being captured correctly, you can make changes to the Postgres library database and check MongoDB for corresponding changes.
1113
- Using pgAdmin or psql, apply the following updates to the library database in Postgres
@@ -38,14 +40,35 @@ If you are taking part in an instructor led lab, you should prefix the book IDs
3840

3941
If continuous migration is operating correctly, you should see an update to the `Total events seen` and `Events in the last hour` counts in Relational Migrator.
4042

41-
<Screenshot url="http://127.0.0.1:8278" src="img/210-image-013.png" alt="Screenshot of the Data Migration monitoring page" />
43+
<Screenshot url="http://127.0.0.1:8278" src="img/220-image-013.png" alt="Screenshot of the Data Migration monitoring page" />
4244

4345
Now check for the new books in MongoDB:
4446

45-
- In Compass, run a search against the books collection for a books we added to Postgres: `{_id: /^14472240/}`
47+
<Tabs groupId="MongoDB Interfaces Documents Added">
48+
<TabItem value="Atlas UI" label="Atlas UI">
49+
50+
- In a web browser, navigate to the [MongoDB Atlas portal](https://cloud.mongodb.com) and sign in with your account
51+
- Navigate to the cloud project containing the cluster you migrated data to
52+
- Select your cluster and click `View collections`
53+
- Select the `books` collection in the database you migrated data to
54+
- Enter a query in the Filter text box that uses a regular expression to look for any book where the _id value starts with the common prefix of the books we added: `{_id: /^14472240/}`
55+
- Click `Apply`
56+
- If the CDC process worked correctly, you should see three book documents being returned
57+
58+
<Screenshot url="http://cloud.mongodb.com" src="/img/220-image-016.png" alt="Screenshot of the Atlas UI" />
59+
60+
</TabItem>
61+
<TabItem value="Compass" label="Compass">
62+
63+
- In Compass, select the `books` collection in the `CONNECTIONS` navigation panel on the left hand side.
64+
- Enter a query that uses a regular expression to look for any book where the _id value starts with the common prefix of the books we added: `{_id: /^14472240/}`
65+
- Click `Find`
4666
- If the CDC process worked correctly, you should see three book documents being returned
4767

48-
![Screenshot of MongoDB Compass](/img/210-image-014.png)
68+
![Screenshot of MongoDB Compass](/img/220-image-014.png)
69+
70+
</TabItem>
71+
</Tabs>
4972

5073
:::info
5174
If you are taking part in an instructor led lab, modify the query to include the unique combination of characters you added to the book IDs when adding them to Postgres.
@@ -72,10 +95,24 @@ Check for updates to the `Total events seen` and `Events in the last hour` count
7295

7396
Verify the books have been deleted in MongoDB:
7497

98+
<Tabs groupId="MongoDB Interfaces Documents Removed">
99+
<TabItem value="Atlas UI" label="Atlas UI">
100+
101+
- In the Atlas UI, run the same search against the books collection: `{_id: /^14472240/}`
102+
- If the CDC process worked correctly, the query should not find any matching books
103+
104+
<Screenshot url="http://cloud.mongodb.com" src="/img/220-image-017.png" alt="Screenshot of the Atlas UI" />
105+
106+
</TabItem>
107+
<TabItem value="Compass" label="Compass">
108+
75109
- In Compass, run the same search against the books collection: `{_id: /^14472240/}`
76110
- If the CDC process worked correctly, the query should not find any matching books
77111

78-
![Screenshot of MongoDB Compass](/img/210-image-015.png)
112+
![Screenshot of MongoDB Compass](/img/220-image-015.png)
113+
114+
</TabItem>
115+
</Tabs>
79116

80117
Click the `Complete CDC` button on the the Relational Migrator Data Migration tab to end the CDC job.
81118

static/img/210-image-006.png

-130 KB
Binary file not shown.

static/img/210-image-007.png

-236 KB
Binary file not shown.

static/img/210-image-008.png

-267 KB
Binary file not shown.

static/img/210-image-009.png

-264 KB
Binary file not shown.

static/img/210-image-010.png

-279 KB
Binary file not shown.

static/img/210-image-011.png

-210 KB
Binary file not shown.

0 commit comments

Comments
 (0)