From cfe78b0e78fbfab594705aca5825ec789a88528e Mon Sep 17 00:00:00 2001 From: RKeaves Date: Sun, 4 May 2025 10:34:36 -0500 Subject: [PATCH] Update upating_unit3d_version.md --- upating_unit3d_version.md | 44 +++++++++++++++++++++------------------ 1 file changed, 24 insertions(+), 20 deletions(-) diff --git a/upating_unit3d_version.md b/upating_unit3d_version.md index 1192f1b..d0f6725 100644 --- a/upating_unit3d_version.md +++ b/upating_unit3d_version.md @@ -6,38 +6,42 @@ Update UNIT3D to the latest version by reviewing the release notes and following UNIT3D offers built-in backups. Refer to the [Backups documentation](docs/backups.md) for usage. -> **Important:** Ensure there is a complete backup before proceeding. +> [!IMPORTANT] +> Ensure there is a complete backup before proceeding. ## 2. Enter Maintenance Mode: -```sh +```bash cd /var/www/html php artisan down ``` ## 3. Update UNIT3D: -> **Tip:** Before running the update, review the new release’s minimum requirements to ensure the environment meets them. +> [!NOTE] +> Before running the update, review the new release’s minimum requirements to ensure the environment meets them. 1. **Proceed to update:** + The updater will fetch the latest commits from the upstream repository and stage them for installation. - ```sh + ```bash cd /var/www/html php artisan git:update ``` There will be a prompt to confirm each step; choose `yes` to overwrite with the new version. - ```sh + ```bash Start the update process (yes/no) [yes]: > yes ``` 2. **Accept upstream files:** - When prompted for each changed file, type `yes` to overwrite the local copy or press Enter to accept the default shown in brackets. - ```sh + When prompted for each changed file, type `yes` to overwrite the local copy or press `Enter` to accept the default shown in brackets. + + ```bash Update config/unit3d.php (yes/no) [yes]: > yes @@ -45,23 +49,23 @@ php artisan down [============================] (Done!) ``` -3. **Run new migrations:** +3. **Run new migrations:** - ```sh + ```bash Run new migrations (php artisan migrate) (yes/no) [yes]: > yes ``` -4. **Install new packages:** +4. **Install new packages:** - ```sh + ```bash Install new packages (composer install) (yes/no) [yes]: > yes ``` -5. **Compile assets:** +5. **Compile assets:** - ```sh + ```bash Compile assets (bun run build) (yes/no) [yes]: > yes ``` @@ -72,19 +76,19 @@ The following commands are **optional** and should be run only as needed to reso - **Finish any migrations not completed:** -```sh +```bash sudo php artisan migrate ``` - **Reinstall dependencies:** -```sh +```bash composer install --prefer-dist --no-dev -o ``` - **Clear caches:** -```sh +```bash sudo php artisan cache:clear && \ sudo php artisan queue:clear && \ sudo php artisan auto:email-blacklist-update && \ @@ -94,13 +98,13 @@ sudo php artisan set:all_cache - **Rebuild static assets:** -```sh +```bash sudo bun install && sudo bun run build ``` - **Restart services:** -```sh +```bash sudo systemctl restart php8.4-fpm && \ sudo php artisan queue:restart && \ sudo php artisan up @@ -108,8 +112,8 @@ sudo php artisan up - **If running external UNIT3D-Announce, restart the supervisor services:** -```sh +```bash sudo supervisorctl reread && \ sudo supervisorctl update && \ sudo supervisorctl reload -``` +``` \ No newline at end of file