Skip to content

Conversation

@taroface
Copy link
Contributor

@taroface taroface commented Oct 1, 2025

DOC-13338
DOC-14748

Notes for reviewers:

Page Please review Notes
Load and Replicate entire flow, but focus on Replicator setup, usage, troubleshooting Fetch content is pre-existing
Migration Failback entire flow
Resume Replication Replicator usage, any missing context/caveats about resuming
MOLT Replicator whole page
MOLT Fetch new user permissions table Lightly restructured to match MOLT Replicator doc; added export retry flags
MOLT release notes Oct 23 notes

@github-actions
Copy link

github-actions bot commented Oct 1, 2025

Files changed:

@netlify
Copy link

netlify bot commented Oct 1, 2025

Deploy Preview for cockroachdb-api-docs canceled.

Name Link
🔨 Latest commit 32f385c
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-api-docs/deploys/68fb749caa92060008a6e14c

@netlify
Copy link

netlify bot commented Oct 1, 2025

Deploy Preview for cockroachdb-interactivetutorials-docs canceled.

Name Link
🔨 Latest commit 32f385c
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-interactivetutorials-docs/deploys/68fb749c4d6fbf00084f9b1e

@netlify
Copy link

netlify bot commented Oct 1, 2025

Netlify Preview

Name Link
🔨 Latest commit 32f385c
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-docs/deploys/68fb749c2846930008f9c6b1
😎 Deploy Preview https://deploy-preview-20465--cockroachdb-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@taroface taroface changed the title [wip] MOLT Replicator draft docs [WIP] MOLT Replicator draft docs Oct 1, 2025
Copy link

@ryanluu12345 ryanluu12345 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Excellent work @taroface . Not an easy doc to write, but you made it understandable and clean! Let's bottom out on some of these discussions and ensure the deprecation effort from @tuansydau reflects the reality of what we are documenting.

@noelcrl
Copy link
Contributor

noelcrl commented Oct 14, 2025

@taroface
For this section: https://www.cockroachlabs.com/docs/molt/migrate-data-load-replicate-only?filters=oracle#oracle-instant-client

We should also make the user grab their own copy of instant client from Oracle. For the Linux instructions, we should replace:

sudo apt-get install -yqq --no-install-recommends libaio1t64
sudo ln -s /usr/lib/x86_64-linux-gnu/libaio.so.1t64 /usr/lib/x86_64-linux-gnu/libaio.so.1
curl -o /tmp/ora-libs.zip https://replicator.cockroachdb.com/third_party/instantclient-basiclite-linux-amd64.zip
unzip -d /tmp /tmp/ora-libs.zip
sudo mv /tmp/instantclient_21_13/* /usr/lib
export LD_LIBRARY_PATH=/usr/lib

With:

sudo apt-get install -yqq --no-install-recommends libaio1t64
sudo ln -s /usr/lib/x86_64-linux-gnu/libaio.so.1t64 /usr/lib/x86_64-linux-gnu/libaio.so.1
# Download the Oracle Instant Client libraries from Oracle: (https://www.oracle.com/ca-en/database/technologies/instant-client.html) into /tmp/instantclient-basiclite-linux-amd64.zip for example
unzip -d /tmp /tmp/instantclient-basiclite-linux-amd64.zip
sudo mv /tmp/instantclient_21_13/* /usr/lib
export LD_LIBRARY_PATH=/usr/lib

Let me know if you have questions on this, it should be updated for each instance of the oracle instant client instructions throughout the docs.

The actual links for Linux binaries:
Download from the Official Oracle site here (linux amd64) or here (linux x86).

@crash-overdrive
Copy link

Can we link the replicator dashboard in the DOCS?
Replicator Grafana dashboard
Replicator Grafana dashboard for Oracle

Copy link
Contributor

@florence-crl florence-crl left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

first set of comments from my review

@florence-crl florence-crl self-requested a review October 22, 2025 20:34
Copy link
Contributor

@florence-crl florence-crl left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

second set of comments from my review

@florence-crl florence-crl self-requested a review October 22, 2025 22:03
@taroface
Copy link
Contributor Author

Thanks all for your comments. I've updated the PR (especially molt-replicator.md) and am working through Docs review comments concurrently. Could you PTAL for a final pass on the tech side?

Copy link
Contributor

@florence-crl florence-crl left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Existing issue: I could not leave an inline comment for line 9 in _includes/molt/molt-setup.md

{% include feature-phases/preview.md %}

The preview link does not render correctly on Bulk load page and Load and replicate.


third set of comments from my review

Copy link
Contributor

@florence-crl florence-crl left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fourth (and final) set of comments.
Very comprehensive job!
lgtm pending suggestions.

Copy link

@ryanluu12345 ryanluu12345 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Generally looks good to me! Mainly clarification about the metrics that have now been updated or renamed since the Replicator wiki was last updated + some nits.

I've also added some new metrics for consideration.

@taroface taroface changed the title [WIP] MOLT Replicator draft docs MOLT Replicator draft docs Oct 23, 2025
Copy link

@ryanluu12345 ryanluu12345 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! Excellent work!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants