Differences

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

--- installation:installing_multiple_instances [2015/12/21 16:47] – ↷ Links adapted because of a move operation demiankatz
+++ installation:installing_multiple_instances [2019/09/06 10:22] – demiankatz
@@ Line 1: / Line 1: @@
 ====== Installing Multiple Instances ======
-// This page refers to VuFind 2.x; for similar notes related to earlier versions, see [[legacy:installation:installing_multiple_instances|this page]]. //
 There are a few reasons you might want to have several instances of VuFind.  Two real-life examples:
@@ Line 86: / Line 84: @@
 ===== 4 Set up a new Solr Core - if required =====
-Solr Cores hold the searchable records within vufind. Follow these steps if you want this instance to search different records to other instances of vufind on your system.
+Solr Cores hold the searchable records within VuFind. Follow these steps if you want this instance to search different records to other instances of vufind on your system.
 The most common setup, outlined here is an additional core on the existing Solr instance, though there are other options, see further down this page.
-  * Shutdown vufind ($VUFIND_HOME/vufind.sh stop)
+  * Shut down Solr (see [[administration:starting_and_stopping_solr#stopping_solr_manually|stopping Solr manually]])
   * Copy the existing core (usually biblio) under VuFind's solr directory to a new directory of your choice. e.g. <code>
 cd $VUFIND_HOME/solr
@@ Line 96: / Line 94: @@
 </code>
   * If you don't want your new core to contain the records of the core you just copied from (e.g. biblio), go in to the new directory and delete (or move if you are cautious) the index folder <code>cd springfield; rm -r index</code>
-  * Edit solr/solr.xml to make the new core active. <code><core name="springfield" instanceDir="springfield"/></code>
+  * If you are using an old version of VuFind (pre-3.0) you may have to edit solr/solr.xml to make the new core active (<nowiki><core name="springfield" instanceDir="springfield"/></nowiki>); newer versions will load the core automatically.
-  * Edit conf/solrconfig.xml (in the new core directory) to adjust incorrect paths. If you have copied the biblo folder, use your text editor to search for 'biblio' and replace all occurrences (there are about two).
+  * Edit conf/solrconfig.xml (in the new core directory) to adjust incorrect paths. If you have copied the biblo folder, use your text editor to search for 'biblio' and replace all occurrences (there should be one or two).
   * edit $VUFIND_HOME/<instance_name>/config/vufind/config.ini, change the default_core setting under [index] to use the new core. E.g.:   default_core    = springfield
   * If using SolrMarc (i.e. if you will be importing MARC records in to this instance), configure import/import.properties in your [[configuration:local_settings_directory|local settings directory]] to point to the new core.
@@ Line 126: / Line 124: @@
 Creating a new core usually makes more sense than creating a copy of Solr, but if your index is too large to fit on a single server, you could also copy VuFind's Solr index and startup script to another server, and reconfigure your instance to point there (using the url setting in the [Index] section of [[configuration:files:config.ini]] and, if necessary, the solr.path = REMOTE and solr.hosturl settings of SolrMarc's import.properties file).
-It probably does not make sense to try to run two separate instances of Solr on a single server, but if you have a good reason to do this, refer to the old [[legacy:installation:installing_multiple_instances|VuFind 1.x multiple instances documentation]] for some tips; steps 4 and 6 there are still relevant.
 ===== Example shell transcript of setting up a new instance =====
 The following example creates a new instance called springfield, with a new Solr core, on server vufindserver as user libadmin.