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/01/30 01:23] – demiankatzinstallation:fedora [2023/04/24 14:52] – 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 7: Line 5:
 ====== Version Requirements ====== ====== Version Requirements ======
  
-These instructions were most recently tested on Fedora 27 but should also work with other recent versions with little or no modification. If you are using an older Fedora 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 Fedora 38 but should also work with other recent versions with little or no modification. It should also work with other members of the RedHat family, including CentOS, RedHat Enterprise Linux, Oracle Linux, etc., though in many cases, you may need to replace "dnf" commands with "yum." If you are using an older Fedora distribution, make sure it meets the [[installation:requirements|requirements]] (such as minimum PHP version) of the VuFind release you are installing.
 ====== A Note on SELinux ====== ====== A Note on SELinux ======
  
Line 29: Line 27:
  
 <code bash> <code bash>
-su+sudo su
 </code> </code>
  
Line 71: Line 69:
 ===== 2. Install MySQL/MariaDB ===== ===== 2. Install MySQL/MariaDB =====
  
-VuFind uses the MySQL database for storing user comments, tags and other information.  You should install this component next.  Some versions of Fedora have replaced MySQL with the functionally equivalent MariaDB.+VuFind can use the MariaDB or MySQL database for storing user comments, tags and other information.  You should install this component next. Most Fedora distributions use MariaDB, but some older versions used to use MySQL.
  
 // Fedora 22 or newer: // // Fedora 22 or newer: //
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 106: Line 104:
 </code> </code>
  
- +:!: Starting with Fedora 34, the secure installation script may ask you if you want to switch to Unix socket authentication; you must answer NO to this question, as this authentication mechanism is currently incompatible with VuFind.
- +
  
  
Line 116: Line 112:
  
 <code bash> <code bash>
-dnf install php php-devel php-intl php-ldap php-mysqli php-xsl php-gd php-mbstring php-mcrypt+dnf install php php-devel php-intl php-ldap php-mysqli php-xsl php-gd php-mbstring php-json php-soap php-sodium
 </code> </code>
  
Line 123: Line 119:
 :!: 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 139: Line 135:
 </code> </code>
  
 +:!: If you are using Fedora 28 or newer and VuFind 4.x or earlier, installing java-*-openjdk-devel may give you an incompatible version of Java. You should specifically "dnf install java-1.8.0-openjdk-devel" to be sure you get an appropriate version.
 ===== 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!
Line 152: Line 148:
 dnf install wget dnf install wget
 cd /tmp cd /tmp
-wget http://downloads.sourceforge.net/vufind/vufind-4.1.2.tar.gz?use_mirror=osdn -O vufind-4.1.2.tar.gz +wget https://github.com/vufind-org/vufind/releases/download/v9.0.1/vufind-9.0.1.tar.gz 
-tar xzvf vufind-4.1.2.tar.gz +tar xzvf vufind-9.0.1.tar.gz 
-mv vufind-4.1.2 /usr/local/vufind+mv vufind-9.0.1 /usr/local/vufind
 </code> </code>
  
Line 165: Line 161:
 </code> </code>
  
-Appropriate security permissions need to be set up so Apache can access the VuFind code.  The chcon line sets file permissions so Apache is allowed to load the files.  The first setsebool command allows Apache to communicate with itself internally, which is necessary to access the search back-end.  The second setsebool command allows Apache to send email, which is necessary for VuFind's message-sending functions.+Appropriate security permissions need to be set up so Apache can access the VuFind code.  The chcon line sets file permissions so Apache is allowed to load the files.  The first setsebool command allows Apache to communicate with itself internally, which is necessary to access the search back-end.  The second setsebool command allows Apache to send email, which is necessary for VuFind's message-sending functions. The semanage command allows Apache to communicate with Solr on its default port of 8983.
  
 <code bash> <code bash>
Line 171: Line 167:
 setsebool -P httpd_can_network_relay=1 setsebool -P httpd_can_network_relay=1
 setsebool -P httpd_can_sendmail=1 setsebool -P httpd_can_sendmail=1
 +semanage port -a -t http_port_t -p tcp 8983
 </code> </code>
  
Line 256: Line 253:
 :!: Newer versions of Solr will not run under the root account by default; you should change the ownership of /usr/local/vufind/solr and run the service as a different user for better security. :!: Newer versions of Solr will not run under the root account by default; you should change the ownership of /usr/local/vufind/solr and run the service as a different user for better security.
  
-For more information on managing the operation of the Solr server, including how to make it start automatically, see the [[administration:starting_and_stopping_solr|Starting and Stopping Solr]] page.+:!: 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 Solr 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 =====
Line 276: Line 275:
 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.
-  * 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 312: Line 309:
 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 =====+===== 4. Secure Your System and Prepare for Production =====
  
 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.
 +
 +There are also some further production-specific considerations listed in the [[administration:production_checklist|Production Checklist]].
 +===== 5. Troubleshooting Notes =====
 +
 +==== Encryption Issues ====
 +
 +If you are using Fedora 36 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. See [[https://openlibraryfoundation.atlassian.net/browse/VUFIND-1563|VUFIND-1563]] for a workaround. 
 ---- struct data ---- ---- struct data ----
 +properties.Page Owner : 
 ---- ----
  
installation/fedora.txt · Last modified: 2024/06/24 11:12 by demiankatz