Segun-Ogundipe commented on a change in pull request #195:
URL:
https://github.com/apache/incubator-dolphinscheduler-website/pull/195#discussion_r507900430
##########
File path: docs/en-us/development/development-environment-setup.md
##########
@@ -0,0 +1,148 @@
+#### Preparation
+
+1. First, fork the dolphinscheduler code from the remote repository to your
local repository.
Review comment:
This needs to have a link to the dolphinscheduler repo as in the Chinese
version
1. First, fork the
[dolphinscheduler](https://github.com/apache/incubator-dolphinscheduler) code
from the remote repo...
##########
File path: docs/en-us/development/development-environment-setup.md
##########
@@ -0,0 +1,148 @@
+#### Preparation
+
+1. First, fork the dolphinscheduler code from the remote repository to your
local repository.
+
+2. Install MySQL/PostgreSQL, JDK and MAVEN in your own software development
environment.
+
+3. Clone your forked repository to the local file system.
+```
+ git clone https://github.com/apache/incubator-dolphinscheduler.git`
+```
+4. After finished the clone, go into the project folder and execute the
following commands:
+```
+ git branch -a #check the branch
Review comment:
git branch -a #list all the branches
##########
File path: docs/en-us/development/development-environment-setup.md
##########
@@ -0,0 +1,148 @@
+#### Preparation
+
+1. First, fork the dolphinscheduler code from the remote repository to your
local repository.
+
+2. Install MySQL/PostgreSQL, JDK and MAVEN in your own software development
environment.
+
+3. Clone your forked repository to the local file system.
+```
+ git clone https://github.com/apache/incubator-dolphinscheduler.git`
+```
+4. After finished the clone, go into the project folder and execute the
following commands:
+```
+ git branch -a #check the branch
+ git checkout dev #shift the dev branch
Review comment:
git checkout dev #switch to the dev branch
##########
File path: docs/en-us/development/development-environment-setup.md
##########
@@ -0,0 +1,148 @@
+#### Preparation
+
+1. First, fork the dolphinscheduler code from the remote repository to your
local repository.
+
+2. Install MySQL/PostgreSQL, JDK and MAVEN in your own software development
environment.
+
+3. Clone your forked repository to the local file system.
+```
+ git clone https://github.com/apache/incubator-dolphinscheduler.git`
+```
+4. After finished the clone, go into the project folder and execute the
following commands:
+```
+ git branch -a #check the branch
+ git checkout dev #shift the dev branch
+ git pull #sychronize the branch
+ mvn -U clean package -Prelease -Dmaven.test.skip=true #need to compile
the necessary classes due to the project use gRPC dependencies
Review comment:
mvn -U clean package -Prelease -Dmaven.test.skip=true #Because the
project uses gRPC, you need to compile the project to generate the required
classes.
##########
File path: docs/en-us/development/development-environment-setup.md
##########
@@ -0,0 +1,148 @@
+#### Preparation
+
+1. First, fork the dolphinscheduler code from the remote repository to your
local repository.
+
+2. Install MySQL/PostgreSQL, JDK and MAVEN in your own software development
environment.
+
+3. Clone your forked repository to the local file system.
+```
+ git clone https://github.com/apache/incubator-dolphinscheduler.git`
+```
+4. After finished the clone, go into the project folder and execute the
following commands:
+```
+ git branch -a #check the branch
+ git checkout dev #shift the dev branch
+ git pull #sychronize the branch
+ mvn -U clean package -Prelease -Dmaven.test.skip=true #need to compile
the necessary classes due to the project use gRPC dependencies
+```
+#### Install node
+
+1. Install nvm
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh
+
+2. Refresh the environment variables
+source ~/.bash_profile
+
+3. Install node
+nvm install v12.12.0
+note:mac users could install npm through brew:brew install npm
+
+4. Validate the node installation
+node --version
+
+#### Install zookeeper
+
+1. Download zookeeper
+http://apache.mirrors.hoobly.com/zookeeper/zookeeper-3.6.1/apache-zookeeper-3.6.1-bin.tar.gz
+
+2. Copy the zookeeper config file
+cp conf/zoo_sample.cfg conf/zoo.cfg
+
+3. Modify zookepper cofig
+vi conf/zoo.cfg
+dataDir=./tmp/zookeeper
+
+4. Start/stop zookeeper
+./bin/zkServer.sh start
+./bin/zkServer.sh stop
+
+#### Create database
+
+Create user, user name: ds_user, password: dolphinscheduler
+```
+ mysql> CREATE DATABASE dolphinscheduler DEFAULT CHARACTER SET utf8 DEFAULT
COLLATE utf8_general_ci;
+ mysql> GRANT ALL PRIVILEGES ON dolphinscheduler.* TO 'ds_user'@'%'
IDENTIFIED BY 'dolphinscheduler';
+ mysql> GRANT ALL PRIVILEGES ON dolphinscheduler.* TO 'ds_user'@'localhost'
IDENTIFIED BY 'dolphinscheduler';
+ mysql> flush privileges;
+```
+
+#### Set up the front-end
+
+1. Enter the dolphinscheduler-ui folder
+cd dolphinscheduler-ui
+
+2. Run command
+npm install
+
+#### Set up the back-end
+
+1. Import the project to IDEA
+file-->open
+
+2. Modify the database configurations, the 'datasource.properties' under the
resource folder which belongs to the dao module
+```
+ spring.datasource.driver-class-name=com.mysql.jdbc.Driver
+ spring.datasource.url=jdbc:mysql://localhost:3306/dolphinscheduler
+ spring.datasource.username=ds_user
+ spring.datasource.password=dolphinscheduler
+```
+
+3. Modify the pom.xml under the root directory, change the scope of the
mysql-connector-java to complie
+
+4. Refresh the dao module
+try to run the main method inside
org.apache.dolphinscheduler.dao.upgrade.shell.CreateDolphinScheduler to insert
tables and data needed for the project.
+
+5. Modify the service module
+try to change the zookeeper.quorum part of the zookeeper.properties file
+zookeeper.quorum=localhost:2181
+
+6. Modify the dolphinscheduler-ui module
+try to change the .env file
+```
+ API_BASE = http://localhost:12345
+ DEV_HOST = localhost
+```
+
+#### Start the project
+
+1. Start zookeeper
+./bin/zkServer.sh start
+
+2. Start MasterServer
+try to run the main method inside
org.apache.dolphinscheduler.server.master.MasterServer and VM Options is needed:
+```
+ -Dlogging.config=classpath:logback-master.xml
-Ddruid.mysql.usePingMethod=false
+```
+3. Start WorkerServer
Review comment:
3. Start WorkerServer
run the main method of
org.apache.dolphinscheduler.server.worker.WorkerServer, you need to set the
following VM options:
##########
File path: docs/en-us/development/development-environment-setup.md
##########
@@ -0,0 +1,148 @@
+#### Preparation
+
+1. First, fork the dolphinscheduler code from the remote repository to your
local repository.
+
+2. Install MySQL/PostgreSQL, JDK and MAVEN in your own software development
environment.
+
+3. Clone your forked repository to the local file system.
+```
+ git clone https://github.com/apache/incubator-dolphinscheduler.git`
+```
+4. After finished the clone, go into the project folder and execute the
following commands:
+```
+ git branch -a #check the branch
+ git checkout dev #shift the dev branch
+ git pull #sychronize the branch
+ mvn -U clean package -Prelease -Dmaven.test.skip=true #need to compile
the necessary classes due to the project use gRPC dependencies
+```
+#### Install node
+
+1. Install nvm
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh
+
+2. Refresh the environment variables
+source ~/.bash_profile
+
+3. Install node
+nvm install v12.12.0
+note:mac users could install npm through brew:brew install npm
+
+4. Validate the node installation
+node --version
+
+#### Install zookeeper
+
+1. Download zookeeper
+http://apache.mirrors.hoobly.com/zookeeper/zookeeper-3.6.1/apache-zookeeper-3.6.1-bin.tar.gz
+
+2. Copy the zookeeper config file
+cp conf/zoo_sample.cfg conf/zoo.cfg
+
+3. Modify zookepper cofig
+vi conf/zoo.cfg
+dataDir=./tmp/zookeeper
+
+4. Start/stop zookeeper
+./bin/zkServer.sh start
+./bin/zkServer.sh stop
+
+#### Create database
+
+Create user, user name: ds_user, password: dolphinscheduler
+```
+ mysql> CREATE DATABASE dolphinscheduler DEFAULT CHARACTER SET utf8 DEFAULT
COLLATE utf8_general_ci;
+ mysql> GRANT ALL PRIVILEGES ON dolphinscheduler.* TO 'ds_user'@'%'
IDENTIFIED BY 'dolphinscheduler';
+ mysql> GRANT ALL PRIVILEGES ON dolphinscheduler.* TO 'ds_user'@'localhost'
IDENTIFIED BY 'dolphinscheduler';
+ mysql> flush privileges;
+```
+
+#### Set up the front-end
+
+1. Enter the dolphinscheduler-ui folder
+cd dolphinscheduler-ui
+
+2. Run command
+npm install
+
+#### Set up the back-end
+
+1. Import the project to IDEA
+file-->open
+
+2. Modify the database configurations, the 'datasource.properties' under the
resource folder which belongs to the dao module
+```
+ spring.datasource.driver-class-name=com.mysql.jdbc.Driver
+ spring.datasource.url=jdbc:mysql://localhost:3306/dolphinscheduler
+ spring.datasource.username=ds_user
+ spring.datasource.password=dolphinscheduler
+```
+
+3. Modify the pom.xml under the root directory, change the scope of the
mysql-connector-java to complie
+
+4. Refresh the dao module
+try to run the main method inside
org.apache.dolphinscheduler.dao.upgrade.shell.CreateDolphinScheduler to insert
tables and data needed for the project.
+
+5. Modify the service module
+try to change the zookeeper.quorum part of the zookeeper.properties file
+zookeeper.quorum=localhost:2181
+
+6. Modify the dolphinscheduler-ui module
+try to change the .env file
+```
+ API_BASE = http://localhost:12345
+ DEV_HOST = localhost
+```
+
+#### Start the project
+
+1. Start zookeeper
+./bin/zkServer.sh start
+
+2. Start MasterServer
+try to run the main method inside
org.apache.dolphinscheduler.server.master.MasterServer and VM Options is needed:
+```
+ -Dlogging.config=classpath:logback-master.xml
-Ddruid.mysql.usePingMethod=false
+```
+3. Start WorkerServer
+try to run the main method inside
org.apache.dolphinscheduler.server.worker.WorkerServer and VM Options is needed:
+```
+ -Dlogging.config=classpath:logback-worker.xml
-Ddruid.mysql.usePingMethod=false
+```
+4. Start ApiApplicationServer
+try to run the main method inside
org.apache.dolphinscheduler.api.ApiApplicationServer and VM Options is needed:
+```
+ -Dlogging.config=classpath:logback-api.xml -Dspring.profiles.active=api
+```
+5. We are not going to start the other modules. if they are required to be
started, check script/dolphinscheduler-daemon.sh and set them the same VM
Options.
+```
+ if [ "$command" = "api-server" ]; then
+ LOG_FILE="-Dlogging.config=classpath:logback-api.xml
-Dspring.profiles.active=api"
+ CLASS=org.apache.dolphinscheduler.api.ApiApplicationServer
+ elif [ "$command" = "master-server" ]; then
+ LOG_FILE="-Dlogging.config=classpath:logback-master.xml
-Ddruid.mysql.usePingMethod=false"
+ CLASS=org.apache.dolphinscheduler.server.master.MasterServer
+ elif [ "$command" = "worker-server" ]; then
+ LOG_FILE="-Dlogging.config=classpath:logback-worker.xml
-Ddruid.mysql.usePingMethod=false"
+ CLASS=org.apache.dolphinscheduler.server.worker.WorkerServer
+ elif [ "$command" = "alert-server" ]; then
+ LOG_FILE="-Dlogback.configurationFile=conf/logback-alert.xml"
+ CLASS=org.apache.dolphinscheduler.alert.AlertServer
+ elif [ "$command" = "logger-server" ]; then
+ CLASS=org.apache.dolphinscheduler.server.log.LoggerServer
+ else
+ echo "Error: No command named \`$command' was found."
+ exit 1
+ fi
+```
+
+6. Start the front-end ui modules
+cd dolphinscheduler-ui directory
+And run
+npm run start
+
+#### Visit the project
+1. Visit http://localhost:8888
+
+2. Sign in with the administrator role
Review comment:
2. Sign in with the administrator account
##########
File path: docs/en-us/development/development-environment-setup.md
##########
@@ -0,0 +1,148 @@
+#### Preparation
+
+1. First, fork the dolphinscheduler code from the remote repository to your
local repository.
+
+2. Install MySQL/PostgreSQL, JDK and MAVEN in your own software development
environment.
+
+3. Clone your forked repository to the local file system.
+```
+ git clone https://github.com/apache/incubator-dolphinscheduler.git`
+```
+4. After finished the clone, go into the project folder and execute the
following commands:
+```
+ git branch -a #check the branch
+ git checkout dev #shift the dev branch
+ git pull #sychronize the branch
+ mvn -U clean package -Prelease -Dmaven.test.skip=true #need to compile
the necessary classes due to the project use gRPC dependencies
+```
+#### Install node
+
+1. Install nvm
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh
+
+2. Refresh the environment variables
+source ~/.bash_profile
+
+3. Install node
+nvm install v12.12.0
+note:mac users could install npm through brew:brew install npm
+
+4. Validate the node installation
+node --version
+
+#### Install zookeeper
+
+1. Download zookeeper
+http://apache.mirrors.hoobly.com/zookeeper/zookeeper-3.6.1/apache-zookeeper-3.6.1-bin.tar.gz
+
+2. Copy the zookeeper config file
+cp conf/zoo_sample.cfg conf/zoo.cfg
+
+3. Modify zookepper cofig
+vi conf/zoo.cfg
+dataDir=./tmp/zookeeper
+
+4. Start/stop zookeeper
+./bin/zkServer.sh start
+./bin/zkServer.sh stop
+
+#### Create database
+
+Create user, user name: ds_user, password: dolphinscheduler
+```
+ mysql> CREATE DATABASE dolphinscheduler DEFAULT CHARACTER SET utf8 DEFAULT
COLLATE utf8_general_ci;
+ mysql> GRANT ALL PRIVILEGES ON dolphinscheduler.* TO 'ds_user'@'%'
IDENTIFIED BY 'dolphinscheduler';
+ mysql> GRANT ALL PRIVILEGES ON dolphinscheduler.* TO 'ds_user'@'localhost'
IDENTIFIED BY 'dolphinscheduler';
+ mysql> flush privileges;
+```
+
+#### Set up the front-end
+
+1. Enter the dolphinscheduler-ui folder
+cd dolphinscheduler-ui
+
+2. Run command
+npm install
+
+#### Set up the back-end
+
+1. Import the project to IDEA
+file-->open
+
+2. Modify the database configurations, the 'datasource.properties' under the
resource folder which belongs to the dao module
Review comment:
2. Modify the database configuration in the datasource.properties file
in the resource directory of the dao module
##########
File path: docs/en-us/development/development-environment-setup.md
##########
@@ -0,0 +1,148 @@
+#### Preparation
+
+1. First, fork the dolphinscheduler code from the remote repository to your
local repository.
+
+2. Install MySQL/PostgreSQL, JDK and MAVEN in your own software development
environment.
+
+3. Clone your forked repository to the local file system.
+```
+ git clone https://github.com/apache/incubator-dolphinscheduler.git`
+```
+4. After finished the clone, go into the project folder and execute the
following commands:
+```
+ git branch -a #check the branch
+ git checkout dev #shift the dev branch
+ git pull #sychronize the branch
+ mvn -U clean package -Prelease -Dmaven.test.skip=true #need to compile
the necessary classes due to the project use gRPC dependencies
+```
+#### Install node
+
+1. Install nvm
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh
+
+2. Refresh the environment variables
+source ~/.bash_profile
+
+3. Install node
+nvm install v12.12.0
+note:mac users could install npm through brew:brew install npm
+
+4. Validate the node installation
+node --version
+
+#### Install zookeeper
+
+1. Download zookeeper
+http://apache.mirrors.hoobly.com/zookeeper/zookeeper-3.6.1/apache-zookeeper-3.6.1-bin.tar.gz
+
+2. Copy the zookeeper config file
+cp conf/zoo_sample.cfg conf/zoo.cfg
+
+3. Modify zookepper cofig
+vi conf/zoo.cfg
+dataDir=./tmp/zookeeper
+
+4. Start/stop zookeeper
+./bin/zkServer.sh start
+./bin/zkServer.sh stop
+
+#### Create database
+
+Create user, user name: ds_user, password: dolphinscheduler
+```
+ mysql> CREATE DATABASE dolphinscheduler DEFAULT CHARACTER SET utf8 DEFAULT
COLLATE utf8_general_ci;
+ mysql> GRANT ALL PRIVILEGES ON dolphinscheduler.* TO 'ds_user'@'%'
IDENTIFIED BY 'dolphinscheduler';
+ mysql> GRANT ALL PRIVILEGES ON dolphinscheduler.* TO 'ds_user'@'localhost'
IDENTIFIED BY 'dolphinscheduler';
+ mysql> flush privileges;
+```
+
+#### Set up the front-end
+
+1. Enter the dolphinscheduler-ui folder
+cd dolphinscheduler-ui
+
+2. Run command
+npm install
+
+#### Set up the back-end
+
+1. Import the project to IDEA
+file-->open
+
+2. Modify the database configurations, the 'datasource.properties' under the
resource folder which belongs to the dao module
+```
+ spring.datasource.driver-class-name=com.mysql.jdbc.Driver
+ spring.datasource.url=jdbc:mysql://localhost:3306/dolphinscheduler
+ spring.datasource.username=ds_user
+ spring.datasource.password=dolphinscheduler
+```
+
+3. Modify the pom.xml under the root directory, change the scope of the
mysql-connector-java to complie
+
+4. Refresh the dao module
+try to run the main method inside
org.apache.dolphinscheduler.dao.upgrade.shell.CreateDolphinScheduler to insert
tables and data needed for the project.
+
+5. Modify the service module
+try to change the zookeeper.quorum part of the zookeeper.properties file
+zookeeper.quorum=localhost:2181
+
+6. Modify the dolphinscheduler-ui module
+try to change the .env file
Review comment:
5. Modify the .env file of the dolphinscheduler-ui module
##########
File path: docs/en-us/development/development-environment-setup.md
##########
@@ -0,0 +1,148 @@
+#### Preparation
+
+1. First, fork the dolphinscheduler code from the remote repository to your
local repository.
+
+2. Install MySQL/PostgreSQL, JDK and MAVEN in your own software development
environment.
+
+3. Clone your forked repository to the local file system.
+```
+ git clone https://github.com/apache/incubator-dolphinscheduler.git`
+```
+4. After finished the clone, go into the project folder and execute the
following commands:
+```
+ git branch -a #check the branch
+ git checkout dev #shift the dev branch
+ git pull #sychronize the branch
+ mvn -U clean package -Prelease -Dmaven.test.skip=true #need to compile
the necessary classes due to the project use gRPC dependencies
+```
+#### Install node
+
+1. Install nvm
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh
+
+2. Refresh the environment variables
+source ~/.bash_profile
+
+3. Install node
+nvm install v12.12.0
+note:mac users could install npm through brew:brew install npm
+
+4. Validate the node installation
+node --version
+
+#### Install zookeeper
+
+1. Download zookeeper
+http://apache.mirrors.hoobly.com/zookeeper/zookeeper-3.6.1/apache-zookeeper-3.6.1-bin.tar.gz
+
+2. Copy the zookeeper config file
+cp conf/zoo_sample.cfg conf/zoo.cfg
+
+3. Modify zookepper cofig
+vi conf/zoo.cfg
+dataDir=./tmp/zookeeper
+
+4. Start/stop zookeeper
+./bin/zkServer.sh start
+./bin/zkServer.sh stop
+
+#### Create database
+
+Create user, user name: ds_user, password: dolphinscheduler
+```
+ mysql> CREATE DATABASE dolphinscheduler DEFAULT CHARACTER SET utf8 DEFAULT
COLLATE utf8_general_ci;
+ mysql> GRANT ALL PRIVILEGES ON dolphinscheduler.* TO 'ds_user'@'%'
IDENTIFIED BY 'dolphinscheduler';
+ mysql> GRANT ALL PRIVILEGES ON dolphinscheduler.* TO 'ds_user'@'localhost'
IDENTIFIED BY 'dolphinscheduler';
+ mysql> flush privileges;
+```
+
+#### Set up the front-end
+
+1. Enter the dolphinscheduler-ui folder
+cd dolphinscheduler-ui
+
+2. Run command
+npm install
+
+#### Set up the back-end
+
+1. Import the project to IDEA
+file-->open
+
+2. Modify the database configurations, the 'datasource.properties' under the
resource folder which belongs to the dao module
+```
+ spring.datasource.driver-class-name=com.mysql.jdbc.Driver
+ spring.datasource.url=jdbc:mysql://localhost:3306/dolphinscheduler
+ spring.datasource.username=ds_user
+ spring.datasource.password=dolphinscheduler
+```
+
+3. Modify the pom.xml under the root directory, change the scope of the
mysql-connector-java to complie
+
+4. Refresh the dao module
+try to run the main method inside
org.apache.dolphinscheduler.dao.upgrade.shell.CreateDolphinScheduler to insert
tables and data needed for the project.
+
+5. Modify the service module
+try to change the zookeeper.quorum part of the zookeeper.properties file
+zookeeper.quorum=localhost:2181
+
+6. Modify the dolphinscheduler-ui module
+try to change the .env file
+```
+ API_BASE = http://localhost:12345
+ DEV_HOST = localhost
+```
+
+#### Start the project
+
+1. Start zookeeper
+./bin/zkServer.sh start
+
+2. Start MasterServer
+try to run the main method inside
org.apache.dolphinscheduler.server.master.MasterServer and VM Options is needed:
+```
+ -Dlogging.config=classpath:logback-master.xml
-Ddruid.mysql.usePingMethod=false
+```
+3. Start WorkerServer
+try to run the main method inside
org.apache.dolphinscheduler.server.worker.WorkerServer and VM Options is needed:
+```
+ -Dlogging.config=classpath:logback-worker.xml
-Ddruid.mysql.usePingMethod=false
+```
+4. Start ApiApplicationServer
+try to run the main method inside
org.apache.dolphinscheduler.api.ApiApplicationServer and VM Options is needed:
Review comment:
4. Start ApiApplicationServer
run the main method of org.apache.dolphinscheduler.api.ApiApplicationServer,
you need to set the following VM options:
##########
File path: docs/en-us/development/development-environment-setup.md
##########
@@ -0,0 +1,148 @@
+#### Preparation
+
+1. First, fork the dolphinscheduler code from the remote repository to your
local repository.
+
+2. Install MySQL/PostgreSQL, JDK and MAVEN in your own software development
environment.
+
+3. Clone your forked repository to the local file system.
+```
+ git clone https://github.com/apache/incubator-dolphinscheduler.git`
+```
+4. After finished the clone, go into the project folder and execute the
following commands:
+```
+ git branch -a #check the branch
+ git checkout dev #shift the dev branch
+ git pull #sychronize the branch
+ mvn -U clean package -Prelease -Dmaven.test.skip=true #need to compile
the necessary classes due to the project use gRPC dependencies
+```
+#### Install node
+
+1. Install nvm
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh
+
+2. Refresh the environment variables
+source ~/.bash_profile
+
+3. Install node
+nvm install v12.12.0
+note:mac users could install npm through brew:brew install npm
+
+4. Validate the node installation
+node --version
+
+#### Install zookeeper
+
+1. Download zookeeper
+http://apache.mirrors.hoobly.com/zookeeper/zookeeper-3.6.1/apache-zookeeper-3.6.1-bin.tar.gz
+
+2. Copy the zookeeper config file
+cp conf/zoo_sample.cfg conf/zoo.cfg
+
+3. Modify zookepper cofig
+vi conf/zoo.cfg
+dataDir=./tmp/zookeeper
+
+4. Start/stop zookeeper
+./bin/zkServer.sh start
+./bin/zkServer.sh stop
+
+#### Create database
+
+Create user, user name: ds_user, password: dolphinscheduler
+```
+ mysql> CREATE DATABASE dolphinscheduler DEFAULT CHARACTER SET utf8 DEFAULT
COLLATE utf8_general_ci;
+ mysql> GRANT ALL PRIVILEGES ON dolphinscheduler.* TO 'ds_user'@'%'
IDENTIFIED BY 'dolphinscheduler';
+ mysql> GRANT ALL PRIVILEGES ON dolphinscheduler.* TO 'ds_user'@'localhost'
IDENTIFIED BY 'dolphinscheduler';
+ mysql> flush privileges;
+```
+
+#### Set up the front-end
+
+1. Enter the dolphinscheduler-ui folder
+cd dolphinscheduler-ui
+
+2. Run command
+npm install
Review comment:
2. Run `npm install`
##########
File path: docs/en-us/development/development-environment-setup.md
##########
@@ -0,0 +1,148 @@
+#### Preparation
+
+1. First, fork the dolphinscheduler code from the remote repository to your
local repository.
+
+2. Install MySQL/PostgreSQL, JDK and MAVEN in your own software development
environment.
+
+3. Clone your forked repository to the local file system.
+```
+ git clone https://github.com/apache/incubator-dolphinscheduler.git`
+```
+4. After finished the clone, go into the project folder and execute the
following commands:
+```
+ git branch -a #check the branch
+ git checkout dev #shift the dev branch
+ git pull #sychronize the branch
+ mvn -U clean package -Prelease -Dmaven.test.skip=true #need to compile
the necessary classes due to the project use gRPC dependencies
+```
+#### Install node
+
+1. Install nvm
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh
+
+2. Refresh the environment variables
+source ~/.bash_profile
+
+3. Install node
+nvm install v12.12.0
+note:mac users could install npm through brew:brew install npm
+
+4. Validate the node installation
+node --version
+
+#### Install zookeeper
+
+1. Download zookeeper
+http://apache.mirrors.hoobly.com/zookeeper/zookeeper-3.6.1/apache-zookeeper-3.6.1-bin.tar.gz
+
+2. Copy the zookeeper config file
+cp conf/zoo_sample.cfg conf/zoo.cfg
+
+3. Modify zookepper cofig
+vi conf/zoo.cfg
+dataDir=./tmp/zookeeper
+
+4. Start/stop zookeeper
+./bin/zkServer.sh start
+./bin/zkServer.sh stop
+
+#### Create database
+
+Create user, user name: ds_user, password: dolphinscheduler
+```
+ mysql> CREATE DATABASE dolphinscheduler DEFAULT CHARACTER SET utf8 DEFAULT
COLLATE utf8_general_ci;
+ mysql> GRANT ALL PRIVILEGES ON dolphinscheduler.* TO 'ds_user'@'%'
IDENTIFIED BY 'dolphinscheduler';
+ mysql> GRANT ALL PRIVILEGES ON dolphinscheduler.* TO 'ds_user'@'localhost'
IDENTIFIED BY 'dolphinscheduler';
+ mysql> flush privileges;
+```
+
+#### Set up the front-end
+
+1. Enter the dolphinscheduler-ui folder
+cd dolphinscheduler-ui
+
+2. Run command
+npm install
+
+#### Set up the back-end
+
+1. Import the project to IDEA
+file-->open
+
+2. Modify the database configurations, the 'datasource.properties' under the
resource folder which belongs to the dao module
+```
+ spring.datasource.driver-class-name=com.mysql.jdbc.Driver
+ spring.datasource.url=jdbc:mysql://localhost:3306/dolphinscheduler
+ spring.datasource.username=ds_user
+ spring.datasource.password=dolphinscheduler
+```
+
+3. Modify the pom.xml under the root directory, change the scope of the
mysql-connector-java to complie
+
+4. Refresh the dao module
+try to run the main method inside
org.apache.dolphinscheduler.dao.upgrade.shell.CreateDolphinScheduler to insert
tables and data needed for the project.
+
+5. Modify the service module
+try to change the zookeeper.quorum part of the zookeeper.properties file
+zookeeper.quorum=localhost:2181
+
+6. Modify the dolphinscheduler-ui module
+try to change the .env file
+```
+ API_BASE = http://localhost:12345
+ DEV_HOST = localhost
+```
+
+#### Start the project
+
+1. Start zookeeper
+./bin/zkServer.sh start
+
+2. Start MasterServer
+try to run the main method inside
org.apache.dolphinscheduler.server.master.MasterServer and VM Options is needed:
Review comment:
2. Start MasterServer
run the main method of
org.apache.dolphinscheduler.server.master.MasterServer, you need to set the
following VM options:
##########
File path: docs/en-us/development/development-environment-setup.md
##########
@@ -0,0 +1,148 @@
+#### Preparation
+
+1. First, fork the dolphinscheduler code from the remote repository to your
local repository.
+
+2. Install MySQL/PostgreSQL, JDK and MAVEN in your own software development
environment.
+
+3. Clone your forked repository to the local file system.
+```
+ git clone https://github.com/apache/incubator-dolphinscheduler.git`
+```
+4. After finished the clone, go into the project folder and execute the
following commands:
+```
+ git branch -a #check the branch
+ git checkout dev #shift the dev branch
+ git pull #sychronize the branch
Review comment:
git pull #synchronize the branch with the remote branch
##########
File path: docs/en-us/development/development-environment-setup.md
##########
@@ -0,0 +1,148 @@
+#### Preparation
+
+1. First, fork the dolphinscheduler code from the remote repository to your
local repository.
+
+2. Install MySQL/PostgreSQL, JDK and MAVEN in your own software development
environment.
+
+3. Clone your forked repository to the local file system.
+```
+ git clone https://github.com/apache/incubator-dolphinscheduler.git`
+```
+4. After finished the clone, go into the project folder and execute the
following commands:
+```
+ git branch -a #check the branch
+ git checkout dev #shift the dev branch
+ git pull #sychronize the branch
+ mvn -U clean package -Prelease -Dmaven.test.skip=true #need to compile
the necessary classes due to the project use gRPC dependencies
+```
+#### Install node
+
+1. Install nvm
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh
+
+2. Refresh the environment variables
+source ~/.bash_profile
+
+3. Install node
+nvm install v12.12.0
+note:mac users could install npm through brew:brew install npm
+
+4. Validate the node installation
+node --version
+
+#### Install zookeeper
+
+1. Download zookeeper
+http://apache.mirrors.hoobly.com/zookeeper/zookeeper-3.6.1/apache-zookeeper-3.6.1-bin.tar.gz
+
+2. Copy the zookeeper config file
+cp conf/zoo_sample.cfg conf/zoo.cfg
+
+3. Modify zookepper cofig
+vi conf/zoo.cfg
+dataDir=./tmp/zookeeper
+
+4. Start/stop zookeeper
+./bin/zkServer.sh start
+./bin/zkServer.sh stop
+
+#### Create database
+
+Create user, user name: ds_user, password: dolphinscheduler
+```
+ mysql> CREATE DATABASE dolphinscheduler DEFAULT CHARACTER SET utf8 DEFAULT
COLLATE utf8_general_ci;
+ mysql> GRANT ALL PRIVILEGES ON dolphinscheduler.* TO 'ds_user'@'%'
IDENTIFIED BY 'dolphinscheduler';
+ mysql> GRANT ALL PRIVILEGES ON dolphinscheduler.* TO 'ds_user'@'localhost'
IDENTIFIED BY 'dolphinscheduler';
+ mysql> flush privileges;
+```
+
+#### Set up the front-end
+
+1. Enter the dolphinscheduler-ui folder
+cd dolphinscheduler-ui
+
+2. Run command
+npm install
+
+#### Set up the back-end
+
+1. Import the project to IDEA
+file-->open
+
+2. Modify the database configurations, the 'datasource.properties' under the
resource folder which belongs to the dao module
+```
+ spring.datasource.driver-class-name=com.mysql.jdbc.Driver
+ spring.datasource.url=jdbc:mysql://localhost:3306/dolphinscheduler
+ spring.datasource.username=ds_user
+ spring.datasource.password=dolphinscheduler
+```
+
+3. Modify the pom.xml under the root directory, change the scope of the
mysql-connector-java to complie
+
+4. Refresh the dao module
+try to run the main method inside
org.apache.dolphinscheduler.dao.upgrade.shell.CreateDolphinScheduler to insert
tables and data needed for the project.
+
+5. Modify the service module
+try to change the zookeeper.quorum part of the zookeeper.properties file
+zookeeper.quorum=localhost:2181
+
+6. Modify the dolphinscheduler-ui module
+try to change the .env file
+```
+ API_BASE = http://localhost:12345
+ DEV_HOST = localhost
+```
+
+#### Start the project
+
+1. Start zookeeper
+./bin/zkServer.sh start
+
+2. Start MasterServer
+try to run the main method inside
org.apache.dolphinscheduler.server.master.MasterServer and VM Options is needed:
+```
+ -Dlogging.config=classpath:logback-master.xml
-Ddruid.mysql.usePingMethod=false
+```
+3. Start WorkerServer
+try to run the main method inside
org.apache.dolphinscheduler.server.worker.WorkerServer and VM Options is needed:
+```
+ -Dlogging.config=classpath:logback-worker.xml
-Ddruid.mysql.usePingMethod=false
+```
+4. Start ApiApplicationServer
+try to run the main method inside
org.apache.dolphinscheduler.api.ApiApplicationServer and VM Options is needed:
+```
+ -Dlogging.config=classpath:logback-api.xml -Dspring.profiles.active=api
+```
+5. We are not going to start the other modules. if they are required to be
started, check script/dolphinscheduler-daemon.sh and set them the same VM
Options.
+```
+ if [ "$command" = "api-server" ]; then
+ LOG_FILE="-Dlogging.config=classpath:logback-api.xml
-Dspring.profiles.active=api"
+ CLASS=org.apache.dolphinscheduler.api.ApiApplicationServer
+ elif [ "$command" = "master-server" ]; then
+ LOG_FILE="-Dlogging.config=classpath:logback-master.xml
-Ddruid.mysql.usePingMethod=false"
+ CLASS=org.apache.dolphinscheduler.server.master.MasterServer
+ elif [ "$command" = "worker-server" ]; then
+ LOG_FILE="-Dlogging.config=classpath:logback-worker.xml
-Ddruid.mysql.usePingMethod=false"
+ CLASS=org.apache.dolphinscheduler.server.worker.WorkerServer
+ elif [ "$command" = "alert-server" ]; then
+ LOG_FILE="-Dlogback.configurationFile=conf/logback-alert.xml"
+ CLASS=org.apache.dolphinscheduler.alert.AlertServer
+ elif [ "$command" = "logger-server" ]; then
+ CLASS=org.apache.dolphinscheduler.server.log.LoggerServer
+ else
+ echo "Error: No command named \`$command' was found."
+ exit 1
+ fi
+```
+
+6. Start the front-end ui modules
+cd dolphinscheduler-ui directory
+And run
+npm run start
Review comment:
cd dolphinscheduler-ui directory and run `npm run start`
##########
File path: docs/en-us/development/development-environment-setup.md
##########
@@ -0,0 +1,148 @@
+#### Preparation
+
+1. First, fork the dolphinscheduler code from the remote repository to your
local repository.
+
+2. Install MySQL/PostgreSQL, JDK and MAVEN in your own software development
environment.
+
+3. Clone your forked repository to the local file system.
+```
+ git clone https://github.com/apache/incubator-dolphinscheduler.git`
+```
+4. After finished the clone, go into the project folder and execute the
following commands:
+```
+ git branch -a #check the branch
+ git checkout dev #shift the dev branch
+ git pull #sychronize the branch
+ mvn -U clean package -Prelease -Dmaven.test.skip=true #need to compile
the necessary classes due to the project use gRPC dependencies
+```
+#### Install node
+
+1. Install nvm
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh
+
+2. Refresh the environment variables
+source ~/.bash_profile
+
+3. Install node
+nvm install v12.12.0
+note:mac users could install npm through brew:brew install npm
+
+4. Validate the node installation
+node --version
+
+#### Install zookeeper
+
+1. Download zookeeper
+http://apache.mirrors.hoobly.com/zookeeper/zookeeper-3.6.1/apache-zookeeper-3.6.1-bin.tar.gz
+
+2. Copy the zookeeper config file
+cp conf/zoo_sample.cfg conf/zoo.cfg
+
+3. Modify zookepper cofig
+vi conf/zoo.cfg
+dataDir=./tmp/zookeeper
+
+4. Start/stop zookeeper
+./bin/zkServer.sh start
+./bin/zkServer.sh stop
+
+#### Create database
+
+Create user, user name: ds_user, password: dolphinscheduler
+```
+ mysql> CREATE DATABASE dolphinscheduler DEFAULT CHARACTER SET utf8 DEFAULT
COLLATE utf8_general_ci;
+ mysql> GRANT ALL PRIVILEGES ON dolphinscheduler.* TO 'ds_user'@'%'
IDENTIFIED BY 'dolphinscheduler';
+ mysql> GRANT ALL PRIVILEGES ON dolphinscheduler.* TO 'ds_user'@'localhost'
IDENTIFIED BY 'dolphinscheduler';
+ mysql> flush privileges;
+```
+
+#### Set up the front-end
+
+1. Enter the dolphinscheduler-ui folder
+cd dolphinscheduler-ui
+
+2. Run command
+npm install
+
+#### Set up the back-end
+
+1. Import the project to IDEA
+file-->open
+
+2. Modify the database configurations, the 'datasource.properties' under the
resource folder which belongs to the dao module
+```
+ spring.datasource.driver-class-name=com.mysql.jdbc.Driver
+ spring.datasource.url=jdbc:mysql://localhost:3306/dolphinscheduler
+ spring.datasource.username=ds_user
+ spring.datasource.password=dolphinscheduler
+```
+
+3. Modify the pom.xml under the root directory, change the scope of the
mysql-connector-java to complie
+
+4. Refresh the dao module
+try to run the main method inside
org.apache.dolphinscheduler.dao.upgrade.shell.CreateDolphinScheduler to insert
tables and data needed for the project.
Review comment:
4. Refresh the dao module, run the main method of
org.apache.dolphinscheduler.dao.upgrade.shell.CreateDolphinScheduler to
automatically insert the tables and data required by the project
##########
File path: md_json/docs.json
##########
@@ -30,6 +30,11 @@
"link": "/en-us/docs/development/developers.html",
"meta": {}
},
+ {
+ "filename": "development-environment-setup.md",
+ "link": "/en-us/docs/development/development-environment-setup.html",
+ "meta": {}
+ },
Review comment:
You shouldn't edit this file, it is automatically generated and modified
##########
File path: docs/en-us/development/development-environment-setup.md
##########
@@ -0,0 +1,148 @@
+#### Preparation
+
+1. First, fork the dolphinscheduler code from the remote repository to your
local repository.
+
+2. Install MySQL/PostgreSQL, JDK and MAVEN in your own software development
environment.
+
+3. Clone your forked repository to the local file system.
+```
+ git clone https://github.com/apache/incubator-dolphinscheduler.git`
+```
+4. After finished the clone, go into the project folder and execute the
following commands:
+```
+ git branch -a #check the branch
+ git checkout dev #shift the dev branch
+ git pull #sychronize the branch
+ mvn -U clean package -Prelease -Dmaven.test.skip=true #need to compile
the necessary classes due to the project use gRPC dependencies
+```
+#### Install node
+
+1. Install nvm
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh
+
+2. Refresh the environment variables
+source ~/.bash_profile
+
+3. Install node
+nvm install v12.12.0
+note:mac users could install npm through brew:brew install npm
+
+4. Validate the node installation
+node --version
+
+#### Install zookeeper
+
+1. Download zookeeper
+http://apache.mirrors.hoobly.com/zookeeper/zookeeper-3.6.1/apache-zookeeper-3.6.1-bin.tar.gz
+
+2. Copy the zookeeper config file
+cp conf/zoo_sample.cfg conf/zoo.cfg
+
+3. Modify zookepper cofig
+vi conf/zoo.cfg
+dataDir=./tmp/zookeeper
+
+4. Start/stop zookeeper
+./bin/zkServer.sh start
+./bin/zkServer.sh stop
+
+#### Create database
+
+Create user, user name: ds_user, password: dolphinscheduler
+```
+ mysql> CREATE DATABASE dolphinscheduler DEFAULT CHARACTER SET utf8 DEFAULT
COLLATE utf8_general_ci;
+ mysql> GRANT ALL PRIVILEGES ON dolphinscheduler.* TO 'ds_user'@'%'
IDENTIFIED BY 'dolphinscheduler';
+ mysql> GRANT ALL PRIVILEGES ON dolphinscheduler.* TO 'ds_user'@'localhost'
IDENTIFIED BY 'dolphinscheduler';
+ mysql> flush privileges;
+```
+
+#### Set up the front-end
+
+1. Enter the dolphinscheduler-ui folder
+cd dolphinscheduler-ui
+
+2. Run command
+npm install
+
+#### Set up the back-end
+
+1. Import the project to IDEA
+file-->open
+
+2. Modify the database configurations, the 'datasource.properties' under the
resource folder which belongs to the dao module
+```
+ spring.datasource.driver-class-name=com.mysql.jdbc.Driver
+ spring.datasource.url=jdbc:mysql://localhost:3306/dolphinscheduler
+ spring.datasource.username=ds_user
+ spring.datasource.password=dolphinscheduler
+```
+
+3. Modify the pom.xml under the root directory, change the scope of the
mysql-connector-java to complie
Review comment:
3. Modify pom.xml in the root directory and modify the scope of
mysql-connector-java to compile
----------------------------------------------------------------
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.
For queries about this service, please contact Infrastructure at:
[email protected]
