Update upating_unit3d_version.md

This commit is contained in:
RKeaves 2025-05-04 10:34:36 -05:00
parent 4913faf5e1
commit cfe78b0e78
1 changed files with 24 additions and 20 deletions

View File

@ -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. 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: ## 2. Enter Maintenance Mode:
```sh ```bash
cd /var/www/html cd /var/www/html
php artisan down php artisan down
``` ```
## 3. Update UNIT3D: ## 3. Update UNIT3D:
> **Tip:** Before running the update, review the new releases minimum requirements to ensure the environment meets them. > [!NOTE]
> Before running the update, review the new releases minimum requirements to ensure the environment meets them.
1. **Proceed to update:** 1. **Proceed to update:**
The updater will fetch the latest commits from the upstream repository and stage them for installation. The updater will fetch the latest commits from the upstream repository and stage them for installation.
```sh ```bash
cd /var/www/html cd /var/www/html
php artisan git:update php artisan git:update
``` ```
There will be a prompt to confirm each step; choose `yes` to overwrite with the new version. 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]: Start the update process (yes/no) [yes]:
> yes > yes
``` ```
2. **Accept upstream files:** 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]: Update config/unit3d.php (yes/no) [yes]:
> yes > yes
@ -47,21 +51,21 @@ php artisan down
3. **Run new migrations:** 3. **Run new migrations:**
```sh ```bash
Run new migrations (php artisan migrate) (yes/no) [yes]: Run new migrations (php artisan migrate) (yes/no) [yes]:
> yes > yes
``` ```
4. **Install new packages:** 4. **Install new packages:**
```sh ```bash
Install new packages (composer install) (yes/no) [yes]: Install new packages (composer install) (yes/no) [yes]:
> yes > yes
``` ```
5. **Compile assets:** 5. **Compile assets:**
```sh ```bash
Compile assets (bun run build) (yes/no) [yes]: Compile assets (bun run build) (yes/no) [yes]:
> 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:** - **Finish any migrations not completed:**
```sh ```bash
sudo php artisan migrate sudo php artisan migrate
``` ```
- **Reinstall dependencies:** - **Reinstall dependencies:**
```sh ```bash
composer install --prefer-dist --no-dev -o composer install --prefer-dist --no-dev -o
``` ```
- **Clear caches:** - **Clear caches:**
```sh ```bash
sudo php artisan cache:clear && \ sudo php artisan cache:clear && \
sudo php artisan queue:clear && \ sudo php artisan queue:clear && \
sudo php artisan auto:email-blacklist-update && \ sudo php artisan auto:email-blacklist-update && \
@ -94,13 +98,13 @@ sudo php artisan set:all_cache
- **Rebuild static assets:** - **Rebuild static assets:**
```sh ```bash
sudo bun install && sudo bun run build sudo bun install && sudo bun run build
``` ```
- **Restart services:** - **Restart services:**
```sh ```bash
sudo systemctl restart php8.4-fpm && \ sudo systemctl restart php8.4-fpm && \
sudo php artisan queue:restart && \ sudo php artisan queue:restart && \
sudo php artisan up sudo php artisan up
@ -108,7 +112,7 @@ sudo php artisan up
- **If running external UNIT3D-Announce, restart the supervisor services:** - **If running external UNIT3D-Announce, restart the supervisor services:**
```sh ```bash
sudo supervisorctl reread && \ sudo supervisorctl reread && \
sudo supervisorctl update && \ sudo supervisorctl update && \
sudo supervisorctl reload sudo supervisorctl reload