About Features Downloads Getting Started Documentation Events Support GitHub

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

Site Tools


Warning: This page has not been updated in over over a year and may be outdated or deprecated.
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
installation:ubuntu [2019/05/03 11:40] – Remove mcrypt notes; no longer needed. demiankatzinstallation:ubuntu [2024/02/12 12:55] (current) demiankatz
Line 1: Line 1:
-====== VuFind on Ubuntu ======+====== VuFind® on Ubuntu ======
  
 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 5: Line 5:
 ====== Version Requirements ====== ====== Version Requirements ======
  
-These instructions were most recently tested on Ubuntu 18.10 but should also work with other recent versions with little or no modification. If you are using an older Ubuntu distribution, make sure it meets the [[installation:requirements|requirements]] (such as minimum PHP version) of the VuFind release you are installing.+These instructions were most recently tested on Ubuntu 22.04 LTS and Debian 10.1 but should also work with other recent versions with  little or no modification. Use of an LTS (long term support) release is strongly recommended to reduce the amount of upgrading you will need to do over time. If you are using an older Ubuntu distribution, make sure it meets the [[installation:requirements|requirements]] (such as minimum PHP version) of the VuFind® release you are installing.
 ====== Getting Started ====== ====== Getting Started ======
  
 ===== 1. Install Ubuntu. ===== ===== 1. Install Ubuntu. =====
  
-You can obtain a free copy of Ubuntu 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.+You can obtain a free copy of Ubuntu 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.
  
 If you install a desktop version of Ubuntu, you will need to open the terminal application in order to run the commands listed below. If you install a desktop version of Ubuntu, you will need to open the terminal application in order to run the commands listed below.
Line 30: Line 30:
  
  
-====== 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.  It will quickly load VuFind into the default /usr/local/vufind directory, making the assumption that your local settings belong in /usr/local/vufind/local.+The easiest way to get VuFind® up and running is to install it from the DEB package.  This section provides instructions on doing that.  It will quickly load VuFind® into the default /usr/local/vufind directory, making the assumption that your local settings belong in /usr/local/vufind/local.
  
 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. 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 39: Line 39:
  
 <code bash> <code bash>
-wget https://github.com/vufind-org/vufind/releases/download/v5.1/vufind_5.1.deb+wget https://github.com/vufind-org/vufind/releases/download/v9.1.1/vufind_9.1.1.deb
 </code> </code>
  
-===== 2. Install the package =====+===== 2. Install preferred dependencies (optional) ===== 
 + 
 +By default, if your system does not already have PHP, Java or a MySQL-compatible database installed, VuFind®'s .deb package will automatically install these for you. VuFind® picks your distribution's default PHP version and Java JDK (usually JDK 11 as of this writing) and will choose MySQL over MariaDB (if both options are available in the distribution). If you have different preferences, you can install alternative compatible packages before installing the VuFind® package, and it should take advantage of them instead of installing unwanted versions. 
 + 
 +==== Example 1: Installing a Non-Default JDK ==== 
 + 
 +:!: This option is not supported before VuFind® 7.1, which increased the flexibility of Java handling in the .deb package. 
 + 
 +If you want to run VuFind® with JDK 17 in an Ubuntu release that uses JDK 11 by default, you can simply run: ''sudo apt-get install openjdk-17-jdk'' prior to installing the .deb package. 
 + 
 +==== Example 2: Using MariaDB instead of MySQL ==== 
 + 
 +If you prefer MariaDB to MySQL, simply run this command before installing VuFind®: ''sudo apt-get install mariadb-server'' 
 + 
 +===== 3. Install the package =====
  
 <code bash> <code bash>
-sudo dpkg -i vufind_5.1.deb+sudo dpkg -i vufind_9.1.1.deb
 </code> </code>
  
-If you do not have all of VuFind's dependencies installed already, dpkg will fail with an error message.  You can correct this problem by installing the missing requirements using apt-get:+If you do not have all of VuFind®'s dependencies installed already, dpkg will fail with an error message.  You can correct this problem by installing the missing requirements using apt-get:
  
 <code bash> <code bash>
Line 58: Line 72:
 ==== Database Issues ==== ==== Database Issues ====
  
