Update upating_unit3d_version.md
This commit is contained in:
parent
4913faf5e1
commit
cfe78b0e78
|
@ -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 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:**
|
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
|
||||||
|
|
Loading…
Reference in New Issue