Differences

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

--- administration:starting_and_stopping_solr [2017/08/22 13:05] – [Linux (init.d) Method] demiankatz
+++ administration:starting_and_stopping_solr [2018/08/01 20:12] – [Linux Method] demiankatz
@@ Line 21: / Line 21: @@
 Note:  If you previously rebooted your system without manually stopping Solr, the script may mistakenly believe that it is still running.  In this case, a [[starting_and_stopping_solr#restarting_solr_manually|manual restart]] should solve the problem.
+=== Limit Warnings ===
+Starting with Solr 7.3.1, you may see warnings on startup resembling:
+<code>
+*** [WARN] *** Your open file limit is currently 1024.
+ It should be set to 65000 to avoid operational disruption.
+ If you no longer wish to see this warning, set SOLR_ULIMIT_CHECKS to false in your profile or solr.in.sh
+*** [WARN] ***  Your Max Processes Limit is currently 15058.
+ It should be set to 65000 to avoid operational disruption.
+ If you no longer wish to see this warning, set SOLR_ULIMIT_CHECKS to false in your profile or solr.in.sh
+</code>
+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>
+username         soft    nproc           65000
+username         soft    nofile          65000
+username         hard    nproc           65000
+username         hard    nofile          65000
+</code>
+(where "username" is the name of the user that will be running Solr).
+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 116: / 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