About Features Downloads Getting Started Documentation Events Support GitHub

Love VuFind®? Consider becoming a financial supporter. Your support helps build a better VuFind®!

VuFind Documentation

Site Tools

You are here: start » legacy » installation » ubuntu
Trace:
Warning: This page has not been updated in over over a year and may be outdated or deprecated.
legacy:installation:ubuntu

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Last revisionBoth sides next revision
installation_ubuntu [2012/05/03 12:36] – demiankatzlegacy:installation:ubuntu [2016/09/14 12:42] – old revision restored (2015/12/14 14:50) demiankatz
Line 1: Line 1:
-====== VuFind 1.3 on Ubuntu ======+====== VuFind 1.4 on Ubuntu ======
  
-//This documentation will help you install VuFind 1.3. Documentation for the previous major release, VuFind 1.2, can be found [[http://vufind.org/wiki/installation_ubuntu?rev=1312204070|here]], but using the old version is NOT recommended.//+//This documentation will help you install VuFind 1.4. Documentation for the previous major release, VuFind 1.3, can be found [[http://vufind.org/wiki/legacy:installation:ubuntu?rev=1349787598|here]], but using the old version is NOT recommended.// 
 + 
 +//Instructions for VuFind 2.x can be found [[installation:ubuntu|here]].//
  
 These instructions assume that you are starting with a clean installation of Ubuntu.  If you already have an Ubuntu server, you will be able to skip some steps, but you may have to reconfigure some existing software. These instructions assume that you are starting with a clean installation of Ubuntu.  If you already have an Ubuntu server, you will be able to skip some steps, but you may have to reconfigure some existing software.
Line 7: Line 9:
 ====== Getting Started ====== ====== Getting Started ======
  
