Commit c14b94a8 authored by Ben Hayward's avatar Ben Hayward

Update installation.md

1 merge request!6[Sprint/NuancedNumbat](chore): Added in section for troubleshooting failed ES building on Linux
......@@ -39,49 +39,7 @@ _**Linux users:** To get Elasticsearch 6 to run, you must make a settings change
4. Run `docker-compose up front-build`
5. Navigate to [http://localhost:8080](http://localhost:8080)
## Troubleshooting
### Minds is already installed
- Ensure **engine/settings.php** does not exist and re-run `docker-compose up installer`
### Cassandra will not boot
- Ensure thrift is enabled
- Cassandra requires at least 4GB of memory to operate. You can start Cassandra manually by running `docker-compose up cassandra`
### Docker is frozen
- You might need to increase the resources allotted to Docker. To do this, go to _Docker > Preferences > Advanced_. From there, move the CPU/Memory sliders up and see if that fixes the problem
### ElasticSearch is missing indexes (Linux)
Sometimes on Linux there can be still be issues after building the Elasticsearch indexes, due to permission issues. This can manifest in a few ways, but is usually indicated simply by an error complaining about missing indexes in ElasticSearch.
First, run this command, or add it to your .bashrc or .zshrc to have it permanently available:
```
alias dm-disk='docker run --rm -it -v /:/docker alpine:edge $@'
```
Next, run `docker volume ls` and find the name of the Elasticsearch data container.
Copy it to your clipboard, and run the second command, replacing the end with the copied name:
```
docker volume ls
docker volume inspect xxxxx_elasticsearch_etc
```
This will output JSON to your terminal. In that JSON, look for the Mountpoint key, and copy over the path value (we will call it $MOUNTPOINT).
It should look something like this:
/var/lib/docker/volumes/minds_elasticsearch-data/_data
Next up, you need to run
```
dm-disk
chmod -R 0777 /docker/$MOUNTPOINT
```
### Nuclear Option
## Nuclear Option
When things aren't running smoothly in your Dockerized environment, sometimes it's best to start from scratch. Follow these steps to **completely delete your data** and start fresh:
......
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