Upgrade from v3 to v4 Guide

Introduction

The v4 version introduces a task queue mechanism, significantly improving resource efficiency and enhancing high-concurrency capabilities.

1. Preparation Before Upgrade

• Export the database and save it as apple.sql.
• Recommended Deployment Method: Docker Compose

2. Uninstall Old Backend Version

Stop and remove old containers using the following commands:

docker stop appleautopro
docker rm appleautopro
docker ps -a | grep 'apple-auto' | awk '{print $1}' | xargs docker rm -f

3. Deploy the New Version

Using Docker Compose

1. Install and configure Docker Compose
   Refer to the Docker Compose Deployment Guide for installation steps.

2. Restore Database

   • Place apple.sql in the project root directory.
   • Import the database using:

   docker compose cp apple.sql mariadb:/tmp
   docker compose exec -it mariadb mariadb -uroot -p<database_root_password>

3. Rebuild Database in MariaDB Container:

DROP DATABASE appleautopro;
CREATE DATABASE appleautopro;
USE appleautopro;
SOURCE /tmp/apple.sql;

Exit the container by typing exit twice.

4. Restart the Service:

docker compose down && docker compose up -d

5. Verify Data and Functionality:
   Log in using the original account and check if the data is correct. Once confirmed, old database files and web files can be deleted.

---

Manual Deployment

1. Frontend Installation
   Follow Frontend Installation Guide steps 1 to 6.
   Note: Set PHP version to 8.x.
2. System Configuration Check
   Log into the admin panel and verify system settings.
3. Backend Installation
   Follow Backend Installation Guide to complete the backend setup.

---

🎉 Upgrade Complete

You have successfully upgraded from v3 to v4!