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.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
installation:fedora [2017/11/20 15:27] – demiankatz | installation: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: | ||
These instructions assume that you are starting with a clean installation of Fedora. | These instructions assume that you are starting with a clean installation of Fedora. | ||
Line 7: | Line 5: | ||
====== Version Requirements ====== | ====== Version Requirements ====== | ||
- | These instructions were most recently tested on Fedora | + | These instructions were most recently tested on Fedora |
====== A Note on SELinux ====== | ====== A Note on SELinux ====== | ||
Line 29: | Line 27: | ||
<code bash> | <code bash> | ||
- | su | + | sudo su |
</ | </ | ||
Line 71: | Line 69: | ||
===== 2. Install MySQL/ | ===== 2. Install MySQL/ | ||
- | VuFind | + | VuFind |
// Fedora 22 or newer: // | // Fedora 22 or newer: // | ||
Line 88: | Line 86: | ||
- | // Fedora | + | // Fedora |
<code bash> | <code bash> | ||
- | service mariadb | + | systemctl |
</ | </ | ||
Line 97: | Line 95: | ||
<code bash> | <code bash> | ||
- | service | + | service |
</ | </ | ||
Line 106: | Line 104: | ||
</ | </ | ||
- | + | :!: Starting with Fedora 34, the secure installation script may ask you if you want to switch to Unix socket authentication; | |
- | + | ||
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 |
</ | </ | ||
Line 123: | Line 119: | ||
:!: Starting with VuFind 4.0, the php-mcrypt module is no longer needed. Instead, you will need php-openssl, | :!: Starting with VuFind 4.0, the php-mcrypt module is no longer needed. Instead, you will need php-openssl, | ||
- | Note that the php-ldap library is only needed if you will be using LDAP authentication; | + | Note that the php-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 [[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: | ||
</ | </ | ||
+ | :!: 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" | ||
===== 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/ | + | wget https://github.com/vufind-org/vufind/ |
- | tar xzvf vufind-4.1.1.tar.gz | + | tar xzvf vufind-9.0.1.tar.gz |
- | mv vufind-4.1.1 / | + | mv vufind-9.0.1 / |
</ | </ | ||
Line 165: | Line 161: | ||
</ | </ | ||
- | 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. | + | 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. |
<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 | ||
</ | </ | ||
Line 256: | Line 253: | ||
:!: Newer versions of Solr will not run under the root account by default; you should change the ownership of / | :!: Newer versions of Solr will not run under the root account by default; you should change the ownership of / | ||
- | For more information on managing the operation of the Solr server, including | + | :!: If you get a warning about limit settings, see the [[administration: |
+ | |||
+ | For more information on managing the operation of the Solr server, including | ||
===== 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 / | + | The [[development:troubleshooting|troubleshooting |
- | * If that does not help, try editing / | + | |
- | + | ||
- | If you are still stuck, try one of the mailing lists on the [[http:// | + | |
+ | If you are still stuck, try one of the mailing lists on the [[http:// | ||
==== Auto-Configuration ==== | ==== Auto-Configuration ==== | ||
Line 312: | Line 309: | ||
VuFind won't do much good without any data – see the [[: | VuFind won't do much good without any data – see the [[: | ||
- | ===== 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. | ||
+ | :!: 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: | ||
+ | ===== 5. Troubleshooting Notes ===== | ||
+ | |||
+ | ==== Encryption Issues ==== | ||
+ | |||
+ | If you are using Fedora 36 or newer, OpenSSL may not be configured to support VuFind' | ||
---- struct data ---- | ---- struct data ---- | ||
+ | properties.Page Owner : | ||
---- | ---- | ||
installation/fedora.txt · Last modified: 2024/06/24 11:12 by demiankatz