(DOCSP-25788) Restyled and added missing orphan ObjectRocket guide. (#213)

Author: erabil-mdb

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

@@ -0,0 +1,62 @@
+:orphan:
+:template: guide
+
+.. _guide-migrate-object-rocket:
+
+==========================================
+Migrate from ObjectRocket to MongoDB Atlas
+==========================================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+Overview
+--------
+ 
+.. short-description::
+    
+   Migrate data from Object Rocket to MongoDB Atlas.
+
+Moving your MongoDB deployment to Atlas allows you take advantage
+of all the benefits Atlas brings, including best-in-class automation,
+backup, scalability, and compliance with the most demanding data
+security and privacy standards.
+
+This guide will walk you through how to use the :manual:`mongodump
+</reference/program/mongodump/>` and :manual:`mongorestore
+</reference/program/mongorestore/>` tools to migrate your data from
+ObjectRocket to Atlas.
+
+.. time:: 20
+
+What You'll Need
+----------------
+
+.. include:: /includes/migrate_or_prereqs.rst
+
+Procedure
+---------
+
+.. include:: /includes/migrate_from_or.rst
+  
+Migration Support
+-----------------
+
+If you have any questions regarding migration beyond what is covered
+in this documentation, or if you encounter an error during migration, please
+see the Atlas documentation on
+:atlas:`requesting support </support/#request-support>`.
+
+Summary
+-------
+
+You created an Atlas cluster, migrated data from your old ObjectRocket
+MongoDB cluster, and updated your applications to use the connection string
+for your new Atlas cluster.
+
+.. guide-next::

source/includes/migrate_from_or.rst

@@ -0,0 +1,54 @@
+.. procedure::
+   :style: normal
+
+   .. step:: Create an Atlas deployment.
+ 
+      If you don't already have an Atlas deployment, :atlas:`create one
+      </tutorial/create-new-cluster/>` now.
+
+   .. step:: Stop your applications.
+
+      Stopping your applications prevents any additional database writes
+      from occurring while you move your data from ObjectRocket to Atlas.
+
+   .. step:: Run ``mongodump`` on your ObjectRocket deployment.
+
+      ``mongodump`` creates a binary export of the contents of your deployment.
+      The :manual:`mongodump documentation </reference/program/mongodump/>`
+      contains detailed instructions on using the ``mongodump`` utility. Use
+      your ObjectRocket credentials to access your ObjectRocket deployment.
+      In the following example, a user named ``db_user`` exports all databases
+      to a directory named ``dump`` in the current working directory:
+
+      .. code-block:: shell
+
+         mongodump --host iad-mongos2.objectrocket.com --port 12345 --username db_user --password "myPwd" --out dump
+
+   .. step:: Use ``mongorestore`` to restore the ``dump`` directory to your 
+      Atlas deployment.
+      
+      The :manual:`mongorestore documentation </reference/program/mongorestore/>`
+      contains detailed instructions on using the ``mongorestore`` utility. Use
+      your Atlas credentials to access your Atlas deployment.
+      In the following example, a user named ``db_user`` restores the default
+      ``dump`` directory to the host ``example1.mongodb.net``:
+      
+      .. code-block:: shell
+
+         mongorestore --host example1.mongodb.net --port 27017 --username db_user --password "myPwd" dump/
+
+   .. step:: Verify your data integrity.
+      
+      Use the :atlas:`Atlas Data Explorer </data-explorer>` 
+      to verify that all of your collections are present and populate
+
+   .. step:: Update your applications with your new connection string.
+
+      Click the :guilabel:`Connect` button in the cluster panel for your Atlas
+      cluster to obtain the connection string to use in your applications.
+      To learn more about connecting to your Atlas cluster, see
+      :atlas:`Connect to a Cluster </connect-to-cluster>`.
+
+   .. step:: Restart your applications.
+
+      You're ready to start using your Atlas deployment.

source/includes/migrate_or_prereqs.rst

@@ -0,0 +1,13 @@
+* A MongoDB account for Atlas. See :guides:`Sign Up for a MongoDB Account 
+  </cloud/account>`.
+
+* An ObjectRocket MongoDB deployment.
+
+* The ``mongodump`` and ``mongorestore`` executables. See 
+  :dl:`MongoDB server bundle <community>` for your platform and locate 
+  ``mongodump`` and ``mongorestore`` in the ``bin`` directory.
+
+.. note::
+   The time required for this procedure varies according to the
+   quantity of data you plan to move. Small data sets can be
+   exported quickly, while larger data sets require more time.