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 # 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 ## 1. Create Backup
@ -51,11 +51,11 @@ cd /var/www/html
php artisan git:update 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 ## 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 ```sql
2025_02_17_074140_update_columns_to_boolean ......................................................................................... 38.50ms FAIL 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 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: 1. Log in to MySQL:
@ -75,7 +75,7 @@ In Connection.php line 571:
mysql -u your_username -p 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 ```bash
USE your_database_name; USE your_database_name;
@ -83,7 +83,7 @@ USE your_database_name;
2. Fix the Null Values: 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 ```sql
UPDATE tickets SET staff_read = 0 WHERE staff_read IS NULL; UPDATE tickets SET staff_read = 0 WHERE staff_read IS NULL;
@ -96,6 +96,7 @@ exit;
``` ```
4. Complete migrations: 4. Complete migrations:
```bash ```bash
php artisan migrate php artisan migrate
``` ```
@ -104,7 +105,7 @@ php artisan migrate
## 7. Final Reset & Cleanup ## 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 ```bash
sudo -u www-data composer install --prefer-dist --no-dev -o && \ 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 sudo php artisan auto:sync_people_to_meilisearch
``` ```
**Bring the site back online:** - Resume normal site functionality:
```bash ```bash
sudo php artisan scout:sync-index-settings && \ sudo php artisan scout:sync-index-settings && \
sudo php artisan auto:sync_torrents_to_meilisearch --wipe && \ sudo php artisan auto:sync_torrents_to_meilisearch --wipe && \