Hi there,
Here are a couple suggestions on things to investigate. We'll start with some basic checks:
Elasticsearch also requires Java - make sure you're running the expected version. You can run the command java -version to check. Here is the output I get for a 2.6 installation with Elasticsearch 5.6:
openjdk version "11.0.8" 2020-07-14
OpenJDK Runtime Environment (build 11.0.8+10-post-Ubuntu-0ubuntu120.04)
OpenJDK 64-Bit Server VM (build 11.0.8+10-post-Ubuntu-0ubuntu120.04, mixed mode, sharing)
Second, make sure that the permissions are properly configured in AtoM. AtoM expects all files and subdirectories to be owned by the www-data user if you are following our recommended installation instructions. You can try resetting these permissions with the following:
- sudo chown -R www-data:www-data /usr/share/nginx/atom
Check to see if Elasticsearch is running:
- sudo systemctl status elasticsearch
If not, try enabling and then starting ES, like so:
- sudo systemctl enable elasticsearch
- sudo systemctl start elasticsearch
If none of the above helped:
The most common reason we see for this installation error is not enough available memory. Elasticsearch is known to require a lot of memory during installation - though you can always scale that back a bit after everything is successfully installed and configured. Note that in our Technical Requirements page, this is what we recommend, and when used we typically don't see these kinds of errors:
For a frame of reference, Artefactual’s standard AtoM test/demo site deployment is a cloud VM with the following specifications:
Processor: 2 vCPUs @ 2.3GHz
Memory: 7GB
Disk space (processing): 50GB at a minimum for AtoM’s core stack plus more storage would be required for supporting any substantial number of digital objects.
If you do already have a lot of available memory for your server and none of the suggestions above have helped, then the next problem could be the default JVM heap_size in ES. The size of the heap is declared in /etc/default/elasticsearch - - specifically the ES_HEAP_SIZE for your install. Once the value is changed you will have to restart Elasticsearch. Remember, this shouldn't be set higher than half of the total available RAM on the server. If you do want to try to adjust this, I've found the following links to help guide you with tuning ES:
There is also this StackOverflow thread on adjusting heap size:
Finally, if none of the above has helped resolve the issue, the next thing you could try is to see if the ES logs have any more information than what you've found in your stack trace. In our recommended Ubuntu installation instructions, the Elasticsearch (ES) log is normally located in /var/log/elasticsearch/elasticsearch.log and you could check there to see if there's more information available. Try doing some web searches with the error message to see if you can find further suggestions online - and remember to make sure they are for the correct version of ES!
A lot of this information and more can be found in previous user forum threads. For general Elasticsearch troubleshooting, please see the following previous forum threads, which include many suggestions, and may cover some ground I haven't posted here:
If you need to remove and reinstall ES (for example, if you have the wrong version, or multiple versions running:
In this thread, a user shared how they adjusted the heap size:
Please start with these suggestions - specifically, trying to determine if it is a memory issue, as it commonly is with Elasticsearch issues - and let us know what you find. If nothing in there helps you to identify and/or solve the issue, please provide us with more information about your installation environment (ES version, O/S version, available system memory, etc...) and what you've tried so far, and we'll try to return with further ideas and suggestions.