wisemapping-open-source/README.md

3.0 KiB

Overview

WiseMapping is a free web based mind map product. The goal of this project is to provide a high quality product that can be deployed by enterprises, educational and academic institutions. WiseMapping is based on the same code product supporting http://www.wisemapping.com.

Compiling and Running

Prerequisites

The following products must be installed:

* OpenJDK 11 or higher
* Maven 3.x or higher ([http://maven.apache.org/])

Compiling

WiseMapping uses Maven as packaging and project management. It's composed of 5 maven sub-modules:

* wise-ui:  React font-end fetcher
* wise-webapp: J2EE web application 

The full compilation of the project can be performed executing within :

mvn clean install

Once this command is executed, the file /wise-webapp/target/wisemapping*.war will be generated.

Local Development

The previously generated war can be deployed locally executing within the directory /wise-webapp the following command:

cd wise-webapp;mvn jetty:run-war

This will start the application on the URL: [http://localhost:8080/] using file based database.

User: test@wisemapping.org Password: test

Local Development + UI Integration

In order to reduce the life-cycle to develop UI backend testing, you can do the following hack:

* Clone [wisemapping-open-source](https://bitbucket.org/wisemapping/wisemapping-open-source/) and [wisemapping-frontend](https://bitbucket.org/wisemapping/wisemapping-frontend/) at the same top level directory
* Compile `wisemapping-frontend`. Details for compilation can be found in the `wisemapping-frontend` readme.
* Compile `wisemapping-open-source`

A quick and dirty solution to share changes in the UI is to manually compile the dist. This will make the loader file available without the need to publish:

cp -r wisemapping-frontend/packages/mindplot/dist/* wisemapping-open-source/wise-ui/target/wisemapping-mindplot/package/dist

Compiling and running with docker-compose

Check out the [docker section](./docker/README.

Troubleshooting

mvn package fails with the error java.lang.UnsatisfiedLinkError: Can't load library: /usr/lib/jvm/java-11-openjdk-amd64/lib/libawt_xawt.so in Ubuntu
Make sure you have the jdk installed: `sudo apt-get install openjdk-11-jdk`
mvn package does not generate the wisemapping.war file
Run `mvn clean install -DskipTests`

Members

Founders

Individual Contributors

Past Individual Contributors

  • Ignacio Manzano

License

The source code is Licensed under the WiseMapping Open License, Version 1.0 (the “License”); You may obtain a copy of the License at: [https://wisemapping.atlassian.net/wiki/display/WS/License]