forked from RKeaves/upating_unit3d_version
Add upating_unit3d_version.md
This commit is contained in:
commit
e4b485605d
|
|
@ -0,0 +1,211 @@
|
|||
# UNIT3D Update
|
||||
|
||||
_Whether you're upgrading from UNIT3D v8.3.3 to v9.0.1 or updating your PHP environment from 8.3 to 8.4, this tutorial offers a detailed guide to the entire process._
|
||||
|
||||
> [!IMPORTANT]
|
||||
> backup.
|
||||
|
||||
## 1. Create a Backup
|
||||
|
||||
UNIT3D provides built-in backup tools through PHP Artisan.
|
||||
|
||||
## 2. Table of Contents
|
||||
|
||||
- [Prerequisites](#3-prerequisites)
|
||||
- [Update Procedures](#4-update-procedures)
|
||||
- [4.1 Enter Maintenance Mode & Prepare Meilisearch](#41-enter-maintenance-mode--prepare-meilisearch)
|
||||
- [4.2 Update PHP to 8.4](#42-update-php-to-84)
|
||||
- [4.3 Update UNIT3D](#43-update-unit3d)
|
||||
- [4.4 Database Migration Fix](#44-database-migration-fix)
|
||||
- [Post-Update Procedures](#5-post-update-procedures)
|
||||
- [Troubleshooting](#6-troubleshooting)
|
||||
|
||||
---
|
||||
|
||||
## 3. Prerequisites
|
||||
|
||||
- Complete backup in `~/tempBackup`
|
||||
- Sudo privileges
|
||||
- Current versions:
|
||||
- UNIT3D: **v8.3.3**
|
||||
- PHP: **8.3**
|
||||
- Required tools:
|
||||
```text
|
||||
curl, apt, nginx, mysql/mariadb, nano/micro
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. Update Procedures
|
||||
|
||||
### 4.1 Enter Maintenance Mode & Prepare Meilisearch
|
||||
|
||||
```bash
|
||||
cd /var/www/html
|
||||
php artisan down
|
||||
```
|
||||
|
||||
**Meilisearch Update:**
|
||||
```bash
|
||||
sudo apt update
|
||||
sudo apt upgrade
|
||||
sudo systemctl stop meilisearch
|
||||
sudo curl -L https://install.meilisearch.com | sudo sh
|
||||
sudo mv ./meilisearch /usr/local/bin/
|
||||
sudo chmod +x /usr/local/bin/meilisearch
|
||||
sudo rm -rf /var/lib/meilisearch/data
|
||||
```
|
||||
Proceed with the following command:
|
||||
|
||||
> **Note:**
|
||||
> This step had to be repeated.
|
||||
|
||||
```bash
|
||||
sudo chmod +x /usr/local/bin/meilisearch
|
||||
sudo systemctl start meilisearch
|
||||
```
|
||||
|
||||
### 4.2 Update PHP to 8.4
|
||||
|
||||
Add PHP Repository & Update Package Lists:
|
||||
|
||||
```bash
|
||||
sudo add-apt-repository ppa:ondrej/php
|
||||
sudo apt update
|
||||
```
|
||||
|
||||
Backup Current PHP Packages & Install PHP 8.4:
|
||||
|
||||
```bash
|
||||
sudo dpkg -l | grep php | tee ~/tempBackup/packages.txt
|
||||
sudo apt install php8.4-common php8.4-cli php8.4-fpm php8.4-{redis,bcmath,curl,dev,gd,igbinary,intl,mbstring,mysql,opcache,readline,xml,zip}
|
||||
```
|
||||
|
||||
**NGINX Configuration Update:**
|
||||
1. Edit Nginx configuration file::
|
||||
|
||||
```bash
|
||||
sudo nano /etc/nginx/sites-available/default
|
||||
```
|
||||
|
||||
2. Update the `fastcgi_pass` directive to use the PHP 8.4 socket
|
||||
|
||||
> **Note:**
|
||||
> Locate the line
|
||||
> ```nginx
|
||||
> fastcgi_pass unix:/var/run/php/***.sock;
|
||||
> ```
|
||||
> and replace `***` with your site’s identifier.
|
||||
|
||||
For example, to point to the PHP 8.4 FPM socket:
|
||||
|
||||
```nginx
|
||||
fastcgi_pass unix:/var/run/php/php8.4-fpm.sock;
|
||||
```
|
||||
Save and exit the editor.
|
||||
|
||||
3. Test the Nginx configuration:
|
||||
```bash
|
||||
sudo nginx -t
|
||||
```
|
||||
|
||||
4. Restart Nginx and PHP-FPM, and Remove PHP 8.3:
|
||||
|
||||
```bash
|
||||
sudo nginx -t
|
||||
sudo systemctl restart nginx
|
||||
sudo systemctl restart php8.4-fpm
|
||||
sudo systemctl stop php8.3-fpm
|
||||
sudo apt purge '^php8.3.*'
|
||||
php -v
|
||||
```
|
||||
|
||||
### 4.3 Update UNIT3D
|
||||
|
||||
```bash
|
||||
cd /var/www/html
|
||||
php artisan git:update
|
||||
```
|
||||
|
||||
> [!NOTE]
|
||||
> During file conflicts:
|
||||
> - Backup conflicts to `~/tempBackup/fileConflicts.txt`
|
||||
> - Generally recommend accepting all updates
|
||||
> - After the update, it's a good idea to save any file conflicts for review
|
||||
|
||||
### 4.4 Database Migration Fix
|
||||
|
||||
During the update, you might encounter an error related to the tickets table
|
||||
|
||||
**Resolve NULL values in tickets table:**
|
||||
|
||||
1. Log in to MySQL:
|
||||
|
||||
```bash
|
||||
mysql -u your_username -p
|
||||
```
|
||||
|
||||
When prompted, enter your MySQL password. Once logged in, select the appropriate database by running:
|
||||
|
||||
```bash
|
||||
USE your_database_name;
|
||||
```
|
||||
|
||||
1. Fix the Null Values:
|
||||
|
||||
Run the following SQL command to update any null entries in the `staff_read` column to 0:
|
||||
|
||||
```sql
|
||||
UPDATE tickets SET staff_read = 0 WHERE staff_read IS NULL;
|
||||
```
|
||||
|
||||
9. Exit MySQL:
|
||||
|
||||
```sql
|
||||
exit;
|
||||
```
|
||||
|
||||
2. Complete migrations:
|
||||
```bash
|
||||
php artisan migrate
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. Post-Update Procedures
|
||||
|
||||
**Final System Reset:**
|
||||
```bash
|
||||
sudo -u www-data composer install --prefer-dist --no-dev -o
|
||||
sudo php artisan set:all_cache
|
||||
bun install && bun run build
|
||||
sudo systemctl restart php8.4-fpm
|
||||
sudo supervisorctl reload
|
||||
```
|
||||
|
||||
**Meilisearch Reindexing:**
|
||||
```bash
|
||||
sudo php artisan scout:sync-index-settings
|
||||
sudo php artisan auto:sync_torrents_to_meilisearch --wipe
|
||||
sudo php artisan auto:sync_people_to_meilisearch
|
||||
```
|
||||
|
||||
**Bring System Online:**
|
||||
```bash
|
||||
php artisan up
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. Troubleshooting
|
||||
|
||||
**Common Issues:**
|
||||
- **Migration Errors:** Ensure database user has ALTER privileges
|
||||
- **PHP Version Mismatch:** Verify `php -v` and NGINX config
|
||||
- **Meilisearch Failures:** Check `/var/log/meilisearch.log`
|
||||
|
||||
**Log Locations:**
|
||||
```text
|
||||
/var/www/html/storage/logs/laravel.log
|
||||
/var/log/nginx/error.log
|
||||
```
|
||||
Loading…
Reference in New Issue