Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		 Previous revision
install_rasberry [2024/02/07 21:06] – created systeminstall_rasberry [2024/02/08 19:07] (current) – [Disable strict mode] system
Line 2: Line 2:
 ===== Prep ===== ===== Prep =====
  
-  * These instructions are for Raspberry Pi OS based on Debian version 12 (bookworm). +  * This guide  is for Raspberry Pi OS based on Debian version 12 (Bookworm). 
-  * You can issue the command **cat /etc/issue.net** to confirm the version. It should say **Debian GNU/Linux 12 +  * You can run the command **cat /etc/issue.net** to confirm the version. **Debian GNU/Linux 12** should be displayed.
-**.+
   * Make sure it is up to date.   * Make sure it is up to date.
 <code bash> <code bash>
Line 16: Line 15:
 sudo apt-get -y install nginx sudo apt-get -y install nginx
 </code> </code>
-  * Ensure the web server starts up and is running+  * Make sure that the web server is started and running
 <code bash> <code bash>
 sudo systemctl stop nginx.service sudo systemctl stop nginx.service
 sudo systemctl start nginx.service sudo systemctl start nginx.service
 </code> </code>
-  * Navigate to the IP Address of the server where you installed **Nginx** using a browser to ensure Nginx serves content e.g. http://127.0.0.1+  * Using a browser, navigate to the IP address of the server on which you have installed Nginx to ensure that Nginx is serving content, e.g. http://127.0.0.1
  
 ===== Configure Nginx to interpret .php files ===== ===== Configure Nginx to interpret .php files =====
-  * The default install of **Nginx** does not support the serving of **.php** files.+  * The default installation of Nginx does not support serving .php files.
   * We will install a program (actually a service) called **php-fpm**.   * We will install a program (actually a service) called **php-fpm**.
   * This service will listen for requests to interpret.   * This service will listen for requests to interpret.
Line 34: Line 33:
 </code> </code>
 ===== Modify Nginx ===== ===== Modify Nginx =====
-  * Now that the php-fpm service is installed we should change the default **Nginx** server to make use of it.+  * Now that the php-fpm service is installed, let us change the default nginx server to use it.
   * Edit the default server file:   * Edit the default server file:
 <code bash> <code bash>
Line 44: Line 43:
 index index.php index.html index.htm index.nginx-debian.html; index index.php index.html index.htm index.nginx-debian.html;
 </code> </code>
-  * Activate PHP processing by un-commenting this this section. Note that we use the UNIX socket and we are using **8.2** and not **7.4** which is specified originally in the config file.+  * Enable PHP processing by leaving this section uncommented. Note that we are using the UNIX socket and that we are using 8.2 and not 7.4 as originally specified in the configuration file.
 <code bash> <code bash>
 # pass PHP scripts to FastCGI server # pass PHP scripts to FastCGI server
Line 57: Line 56:
 } }
 </code> </code>
-  * Enable the hiding of .htaccess files+  * Activate the hiding of .htaccess files
 <code bash> <code bash>
 # deny access to .htaccess files, if Apache's document root # deny access to .htaccess files, if Apache's document root
Line 66: Line 65:
 } }
 </code> </code>
-  * Reload the **Nginx** web server's configuration+  * Reload the configuration of the Nginx web server 
 <code bash> <code bash>
 sudo systemctl reload nginx.service sudo systemctl reload nginx.service
Line 80: Line 79:
 ?> ?>
 </code> </code>
-  * Navigate to http://127.0.0.1/test.php and see if the page display the PHP info.+  * Navigate to http://127.0.0.1/test.php and check that the page displays the PHP information.
  
 ===== Install MariaDB ===== ===== Install MariaDB =====
 ==== Why MariaDB? ==== ==== Why MariaDB? ====
-  * We discovered that the version of MySQL that comes bundled by default with Debian 12 (bookworm) are breaking things on RADIUSdesk. +  * We have  found that the version of MySQL that comes with Debian 12 (bookworm) by default causes problems with RADIUSdesk. 
-  * For this reason we install MariaDB as an alternative. +  * For this reason, we have installed MariaDB as an alternative. 
-  * MariaDB is an open-source relational database management system, commonly used as an alternative for MySQL as the database portion of the popular LAMP (Linux, Apache, MySQL, PHP/Python/Perl) stack. +  * MariaDB is an open-source relational database management system that is often used as an alternative to MySQL as the database part of the popular LAMP (Linux, Apache, MySQL, PHP/Python/Perl) stack. 
-  * It is intended to be a drop-in replacement for MySQL. +  * It is intended as an immediate replacement for MySQL. 
-  * Be sure to supply a root password for the MariaDB database when asked for it if you are security conscious else simply hit the ESC key.+  * Be sure to provide a root password for the MariaDB database when prompted if you are security conscious, otherwise just hit the ESC key.
 <code bash> <code bash>
 sudo apt-get -y install mariadb-server php8.2-mysql sudo apt-get -y install mariadb-server php8.2-mysql
Line 96: Line 95:
 </code> </code>
 ==== Disable strict mode ==== ==== Disable strict mode ====
-  * With Debian 12 (bookworm), the bundled release of MariaDB is at version 15.1 which introduced a few Strict modes which have some problems with RADIUSdesk database implementation. +  * With Debian 12 (Bookworm), the bundled version of MariaDB is on version 15.1, which has introduced some strict modes that have some issues with the RADIUSdesk database implementation. 
-  * We will disable Strict SQL Mode in MariaDB by creating a new file /etc/mysql/conf.d/disable_strict_mode.cnf+  * We will disable the Strict SQL mode in MariaDB by creating a new file /etc/mysql/conf.d/disable_strict_mode.cnf
 <code bash> <code bash>
 sudo vi /etc/mysql/conf.d/disable_strict_mode.cnf sudo vi /etc/mysql/conf.d/disable_strict_mode.cnf
Line 106: Line 105:
 sql_mode=IGNORE_SPACE,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION sql_mode=IGNORE_SPACE,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION
 </code> </code>
-  * Save the file and restart the MySQL Server+  * Save the file and restart the MySQL server
 <code bash> <code bash>
 sudo systemctl restart mariadb sudo systemctl restart mariadb
  • install_rasberry.1707332786.txt.gz
  • Last modified: 2024/02/07 21:06
  • by system