Installation Steps
Before starting the installation, you must have Java Development Kit 7 or higher installed. You can download it from (http://java.sun.com/javase/downloads/index.jsp).
- Download the installer from here.
Unzip the wisemapping-3.X.zip binary distribution. This will generate a
wisemapping-<version> directory.
- Open a command line terminal within
wisemapping-<version>
directory. Finally, execute the following line to start wisemapping:
~:> java -Dorg.apache.jasper.compiler.disablejsr199=true -jar start.jar
After some time, you should see something like this. This means that the application is ready to accept requests:
2014-01-23 18:35:38.063:INFO:oejs.Server:jetty-8.1.14.v20131031 2014-01-23 18:35:38.082:INFO:oejdp.ScanningAppProvider:Deployment monitor ~/wisemapping-v3.0.2/webapps at interval 1 2014-01-23 18:35:38.086:INFO:oejdp.ScanningAppProvider:Deployment monitor ~//wisemapping-v3.0.2/contexts at interval 1 2014-01-23 18:35:38.088:INFO:oejd.DeploymentManager:Deployable added: ~//wisemapping-v3.0.2/contexts/wisemapping.xml 2014-01-23 18:35:42.322:INFO:/wisemapping:No Spring WebApplicationInitializer types detected on classpath 2014-01-23 18:35:42.768:INFO:/wisemapping:Initializing Spring root WebApplicationContext 2014-01-23 18:35:45,290 WARN org.openid4java.server.RealmVerifier - RP discovery / realm validation disabled; 2014-01-23 18:35:45.547:INFO:/wisemapping:Initializing Spring FrameworkServlet 'mvc-rest' 2014-01-23 18:35:46.511:INFO:/wisemapping:Initializing Spring FrameworkServlet 'mvc-servlet' 2014-01-23 18:35:46.909:INFO:oejs.AbstractConnector:Started SelectChannelConnector@0.0.0.0:8080
- WiseMapping server will be started on http://localhost:8080/wisemapping/. You could start testing it using the user test@wisemapping.org and password test.
Congrats!, you should have WiseMapping really to be use. A couple of additional comments you have to keep in mind:
- This default installation comes with embedded HQSQL file based database. For production environments, we strongly encourage you to use MySql. Take a look at this page for more information.
- There are a couple of additional defaults you might be interested in reviewing (email servers, etc). Review the file WEB-INF/app.properties and adjust it based on your requirements.
Finally, for advance installation questions or problems you visit he group https://groups.google.com/d/forum/wisemapping-support.
Additional Steps
Also in the file app.properties
, Part Plain SMTP Server Configuration with SMTP settings for an address to you that works. This is necessary so that registered users can receive email confirmation notifications when a card is shared or a new password when they have forgotten.
Silent process
When you run the script start.sh
, the server runs as you do not leave the terminal. To avoid having to maintain a permanently open terminal, it executes the command followed by &
.Information
Each time you make a change to the file app.properties
, you will kill the java process underway and start the script start.sh
.
When the machine crashes and needs to restart, it may be useful to revive Wisemapping start. To do this, create a file/etc/init.d/wisemapping
contains this line: