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.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
installation_ubuntu [2012/05/03 12:36] – demiankatz | legacy:installation:ubuntu [2015/12/14 18:44] – ↷ Links adapted because of a move operation 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:// | + | //This documentation will help you install VuFind 1.4. Documentation for the previous major release, VuFind 1.3, can be found [[http:// |
+ | |||
+ | // | ||
These instructions assume that you are starting with a clean installation of Ubuntu. | These instructions assume that you are starting with a clean installation of Ubuntu. | ||
Line 7: | Line 9: | ||
====== Getting Started ====== | ====== Getting Started ====== | ||
- | Install Ubuntu. | + | Install Ubuntu. |
====== 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. | + | The easiest way to get VuFind up and running is to install it from the DEB package. |
Line 44: | Line 46: | ||
<code bash> | <code bash> | ||
- | wget http:// | + | wget http:// |
</ | </ | ||
Line 50: | Line 52: | ||
<code bash> | <code bash> | ||
- | sudo dpkg -i vufind_1.3.deb | + | sudo dpkg -i vufind_1.4.deb |
</ | </ | ||
Line 70: | Line 72: | ||
* If you need to install MySQL, you will be prompted for a root password during installation. | * If you need to install MySQL, you will be prompted for a root password during installation. | ||
- | * If you are a Voyager library, you will also need to install the [[installation_ubuntu# | + | * If you are a Voyager library, you will also need to install the PHP OCI Driver for Oracle – see [[installation: |
* 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. | * You will need to answer some prompts during the installation process. | ||
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 / | + | Once everything is set up, you should have a working copy of VuFind in / |
====== 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, | Note that the php5-ldap library is only needed if you will be using LDAP authentication, | ||
- | If you are a Voyager library, you will also need to install the [[installation_ubuntu# | + | If you are a Voyager library, you will also need to install the PHP OCI Driver for Oracle – see [[installation: |
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:// | + | svn export --force https:// |
sudo mv / | sudo mv / | ||
</ | </ | ||
Line 221: | Line 223: | ||
===== 10. Final Configuration ===== | ===== 10. Final Configuration ===== | ||
- | Everything is set up - proceed to [[installation_ubuntu# | + | Everything is set up - proceed to [[ubuntu# |
- | + | ||
- | ====== 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:// | + | |
- | + | ||
- | <code bash> | + | |
- | sudo pear upgrade pear | + | |
- | </ | + | |
- | + | ||
- | ===== 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 / | + | |
- | cd / | + | |
- | </ | + | |
- | + | ||
- | Now, you need to get the [[http:// | + | |
- | + | ||
- | Install the unzip utility (for extracting files from the archives) if you haven' | + | |
- | + | ||
- | <code bash> | + | |
- | sudo apt-get install unzip | + | |
- | </ | + | |
- | + | ||
- | 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 | + | |
- | </ | + | |
- | + | ||
- | Set up some symbolic links to make the paths simpler and easier to upgrade: | + | |
- | + | ||
- | <code bash> | + | |
- | sudo ln -s instantclient_11_1 instantclient | + | |
- | cd / | + | |
- | sudo ln -s libclntsh.so.11.1 libclntsh.so | + | |
- | sudo ln -s libocci.so.11.1 libocci.so | + | |
- | </ | + | |
- | + | ||
- | 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 / | + | |
- | </ | + | |
- | + | ||
- | You will need the make utility if you do not already have it. Install it like this: | + | |
- | + | ||
- | <code bash> | + | |
- | sudo apt-get install make | + | |
- | </ | + | |
- | + | ||
- | Now compile and install the OCI8 package with PECL | + | |
- | + | ||
- | <code bash> | + | |
- | sudo pecl install oci8 | + | |
- | </ | + | |
- | + | ||
- | Note, you will be prompted for the instantclient directory, so when you're prompted, just enter | + | |
- | + | ||
- | <code bash> | + | |
- | instantclient,/ | + | |
- | </ | + | |
- | + | ||
- | Now install the PHP extension and restart Apache | + | |
- | + | ||
- | <code bash> | + | |
- | sudo sh -c 'echo extension=oci8.so > / | + | |
- | sudo / | + | |
- | </ | + | |
- | + | ||
- | + | ||
- | ===== 4. Set up PDO_OCI ===== | + | |
- | + | ||
- | If VuFind doesn' | + | |
- | + | ||
- | Install some prerequisites: | + | |
- | + | ||
- | <code bash> | + | |
- | sudo apt-get install --yes build-essential libaio1 | + | |
- | </ | + | |
- | + | ||
- | Download and unzip the package: | + | |
- | + | ||
- | <code bash> | + | |
- | sudo mkdir -p / | + | |
- | cd / | + | |
- | sudo pecl download pdo_oci | + | |
- | sudo tar xvf PDO_OCI-1.0.tgz | + | |
- | cd PDO_OCI-1.0 | + | |
- | </ | + | |
- | + | ||
- | Edit the config.m4 file... | + | |
- | + | ||
- | Add these lines: | + | |
- | + | ||
- | < | + | |
- | elif test -f $PDO_OCI_DIR/ | + | |
- | PDO_OCI_VERSION=11.1 | + | |
- | </ | + | |
- | + | ||
- | above these lines: | + | |
- | + | ||
- | < | + | |
- | elif test -f $PDO_OCI_DIR/ | + | |
- | PDO_OCI_VERSION=10.1 | + | |
- | </ | + | |
- | + | ||
- | Also add these lines: | + | |
- | + | ||
- | < | + | |
- | 11.1) | + | |
- | PHP_ADD_LIBRARY(clntsh, | + | |
- | ;; | + | |
- | </ | + | |
- | + | ||
- | above these lines: | + | |
- | + | ||
- | < | + | |
- | *) | + | |
- | AC_MSG_ERROR(Unsupported Oracle version! $PDO_OCI_VERSION) | + | |
- | ;; | + | |
- | </ | + | |
- | + | ||
- | Now build everything: | + | |
- | + | ||
- | <code bash> | + | |
- | sudo phpize | + | |
- | sudo mkdir -p / | + | |
- | sudo ln -s / | + | |
- | sudo ln -s / | + | |
- | sudo ln -s / | + | |
- | sudo ./configure --with-pdo-oci=instantclient,/ | + | |
- | sudo make | + | |
- | sudo make install | + | |
- | </ | + | |
- | + | ||
- | Add the newly-built module to Apache: | + | |
- | + | ||
- | <code bash> | + | |
- | sudo sh -c 'echo extension=pdo_oci.so > / | + | |
- | sudo / | + | |
- | </ | + | |
====== Configuring and Starting VuFind ====== | ====== Configuring and Starting VuFind ====== | ||
Line 388: | Line 238: | ||
sudo nano / | sudo nano / | ||
</ | </ | ||
+ | |||
+ | If you used a non-standard install directory (not / | ||
===== 2. Start VuFind ===== | ===== 2. Start VuFind ===== | ||
Line 398: | Line 250: | ||
</ | </ | ||
- | For more information on managing the operation of the VuFind server, including how to make it start automatically, | + | For more information on managing the operation of the VuFind server, including how to make it start automatically, |
===== 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. | + | Congratulations -- you now have a running copy of VuFind. |
===== 5. Mail Issues===== | ===== 5. Mail Issues===== |
legacy/installation/ubuntu.txt · Last modified: 2018/12/19 17:12 by demiankatz