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 » installation » fedora
Trace:
Warning: This page has not been updated in over over a year and may be outdated or deprecated.
installation:fedora

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
Next revisionBoth sides next revision
installation:fedora [2018/07/16 16:30] – demiankatzinstallation:fedora [2019/05/03 12:09] – [2. Install MySQL/MariaDB] demiankatz
Line 1: Line 1:
 ====== VuFind on Fedora ====== ====== VuFind on Fedora ======
- 
-//These instructions apply to VuFind 2.0 and newer; instructions for VuFind 1.x can be found [[legacy:installation:fedora|here]].// 
  
 These instructions assume that you are starting with a clean installation of Fedora.  If you already have a Fedora 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 Fedora.  If you already have a Fedora server, you will be able to skip some steps, but you may have to reconfigure some existing software.
Line 29: Line 27:
  
 <code bash> <code bash>
-su+sudo su
 </code> </code>
  
Line 88: Line 86:
  
  
-// Fedora 22 or newer: //+// Fedora 30 or newer: //
  
 <code bash> <code bash>
-service mariadb start+systemctl start mariadb
 </code> </code>
  
Line 97: Line 95:
  
 <code bash> <code bash>
-service mysqld start+service mariadb start
 </code> </code>
  
Line 116: Line 114:
  
 <code bash> <code bash>
-dnf install php php-devel php-intl php-ldap php-mysqli php-xsl php-gd php-mbstring php-mcrypt php-json+dnf install php php-devel php-intl php-ldap php-mysqli php-xsl php-gd php-mbstring php-mcrypt php-json php-soap
 </code> </code>
  
Line 123: Line 121:
 :!: Starting with VuFind 4.0, the php-mcrypt module is no longer needed. Instead, you will need php-openssl, which should be automatically installed as part of the command above. :!: Starting with VuFind 4.0, the php-mcrypt module is no longer needed. Instead, you will need php-openssl, which should be automatically installed as part of the command above.
  
-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-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 152: Line 150:
 dnf install wget dnf install wget
 cd /tmp cd /tmp
-wget https://github.com/vufind-org/vufind/releases/download/v5.0/vufind-5.0.tar.gz +wget https://github.com/vufind-org/vufind/releases/download/v5.1/vufind-5.1.tar.gz 
-tar xzvf vufind-5.0.tar.gz +tar xzvf vufind-5.1.tar.gz 
-mv vufind-5.0 /usr/local/vufind+mv vufind-5.1 /usr/local/vufind
 </code> </code>
  
Line 278: Line 276:
 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/httpd/error.log) for messages. +The [[development:troubleshooting|troubleshooting page]] has several suggestions that may help.
-  * Check your php-fpm error log (usually /var/log/php-fpm/www-error.log) for messages. +
-  * 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 318: Line 313:
  
 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.
  
 ---- struct data ---- ---- struct data ----
 ---- ----
  
installation/fedora.txt · Last modified: 2024/07/11 18:57 by demiankatz