RebelMouse Talk to Us
The RebelMouse Site Migration Guide

An overview of our straightforward migration process

RebelMouse's Importer tool (available via GitHub) was built to make importing your content into RebelMouse simple, fast, and accurate.

To help you get up and running on RebelMouse quickly, we've taken steps to automate as much of the migration process as possible.


Overview

This guide covers the process's three basic steps:

  1. Setting up Your Environment
  2. Preparing Your Data
  3. The Migration Process

Your Environment

Create Your Environment

You will first need a docker application on your local machine. Once this has been set up, you will need to download the RebelMouse Importer.

These are the only steps necessary to prepare your import environment.

Configure Your Environment

Once you've created your environment, you will need to configure it in order to start using the API.

We've made this configuration as simple as possible by placing a folder named settings.py with already-specified variables in a root folder of the RebelMouse Importer.

You will need to know your:

  1. Domain
  2. API token
  3. Basic authorization (e.g., username, password)

Prepare Your Data

Review Our Example

RebelMouse has API documentation and guides that you should get acquainted with first, but we know that the most helpful thing for any developer is ultimately a working example. For this reason, we've provided a WordPress example for you to review.

In the docker container, you will see three main elements:

  1. A data dump
  2. Data storage to keep processed data (MongoDB) between operations
  3. Scripts that use our public API and explain all the migration steps

Set up in XML

Following the WordPress example provided (altering it as needed for your specific application), set up your data in an XML format.

Once it's ready, you can simply copy and paste.

Migration Process

Objects

To start, we have to import four kinds of objects:

  1. Media assets
  2. Sections
  3. Authors
  4. Posts

The easiest way to ensure that this is done correctly is to start from scratch. To do this, you'll want to start from an empty RebelMouse site (Runner) that doesn't contain any existing posts or sections.

Migration Steps

  1. Upload the Dump: The dump file is already in place since it's already been used for testing multiple times.
  2. Parse the Dump: Depending on your specific use case, the whole import process might be as simple as running one script. However, for demoing purposes, let's go through it step by step.
    1. Dump Parsing Process (~30 seconds)
      1. The first step is the dump parsing process. This will extract all of the needed data from the source file and store it in MongoDB. It will also get rid of all of the unnecessary data so it's easier to analyze the content. This process only needs to be performed once, which speeds up additional import attempts when needed.
  3. Import Images: Next, we'll begin the import process for images.
  4. Import Sections: Now it's time for sections.
    1. At this point in time, we can only handle standard sections. Support for nested sections was added to our API recently, and will be added to the Importer's functionality soon.
  5. Import Authors: Next up is the creation of authors. There's nothing special behind this process, as it's very similar to the process that we use for all WordPress imports.
  6. Import Posts: At this point, all media, sections, and authors have been imported. Now we can import posts.
  7. Check for Errors: Different kinds of errors may occur during the import process. We save and log them all so a developer can go back and debug and/or fix them.
    1. There may be serious issues that will require closer attention.
    2. There may also be insignificant errors that can (and should) be ignored.
      1. For example, something that should be ignored is a completely broken post draft that can't be imported. It should not be imported as there is no need to migrate bad data to your new site.
  8. Import Completed: Check the results to be sure that everything looks as expected.

If you have any questions about this process, email support@rebelmouse.com or talk to your account manager. If you're running into an issue or error, please be sure to include screenshots and details about the nature of the problem so we can better assist you.

Good luck!

Build on a Better PlatformReady to See More?
Request a Proposal
People on a train station
Rebel Insights

RebelMouse Q1 2021 Platform Updates

Speed, performance, and Core Web Vitals enhancements

Click here to read our Q2 2021 platform performance updates!

At RebelMouse, we pour our souls into making sure that our platform is always the most modern, high-performance CMS on the market. In fact, we invested over $100,000 worth of hours into our platform in Q1 2021 alone. This has resulted in updates and performance enhancements that publishers would have to pay for on their own to make happen on any other platform, such as WordPress. We're proud to be at a level of scale where we can invest this way into our platform, and we will continue to invest at this rate every quarter moving forward just as we have in the past.

Here are the major updates that we've added to the platform in Q1.

Keep reading... Show less
Build on a Better PlatformReady to See More?
Request a Proposal
An Important Note on Site Quality From Google’s Search Expert
Rebel Insights

An Important Note on Site Quality From Google’s Search Expert

Do you ever wonder if a few typos can impact your site’s search performance? According to Google’s Search Advocate John Mueller, it takes more than just a few grammatical missteps for Google’s crawler to determine your site’s quality.

During a New Year’s Eve Office Hours hangout, Mueller said that if certain portions of a website are deemed low quality, it can negatively impact the site’s search ranking overall. A good example of this is a site that has different language versions within the same domain. If the site has a French-language version that is made up of quality content, but the English translation isn’t up to the same standard, the ranking of the French version of the site could be negatively impacted.

Keep reading... Show less
Build on a Better PlatformReady to See More?
Request a Proposal