After the AnQiCMS program upgrade, if the backend interface does not change, how should I handle it?

After you upgrade AnQiCMS, with great expectations, you opened the back-end, only to find that the interface is still the same, without any change?This is indeed a confusing scene. As an expert in website operations for many years, I can confidently tell you that this is a fairly common phenomenon, not a problem with AnQiCMS itself, and it usually only requires a few simple steps to resolve easily.AnQiCMS is known for its efficiency and simplicity, even the 'illusion' after program upgrades is often due to some common operation details.

We know that AnQiCMS is developed in Go language, and its core is a compiled executable file.This means that when you upgrade AnQiCMS, even if new files have been uploaded to the server, the old program process may still be running, causing the backend interface you see to still be the old version.A new interface and features, such as AnQiCMS is onv2.1.0A new backend management interface and features have been introduced in this version, requiring a new program process to load and display.

Then, when you encounter this situation, why not follow these steps one by one to investigate and deal with it:

1. Confirm whether the AnQiCMS program has truly restarted

This is the most common and most critical step. Simply uploading a new file will not automatically stop the old program process and start a new one.You need to explicitly perform a 'stop' and 'start' operation of the program to load new program code on the server.

If you are using Baota panel (or a similar visual management tool), you usually find your AnQiCMS project in the "Go project" or "Other project" management interface, then click the "Stop" button, wait for a moment, and then click the "Start" button.Ensure the operation is successful before attempting to access the backend.

For users accustomed to managing servers via the command line, you need to enter the installation directory of AnQiCMS, then execute the stop script and the start script sequentially. Typically, these scripts are namedstop.shandstart.sh. Execute./stop.shStop the currently running AnQiCMS process and then execute./start.shStart a new version of AnQiCMS. To executestart.shAfter, if the program fails to start successfully, you can check the same directory underrunning.logThe file may contain detailed reasons for the failure to start. Sometimes, an old process may not have been closed completely, which can lead to port occupation, at this time you can uselsof -i:{端口号}for examplelsof -i:8001Command to check which process is using the port, then usekill -9 {PID}command to forcibly terminate the process.

2. Clear browser cache

Even if the program has been successfully updated and restarted, your browser may stubbornly display the cached content of the old version.The browser stores the static resources of the website (such as CSS, JavaScript files, and images) to improve access speed.If these old version resources are still in the cache, the backend interface will naturally not change.

The solution is very simple: try to perform a forced refresh when accessing the AnQiCMS backend interface. Most browsers on the Windows system can do this by pressingCtrl + F5Press theCmd + Shift + RTo implement. If the forced refresh is ineffective, you may need to go to the browser settings, manually clear all cache data related to the website, or try using the browser's 'Private Mode' (Incognito Mode) or try a browser that has never visited the website for testing.

3. Check reverse proxy or CDN cache

If you use Nginx or Apache and other reverse proxy services on the server front-end, or if the website is connected to a CDN service, then these service layers may also exist in cache.These cache layers will cache the website content, even if your AnQiCMS program has been updated, users (including yourself) will still access the old version of the cached content when accessing through a proxy or CDN.

If this is the case, you need to log in to your Nginx/Apache configuration interface or the management platform of your CDN provider, find and execute the "clear cache" or "refresh cache" operation.In some cases, restarting the Nginx or Apache service may also help clear its internal cache.For example, you can use for Nginx,sudo systemctl restart nginxcommand to restart the service.

4. Verify the integrity of the update files.

Although it is not common, it occasionally happens that the upgrade file is uploaded incomplete or damaged.If the new version of the file does not fully replace the old file or some critical files are missing, the program will not be able to load new features and interfaces correctly during execution.

You can download the latest installation package of AnQiCMS again, then upload all files and overwrite them to the AnQiCMS installation directory using FTP, SFTP, or a file management tool.Before overwriting, be sure to make a data backup to prevent any unexpected issues. After uploading, please also perform the steps of restarting the program and clearing the browser cache.

5. Check AnQiCMS log

If all the above steps do not solve the problem, then deeply checking the AnQiCMS log file is the final means of troubleshooting. AnQiCMS will generaterunning.logandcheck.logWait for the log file, which records the detailed information of the program during operation, including startup errors, runtime exceptions, and so on.

Read these log files carefully, you may find specific error information, such as database connection failure, file permission issues, configuration parsing errors, etc.Based on the error tips in the log, you can solve the problem more specifically.

Daily maintenance tips:Before upgrading any AnQiCMS program, it is essential to develop the habit of backing up.Back up your database and website files to prevent unforeseen problems during the upgrade process.At the same time, carefully read the update log released by AnQiCMS official(changelog.mdAnd upgrade guide, learn about the main changes and upgrade注意事项, can effectively avoid many unnecessary troubles.

AnQiCMS as an efficient, secure, and easy-to-use content management system, its upgrade process is usually smooth and painless under the premise of following the correct operation.By following the above troubleshooting steps, you are sure to bring the latest features of AnQiCMS to life in your website backend!

Frequently Asked Questions (FAQ)

1. Why does AnQiCMS require manual restart every time it is upgraded? Answer:AnQiCMS is developed using Go language, the characteristic of Go language is to compile the entire program into a standalone executable binary file.This means that when you upgrade, even if you upload a new executable file, the old version of the program process is still running on the server.Only by manually stopping the old process and starting a new one, the server will load and run the updated program code, thereby enabling new features and interfaces.

2. I am using Baota panel, how should I operate to ensure that AnQiCMS upgrade takes effect? Answer:In the Baota panel, after upgrading AnQiCMS, you need to go to the "Website" menu under "Go project" (or "Other project") to find your AnQiCMS project.First, click the "Stop" button to close the running old version program, then wait a few seconds to confirm that it has stopped.After that, click the 'Start' button to launch the new version of the program.Please make sure to clear your browser cache after restarting the programCtrl + F5Force refresh or clear browser data to ensure that the latest background interface and resources are loaded.

3. What if the program fails to start or the background port is occupied after AnQiCMS upgrade? Answer:If the program fails to start, first check the AnQiCMS installation directory.running.logA file often records detailed error information. If the log indicates that the port is occupied, it is usually because the old program process did not close completely.You can log in to the server using SSH, and uselsof -i:{端口号}for examplelsof -i:8001) Use the command to find the process ID (PID) of the process occupying the default port of AnQiCMS, then usekill -9 {PID}Command to force terminate the process. After termination, try to manually start AnQiCMS.