-  * **Case 1 - MySQL, Ubuntu 17 or earlier:** If you need to install MySQL, you may 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. +  * **Case 1 - MySQL:** If you wish to connect to the root account through the web-based installer in order to set up VuFind®'s database, you should follow these steps: 
-  * **Case 2 - MySQL, Ubuntu 18+:** If you wish to connect to the root account through the web-based installer in order to set up VuFind's database, you will need to disable the root account's "auth_socket" plugin, which prevents regular logins. You can do this by logging in with "sudo mysql -urootand then running <nowiki>"UPDATE mysql.user SET plugin='mysql_native_password' WHERE User='root'; FLUSH PRIVILEGES;"</nowiki> Next you should run "sudo /usr/bin/mysql_secure_installationto set a root password. +    - Disable the root account's "auth_socket" plugin, which prevents regular loginsby logging in with ''sudo mysql -uroot'' and then running ''<nowiki>UPDATE mysql.user SET plugin='mysql_native_password' WHERE User='root'; FLUSH PRIVILEGES;</nowiki>'' 
-  * **Case - MariaDB:** If you are using a distribution that includes MariaDB instead of MySQL, you will not be prompted to set a root password. Instead, you should run "sudo /usr/bin/mysql_secure_installationto properly set up security. If you wish to connect to the root account through the web-based installer in order to set up VuFind's database, you may also need to disable the root account's "unix_socket" plugin, which prevents regular logins. You can do this by logging in with "sudo mysql -uroot -pand then running <nowiki>"UPDATE mysql.user SET plugin='' WHERE User='root'; FLUSH PRIVILEGES;"</nowiki>+    - Quit the MySQL tool and run ''sudo /usr/bin/mysql_secure_installation'' at the command line to automatically improve some database security settings. 
 +    - If the mysql_secure_installation process does not automatically help you set a root password, you may wish to do so manually, by logging in with ''sudo mysql -uroot'' and then running ''<nowiki>ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password by 'your-password-here';</nowiki>'' 
 +    - Edit /etc/mysql/mysql.conf.d/mysqld.cnf, add the appropriate line for your Ubuntu version to the bottom of the file: 
 +      * **Ubuntu 20/21**: default_authentication_plugin=mysql_native_password 
 +      * **Ubuntu 22+:** authentication_policy=mysql_native_password 
 +    * Run ''sudo service mysql restart'' before attempting to set up VuFind®. This will ensure that new accounts are created using a PHP-compatible authentication method
 +  * **Case - MariaDB 10.3 and earlier:** If you are using a distribution that includes MariaDB instead of MySQL, you will not be prompted to set a root password during installation. Instead, you should run ''sudo /usr/bin/mysql_secure_installation'' to properly set up security. If this command is missing, try installing the mariadb-client and mariadb-server packages with apt-get. If you wish to connect to the root account through the web-based installer in order to set up VuFind®'s database, you may also need to disable the root account's "unix_socket" plugin, which prevents regular logins. You can do this by logging in with ''sudo mysql -uroot -p'' and then running ''<nowiki>UPDATE mysql.user SET plugin='' WHERE User='root'; FLUSH PRIVILEGES;</nowiki>'' 
 +  * **Case 3 - MariaDB 10.4 and later:** MariaDB 10.4 significantly changes how authentication is handled; see [[https://mariadb.com/kb/en/authentication-from-mariadb-104/|Authentication from MariaDB 10.4]] in the application's documentation for more details. Notes on successfully configuring MariaDB 10.4 and VuFind® will be added here as time permits. 
 +  * **When all else fails:** If you cannot successfully connect to the database with VuFind®'s installer using the root account, you can still set up the database manually through the command line. When filling out the "Auto Configure" database form, omit the "MySQL Root User" and "MySQL Root Password" fields at the bottom, and instead of clicking the regular "Submit" form, click the "Skip" button below it. This will show you all of the SQL commands that need to be run to set up VuFind®'s database. Using the MySQL command line client (''mysql -u root -p''), run the first four (CREATE DATABASE/CREATE USER/GRANT/FLUSH) commands that are displayed. This will set up your new VuFind® database. Now, you need to run a "USE" command to select that database (e.g. "USE vufind;" if you're using the default database name of "vufind"). Finally, copy and paste the remainder of the SQL (consisting of many CREATE TABLE statements). This will populate your new VuFind® database. You may also need to edit the [Database] section of config.ini to adjust the database connection string to use the credentials created for your new database. 
 + 
 +==== Encryption Issues ==== 
 + 
 +If you are using Ubuntu 22.04 or newer, OpenSSL may not be configured to support VuFind®'s default blowfish encryption algorithm, which could lead to errors when users access their ILS accounts. VuFind® 9.0 and newer should automatically help you solve this problem through the installation/upgrade process, but for earlier releases, see [[https://openlibraryfoundation.atlassian.net/browse/VUFIND-1563|VUFIND-1563]] for a workaround.
  
 ==== ILS-Specific Issues ==== ==== ILS-Specific Issues ====
  
-  * If you are a Voyager library, you will also need to install the PHP OCI Driver for Oracle – see [[php_oci|this page]] for detailed instructions+  * If you are a Voyager library, you will also need to install the [[php_oci|PHP OCI Driver for Oracle]]. 
-  * 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 php-sybase package using apt-get.
  
 ==== Rolling Back ==== ==== Rolling Back ====
Line 71: Line 97:
   * 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.+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, or at least make sure appropriate environment variable settings are loaded by running: You may want to restart your system one more time to be sure all the new settings are in place, or at least make sure appropriate environment variable settings are loaded by running:
Line 79: Line 105:
 </code> </code>
  
-Now you can proceed to [[ubuntu#configuring_and_starting_vufind|Configuring and Starting VuFind]] below to finish setup and get things running!+Now 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 ======
  
-Following these steps will give you a running instance of VuFind.  :!: Note that if you already followed the steps above to install VuFind from the DEB package, you can skip this entire section!+Following these steps will give you a running instance of VuFind®.  :!: Note that if you already followed the steps above to install VuFind® from the DEB package, you can skip this entire section!
  
  
 ===== 1. Install Apache HTTP Server ===== ===== 1. Install Apache HTTP Server =====
-Now install the Apache web server.  This will facilitate communication between VuFind and web browsers.  The following lines accomplish three things:  the first line installs Apache, the second line turns on the URL rewriting module required by VuFind, and the third line restarts the server to activate the newly-installed module.+Now install the Apache web server.  This will facilitate communication between VuFind® and web browsers.  The following lines accomplish three things:  the first line installs Apache, the second line turns on the URL rewriting module required by VuFind®, and the third line restarts the server to activate the newly-installed module.
  
 <code bash> <code bash>
Line 95: Line 121:
 </code> </code>
  
-// IMPORTANT: If your VuFind instance will include records with slashes in their IDs, you need to add "AllowEncodedSlashes on" to the appropriate <nowiki><VirtualHost></nowiki> section of your Apache configuration! //+// IMPORTANT: If your VuFind® instance will include records with slashes in their IDs, you need to add "AllowEncodedSlashes on" to the appropriate <nowiki><VirtualHost></nowiki> section of your Apache configuration! //
 ===== 2. Install MySQL ===== ===== 2. Install MySQL =====
  
-VuFind uses the MySQL database for storing user comments, tags and other information.  You should install this component next:+VuFind® uses the MySQL database for storing user comments, tags and other information.  You should install this component next:
  
 <code bash> <code bash>
Line 104: Line 130:
 </code> </code>
  
-Note: During installation, you will be prompted for a MySQL root password.  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. +Note: See [[installation:ubuntu#database_issues|Database Issues]] above for some important notes on additional setup that may be necessary to make the database compatible with VuFind®.
- +
-Note: If you are using a distribution that includes MariaDB instead of MySQL, you will not be prompted to set a root password. Instead, you should run "sudo /usr/bin/mysql_secure_installation" to properly set up security.  If you wish to connect to the root account through the web-based installer in order to set up VuFind'database, you will also need to disable the root account's "unix_socket" plugin, which prevents regular logins. You can do this by logging in with "sudo mysql -uroot -p" and then running <nowiki>"UPDATE mysql.user SET plugin='' WHERE User='root'; FLUSH PRIVILEGES;"</nowiki>+
  
 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 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
  
-Note: Some Linux distributions have replaced MySQL with MariaDB. If you are working with one of those platforms (or if Ubuntu has changed its defaults by the time you are reading this), the two should be functionally equivalent.+Note: Some Linux distributions have replaced MySQL with MariaDB. The two should be functionally equivalent, and both should work equally well with VuFind®.
 ===== 3. Install PHP ===== ===== 3. Install PHP =====
  
-Most of VuFind is written using the PHP language.  We must install this next, being sure to enable modules for key technologies used by VuFind (MySQL, LDAP, etc.)+Most of VuFind® is written using the PHP language.  We must install this next, being sure to enable modules for key technologies used by VuFind® (MySQL, LDAP, etc.)
  
 <code bash> <code bash>
Line 119: Line 143:
 </code> </code>
  
-Note that the php-ldap library is only needed if you will be using LDAP authentication; you can exclude this package if you like. The php-soap library is only used by the Symphony ILS driver (as of this writing), but it is required by one of VuFind's composer dependencies and will need to be installed if you plan to run composer manually for any reason. The php-gd package is also optional, though including it will ensure better support for cover images.+Note that the php-ldap library is only needed if you will be using LDAP authentication; you can exclude this package if you like. The php-soap library is only used by the Symphony ILS driver (as of this writing), but it is required by one of VuFind®'s composer dependencies and will need to be installed if you plan to run composer manually for any reason. The php-gd package is also optional, though including it will ensure better support for cover images.
  
 If you are a Voyager library, you will also need to install the PHP OCI Driver for Oracle – see [[php_oci|this page]] for detailed instructions. If you are a Voyager library, you will also need to install the PHP OCI Driver for Oracle – see [[php_oci|this page]] for detailed instructions.
Line 129: Line 153:
 </code> </code>
  
-:!: These instructions assume you are using an Ubuntu distribution including PHP 7. If you are on an older distribution, you may need to change "php" to "php5" in the package names and install a PHP 5-compatible version of VuFind (4.x or earlier). This is not recommended!+:!: These instructions assume you are using an Ubuntu distribution including PHP 7. If you are on an older distribution, you may need to change "php" to "php5" in the package names and install a PHP 5-compatible version of VuFind® (4.x or earlier). This is not recommended!
 ===== 4. Install the Java JDK ===== ===== 4. Install the Java JDK =====
-Next install JDK (the Java Development Kit) on the server – VuFind's searching back-end and MARC indexing tools rely on Java. Note that some VuFind components may be able to run using only the JRE (Java Runtime Environment), but the JDK is strongly recommended, and required for proper MARC indexing after release 3.1.+Next install JDK (the Java Development Kit) on the server – VuFind®'s searching back-end and MARC indexing tools rely on Java. Note that some VuFind® components may be able to run using only the JRE (Java Runtime Environment), but the JDK is strongly recommended, and required for proper MARC indexing after release 3.1.
  
 <code bash> <code bash>
Line 137: Line 161:
 </code> </code>
  
-===== 5. Download VuFind ===== +===== 5. Download VuFind® ===== 
-All the prerequisites are in place, so now for the fun part – downloading and installing VuFind itself!+All the prerequisites are in place, so now for the fun part – downloading and installing VuFind® itself!
  
-Instructions for obtaining VuFind can be found on the [[http://vufind.org/downloads.php|download page]].  You can either download a particular release in tar.gz or zip format, or you can load the latest development code directly from Git.+Instructions for obtaining VuFind® can be found on the [[http://vufind.org/downloads.php|download page]].  You can either download a particular release in tar.gz or zip format, or you can load the latest development code directly from Git.
  
-:!: Starting with VuFind 3.0, when loading code from Git, you will also need to install dependencies using [[development:recommended_tools:composer|Composer]].+:!: Starting with VuFind® 3.0, when loading code from Git, you will also need to install dependencies using [[development:recommended_tools:composer|Composer]].
  
 You can choose whatever download method you prefer; here is a sample approach for downloading a pre-packaged .tar.gz file: You can choose whatever download method you prefer; here is a sample approach for downloading a pre-packaged .tar.gz file:
Line 148: Line 172:
 <code> <code>
 cd /tmp cd /tmp
-wget https://github.com/vufind-org/vufind/releases/download/v5.1/vufind-5.1.tar.gz +wget https://github.com/vufind-org/vufind/releases/download/v9.1.1/vufind-9.1.1.tar.gz 
-tar xzvf vufind-5.1.tar.gz +tar -xzvf vufind-9.1.1.tar.gz 
-sudo mv vufind-5.1 /usr/local/vufind+sudo mv vufind-9.1.1 /usr/local/vufind
 </code> </code>
  
-===== 6. Install VuFind =====+===== 6. Install VuFind® =====
  
-The groundwork is set, so you can now run VuFind's install script to set up your basic configuration.  You can accept the defaults for now -- you can run the installer again later if you need to make changes.+The groundwork is set, so you can now run VuFind®'s install script to set up your basic configuration.  You can accept the defaults for now -- you can run the installer again later if you need to make changes.
  
 <code bash> <code bash>
Line 169: Line 193:
 </code> </code>
  
-If you plan to use VuFind's command line tools, you also need a separate cache for that:+If you plan to use VuFind®'s command line tools, you also need a separate cache for that:
  
 <code bash> <code bash>
-mkdir /usr/local/vufind/local/cache/cli+sudo mkdir /usr/local/vufind/local/cache/cli
 sudo chmod 777 /usr/local/vufind/local/cache/cli sudo chmod 777 /usr/local/vufind/local/cache/cli
 </code> </code>
  
-Note: making the cache world-writable is a simple but less-than-secure approach to enabling proper caching. You may wish to limit ownership to a specific VuFind CLI user or use ACL's using techniques described in [[http://symfony.com/doc/current/book/installation.html#checking-symfony-application-configuration-and-setup|Symfony's Installation Manual]]. +Note: making the cache world-writable is a simple but less-than-secure approach to enabling proper caching. You may wish to limit ownership to a specific VuFind® CLI user or use ACL's using techniques described in [[http://symfony.com/doc/current/book/installation.html#checking-symfony-application-configuration-and-setup|Symfony's Installation Manual]]. 
-===== 7. Link VuFind to Apache =====+===== 7. Link VuFind® to Apache =====
  
-Apache needs to have some extra VuFind settings loaded.  Run this command to make Apache aware of VuFind's configuration file:+Apache needs to have some extra VuFind® settings loaded.  Run this command to make Apache aware of VuFind®'s configuration file:
  
 **Apache 2.2 (Ubuntu 13.04 or earlier):** **Apache 2.2 (Ubuntu 13.04 or earlier):**
Line 201: Line 225:
  
 ===== 8. Set Up Environment Variables ===== ===== 8. Set Up Environment Variables =====
-Some environment variables need to be set so that VuFind-related scripts can find Java and VuFind itself.  If you plan on running VuFind under a specific user account, you should set these only for that user.  If you want to make the settings global for all accounts (the easiest, but not necessarily the best, approach), just run this code to add the necessary lines to a new /etc/profile.d file:+Some environment variables need to be set so that VuFind®-related scripts can find Java and VuFind® itself.  If you plan on running VuFind® under a specific user account, you should set these only for that user.  If you want to make the settings global for all accounts (the easiest, but not necessarily the best, approach), just run this code to add the necessary lines to a new /etc/profile.d file:
  
 <code bash> <code bash>
Line 209: Line 233:
 </code> </code>
  
-//Note: If you are using the Sun JVM instead of the default JVM, you may need to specify a different JAVA_HOME path, like /usr/lib/jvm/java-x-sun.//+//Note: If you have multiple JVMs and want to use a non-default one instead, you may need to specify a different JAVA_HOME path, like /usr/lib/jvm/java-17-openjdk-amd64.//
  
 After creating the file, you must load it manually for the changes to take effect without forcing you to log out and back in again: After creating the file, you must load it manually for the changes to take effect without forcing you to log out and back in again:
Line 219: Line 243:
 ===== 9. Final Configuration ===== ===== 9. Final Configuration =====
  
-Everything is set up - proceed to [[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.
  
-====== Configuring and Starting VuFind ======+====== 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.+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. Start Solr ===== ===== 1. Start Solr =====
  
-To start VuFind's Solr index:+To start VuFind®'s Solr index:
  
 <code bash> <code bash>
Line 233: Line 257:
 ./solr.sh start ./solr.sh start
 </code> </code>
- 
-:!: solr.sh was called vufind.sh prior to release 3.0; if you are installing an old version, please adjust accordingly. 
- 
-:!: If you get an error about an incorrect JAVA_HOME setting on Ubuntu 18, you may need to manually correct it by creating a new default-java symlink: "sudo ln -s /usr/lib/jvm/java-8-openjdk-amd64 /usr/lib/jvm/default-java". If this fails, look at your options in /usr/lib/jvm and pick the most appropriate available Java 8 option. 
  
 :!: If you get a warning about limit settings, see the [[administration:starting_and_stopping_solr|starting and stopping Solr]] page for details on how to fix it. :!: If you get a warning about limit settings, see the [[administration:starting_and_stopping_solr|starting and stopping Solr]] page for details on how to fix it.
  
-For more information on managing the operation of the VuFind server, including troubleshooting notes and instructions for starting it automatically, see the [[administration:starting_and_stopping_solr|Starting and Stopping Solr]] page.+For more information on managing the operation of the VuFind® server, including troubleshooting notes and instructions for starting it automatically, see the [[administration:starting_and_stopping_solr|Starting and Stopping Solr]] page.
  
-===== 2. Configure VuFind =====+===== 2. Configure VuFind® =====
  
 Open a web browser, and browse to this URL: Open a web browser, and browse to this URL:
Line 248: Line 268:
   http://your-server-name/vufind/Install/Home   http://your-server-name/vufind/Install/Home
  
-(Replace "your-server-name" with the address you wish to use to access VuFind; replace "vufind" with your custom base path if you changed the default setting during installation).+(Replace "your-server-name" with the address you wish to use to access VuFind®; replace "vufind" with your custom base path if you changed the default setting during installation).
  
 ==== Troubleshooting ==== ==== Troubleshooting ====
Line 254: Line 274:
 If you see a blank white screen, something is wrong. If you see a blank white screen, something is wrong.
  
-  * Check your Apache error log (usually /var/log/apache2/error.log) for messages. +The [[development:troubleshooting|troubleshooting page]] has several suggestions that may help.
-  * If that does not help, try editing /usr/local/vufind/local/httpd_vufind.conf and uncommenting the "SetEnv VUFIND_ENV development" line -- after an Apache restart, this will put VuFind into development mode (which will display more detailed error messages if the code is capable of running).+
  
-If you are still stuck, try one of the mailing lists on the [[http://vufind.org/support.php|support page]].+If you are still stuck, try one of the mailing lists on the [[http://vufind.org/support.php|support page]]; the community is always willing to help new arrivals.
  
 ==== Auto-Configuration ==== ==== Auto-Configuration ====
Line 273: Line 292:
 Notes: Notes:
  
-  * To set up VuFind's database, you will need to have the root password you set when installing MySQL.+  * To set up VuFind®'s database, you will need to have the root password you set when installing MySQL.
  
 ==== Locking Down Configurations ==== ==== Locking Down Configurations ====
Line 285: Line 304:
 </code> </code>
  
-(Replace "root:root" with a different user/group if you have set up a particular Linux user for the purposes of running VuFind; replace /usr/local/vufind with your VuFind base path if you have customized the location of your installation).+(Replace "root:root" with a different user/group if you have set up a particular Linux user for the purposes of running VuFind®; replace /usr/local/vufind with your VuFind® base path if you have customized the location of your installation).
  
 ===== 3. Import Records ===== ===== 3. Import Records =====
  
-VuFind won't do much good without any data – see the [[:indexing]] 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 and Prepare for Production =====
-:!: When using Ubuntu 18 in combination with VuFind 5.0.x, the SolrMarc importer may fail with an error message about log4j. This will be corrected in a future release; in the meantime, you should downgrade your JVM: +
- +
-<code> +
-sudo apt-get install openjdk-8-jdk +
-sudo update-java-alternatives -s java-1.8.0-openjdk-amd64 +
-sudo rm /usr/lib/jvm/default-java +
-sudo ln -s /usr/lib/jvm/java-8-openjdk-amd64 /usr/lib/jvm/default-java +
-</code> +
-===== 4. Secure Your System =====+
  
-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.+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.
  
 :!: Do not forget this step before going into production -- an improperly secured system on the open Internet can quickly come under attack. :!: Do not forget this step before going into production -- an improperly secured system on the open Internet can quickly come under attack.
  
 +There are also some further production-specific considerations listed in the [[administration:production_checklist|Production Checklist]].
 ---- struct data ---- ---- struct data ----
 +properties.Page Owner : 
 ---- ----
  
installation/ubuntu.1556883623.txt.gz · Last modified: 2019/05/03 11:40 by demiankatz