-Install Ubuntu.  These instructions were written with Ubuntu Server Edition 10.04 LTS in mind, but they should also work on earlier versions with little or no modification.  You can obtain a free copy of the software and find installation instructions at [[http://www.ubuntu.com/|www.ubuntu.com]].  You do not need to install any special packages during the install process to get VuFind working.+Install Ubuntu.  These instructions were originally written with Ubuntu Server Edition 10.04 LTS in mind, but they should also work on other versions with little or no modification.  They have most recently been tested with version 12.10.  You can obtain a free copy of the software and find installation instructions at [[http://www.ubuntu.com/|www.ubuntu.com]].  You do not need to install any special packages during the install process to get VuFind working.
  
 ====== Installing VuFind from the DEB Package ====== ====== Installing VuFind from the DEB Package ======
  
-The easiest way to get VuFind up and running is to install it from the DEB package.  This section provides instructions on doing that.  If you want more control over the installation, skip down to the [[installation_ubuntu#detailed_installation_instructions|Detailed Installation Instructions]] to install everything manually and read explanations of each step of the process.+The easiest way to get VuFind up and running is to install it from the DEB package.  This section provides instructions on doing that.  If you want more control over the installation, skip down to the [[ubuntu#detailed_installation_instructions|Detailed Installation Instructions]] to install everything manually and read explanations of each step of the process.
  
  
Line 44: Line 46:
  
 <code bash> <code bash>
-wget http://downloads.sourceforge.net/vufind/vufind_1.3.deb?use_mirror=osdn -O vufind_1.3.deb+wget http://downloads.sourceforge.net/vufind/vufind_1.4.deb?use_mirror=osdn -O vufind_1.4.deb
 </code> </code>
  
Line 50: Line 52:
  
 <code bash> <code bash>
-sudo dpkg -i vufind_1.3.deb+sudo dpkg -i vufind_1.4.deb
 </code> </code>
  
Line 70: Line 72:
  
   * If you need to install MySQL, you will be prompted for a root password during installation.  For better security, it is a good idea to set this; if you do, be sure you remember it so you can configure VuFind to access the database later.   * If you need to install MySQL, you will be prompted for a root password during installation.  For better security, it is a good idea to set this; if you do, be sure you remember it so you can configure VuFind to access the database later.
-  * If you are a Voyager library, you will also need to install the [[installation_ubuntu#php_oci_driver_for_oracle|PHP OCI Driver for Oracle]] – see the section below for detailed instructions.+  * If you are a Voyager library, you will also need to install the PHP OCI Driver for Oracle – see [[installation:php_oci|this page]] for detailed instructions.
   * If you will be accessing a Sybase database (e.g. for the Horizon LMS), you should also install the php5-sybase package using apt-get.   * If you will be accessing a Sybase database (e.g. for the Horizon LMS), you should also install the php5-sybase package using apt-get.
   * You will need to answer some prompts during the installation process.  If you use a graphical package manager rather than the command line tool, you may not be able to see these prompts unless you open a Terminal window.  For this reason, it is recommended that you use the command line method as described above.   * You will need to answer some prompts during the installation process.  If you use a graphical package manager rather than the command line tool, you may not be able to see these prompts unless you open a Terminal window.  For this reason, it is recommended that you use the command line method as described above.
Line 76: Line 78:
   * If, for some reason, you need to remove the package, you can issue this command (note that -P is for purge and will remove configuration files as well as executable components; use -r for a more cautious removal): sudo dpkg -P vufind   * If, for some reason, you need to remove the package, you can issue this command (note that -P is for purge and will remove configuration files as well as executable components; use -r for a more cautious removal): sudo dpkg -P vufind
  
-Once everything is set up, you should have a working copy of VuFind in /usr/local/vufind.  You may want to restart your system one more time to be sure all the new settings are in place, then you can proceed to [[installation_ubuntu#configuring_and_starting_vufind|Configuring and Starting VuFind]] below to finish setup and get things running!+Once everything is set up, you should have a working copy of VuFind in /usr/local/vufind.  You may want to restart your system one more time to be sure all the new settings are in place, then you can proceed to [[ubuntu#configuring_and_starting_vufind|Configuring and Starting VuFind]] below to finish setup and get things running!
  
 ====== Detailed Installation Instructions ====== ====== Detailed Installation Instructions ======
Line 128: Line 130:
 Note that the php5-ldap library is only needed if you will be using LDAP authentication, and the php5-pspell library is not used at all but might feature in future spelling-related enhancements; you can exclude these packages if you like.  The php5-gd package is also optional, though including it will ensure better support for cover images.  PHP's mbstring library is strongly recommended, but as of this writing, it appears to be automatically included in the php5-dev package. Note that the php5-ldap library is only needed if you will be using LDAP authentication, and the php5-pspell library is not used at all but might feature in future spelling-related enhancements; you can exclude these packages if you like.  The php5-gd package is also optional, though including it will ensure better support for cover images.  PHP's mbstring library is strongly recommended, but as of this writing, it appears to be automatically included in the php5-dev package.
  
-If you are a Voyager library, you will also need to install the [[installation_ubuntu#php_oci_driver_for_oracle|PHP OCI Driver for Oracle]] – see the section below for detailed instructions.+If you are a Voyager library, you will also need to install the PHP OCI Driver for Oracle – see [[installation:php_oci|this page]] for detailed instructions.
  
 If you will be accessing a Sybase database (e.g. for the Horizon LMS), also install php5-sybase: If you will be accessing a Sybase database (e.g. for the Horizon LMS), also install php5-sybase:
Line 156: Line 158:
 <code bash> <code bash>
 sudo apt-get install subversion sudo apt-get install subversion
-svn export --force https://vufind.svn.sourceforge.net/svnroot/vufind/releases/VuFind-1.3 /tmp/vf_download+svn export --force https://vufind.svn.sourceforge.net/svnroot/vufind/releases/VuFind-1.4 /tmp/vf_download
 sudo mv /tmp/vf_download /usr/local/vufind sudo mv /tmp/vf_download /usr/local/vufind
 </code> </code>
Line 221: Line 223:
 ===== 10. Final Configuration ===== ===== 10. Final Configuration =====
  
-Everything is set up - proceed to [[installation_ubuntu#configuring_and_starting_vufind|Configuring and Starting VuFind]] below. +Everything is set up - proceed to [[ubuntu#configuring_and_starting_vufind|Configuring and Starting VuFind]] below.
- +
-====== PHP OCI Driver for Oracle ====== +
-There are a few steps if you need to install the OCI8 libraries.  +
- +
-===== 1. Upgrade PEAR ===== +
-First, upgrade pear to the latest version((see [[http://www.itslot.com/oci8_php5_ubuntu|adapted from pipe's blog]])). +
- +
-<code bash> +
-sudo pear upgrade pear +
-</code> +
- +
-===== 2. Download and Extract the Oracle Instant Client ===== +
- +
-Create a directory to store the Oracle code and then switch to it: +
- +
-<code bash> +
-sudo mkdir -p /opt/oracle +
-cd /opt/oracle +
-</code> +
- +
-Now, you need to get the [[http://www.oracle.com/technology/software/tech/oci/instantclient/index.html|Oracle Instant Client]] (at a minimum you need Basic and SDK zip files).   You will need to accept a license agreement and log in to Oracle's site (free account creation) in order to download the files - grab them with your web browser (be sure to select the appropriate Linux code for your hardware) and then transfer them to the /opt/oracle directory that you just created. +
- +
-Install the unzip utility (for extracting files from the archives) if you haven't already: +
- +
-<code bash> +
-sudo apt-get install unzip +
-</code> +
- +
-Unzip the files (note that some versions of the libraries may have longer filenames - substitute as necessary): +
- +
-<code bash> +
-sudo unzip basic.zip +
-sudo unzip sdk.zip +
-</code> +
- +
-Set up some symbolic links to make the paths simpler and easier to upgrade: +
- +
-<code bash> +
-sudo ln -s instantclient_11_1 instantclient +
-cd /opt/oracle/instantclient +
-sudo ln -s libclntsh.so.11.1 libclntsh.so +
-sudo ln -s libocci.so.11.1 libocci.so +
-</code> +
- +
-Note that numbers in some filenames may vary depending on the version you downloaded. +
- +
- +
-===== 3. Install the Client and PHP Extension ===== +
- +
-Now add the Instant Client to the system dynamic library loader. +
- +
-<code bash> +
-sudo sh -c 'echo /opt/oracle/instantclient > /etc/ld.so.conf.d/oracle-instantclient' +
-</code> +
- +
-You will need the make utility if you do not already have it.  Install it like this: +
- +
-<code bash> +
-sudo apt-get install make +
-</code> +
- +
-Now compile and install the OCI8 package with PECL  +
- +
-<code bash> +
-sudo pecl install oci8 +
-</code> +
- +
-Note, you will be prompted for the instantclient directory, so when you're prompted, just enter +
- +
-<code bash> +
-instantclient,/opt/oracle/instantclient +
-</code> +
- +
-Now install the PHP extension and restart Apache +
- +
-<code bash> +
-sudo sh -c 'echo extension=oci8.so > /etc/php5/apache2/conf.d/oci8.ini' +
-sudo /etc/init.d/apache2 restart +
-</code> +
- +
- +
-===== 4. Set up PDO_OCI ===== +
- +
-If VuFind doesn't work for you with just the OCI8 package installed, you may also need PDO_OCI.  (Notes adapted from [[http://ubuntuforums.org/showthread.php?p=7581997|this page]]). +
- +
-Install some prerequisites: +
- +
-<code bash> +
-sudo apt-get install --yes build-essential libaio1 +
-</code> +
- +
-Download and unzip the package: +
- +
-<code bash> +
-sudo mkdir -p /tmp/pear/download/ +
-cd /tmp/pear/download/ +
-sudo pecl download pdo_oci +
-sudo tar xvf PDO_OCI-1.0.tgz +
-cd PDO_OCI-1.0 +
-</code> +
- +
-Edit the config.m4 file... +
- +
-Add these lines: +
- +
-<code> +
-    elif test -f $PDO_OCI_DIR/lib/libclntsh.$SHLIB_SUFFIX_NAME.11.1; then +
-      PDO_OCI_VERSION=11.1     +
-</code> +
- +
-above these lines: +
- +
-<code> +
-    elif test -f $PDO_OCI_DIR/lib/libclntsh.$SHLIB_SUFFIX_NAME.10.1; then +
-      PDO_OCI_VERSION=10.1     +
-</code> +
- +
-Also add these lines: +
- +
-<code> +
-      11.1) +
-        PHP_ADD_LIBRARY(clntsh, 1, PDO_OCI_SHARED_LIBADD) +
-        ;; +
-</code> +
- +
-above these lines: +
- +
-<code> +
-      *) +
-        AC_MSG_ERROR(Unsupported Oracle version! $PDO_OCI_VERSION) +
-        ;; +
-</code> +
- +
-Now build everything: +
- +
-<code bash> +
-sudo phpize +
-sudo mkdir -p /opt/oracle/instantclient/lib/oracle/11.1 +
-sudo ln -s /opt/oracle/instantclient/sdk /opt/oracle/instantclient/lib/oracle/11.1/client +
-sudo ln -s /opt/oracle/instantclient /opt/oracle/instantclient/lib/oracle/11.1/client/lib +
-sudo ln -s /usr/include/php5 /usr/include/php +
-sudo ./configure --with-pdo-oci=instantclient,/opt/oracle/instantclient,11.1 +
-sudo make +
-sudo make install +
-</code> +
- +
-Add the newly-built module to Apache: +
- +
-<code bash> +
-sudo sh -c 'echo extension=pdo_oci.so > /etc/php5/apache2/conf.d/pdo_oci.ini' +
-sudo /etc/init.d/apache2 restart +
-</code>+
  
 ====== Configuring and Starting VuFind ====== ====== Configuring and Starting VuFind ======
Line 388: Line 238:
 sudo nano /usr/local/vufind/web/conf/config.ini sudo nano /usr/local/vufind/web/conf/config.ini
 </code> </code>
 +
 +If you used a non-standard install directory (not /usr/local/vufind), you should also edit import/import.properties to adjust paths.  If you plan to load authority records, the same thing needs to be done in import/import_auth.properties.
  
 ===== 2. Start VuFind ===== ===== 2. Start VuFind =====
Line 398: Line 250:
 </code> </code>
  
-For more information on managing the operation of the VuFind server, including how to make it start automatically, see the [[Starting and Stopping VuFind]] page.+For more information on managing the operation of the VuFind server, including how to make it start automatically, see the [[administration:starting_and_stopping_solr|Starting and Stopping Solr]] page.
  
 ===== 3. Import Records ===== ===== 3. Import Records =====
  
-VuFind won't do much good without any data – see the [[Importing Records]] page for more details on loading your content into the system.+VuFind won't do much good without any data – see the [[:indexing]] page for more details on loading your content into the system.
  
 ===== 4. Secure Your System ===== ===== 4. Secure Your System =====
  
-Congratulations -- you now have a running copy of VuFind.  However, you should be aware of security concerns.  See the [[Security]] page for some VuFind-specific notes, and take some time to learn about general issues in Unix security if you are not already familiar with the topic; [[http://www.linuxsecurity.com/|LinuxSecurity.com]] is one good source for news and tutorials.+Congratulations -- you now have a running copy of VuFind.  However, you should be aware of security concerns.  See the [[administration:security|Security]] page for some VuFind-specific notes, and take some time to learn about general issues in Unix security if you are not already familiar with the topic; [[http://www.linuxsecurity.com/|LinuxSecurity.com]] is one good source for news and tutorials.
  
 ===== 5. Mail Issues===== ===== 5. Mail Issues=====
legacy/installation/ubuntu.txt · Last modified: 2018/12/19 17:12 by demiankatz