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 revision | ||
legacy:installation:ubuntu [2015/12/14 18:49] – [2. Start VuFind] demiankatz | legacy:installation:ubuntu [2018/12/19 17:12] (current) – demiankatz | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== VuFind 1.4 on Ubuntu ====== | ====== VuFind 1.4 on Ubuntu ====== | ||
- | // | + | // This outdated page has been deleted |
- | + | ||
- | // | + | |
- | + | ||
- | These instructions assume that you are starting with a clean installation of Ubuntu. | + | |
- | + | ||
- | ====== Getting Started ====== | + | |
- | + | ||
- | Install Ubuntu. | + | |
- | + | ||
- | ====== Installing VuFind from the DEB Package ====== | + | |
- | + | ||
- | The easiest way to get VuFind up and running is to install it from the DEB package. | + | |
- | + | ||
- | + | ||
- | + | ||
- | ===== 1. Update the system ===== | + | |
- | + | ||
- | The first step is to make sure you have the latest patches installed. | + | |
- | + | ||
- | <code bash> | + | |
- | sudo apt-get dist-upgrade | + | |
- | </ | + | |
- | + | ||
- | If the dist-upgrade doesn' | + | |
- | + | ||
- | <code bash> | + | |
- | sudo apt-get update | + | |
- | </ | + | |
- | + | ||
- | After installing patches, you should probably reboot your system so that everything can take effect: | + | |
- | + | ||
- | <code bash> | + | |
- | sudo shutdown -r now | + | |
- | </ | + | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | ===== 2. Install the DEB Package ===== | + | |
- | + | ||
- | First, obtain the package from our download site: | + | |
- | + | ||
- | <code bash> | + | |
- | wget http:// | + | |
- | </ | + | |
- | + | ||
- | Next, install the package using the dpkg utility: | + | |
- | + | ||
- | <code bash> | + | |
- | sudo dpkg -i vufind_1.4.deb | + | |
- | </ | + | |
- | + | ||
- | If you do not have all of VuFind' | + | |
- | + | ||
- | <code bash> | + | |
- | sudo apt-get install -f | + | |
- | </ | + | |
- | + | ||
- | If this fails to install everything you need, you may also want to try installing packages individually like this: | + | |
- | + | ||
- | <code bash> | + | |
- | sudo apt-get install [package from dpkg error message] | + | |
- | </ | + | |
- | + | ||
- | If necessary, repeat the process of attempting a dpkg installation and installing missing dependencies with apt-get until dpkg is successful. | + | |
- | + | ||
- | Some important notes: | + | |
- | + | ||
- | * 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 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. | + | |
- | * You will need to answer some prompts during the installation process. | + | |
- | * You may see some minor errors and warnings while everything gets set up – this is normal, so don't panic! | + | |
- | * 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 / | + | |
- | + | ||
- | ====== Detailed Installation Instructions ====== | + | |
- | + | ||
- | Following these steps will give you a running instance of VuFind. | + | |
- | + | ||
- | + | ||
- | ===== 1. Update the system ===== | + | |
- | + | ||
- | The first step is to make sure you have the latest patches installed. | + | |
- | + | ||
- | <code bash> | + | |
- | sudo apt-get dist-upgrade | + | |
- | </ | + | |
- | + | ||
- | After installing patches, you should probably reboot your system so that everything can take effect: | + | |
- | + | ||
- | <code bash> | + | |
- | sudo shutdown -r now | + | |
- | </ | + | |
- | + | ||
- | ===== 2. Install Apache HTTP Server ===== | + | |
- | Now install the Apache web server. | + | |
- | + | ||
- | <code bash> | + | |
- | sudo apt-get -y install apache2 | + | |
- | sudo a2enmod rewrite | + | |
- | sudo / | + | |
- | </ | + | |
- | + | ||
- | ===== 3. Install MySQL ===== | + | |
- | + | ||
- | VuFind uses the MySQL database for storing user comments, tags and other information. | + | |
- | + | ||
- | <code bash> | + | |
- | sudo apt-get -y install mysql-server | + | |
- | </ | + | |
- | + | ||
- | Note: During installation, | + | |
- | + | ||
- | Note: If you would like to do web-based administration of your database, you may also find it helpful to install the phpmyadmin tool: sudo apt-get install phpmyadmin | + | |
- | + | ||
- | ===== 4. Install PHP ===== | + | |
- | + | ||
- | Most of VuFind is written using the PHP language. | + | |
- | + | ||
- | <code bash> | + | |
- | sudo apt-get -y install php5 php5-dev php-pear php5-ldap php5-mysql php5-xsl php5-pspell php5-gd | + | |
- | </ | + | |
- | + | ||
- | 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 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: | + | |
- | + | ||
- | <code bash> | + | |
- | sudo apt-get -y install php5-sybase | + | |
- | </ | + | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | ===== 5. Install the Java JDK ===== | + | |
- | Next install the JDK (Java Development Kit) on the server – VuFind' | + | |
- | + | ||
- | <code bash> | + | |
- | sudo apt-get -y install default-jdk | + | |
- | </ | + | |
- | + | ||
- | //Note: These instructions used to recommend using the Sun JDK (package: sun-java6-jdk) rather than the default. | + | |
- | + | ||
- | //Note: You can run the Jetty server with the JRE, but in order to ensure that your server | + | |
- | can run with the " | + | |
- | + | ||
- | ===== 6. Download VuFind ===== | + | |
- | All the prerequisites are in place, so now for the fun part – downloading and installing VuFind itself! | + | |
- | + | ||
- | <code bash> | + | |
- | sudo apt-get install subversion | + | |
- | svn export --force https:// | + | |
- | sudo mv / | + | |
- | </ | + | |
- | + | ||
- | Note that we download VuFind to the tmp directory and then move it into place as a second step -- this prevents it from being loaded with " | + | |
- | + | ||
- | If you prefer not to use Subversion, you can also download the software from the [[http:// | + | |
- | + | ||
- | Apache needs to have write access to some of the VuFind subdirectories – these commands set that up: | + | |
- | + | ||
- | <code bash> | + | |
- | sudo chown www-data: | + | |
- | sudo chown www-data: | + | |
- | sudo chown www-data: | + | |
- | </ | + | |
- | + | ||
- | ===== 7. Link VuFind to Apache ===== | + | |
- | + | ||
- | Apache needs to have some extra VuFind settings loaded. | + | |
- | + | ||
- | <code bash> | + | |
- | sudo ln -s / | + | |
- | </ | + | |
- | + | ||
- | Apache needs to be restarted so the changes can take effect: | + | |
- | + | ||
- | <code bash> | + | |
- | sudo / | + | |
- | </ | + | |
- | + | ||
- | + | ||
- | ===== 8. Install VuFind ===== | + | |
- | + | ||
- | The groundwork is set, so you can now run VuFind' | + | |
- | + | ||
- | <code bash> | + | |
- | cd / | + | |
- | sudo / | + | |
- | </ | + | |
- | + | ||
- | Scripts for running and updating VuFind need to be made executable so they can run from the command line: | + | |
- | <code bash> | + | |
- | sudo chmod +x / | + | |
- | sudo chmod +x / | + | |
- | </ | + | |
- | + | ||
- | + | ||
- | ===== 9. Set Up Environment Variables ===== | + | |
- | Some environment variables need to be set so that VuFind-related scripts can find Java and VuFind itself. | + | |
- | + | ||
- | <code bash> | + | |
- | sudo sh -c 'echo export JAVA_HOME=\"/ | + | |
- | sudo sh -c 'echo export VUFIND_HOME=\"/ | + | |
- | </ | + | |
- | + | ||
- | //Note: If you are using the Sun JVM instead of the default JVM, your JAVA_HOME path should actually be / | + | |
- | + | ||
- | After editing / | + | |
- | + | ||
- | <code bash> | + | |
- | source / | + | |
- | </ | + | |
- | + | ||
- | ===== 10. Final Configuration ===== | + | |
- | + | ||
- | Everything is set up - proceed to [[ubuntu# | + | |
- | + | ||
- | ====== Configuring and Starting VuFind ====== | + | |
- | + | ||
- | Regardless of the method you used to set up VuFind, you will need to follow these steps to configure final details and get the code running. | + | |
- | + | ||
- | ===== 1. Configure VuFind ===== | + | |
- | + | ||
- | The software is installed, but you still need to configure it with things like your site's base URL and keys for various third-party services. | + | |
- | + | ||
- | You can use any text editor; if you are new to this, you might find Nano relatively easy (it's not beautiful, but at least the command reference is visible on the screen!): | + | |
- | + | ||
- | <code bash> | + | |
- | sudo nano / | + | |
- | </ | + | |
- | + | ||
- | If you used a non-standard install directory (not / | + | |
- | + | ||
- | ===== 2. Start VuFind ===== | + | |
- | + | ||
- | To start VuFind: | + | |
- | + | ||
- | <code bash> | + | |
- | cd / | + | |
- | ./vufind.sh start | + | |
- | </ | + | |
- | + | ||
- | For more information on managing the operation of the VuFind server, including how to make it start automatically, | + | |
- | + | ||
- | ===== 3. Import Records ===== | + | |
- | + | ||
- | VuFind won't do much good without any data – see the [[: | + | |
- | + | ||
- | ===== 4. Secure Your System ===== | + | |
- | + | ||
- | Congratulations -- you now have a running copy of VuFind. | + | |
- | + | ||
- | ===== 5. Mail Issues===== | + | |
- | If you are unable to use "text this" and "email this" try installing: | + | |
- | <code bash> | + | |
- | pear install Mail-1.2.ob2 | + | |
- | pear install Net_SMTP | + | |
- | </code> | + | |
---- struct data ---- | ---- struct data ---- | ||
+ | properties.Page Owner : | ||
---- | ---- | ||
legacy/installation/ubuntu.txt · Last modified: 2018/12/19 17:12 by demiankatz