v2.1.0Version introduces a "brand new backend management interface and features", which requires a new program process to load and display.
Then, when you encounter this situation, it is advisable to investigate and deal with it step by step according to the following steps:
1. Confirm whether the AnQiCMS program has been truly restarted
If you are using Baota panel (or a similar visual management tool), you usually find your AnQiCMS project in the "Go project" or "Other projectsEnsure that the operation is successful before trying to access the backend.
For users accustomed to managing services via the command line, you need to enter the installation directory of AnQiCMS, and then execute the stop script and start script in turn. Usually, these scripts are namedstop.shandstart.sh。Execute./stop.shTo stop the currently running AnQiCMS process, then execute./start.shTo start the new version of AnQiCMS. In executionstart.shIf you encounter a situation where the program fails to start, you can check the same directory.running.log文件，which may contain detailed reasons for the failure to start. Sometimes, old processes may not have been completely closed, which may cause the port to be occupied, at this time you can uselsof -i:{端口号}[for example]lsof -i:8001Command to view which process is using the port, then usekill -9 {PID}command to force 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 (such as CSS, JavaScript files, and images) of websites to improve access speed.If these old versions of the resources are still in the cache, the background interface will naturally not change.
The solution is very simple: try to perform a forced refresh when accessing the AnQiCMS backend interface. In most browsers, on Windows systems, you can pressCtrl + F5English system can be restarted by pressingCmd + Shift + R
3. Check the reverse proxy or CDN cache
If you have used Nginx or Apache and other reverse proxy services on the server front-end, or the website has connected to a CDN service, then these service layers may also exist in the cache.These cache layers will cache the website content, even if your AnQiCMS program has been updated, users (including yourself) will still retrieve the old version of 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 CDN service provider's management platform, 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.sudo systemctl restart nginxcommand.
4. Verify the integrity of the upgrade file.
Although it is not common, but occasionally it may occur that the file upload is incomplete or corrupted.If the new version of the file does not fully cover the old file, or some critical files are missing, the program will not be able to load new features and interfaces correctly when running.
You can download the latest installation package of AnQiCMS again, and then upload all files and overwrite them to the AnQiCMS installation directory via FTP, SFTP, or file management tool.Be sure to back up the data before covering it, just in case.After upload, please perform the steps of restarting the program and clearing the browser cache again.
5. Review AnQiCMS operation log
If all the above steps fail to solve the problem, then deeply checking the AnQiCMS log files is the ultimate means of troubleshooting. AnQiCMS will generaterunning.logandcheck.logThis log file records detailed information about the program's operation, including startup errors and runtime exceptions.
Read these log files carefully, you may find specific error information, such as database connection failure, file permission issues, configuration parsing errors, and so on.Based on the error prompts in the log, you can solve the problem more specifically.
Daily maintenance tips:Before performing any AnQiCMS program upgrade, please make sure to develop the good habit of backup.Backup your database and website files to prevent unforeseen issues during the upgrade process.changelog.md）and upgrade guide, learn about the main changes and upgrade注意事项, to 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 correct operation.By following the above troubleshooting steps, you are sure to make the latest features of AnQiCMS shine in your website backend!
Common Questions (FAQ)
1. Why does AnQiCMS need to be manually restarted every time it is upgraded? Answer:AnQiCMS is developed using Go language, the characteristic of Go language is to compile the entire program into an independent 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, making new features and interfaces effective.
2. I use 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.Firstly, click the 'Stop' button to close the running old version program, and 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.Ctrl + F5Force refresh or clear browser data to ensure the latest background interface and resources are loaded.
3. What should I do 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 underrunning.logFile, usually records detailed error information.If the log indicates that the port is occupied, this is usually because the old program process did not close completely.lsof -i:{端口号}[for example]lsof -i:8001) command to find the process ID (PID) of the process occupying the default port of AnQiCMS, then usekill -9 {PID}Command forces the termination of the process. After termination, try to manually start AnQiCMS.