Differences

This shows you the differences between two versions of the page.

--- administration:starting_and_stopping_solr [2018/06/05 19:06] – [Linux Method] demiankatz
+++ administration:starting_and_stopping_solr [2018/08/01 20:12] – [Linux Method] demiankatz
@@ Line 34: / Line 34: @@
 </code>
-This is warning of some default settings that could impact the performance of your Solr instance. On most Linux platforms, this can be addressed by editing the /etc/security/limits.conf file and adding these lines:
+This is warning of some default settings that could impact the performance of your Solr instance. On some Linux platforms, this can be addressed by editing the /etc/security/limits.conf file and adding these lines:
 <code>
@@ Line 46: / Line 46: @@
 It may be necessary to log out of your terminal session and log back in for these settings to take effect.
+On Linux platforms using systemd, you may be able to work around the problem with a systemd file like this example (in a file like /etc/systemd/system/vufind.service):
+<code>
+Description=VuFind Starter
+After=network.target httpd.service
+[Service]
+Type=forking
+ExecStart=/bin/sh -l -c '/usr/local/vufind/solr.sh start' -x
+PIDFile=/usr/local/vufind/solr/vendor/bin/solr-8080.pid
+User=vufind-user
+ExecStop=/bin/sh -l -c "/usr/local/vufind/solr.sh stop" -x
+SuccessExitStatus=0
+LimitNOFILE=65000
+LimitNPROC=65000
+[Install]
+WantedBy=multi-user.target
+</code>
+(Obviously the /usr/local/vufind path and the vufind-user username should be customized to reflect your local needs).
+Once this is in place, you can use "sudo service vufind start" and "sudo service vufind stop" to start and stop the process, and appropriate limits will be applied.
 ==== Windows Method ====
@@ Line 141: / Line 165: @@
 :!: Important: These instructions were written for VuFind 3.0 or later, when the Solr script was changed to solr.sh instead of vufind.sh; if running VuFind 2.x or earlier, you should replace "solr.sh" with "vufind.sh" in these examples.
-:!: If you need to run VuFind with non-default settings, you may wish to add some lines to export environment variables in this script, or else source a script containing all of your environment settings prior to running "solr.sh".
+:!: If you need to run VuFind with non-default settings, you may wish to add some lines to export environment variables in this script, or else source a script containing all of your environment settings prior to running "solr.sh". In many newer installations of VuFind, such a script is already set up as /etc/profile.d/vufind.sh.
+:!: Newer versions of Solr do not like to be run by the root user; you may need to either add "export SOLR_ADDITIONAL_START_OPTIONS=-force" to your script to force root permissions, or (preferably) set up your script to run Solr as a dedicated user (which can be done by wrapping the solr.sh command with "/bin/su - username -c ...").
 <code>
 #!/bin/sh
 ### BEGIN INIT INFO
+# Provides: vufind
+# Required-Start:
+# Required-Stop:
 # Default-Start: 2 3 4 5
 # Default-Stop: 0 1 6