10. Upgrading from Drupal 7 Organic Groups - backdrop-contrib/og GitHub Wiki

If you are upgrading an existing Organic Groups installation from Drupal 7 (or upgrading a Drupal 7 module that requires Organic Groups), there are some steps you should take to ensure that your upgraded installation is fully enabled at the end of the process.

Stub Modules

NOTE: The stub modules listed below are still needed in the Drupal 7 version when upgrading to Backdrop, EVEN if you are upgrading to Backdrop 1.22.0 and higher.

Backdrop Organic Groups relies on two modules that don't exist in Drupal:

• Entity UI (entity_ui), needed for the Backdrop version of Organic Groups;
• Entity Plus (entity_plus), also needed for the Backdrop version of Organic Groups.

When the Backdrop version of update.php runs, if those modules are not present and enabled, then the update will disable all of the Backdrop modules that depend on them, which includes Organic Groups, plus any further modules that depend on Organic Groups.

So the solution is to install "stub" modules in the Drupal installation prior to generating the database from which the Backdrop upgrade will take place. See below.

Upgrade Process

Assuming you are following the official upgrade instructions or something similar like this, do the following:

1. Download and unzip these two modules, which are Drupal 7 "stub" module needed during the upgrade process:

   • entity_plus.zip
   • entity_ui.zip

2. In Step 2, "Prepare your Drupal site for upgrade", prior to substep 9 ("Make a second backup...calling it backdrop-ready.sql"):

   • Install those two stub modules into sites/all/modules of your Drupal installation;
   • Enable those two modules. (They don't do anything. This just makes your database know that they exist, or rather, that they will be forthcoming.)

3. Continue with substep 9: make your second backup of the database to be used for Backdrop, e.g., backdrop-ready.sql.

4. Once you have made that second backup, you can uninstall and remove the two stub modules from your Drupal installation.

5. Continue with the rest of the migration/upgrade process.

Of course, make sure that you've already installed the Backdrop versions of Organic Groups, Entity Plus, and Entity UI in your Backdrop contrib folder prior to running update.php, or all of the above will be for naught.

Moving D7 OG Views to Backdrop

Upon upgrade, Backdrop OG will automatically install the default Views provided by OG. However, these will not overwrite any overridden Views from your Drupal 7. Those will be installed as well.

It's important to understand that any Drupal 7 Views that are "in code" (that is, they are not in the D7 database) will not be installed in Backdrop upon upgrade. You must save your D7 Views to the database if you want them in your new Backdrop site. See Step 2 of the upgrade guidelines