diff --git a/upating_unit3d_version.md b/upating_unit3d_version.md index cb7f7f0..7ce2386 100644 --- a/upating_unit3d_version.md +++ b/upating_unit3d_version.md @@ -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 && \