From 95fb61cf134c2d274e14a3c03460afcf02fa02b8 Mon Sep 17 00:00:00 2001 From: recursivetree <60423027+recursivetree@users.noreply.github.com> Date: Sun, 4 Feb 2024 23:36:07 +0100 Subject: [PATCH] state that only mariadb is compatible with seat (#170) --- docs/installation/manual_installation.md | 8 ++++---- docs/installation/requirements.md | 18 +++++++++--------- 2 files changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/installation/manual_installation.md b/docs/installation/manual_installation.md index ed426a7..8245689 100644 --- a/docs/installation/manual_installation.md +++ b/docs/installation/manual_installation.md @@ -46,7 +46,7 @@ Before we get to installing SeAT, lets ensure that your operating system is up t SeAT relies **heavily** on a database to function. Everything it learns is stored here, along with things such as user accounts for your users. It comes without saying that database security is a very important aspect too. So, ensure that you choose very strong passwords for your installation where required. -This document describes using MariaDB, but you can use MySQL as well. Just double check the [requirements](requirements.md). +SeAT officially supports just MariaDB. Using MySQL or PostreSQL might appear to work on the surface, however it is likely that you will run into issues due to differences between the databases later down the line, and almost no testing with them is done during development. We need to ensure that we have the latest MariaDB installed. To help with this, MariaDB provides an official repository to get the latest versions. @@ -133,9 +133,9 @@ Reload privilege tables now? [Y/n] y That concludes the installation of the database server and securing it. -Next, we need to create an actual user and database for SeAT to use on the newly installed server. To do this we use the `mysql` command line client and enter a few commands as the `root` user to create the database and the user that will be accessing the server. Let get to it. +Next, we need to create an actual user and database for SeAT to use on the newly installed server. To do this we use the `mariadb` command line client and enter a few commands as the `root` user to create the database and the user that will be accessing the server. Let get to it. -Fire up the `mysql` client as root by running: +Fire up the `mariadb` client as root by running: ```bash mariadb -uroot -p @@ -381,7 +381,7 @@ sudo -H -u www-data bash -c 'php /var/www/seat/artisan db:seed --class=Seat\\Ser #### EVE Sde Update -SeAT makes use of a number of tables from the EVE [Static Data Exports](https://developers.eveonline.com/resource/resources). MySQL conversions of this data is available at [https://www.fuzzwork.co.uk/dump/](https://www.fuzzwork.co.uk/dump/) and used in SeAT. +SeAT makes use of a number of tables from the EVE [Static Data Exports](https://developers.eveonline.com/resource/resources). MariaDB conversions of this data is available at [https://www.fuzzwork.co.uk/dump/](https://www.fuzzwork.co.uk/dump/) and used in SeAT. To update to the [latest SDE](https://github.com/eveseat/resources/blob/master/tools/generate_sde_json.php#L22) within SeAT, run: diff --git a/docs/installation/requirements.md b/docs/installation/requirements.md index 6115bdc..0759dbe 100644 --- a/docs/installation/requirements.md +++ b/docs/installation/requirements.md @@ -101,15 +101,15 @@ If you already have it installed, check your current version with `docker versio Software version requirements are based on a *minimum* requirement. -| Type | Requirement | State Check | -| -------------------------- |-----------------------------------------------------------------------------------------------------------------------| ----------- | -| Operating System | Linux (any distribution is suitable, however, Ubuntu tends to get more up-to-date packages on official repositories). | Usually, running `cat /etc/issue` should give you a good idea. | -| Architecture | 64-bit only | `uname -p` | -| PHP | [PHP: ^8.3](http://php.net/) including mysql, gd, bz2, intl, pcntl, gmp, openssl, zip, opcache and redis extensions | `php -v` and `php -i` | -| Database | [MariaDB: ^10.2.7](https://mariadb.org/) or [MySQL: ^5.7](https://www.mysql.com/) | `mysql -V` | -| Caching Service | [Redis](https://redis.io/) | `redis-server -v` | -| Service Supervisor | [Supervisor : 3](http://supervisord.org/) | `supervisord -v` | -| Web Server | [NGinX](https://www.nginx.com/) or [Apache](https://httpd.apache.org/) | `nginx -v` or `httpd -v` | +| Type | Requirement | State Check | +|--------------------|-----------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------| +| Operating System | Linux (any distribution is suitable, however, Ubuntu tends to get more up-to-date packages on official repositories). | Usually, running `cat /etc/issue` should give you a good idea. | +| Architecture | 64-bit only | `uname -p` | +| PHP | [PHP: ^8.3](http://php.net/) including mysql, gd, bz2, intl, pcntl, gmp, openssl, zip, opcache and redis extensions | `php -v` and `php -i` | +| Database | [MariaDB: ^10.2.7](https://mariadb.org/) | `mysql -V` | +| Caching Service | [Redis](https://redis.io/) | `redis-server -v` | +| Service Supervisor | [Supervisor : 3](http://supervisord.org/) | `supervisord -v` | +| Web Server | [NGinX](https://www.nginx.com/) or [Apache](https://httpd.apache.org/) | `nginx -v` or `httpd -v` | !!! tip