Commit d27184fb authored by catch's avatar catch

Issue #3073476 by shimpy, jhodgdon, nitesh624, prabha1997, quietone,...

Issue #3073476 by shimpy, jhodgdon, nitesh624, prabha1997, quietone, alonaoneill, catch, dwebpoint, alexpott, webchick: Convert migrate, migrate_drupal, migrate_drupal_multilingual, migrate_drupal_ui module hook_help() to topic(s)
parent d937a57a
---
label: 'Migrating, updating, and upgrading'
top_level: true
---
<h2>{% trans %}What are updating, upgrading, and migrating?{% endtrans %}</h2>
<p>{% trans %}<em>Updating</em> is the process of changing from one minor version of the software to a newer version, such as from version 8.3.4 to 8.3.5, or 8.3.5 to 8.4.0. Starting with version 8.x, you can also update to major versions 9, 10, and beyond if your add-on modules, themes, and install profiles are compatible. <em>Upgrading</em> is the process of changing from an older major version of the software to a newer version, such as from version 7 to 8. <em>Migrating</em> is the process of importing data into a site.{% endtrans %}</p>
<p>{% trans %}To upgrade a site from Drupal 6 or 7 to Drupal 8 or later, keeping the content and configuration the same, you will install the new version of the software and add-on modules and themes in a new site, and then migrate the content and other data from your old site into the new site.{% endtrans %}</p>
<h2>{% trans %}Overview of Migrating{% endtrans %}</h2>
<p>{% trans %}You can use the <em>Migration</em> group of modules to perform the migration step of upgrading from Drupal 6 or 7 to Drupal 8 or later, as well as other migrations. These modules also provide APIs that can be used by programmers to write custom software for migrations. Here are the functions of the core migration modules:</p>{% endtrans %}
<dl>
<dt>{% trans %}Migrate{% endtrans %}</dt>
<dd>{% trans %}Provides the underlying API for migrating data.{% endtrans %}</dd>
<dt>{% trans %}Migrate Drupal{% endtrans %}</dt>
<dd>{% trans %}Provides data migration from older versions of the Drupal software into a new site.{% endtrans %}</dd>
<dt>{% trans %}Migrate Drupal UI{% endtrans %}</dt>
<dd>{% trans %}Provides a user interface for performing data migration from older versions of the Drupal software into a new site.{% endtrans %}</dd>
</dl>
<p>{% trans %}If the source of the data you want to migrate is a different content management system, or if the data source is a Drupal site that was built using contributed modules that the core migration modules do not support, then you will also need one or more contributed or custom modules in order to migrate your data.{% endtrans %}</dd>
</dl>
<h2>{% trans %}Additional Resources{% endtrans %}</h2>
<ul>
<li>{% trans %}<a href="https://www.drupal.org/docs/upgrading-drupal">Upgrading Drupal</a>{% endtrans %}</li>
</ul>
---
label: 'Migrating data for an upgrade using the user interface'
related:
- migrate.overview
---
{% set migrate_drupal_upgrade = render_var(url('migrate_drupal_ui.upgrade')) %}
{% set migrate_drupal_log = render_var(url('dblog.overview')) %}
{% set overview_topic = render_var(url('help.help_topic', {'id': 'migrate.overview'})) %}
<h2>{% trans %}Goal{% endtrans %}</h2>
<p>{% trans %}Migrate data into a new, empty site, as part of an upgrade from an older version of Drupal. See <a href="{{ overview_topic }}">Migrating and upgrading</a> for an overview of migrating and upgrading.{% endtrans %}</p>
<h2>{% trans %}Steps{% endtrans %}</h2>
<ol>
<li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Configuration</em> &gt; <em>Development</em> &gt; <em><a href="{{ migrate_drupal_upgrade }}">Upgrade</a></em>.{% endtrans %}</li>
<li>{% trans %}Read the introduction and follow the <em>Preparation steps</em> on the page. Then click <em>Continue</em>.{% endtrans %}</li>
<li>{% trans %}Select the Drupal version of the source site. Also enter the database credentials and public and private files directories (private file directory is not available when migrating from Drupal 6). Click <em>Review upgrade</em>.{% endtrans %}</li>
<li>{% trans %}If the next page you see contains a message about conflicting content, that means that the site where you are running the upgrade is not empty. If you continue, you will lose the data in the site. If that is acceptable, click the button to continue; if not, start these steps over in a new, clean Drupal site.{% endtrans %}</li>
<li>{% trans %}On the <em>What will be upgraded?</em> page, review the list of modules whose data will not be upgraded. If that list is not empty and you want to migrate the data from those modules, you will need to download contributed modules and/or install core or contributed modules, and start these steps over.{% endtrans %}</li>
<li>{% trans %}When the list of modules that will and will not be upgraded meets your expectations, click <em>Perform upgrade</em> and wait for the upgrade to complete. You will see a message about the number of upgrade tasks that were successful or failed, and you can review the upgrade message log by clicking the link on the results page.{% endtrans %}</li>
</ol>
<h2>{% trans %}Additional Resources{% endtrans %}</h2>
<ul>
<li>{% trans %}<a href="https://www.drupal.org/docs/upgrading-drupal/upgrading-from-drupal-6-or-7-to-drupal-8-and-newer">Upgrading from Drupal 6 or 7 to Drupal 8 (and newer)</a>{% endtrans %}</li>
</ul>
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment