How to 'Save and Exit' and make the changes take effect after testing AnQiCMS under MacOS environment?

As an experienced website operator, I am well aware of the importance of modifying the configuration file and ensuring its correct effectiveness when testing and managing AnQiCMS in the MacOS environment.AnQiCMS with its efficient and flexible features has become an important tool for our content management.In daily maintenance and functional testing, accurately applying configuration changes is the foundation for ensuring the stable operation of the system and that new features work as expected.

Configuration file location and modification

The core configuration information of AnQi CMS is stored in the root directory of the projectconfig.jsonIn the file.This JSON formatted file includes critical settings such as system running ports, database connection parameters, and so on.config.jsonfile.

To modifyconfig.jsonMake changes, you can use any text editor in the MacOS system.Whether it is the built-in 'text editor' application of the system, or professional code editors such as VS Code, Sublime Text, etc., they can all be used to open and edit this file.During editing, please carefully check the configuration items you need to modify."port": 8001The key-value pair, you just need to change8001To the target port number.

Save configuration changes

Complete onconfig.jsonIt is crucial to save these changes after modifying the file.In your text editor, you usually save by selecting 'File' -> 'Save', or by using the MacOS universal shortcut Command + S (⌘S).Make sure the file has been saved successfully, as only then can AnQiCMS read the latest configuration when it starts up next time.Any unsaved changes will not take effect during system operation.

Make changes effective: Stop and restart AnQiCMS service

AnQiCMS is an application developed based on the Go programming language, which runs as an independent process on your MacOS system.This means that simply saving the configuration file does not make the new settings take effect immediately.config.jsonThe modification requires that you first terminate the running AnQiCMS process, then restart it so that the new process loads and uses the updated configuration file.

In the MacOS environment, the steps to stop and restart the service vary slightly depending on how you start AnQiCMS.

If you are usingDouble-click the AnQiCMS executable file.To start the service: To stop the service, you need to use the MacOS "Activity Monitor" tool.You can quickly open it by searching with Spotlight (Command + Space) for "Activity Monitor" or find it in the "Utilities" folder within the "Applications" directory.In the activity monitor window, use the search box to find the "anqicms" process.Once found, select the process, then click the "X" button at the top of the toolbar, select "Force Exit" to terminate it.config.jsonthe configuration.

If you are usingCommand lineStart AnQiCMS (for example, run directly)./anqicmsOr throughstart.shScript): First, you need to identify the process ID (PID) of the running AnQiCMS process.lsof -i:端口号Please replace 'Port number' with the port number that AnQiCMS is currently listening on. For example, if AnQiCMS was running on port 8001 before, you would enterlsof -i:8001. The command output will list the processes using the port, including the "anqicms" process and its PID. After obtaining the process ID, usekillCommand to force terminate the process:kill -9 进程IDPlease replace the "Process ID" with the one you are inlsofThe actual PID obtained from the command output. After the process terminates, you can run the AnQiCMS executable file again in the terminal (for example./anqicms), or run the corresponding startup script (such as./start.sh), restart AnQiCMS service with new configuration

Verify configuration changes

After completing the restart of AnQiCMS service, the final step is to verify whether your configuration changes have been successfully applied.

If your modifications involve the port number, please try to access it in the browser.http://127.0.0.1:新端口号.If the page can display AnQiCMS website content or the initialization installation interface normally, it means that the port modification has been successful.If inaccessible, please check if the port number you entered is correct and whether any other applications are using the new port.

For other types of configuration changes, such as database connections or other system settings, you may need to log in to the AnQiCMS backend management interface to check or observe the related display and functionality on the website front end to confirm that the changes are applied as expected.By following these verification steps, you can ensure that all configuration adjustments have been applied accurately.

Frequently Asked Questions (FAQ)

Q1: I have savedconfig.jsonthe file and restarted AnQiCMS, but the modifications still have not taken effect. How should I troubleshoot the problem?A1: First, please confirm that you have saved in the text editorconfig.jsonDid it really save successfully.Some editors may require additional confirmation.Secondly, ensure that you completely terminate the old AnQiCMS process and do not let it continue running in the background.lsof -i:端口号command to check if there are any old processes running, and usekill -9 PIDcommand to terminate forcibly. Finally, carefully check that you are inconfig.jsonWhether the modified configuration item contains JSON syntax errors, even missing commas or quotation marks can cause AnQiCMS to fail to parse the configuration file correctly.

Q2: On MacOS, I directly double-click the AnQiCMS executable file to run, but the document mentionsstart.shorstop.shWhere is the script? Do I need to use them?A2: When you double-click the AnQiCMS executable file directly on MacOS, it starts as a regular application process. In this case,start.shandstop.shScripts are typically designed for Linux server environments or scenarios that require more advanced process management, and you do not need to, nor can you use them directly.On MacOS, you should manage (find and force quit) the AnQiCMS process through the "Activity Monitor

Q3: Do I need to modify the Nginx or Apache configuration file if I change the running port of AnQiCMS?A3: Yes, if your AnQiCMS is deployed behind a web server like Nginx or Apache and serves externally through a reverse proxy, then when modifying the AnQiCMS'sconfig.jsonAfter the running port of the running port, you must synchronize the update of the Nginx or Apache configuration file. You need to find the proxy configuration that points to the AnQiCMS internal port.proxy_passCommand (for exampleproxy_pass https://en.anqicms.com;), update the port number to the new AnQiCMS port, and then restart the Nginx or Apache service to ensure that your website can continue to access AnQiCMS normally.