RKeaves
/
upating_unit3d_version
1
0
Fork 1
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update upating_unit3d_version.md

This commit is contained in:
RKeaves 2025-04-29 02:21:59 -05:00
parent 52877ac377
commit e8f4cefe5a
1 changed files with 10 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
upating_unit3d_version.md
View File

@ -1,6 +1,6 @@
# Updating UNIT3D
This guide walks you through updating UNIT3D from `v8.3.3` to `v9.0.1` and upgrading PHP from `8.3` to `8.4`.
This guide walks you through updating UNIT3D.
## 1. Create Backup
@ -51,11 +51,11 @@ cd /var/www/html
php artisan git:update
```
During the update, UNIT3D shows file differences and prompts you to keep or update each file. It is recommended to update all files. Before starting, copy the latest backup to `~/tempBackup`. After the update, file conflicts are saved to `~/tempBackup/fileConflicts.txt` for review and merging if needed.
During the update, UNIT3D prompts for action on file differences. Copy the latest backup to `~/tempBackup` before starting. After the update, review `~/tempBackup/fileConflicts.txt` for conflicts.
## 6. Database Migration Fix
During the update, you might encounter an error related to the tickets table:
During the update, an error related to the `tickets` table may occur:
```sql
2025_02_17_074140_update_columns_to_boolean ......................................................................................... 38.50ms FAIL
@ -67,7 +67,7 @@ In Connection.php line 571:
SQLSTATE[22004]: Null value not allowed: 1138 Invalid use of NULL value
```
**Resolve NULL values in tickets table:**
**Resolve** `Null` values in `tickets` table:
1. Log in to MySQL:
@ -75,7 +75,7 @@ In Connection.php line 571:
mysql -u your_username -p
```
When prompted, enter your MySQL password. Once logged in, select the appropriate database by running:
**Enter** the MySQL password when prompted. After logging in, select the appropriate database by running:
```bash
USE your_database_name;
@ -83,7 +83,7 @@ USE your_database_name;
2. Fix the Null Values:
**Run** the following SQL command to update any null entries in the `staff_read` column to 0:
**Update** `NULL` entries in the `staff_read` column to `0` by running the following SQL command:
```sql
UPDATE tickets SET staff_read = 0 WHERE staff_read IS NULL;
@ -96,6 +96,7 @@ exit;
```
4. Complete migrations:
```bash
php artisan migrate
```
@ -104,7 +105,7 @@ php artisan migrate
## 7. Final Reset & Cleanup
**After updating and migrating, run the following commands to clear caches, reinstall dependencies, rebuild assets, and restart services:**
- Clear caches, reinstall dependencies, rebuild assets, and restart services after updating and migrating.
```bash
sudo -u www-data composer install --prefer-dist --no-dev -o && \
@ -126,7 +127,8 @@ sudo php artisan auto:sync_torrents_to_meilisearch --wipe && \
sudo php artisan auto:sync_people_to_meilisearch
```
**Bring the site back online:**
- Resume normal site functionality:
```bash
sudo php artisan scout:sync-index-settings && \
sudo php artisan auto:sync_torrents_to_meilisearch --wipe && \