Skip to content

Commit 4ad125b

Browse files
steverensteveren
authored
DOCSP-4081: [Atlas] ObjectRocket Migration Guide (#134)
* DOCSP-4081: [Atlas] ObjectRocket Migration Guide
1 parent 14208fe commit 4ad125b

File tree

4 files changed

+118
-0
lines changed

4 files changed

+118
-0
lines changed

‎source/cloud/migrate-from-object-rocket-to-atlas.txt

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
.. guide::
2+
title: Migrate from ObjectRocket to MongoDB Atlas
3+
author: MongoDB Documentation Team
4+
type: Getting Started
5+
level: intermediate
6+
product_version: 4.0
7+
result_description:
8+
Moving your MongoDB deployment to Atlas allows you take advantage
9+
of all the benefits Atlas brings, including best-in-class automation,
10+
backup, scalability, and compliance with the most demanding data
11+
security and privacy standards.
12+
13+
This guide will walk you through how to use the :manual:`mongodump
14+
</reference/program/mongodump/>` and :manual:`mongorestore
15+
</reference/program/mongorestore/>` tools to migrate your data from
16+
Object Rocket to Atlas.
17+
18+
time: 20
19+
prerequisites:
20+
.. include:: /includes/steps/migrate-or-prereqs.rst
21+
22+
check_your_environment:
23+
procedure:
24+
.. include:: /includes/steps/migrate-from-or.rst
25+
summary:
26+
You created an Atlas cluster, migrated data from your old ObjectRocket
27+
MongoDB cluster, and updated your applications to use the connection string
28+
for your new Atlas cluster.
29+
whats_next:
30+
- :doc:`/server/drivers`

‎source/includes/steps-migrate-from-or.yaml

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
title: Create an Atlas deployment
2+
ref: atlas-deployment
3+
content: |
4+
If you don't already have an Atlas deployment, :doc:`create one
5+
</cloud/atlas>` now.
6+
---
7+
title: Stop your applications
8+
ref: stop-applications
9+
content: |
10+
Stopping your applications prevents any additional databsae writes
11+
from occurring while you move your data from ObjectRocket to Atlas.
12+
---
13+
title: Run ``mongodump`` on your ObjectRocket deployment
14+
ref: run-mongodump
15+
content: |
16+
``mongodump`` creates a binary export of the contents of your deployment.
17+
The :manual:`mongodump documentation </reference/program/mongodump/>`
18+
contains detailed instructions on using the ``mongodump`` utility. Use
19+
your ObjectRocket credentials to access your ObjectRocket deployment.
20+
21+
In the following example, a user named ``db_user`` exports all databases
22+
to a directory named ``dump`` in the current working directory:
23+
24+
.. code-block:: shell
25+
26+
mongodump --host iad-mongos2.objectrocket.com --port 12345 --username db_user --password "myPwd" --out dump
27+
---
28+
title: Use ``mongorestore`` to restore the ``dump`` directory to your Atlas deployment
29+
ref: restore-dump
30+
content: |
31+
The :manual:`mongorestore documentation </reference/program/mongorestore/>`
32+
contains detailed instructions on using the ``mongorestore`` utility. Use
33+
your Atlas credentials to access your Atlas deployment.
34+
35+
In the following example, a user named ``db_user`` restores the default
36+
``dump`` directory to the host ``example1.mongodb.net``:
37+
38+
.. code-block:: shell
39+
40+
mongorestore --host example1.mongodb.net --port 27017 --username db_user --password "myPwd" dump/
41+
42+
---
43+
title: Verify your data integrity
44+
ref: verify-data
45+
content: |
46+
Use the `Atlas Data Explorer <https://docs.atlas.mongodb.com/data-explorer>`__
47+
to verify that all of your collections are present and populated.
48+
---
49+
title: Update your applications with your new connection string
50+
ref: update-apps
51+
content: |
52+
Click the :guilabel:`Connect` button in the cluster panel for your Atlas
53+
cluster to obtain the connection string to use in your applications.
54+
To learn more about connecting to your Atlas cluster, see
55+
`Connect to a Cluster <https://docs.atlas.mongodb.com/connect-to-cluster>`__.
56+
---
57+
title: Restart your applications
58+
ref: restart-apps
59+
content: |
60+
You're ready to start using your Atlas deployment.
61+
...

‎source/includes/steps-migrate-or-prereqs.yaml

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
title: MongoDB Atlas account
2+
ref: atlas-account
3+
content: |
4+
If you don't have an Atlas account, :doc:`create one
5+
</cloud/atlas>` now.
6+
---
7+
title: ObjectRocket MongoDB deployment
8+
ref: or-mongo
9+
---
10+
title: The ``mongodump`` and ``mongorestore`` executables
11+
ref: compose-account
12+
content: |
13+
If you don't have the :manual:`mongodump
14+
</reference/program/mongodump/>` and :manual:`mongorestore
15+
</reference/program/mongorestore/>` executables, download the
16+
`MongoDB server bundle <https://www.mongodb.com/download-center/community>`__
17+
for your platform and locate ``mongodump`` and ``mongorestore`` in the
18+
``bin`` directory.
19+
20+
.. note::
21+
22+
The time required for this procedure varies according to the
23+
quantity of data you plan to move. Small data sets can be
24+
exported quickly, while larger data sets require more time.
25+
26+
...

‎source/index.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,7 @@ Guides
1818
Migrate to MongoDB Atlas
1919
cloud/migrate-from-aws-to-atlas
2020
cloud/migrate-from-compose
21+
cloud/migrate-from-object-rocket-to-atlas
2122
server/import
2223
server/drivers
2324
CRUD Guides: Create, Read, Update, and Delete Data

0 commit comments

Comments
 (0)