Browse Source

edits per erika - section intros, etc.

master
Brennen Bearnes 5 years ago
parent
commit
5312c5b745
2 changed files with 14 additions and 10 deletions
  1. +7
    -5
      README.md
  2. +7
    -5
      index.html

+ 7
- 5
README.md View File

@ -15,7 +15,7 @@ This guide focuses on migrating a pre-existing Parse application to a standalone
This guide builds on [How To Run Parse Server on Ubuntu 14.04][run-parse-server]. It requires the following:
- An Ubuntu 14.04 server, configured with a non-root `sudo` user
- A recent Node.js release
- Node.js 5.6.x
- MongoDB 3.0.x
- A domain name pointing at the server
- A Parse App to be migrated
@ -24,9 +24,9 @@ The target server should have enough storage to handle all of your app's data.
## Step 1 – Install Let's Encrypt and Retrieve a Certificate
### Install Let's Encrypt and Dependencies
Let's Encrypt is a new Certificate Authority that provides an easy way to obtain free TLS/SSL certificates. Because a certificate is necessary to secure both the migration of data to MongoDB and your Parse Server API endpoint, we'll begin by retrieving one with the `letsencrypt` client.
Let's Encrypt is a Certificate Authority that provides an easy way to obtain free TLS/SSL certificates. Because a certificate is necessary to secure both the migration of data to MongoDB and your Parse Server API endpoint, we'll begin by retrieving one with the `letsencrypt` client.
### Install Let's Encrypt and Dependencies
You must own or control the registered domain name that you wish to use the certificate with. If you do not already have a registered domain name, you may register one with one of the many domain name registrars out there (e.g. Namecheap, GoDaddy, etc.).
@ -40,7 +40,7 @@ Begin by making sure that the `git` and `bc` packages are installed:
sudo apt-get -y install git bc
```
Next, clone the `letsencrypt` repository from GitHub to `/opt/letsencrypt`. The `/opt/` directory is a standard location for software that's not installed from official packages:
Next, clone the `letsencrypt` repository from GitHub to `/opt/letsencrypt`. The `/opt/` directory is a standard location for software that's not installed from the distribution's official package repositories:
```command
sudo git clone https://github.com/letsencrypt/letsencrypt /opt/letsencrypt
@ -231,7 +231,7 @@ Once finished, the migration process will enter a verification step. Don't fina
![Parse App: Finished Migration, Waiting for Finalization](https://assets.digitalocean.com/articles/parse_migration/small-004.png)
From your `mongo` shell, you can now examine your local database. Begin by using <^>database_name<^> and examining the collections it contains:
Return to your `mongo` shell, and examine your local database. Begin by accessing <^>database_name<^> and examining the collections it contains:
```custom_prefix(>)
use <^>database_name<^>
@ -272,6 +272,8 @@ exit
## Step 3 – Install and Configure Parse Server and PM2
With your app data in MongoDB, we can move on to installing Parse Server itself, and integrating with the rest of the system. We'll give Parse Server a dedicated user, and use a utility called **PM2** to configure it and ensure that it's always running.
### Create a Dedicated Parse User
Instead of running `parse-server` as **root** or your `sudo` user, we'll create a system user called **parse**:


+ 7
- 5
index.html View File

@ -25,7 +25,7 @@
<ul>
<li>An Ubuntu 14.04 server, configured with a non-root <code>sudo</code> user</li>
<li>A recent Node.js release</li>
<li>Node.js 5.6.x</li>
<li>MongoDB 3.0.x</li>
<li>A domain name pointing at the server</li>
<li>A Parse App to be migrated</li>
@ -36,9 +36,9 @@
<h2>Step 1 – Install Let&rsquo;s Encrypt and Retrieve a Certificate</h2>
<h3>Install Let&rsquo;s Encrypt and Dependencies</h3>
<p>Let&rsquo;s Encrypt is a new Certificate Authority that provides an easy way to obtain free TLS/SSL certificates. Because a certificate is necessary to secure both the migration of data to MongoDB and your Parse Server API endpoint, we&rsquo;ll begin by retrieving one with the <code>letsencrypt</code> client.</p>
<p>Let&rsquo;s Encrypt is a Certificate Authority that provides an easy way to obtain free TLS/SSL certificates. Because a certificate is necessary to secure both the migration of data to MongoDB and your Parse Server API endpoint, we&rsquo;ll begin by retrieving one with the <code>letsencrypt</code> client.</p>
<h3>Install Let&rsquo;s Encrypt and Dependencies</h3>
<p>You must own or control the registered domain name that you wish to use the certificate with. If you do not already have a registered domain name, you may register one with one of the many domain name registrars out there (e.g. Namecheap, GoDaddy, etc.).</p>
@ -51,7 +51,7 @@
<pre><code class="command">sudo apt-get -y install git bc
</code></pre>
<p>Next, clone the <code>letsencrypt</code> repository from GitHub to <code>/opt/letsencrypt</code>. The <code>/opt/</code> directory is a standard location for software that&rsquo;s not installed from official packages:</p>
<p>Next, clone the <code>letsencrypt</code> repository from GitHub to <code>/opt/letsencrypt</code>. The <code>/opt/</code> directory is a standard location for software that&rsquo;s not installed from the distribution&rsquo;s official package repositories:</p>
<pre><code class="command">sudo git clone https://github.com/letsencrypt/letsencrypt /opt/letsencrypt
</code></pre>
@ -225,7 +225,7 @@ db.createUser({ user: "parse", pwd: "<span style="color: red;">password</span>",
<p><img src="https://assets.digitalocean.com/articles/parse_migration/small-004.png" alt="Parse App: Finished Migration, Waiting for Finalization" /></p>
<p>From your <code>mongo</code> shell, you can now examine your local database. Begin by using &lt;^>database_name&lt;^> and examining the collections it contains:</p>
<p>Return to your <code>mongo</code> shell, and examine your local database. Begin by accessing &lt;^>database_name&lt;^> and examining the collections it contains:</p>
<pre><code class="custom_prefix(>)">use <span style="color: red;">database_name</span>
</code></pre>
@ -260,6 +260,8 @@ system.indexes
<h2>Step 3 – Install and Configure Parse Server and PM2</h2>
<p>With your app data in MongoDB, we can move on to installing Parse Server itself, and integrating with the rest of the system. We&rsquo;ll give Parse Server a dedicated user, and use a utility called <strong>PM2</strong> to configure it and ensure that it&rsquo;s always running.</p>
<h3>Create a Dedicated Parse User</h3>
<p>Instead of running <code>parse-server</code> as <strong>root</strong> or your <code>sudo</code> user, we&rsquo;ll create a system user called <strong>parse</strong>:</p>


Loading…
Cancel
Save