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 » ubuntu
Trace:
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 [2023/10/30 13:22] – Remove note about end-of-lifed Ubuntu release. demiankatzinstallation:ubuntu [2024/02/12 12:55] (current) – demiankatz
Line 39: Line 39:
  
 <code bash> <code bash>
-wget https://github.com/vufind-org/vufind/releases/download/v9.1/vufind_9.1.deb+wget https://github.com/vufind-org/vufind/releases/download/v9.1.1/vufind_9.1.1.deb
 </code> </code>
  
Line 59: Line 59:
  
 <code bash> <code bash>
-sudo dpkg -i vufind_9.1.deb+sudo dpkg -i vufind_9.1.1.deb
 </code> </code>
  
Line 74: Line 74:
   * **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 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:
     - Disable the root account's "auth_socket" plugin, which prevents regular logins, by logging in with ''sudo mysql -uroot'' and then running ''<nowiki>UPDATE mysql.user SET plugin='mysql_native_password' WHERE User='root'; FLUSH PRIVILEGES;</nowiki>''     - Disable the root account's "auth_socket" plugin, which prevents regular logins, by logging in with ''sudo mysql -uroot'' and then running ''<nowiki>UPDATE mysql.user SET plugin='mysql_native_password' WHERE User='root'; FLUSH PRIVILEGES;</nowiki>''
-    - Quit the MySQL tool and run ''sudo /usr/bin/mysql_secure_installation'' at the command line to set a root password.+    - 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:     - 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 20/21**: default_authentication_plugin=mysql_native_password
Line 129: 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®'s 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 =====
  
Line 173: Line 172:
 <code> <code>
 cd /tmp cd /tmp
-wget https://github.com/vufind-org/vufind/releases/download/v9.1/vufind-9.1.tar.gz +wget https://github.com/vufind-org/vufind/releases/download/v9.1.1/vufind-9.1.1.tar.gz 
-tar -xzvf vufind-9.1.tar.gz +tar -xzvf vufind-9.1.1.tar.gz 
-sudo mv vufind-9.1 /usr/local/vufind+sudo mv vufind-9.1.1 /usr/local/vufind
 </code> </code>
  
installation/ubuntu.1698672132.txt.gz · Last modified: 2023/10/30 13:22 by demiankatz