Skip to content

Commit 4da2d1c

Browse files
Merge pull request #263 from geoblacklight/separate-servers
Update developer docs for running Solr and rails separately
2 parents 6d1cee9 + f360fda commit 4da2d1c

File tree

1 file changed

+16
-3
lines changed

1 file changed

+16
-3
lines changed

docs/docs/developers.md

Lines changed: 16 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -66,14 +66,27 @@ In the diagram above, "My Application" is actually the local test application, `
6666

6767
### Running Solr and Rails server separately
6868

69-
You may decide to run either the Solr server or Rails server separately. With Solr, for instance, run
69+
You may decide to run Solr and the Rails server separately. Solr can be run separately using either Docker or `solr_wrapper`.
70+
71+
To use `solr_wrapper` use the following rake task, which starts Solr and seeds the index with data:
7072
```
7173
$ rake geoblacklight:solr
7274
```
73-
Then, open another Terminal window, navigate to the place where your app is located, and run:
75+
76+
To use docker instead, start the server:
77+
```
78+
$ docker compose up
79+
```
80+
If using docker to run Solr, you need to manually seed the index with data. This `seed` task must be run after the rails server has been started (see below).
7481
```
75-
$ rake engine_cart:server
82+
$ rake geoblacklight:internal:seed
7683
```
84+
85+
Lastly start the rails server. Open another Terminal window, navigate to the place where your app is located, and run:
86+
```
87+
$ rake geoblacklight:server_only
88+
```
89+
7790
Once the server is running, you can open a web browser and visit the URL it prompts, usually [http://localhost:8983/solr/#/blacklight-core](http://localhost:8983/solr/#/blacklight-core) to see the admin interface of your test instance of Solr. As before, remember that ^C (ctrl + c) stops the server.
7891

7992
You may also want to use an external Solr instance, especially in production. You can read more about that [here](/documentation/external_solr).

0 commit comments

Comments
 (0)