Building From Source using Maven

• Install JDK 8 or superior.
• Copy a default database to a reachable and writeable location. You can get a default database from the latest stable release (at the time of writing, 2.0.1).
• Glassfish will be installed in the next step.

1. Get Netbeans 8.2 and install it along with the latest updates. You could also use a newer version of Netbeans, but odds are that you find mismatches in the modules versions when compiling the client that are not worth fixing if you just want to get the code running quickly. Download the "Java EE" flavor, which already includes most of the plugins you will need, plus Glassfish Server 4.1.

   

   When you are prompted to select the application servers to be installed, don't forget to choose Glassfish 4.1.

2. Install a sass compiler: sass compiler , if you are on linux "# apt-get install sass"
3. Open Netbeans and go to Tools ⇒ HTML 5/js and search the sass compiler:

   • sass Compiler

     

1. Checkout the code from the SVN tree in separate directories:
   • Server: svn checkout https://svn.code.sf.net/p/kuwaiba/code/server/trunk
   • Client: svn checkout https://svn.code.sf.net/p/kuwaiba/code/client/trunk
   • Client: svn checkout https://svn.code.sf.net/p/kuwaiba/code/components
2. In the component's folder Open:
• Google Maps for Vaadin 8 project, Clean and Build it.
• Vaadin Lienzo project, Clean and Build it.
3. Open the client project and compile it. It should run out of the box. If you get any errors regarding dependencies and versions, make sure you have installed the latest Netbeans updates and restarted the IDE after installing them.
4. Open the server project, resolve problems, Clean and Build it.

   • Resolve Problems 1

     

   • Resolve Problems 2

     

1. Run client project and compile it. It should run out of the box. If you get any errors regarding dependencies and versions, make sure you have installed the latest Netbeans updates and restarted the IDE after installing them.
2. Do not forget to create the folder structure in /data directory, the easiest way is to copy the folder "data/" from Kuwaiba's installers.
3. Run the server project, If the database is in place, the application should be deployed and started successfully.

Additional Notes

• Note that the trunk version will compile, but it's not a stable build since it's the main active development branch. You can find the the latest stable builds prefixed by version- at the same level as trunk in the SVN repository.

• Whenever you modify the web service API, you have to update the client side stub. This process has been automated by a shell script included in the client code. Note that this script can be easily ported to Windows systems:

  1. Tell the script where the wsimport tool is located. This program is included in your JDK distribution, usually in the bin directory. Add this directory to the PATH environment variable. In GNU/Linux this can be done with the command export PATH=$PATH:<path_to_jdk>/bin/
  2. Go the Communications module in the client cd <client_code_dir>/Communications/
  3. Execute the Unix script ./refresh-ws.sh -c
  4. If the defaults don't suit your setup, execute ./refresh-ws.sh -h to see more options.