Skip to content
This repository has been archived by the owner on May 31, 2022. It is now read-only.

Issue #141: Update README.md: Upgrade path is somewhat supported. #6

Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 14 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,16 +14,23 @@ With `1.0-alpha17`, the SPARQL storage has been [split out, as a standalone
module](https://github.com/ec-europa/rdf_entity/issues/17). Moving services from
one module to the other is impossible with the actual Drupal core. See the
[related Drupal core issue](https://www.drupal.org/project/drupal/issues/2863986)
for details. As the
module is in alpha, we're not providing any update path but we recommend to
follow the next steps in order to update a server in production:
for details.

As this module is in alpha, we would normally not provide an upgrade path.
However, we have since become aware of a number of websites that we have an interest in supporting, that use `rdf_entity`, and that need a reliable upgrade path.

We recommend the following steps in order to update a server in production:

1. The update process is split in two consecutive deployments.
1. Install an empty version of the `sparql_entity_storage` module:
```
$ composer require drupal/sparql_entity_storage:dev-empty-module
```
1. Enable the module.
1. Deploy to production.
1. Require `drupal/rdf_entity` with the new `1.0-alpha17` version and
perform a second deployment.
1. Enable the `sparql_entity_storage` module, export to config.
1. Deploy the changes to production.
(A typical deployment operation will include `drush cr`, `drush updb -y` and `drush cim -y`.)
1. Require `drupal/rdf_entity:^1.0-alpha17`, and perform a second deployment.

Please open an issue if any problems occur during this update process.

If the module is / was used for [RDF SKOS](https://github.com/openeuropa/rdf_skos), please follow the more relevant instructions over there.