github-actions[bot] commented on issue #16931: URL: https://github.com/apache/dolphinscheduler/issues/16931#issuecomment-2564588043
### Search before asking - [X] I had searched in the [issues](https://github.com/apache/dolphinscheduler/issues?q=is%3Aissue) and found no similar feature requirement. ### Description For newcomers who want to try it out, the installation documentation is very unfriendly, especially for those who are not familiar with the Ubuntu environment. It is full of pitfalls. I installed it according to the instructions https://dolphinscheduler.apache.org/zh-cn/docs/3.1.5/guide/installation/pseudo-cluster. I found that I encountered problems almost every 1-2 steps. I asked step by step. I have been struggling with chatgpt 4o. It has been 2 days and only two-thirds of the way. I admit that I am a novice on Ubuntu. I temporarily learned some Ubuntu commands in order to install the pilot project. However, for the majority of users who want to promote the development of the community, the importance of documentation far exceeds the project itself. I hope that everyone can work together to make this open source The project truly benefits the public, so that the public can be more motivated to give feedback and improve. Now I will briefly describe several document problems I fo und as follows: 1. The section "Preparing the DolphinScheduler startup environment" should be placed at the top of the document. Reason: If you directly follow the "preparatory work", all tools that require pre-installation will be installed in the account you are currently logged in, but in fact they should be installed in a new account. For example, as described in subsequent documents: Create the dolphinscheduler user. 2. # To create a user, you need to log in as root: useradd dolphinscheduler. This command should be preceded by sudo, or tell the user how to first enter the root account. 3. # Modify the directory permissions so that the deployment user has operating permissions on the apache-dolphinscheduler-*-bin directory after the binary package is decompressed. chown -R dolphinscheduler:dolphinscheduler apache-dolphinscheduler-*-bin. The description here is very unclear. It should be explained that apache-dolphinscheduler-*-bin is replaced with the file name after decompression of the binary installation package. 4. Enter the installation directory of zookeeper, copy the zoo_sample.cfg configuration file to conf/zoo.cfg, and change the value of dataDir in conf/zoo.cfg to dataDir=./tmp/zookeeper. The zoo_sample.cfg configuration file has changed in the new version. 5. Modify the install_env.sh file. Where is this file? Not found yet The above are just a small part. It’s really impossible to list them all. There are too many... ### Documentation Links _No response_ ### Are you willing to submit a PR? - [ ] Yes I am willing to submit a PR! ### Code of Conduct - [X] I agree to follow this project's [Code of Conduct](https://www.apache.org/foundation/policies/conduct) -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
