wisemapping-open-source/README.md

89 lines
2.7 KiB
Markdown
Raw Normal View History

2014-01-26 02:43:46 +08:00
# Project Information
2011-01-24 23:23:01 +08:00
2011-02-18 10:13:19 +08:00
The goal of this project is to provide a high quality product that can be deployed by educational and academic institutions, private and public companies and anyone who needs to have a mindmapping application. WiseMapping is based on the same code source supporting WiseMapping.com. More info: www.wisemapping.org
2011-01-24 23:23:01 +08:00
2014-01-26 02:43:46 +08:00
## Compiling and Running
2012-03-19 18:43:40 +08:00
2014-01-26 02:43:46 +08:00
### Prerequisites
2014-01-09 07:28:21 +08:00
The following products must be installed:
2022-01-05 13:14:14 +08:00
* Java 11 or higher
* Maven 3.x or higher ([http://maven.apache.org/])
2014-01-09 07:28:21 +08:00
2014-01-26 02:43:46 +08:00
### Compiling
2014-01-09 07:28:21 +08:00
WiseMapping uses Maven as packaging and project management. It's composed of 5 maven sub-modules:
2022-01-05 13:14:14 +08:00
* wise-ui: React font-end fetcher
2014-01-09 07:28:21 +08:00
* wise-webapp: J2EE web application
The full compilation of the project can be performed executing within <project-dir>:
`mvn clean install`
2014-01-09 07:28:21 +08:00
Once this command is executed, the file <project-dir>/wise-webapp/target/wisemapping*.war will be generated.
2014-01-09 07:28:21 +08:00
### Local Development
2014-01-09 07:28:21 +08:00
The previously generated war can be deployed locally executing within the directory <project-dir>/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.
2014-01-09 07:28:21 +08:00
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 [https://bitbucket.org/wisemapping/wisemapping-open-source/] and [https://bitbucket.org/wisemapping/wisemapping-frontend/] at the same top level directory
* Compile `WiseMapping Frontend`
* Compile `WiseMapping Open Source`
* Follow the Local Testing steps.
### Compiling and running with docker-compose
2022-01-05 13:14:14 +08:00
Check out the [docker section](./docker/README.
## Troubleshooting
<details>
<summary>
<code>mvn package</code> fails with the error <code>java.lang.UnsatisfiedLinkError: Can't load library: /usr/lib/jvm/java-11-openjdk-amd64/lib/libawt_xawt.so</code> in Ubuntu
</summary>
Make sure you have the jdk installed: `sudo apt-get install openjdk-11-jdk`
</details>
<details>
<summary><code>mvn package</code> does not generate the wisemapping.war file </summary>
Run `mvn clean install -DskipTests`
</details>
2018-09-17 03:29:19 +08:00
## Maintenance
2014-01-26 02:39:50 +08:00
## Members
2014-01-26 02:43:46 +08:00
### Founders
2014-01-26 02:39:50 +08:00
* Paulo Veiga <pablo@wisemapping.com>
* Pablo Luna <pveiga@wisemapping.com>
2014-01-20 05:21:18 +08:00
### Individual Contributors
2014-01-26 02:43:46 +08:00
2014-01-30 12:47:14 +08:00
* Ezequiel Bergamaschi <ezequielbergamaschi@gmail.com>
2014-01-20 05:21:18 +08:00
2014-01-26 02:43:46 +08:00
### Past Individual Contributors
2014-01-26 02:47:44 +08:00
* Ignacio Manzano
2014-01-09 07:28:21 +08:00
2011-01-24 23:23:01 +08:00
## License
The source code is Licensed under the WiseMapping Open License, Version 1.0 (the “License”);
2014-01-09 07:33:00 +08:00
You may obtain a copy of the License at: [https://wisemapping.atlassian.net/wiki/display/WS/License]
2018-09-17 03:29:19 +08:00