Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Install the Java Development Kit (JDK)

  • Install 

    MySQL 5

    MySQL.

     
  • Install Apache Maven

    Install  Please make sure is able to execute from command line.
    Code Block
    sudo apt-get install maven
    mvn -version

    Install Github Client.

    Code Blocksudo apt-get install git git --version
    • can be executed from the command line by adding it to the PATH:

      • In Windows 7 right click My Computer and select Properties > Advanced.

      • In Windows 8 go to Control Panel > System > Advanced System Settings.
      • Click the Environment Variables button.
      • Under System Variables, select the variable Path and click Edit.
      • In the Variable Value field, append the Maven path (e.g. C:\Program Files\apache-maven-3.3.9\bin) to the current path


  • Install Git Client

2. Install 3rd Party Libraries

...

Code Block

unzip -a install-libraries.zip
cd install-libraries
./install_linux.sh
cd ~install_win.bat
Warning

Depending on your version of Apache Maven, you might get an error "BUILD FAILED" containing the message: Cannot run program "mvn.cmd"

In this case, edit the file install-libraries\lib\setup-maven_win.xml and replace all occurrences of "mvn.cmd" with "mvn.bat"

3. Obtain Source Code

  • Open a Git CMD (Git Bash) window and execute the following:

Code Block
mkdir joget_src
cd joget_src
git clone https://github.com/jogetworkflow/jw-community.git --branch 5.0-SNAPSHOT
cd ~

4. Configure Datasource for Test Case

...

  • Open a Command Prompt, and create a MySQL database with the SQL file in joget_src/jw-community/wflow-install/src/main/resources/data/jwdb-empty.sql

Code Block
mysql -uroot -p
create database jwdb;
exit
mysql -uroot -p jwdb < joget_src/jw-community/wflow-install/src/main/resources/data/jwdb-empty.sql

...

  • Download the sample configuration files wflow.zip

...

  • and unzip it in your user home folder e.g.

...

  • C:\Users\yourusername\
  • Edit the wflow\app_datasource-default.properties

...

  • file e.g. C:\Users\yourusername\wflow\app_datasource-default.properties

...

  • and ensure that the configuration (e.g. MySQL username and password) is correct

...



Code Block
workflowDriver=com.mysql.jdbc.Driver
workflowUrl=jdbc\:mysql\://localhost\:3306/jwdb?characterEncoding\=UTF-8
workflowUser=root
profileName=
workflowPassword=root
Warning

To pass unit tests which require a valid datasource, it is important to ensure that:

  1. the wflow folder is located in the correct path inside your user home folder e.g. C:\Users\yourusername\wflow
  2. the MySQL configuration settings in wflow\app_datasource-default.properties are correct

5. Build Project

  • In a Command Prompt, browse to the jw-community\wflow-app folder and execute the Maven install command

Code Block
cd ~/joget_src/\jw-community/\wflow-app/\
mvn clean install