JWP Installation

jwp - JSP WebProject Installation Instruction

You can use this installation instruction for Linux/Unix and Windows.

1. Requirements:

You will need to install the following software before installing jwp (please ensure to download the correct packages for your system):

Apache Tomcat
please download and install the Apache Tomcat Servlet Container
it can be found at the Apache Homepage: http://jakarta.apache.org

MySQL RDBMS
You need the MySQL Database on your System
http://www.mysql.com

JWP Package
you can download the current release here...

2. Installation
I will only describe the installation of jwp. If you have problems installing Apache Tomcat or MySQL please refer to their FAQ or Manuals.
If you have trouble installing jwp, please send me an eMail, I will try to help you as soon as possible.

In this example I use the following folders to install jwp:

  • Apache Tomcat under Windows: C:\Tomcat
  • Apache Tomcat under Linux: /opt/tomcat
  • JWP Directory under Windows: C:\webapps\jwp
  • JWP Directory under Linux: /opt/webapps/jwp

Please replace the example directories above with your current directories.

2.1. Unzip the jwp Package into your preferred folder
Please check that your tomcat process has enough rights to access the folder of your jwp.

2.2. Go to your Tomcat Config Directory and edit the server.xml file:
You will find the server.xml here (Linux): /opt/tomcat/conf
Windows: C:\Tomcat\conf

Search for the following lines:

<!--Tomcat Root Context-->

<context path="" docBase="ROOT" debug="0"/>


After these lines you can add a new "Context" which specifies the location of your jwp:
For my Windows installation:
<context path="/jwp" docBase="C:\webapps\jwp" debug="0"/>

For my Linux installation:
<context path="/jwp" docBase="/opt/webapps/jwp" debug="0"/>

Save your server.xml

2.3. Create the needed Database
In your jwp folder you will find the "docs" directory.
There you will find the file "database.sql". Use this statements to create the database.

2.4. edit the jwp web.xml
In the WEB-INF directory of your jwp package you will find a file called web.xml
Search for the following lines:

<!--Environment Variables -->
<!---Please configure your database variables here -->

These lines are followed by the configuration lines of jwp:

2.4.1 Edit the database host variable.
This is the IP where your MySQL Server is installed.
Here you have to replace localhost whith your setting. If jwp is running on the same machine as your MySQL Database Server you can use "localhost" or "127.0.0.1"

<env-entry>
<env-entry-name>db_host</env-entry-name>
<!-- enter your host -->
<env-entry-value>localhost</env-entry-value>
<env-entry-type>java.lang.String</env-entry-type>
</env-entry>

2.4.2. Edit the database port on which your MySQL Server listens
Normally 3306 is the standard port, so you need not to change it.

<env-entry>
<env-entry-name>db_port</env-entry-name>
<!-- enter your port -->
<env-entry-value>3306</env-entry-value>
<env-entry-type>java.lang.String</env-entry-type>
</env-entry>

2.4.3. Edit the Database name
Replace "jwpdb" with the database name you have chosen when creating your jwp database


<env-entry>
<env-entry-name>db_database</env-entry-name>
<!-- enter your database name -->
<env-entry-value>jwpdb</env-entry-value>
<env-entry-type>java.lang.String</env-entry-type>
</env-entry>

2.4.4. Configure the correct User who has the rights to access the database
Replace "dbuser" by your database user


<env-entry>
<env-entry-name>db_user</env-entry-name>
<!-- enter your database user -->
<env-entry-value>dbuser</env-entry-value>
<env-entry-type>java.lang.String</env-entry-type>
</env-entry>


2.4.5. Configure the password of the User
Replace "userpass" by the correct password of the database user


<env-entry>
<env-entry-name>db_password</env-entry-name>
<!-- enter the password of the database user -->
<env-entry-value>userpass</env-entry-value>
<env-entry-type>java.lang.String</env-entry-type>
</env-entry>

2.5. Start your MySQL Database and your Apache Tomcat.
Now you can access your jwp using the webbrowser:
http://ip_of_your_webserver:8080/jwp/admin

Replace "ip_of_your_webserver" by the IP of the workstation or server where your Tomcat is installed

2.6 Login with Admin Account

JWP Login

User: admin
Login: admin

2.7. Change the Admin User to your Name
Go to the User Administration and edit the Admin User.