Skip to content

Commit 9b96fb3

Browse files
authored
improve Drupal settings workflow (#16)
1 parent 0440d2b commit 9b96fb3

File tree

1 file changed

+13
-10
lines changed

1 file changed

+13
-10
lines changed

README.md

Lines changed: 13 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -10,18 +10,20 @@ This repository allows you to quickly install Apache Solr for Drupal 9+ into a [
1010
1. You may need to install the relevant Drupal requirements: `ddev composer require drush/drush:* drupal/search_api_solr`
1111
1. Enable the `search_api_solr` module either using the web interface or `ddev drush en -y search_api_solr`
1212
1. Create a search_api server at `admin/config/search/search-api` -> "Add server"
13-
1. Choose Solr as backend.
14-
1. Choose "Standard" as the Solr connector type and configure it:
15-
* Set "Server name" to anything you want. Maybe "ddev-solr-server".
16-
* Set "Backend" to "Solr"
17-
* Set "Solr host" to `solr`.
18-
* Set "Solr core" name to "dev".
19-
* Under "Advanced server configuration" set the "solr.install.dir" to `/opt/solr`.
13+
1. Create a server with the following settings
14+
* Set "Server name" to anything you want. Maybe `ddev-solr-server`.
15+
* Set "Backend" to `Solr`
16+
* Configure Solr backend
17+
* Set "Solr Connector" to `Standard`
18+
* Set "Solr host" to `solr`
19+
* Set "solr core" to `dev`
20+
* Under "Advanced server configuration" set the "solr.install.dir" to `/opt/solr`.
21+
2022
1. `ddev restart`
2123

2224
## Explanation
2325

24-
This is the classic Drupal `solr:8` image recipe used for a long time by Drupal users and compatible with `search_api_solr`.
26+
This is the classic Drupal `solr:8` image recipe used for a long time by Drupal users and compatible with `search_api_solr`.
2527

2628
* It installs a [`.ddev/docker-compose.solr.yaml`](docker-compose.solr.yaml) using the solr:8 docker image.
2729
* A standard Drupal 9+ Solr configuration is included in [.ddev/solr/conf](solr/conf).
@@ -36,17 +38,18 @@ This is the classic Drupal `solr:8` image recipe used for a long time by Drupal
3638
## Alternate Core Name
3739

3840
If you want to use a core name other than the default "dev", add a `.ddev/docker-compose.solr-env.yaml` with these contents, using the core name you want to use:
41+
3942
```
4043
services:
4144
solr:
4245
environment:
4346
- SOLR_CORENAME=somecorename
4447
```
48+
4549
1. Remove the #ddev-generated at the top of the file.
4650
2. Change SOLR_CORE environment variable in the `environment:` section.
4751
3. Change your Drupal configuration to use the new core.
4852

4953
## Caveats
50-
* This recipe won't work with versions of Solr before `solr:8`, and Acquia and Pantheon.io hosting require versions from 3 to 7. You'll want to see the [contributed recipes](https://github.com/drud/ddev-contrib) for older versions of solr.
51-
5254

55+
* This recipe won't work with versions of Solr before `solr:8`, and Acquia and Pantheon.io hosting require versions from 3 to 7. You'll want to see the [contributed recipes](https://github.com/drud/ddev-contrib) for older versions of solr.

0 commit comments

Comments
 (0)