Aq CMS, as a content management system favored by small and medium-sized enterprises and content operation teams, has been evolving to provide more efficient and flexible services.From version 2.x to 3.x, the upgrade is not just a change in version numbers, but also brings optimization of the underlying architecture and a leap in multi-site management mode.For users who have deployed multiple sites in the 2.x period and wish to achieve unified and efficient merging deployment in 3.x, this is undoubtedly an important milestone.

AnQiCMS single application instanceEfficient management of multiple independent sites. This not only greatly reduces server resource consumption, but also simplifies daily operation and maintenance work.

Next, we will detail the specific operation process of upgrading from AnQiCMS 2.x to 3.x and implementing multi-site consolidation deployment.The entire process requires careful attention, but as long as you follow the steps, you will be able to transition smoothly.

One, key preparation before upgrade.

Data security is of utmost importance for any system upgrade. Before starting, please make sure to perform the following preparations:

  1. Full data backup:This is an indispensable first step. Please backup all your 2.x site data completely, including databases (such as MySQL) and file directories (/www/wwwroot/anqicms.comThis, as well as the root directory of your other sites).Store these backup files in a safe, independent location.This ensures that you can always recover to the state before the upgrade in any unexpected situation.
  2. Confirm the main upgrade site:In all your 2.x sites, pick one as the "default site" for the first upgrade.This site will play the role of the 3.x core application in the subsequent steps.Generally, a site with moderate traffic and not highly sensitive data is preferred for processing.
  3. Record the current configuration:Please carefully record the database information, website root directory, bound domain, and Nginx/Apache reverse proxy configuration for each 2.x site.This information is very useful when merging and deploying a new site.
  4. Confirm the server environment:AnQiCMS 3.x has more friendly 'Go project' deployment support for Baota panel, and it is recommended to use Baota panel version 7.9.3 or above.Ensure your server environment meets the requirements for running version 3.x.

Second, upgrade the main upgrade site to AnQiCMS 3.x

At this stage, we will upgrade the selected 'default site' from 2.x to 3.x, and convert its deployment mode to the 3.x recommended Go project mode.

  1. Log in and perform a site upgrade:

    • Tip:If after the upgrade, you find that the background version number has not been updated, this may be due to browser cache or an old program process not completely terminated.You can try clearing the browser cache, or check the process later and manually terminate it before restarting.

  2. Disable and remove the old scheduled task:AnQiCMS 2.x usually depends on the server's cron job to monitor the process.While the 3.x version recommends using the 'Go project' method for deployment in environments such as Baota panel, it comes with process supervision and a more elegant start/stop mechanism.Stop all old scheduled tasks related to this AnQiCMS site and then delete them.

  3. Switch the site deployment mode to “Go project”:This step is the core of the 3.x deployment method.

    • On the server management panel (taking Baota as an example), go to the "Website" menu and select "Go project
    • Click "Add Go project", fill in the relevant information in the pop-up configuration window.
      • Project execution file:The actual executable file path of the AnQiCMS application pointing to your main upgrade site (for example:/www/wwwroot/yourdomain.com/anqicms}]
      • Project name:Enter a name that is easy to recognize, such as “AnQiCMS Main Application”.
      • Project port:Fill in the port that AnQiCMS program listens to for main upgrades (default is 8001).
      • Execute the command:It is usually the same as the 'project execution file'.
      • Running user:It is recommended to choosewwwUsers.
      • Boot on startup:Select this option to ensure that the program runs automatically after the server restarts.
      • Bind domain:Enter the domain name of your main upgrade site.
    • Click submit to complete the configuration. At this point, your main upgrade site is successfully running in the 3.x Go project mode, and the original data and configuration have been retained.

Three, merge deploy other AnQiCMS 2.x sites to 3.x environment

Now, your AnQiCMS 3.x core application has been successfully run.Next, we will merge the original multiple AnQiCMS 2.x sites into this unified 3.x multi-site management system.

  1. Disable and remove the scheduled tasks of other sites:For each AnQiCMS 2.x site that has not been upgraded, repeat the above steps of 'disable and remove the old scheduled task'.Ensure that all old AnQiCMS 2.x program instances have been stopped and their corresponding scheduled tasks have been cleared.

  2. Configure Nginx/Apache reverse proxy for new site:

    • Take Baota as an example, create a 'PHP project' (pure static) and configure reverse proxy:
      • In the “Website” menu of the Baota panel, select “PHP Project”, and click “Add Site”.
      • Enter the domain name of the new site (for example:dev.anqicms.com)，Root directory can be temporarily set to default or copied from the old site's root directory. Database selection 'Do not create', PHP version