.::Tutorial, how to set up HoneyWeb::.
I) Introduction and Requirements
1. Introduction.
The goal of this tutorial is to explain how to set up Honeyweb on a development machine
- Introduction and requirements
- Eclipse installation
- Eclipse and Mysql configuration
-
Running and updating the project
I) Introduction and Requirements
1. Introduction.
The goal of this tutorial is to explain how to set up Honeyweb on a development machine
- You need a recent JDK (not JRE). For example get the last one from http://java.sun.com/javase/downloads/index.jsp.
-
Use this JDK to run eclipse as explained below.
II) Eclipse installation
The project runs on Eclipse Ganymede.
You can download it from: http://www.eclipse.org/ganymede/ .
Unzip the archive.
Before running Eclipse, please edit the eclipse.ini file located in the eclipse folder.
Insert before -vmargs :
-vm
/path-to-your-jdk/jdk1.6.xxbin/java (path to your java bin)
Or if you want to run eclipse from your terminal, add the option: -vm absolute_path_to_your_java_bin . (but you will have to think to add this option every time you start eclipse, do not forget it ! )
III)Eclipse and MYSQL configuration
1. Maven Installation.
Honeyweb is built on Maven and use several tools: Hibernate, Spring 2 and Tapestry 5.
Fortunately Maven will take care of all the dependencies and will download all the jars files required.
Downloading Maven plug-in for Eclipse:
On Eclipse click on "Help" -> "Software Updates" -> "Available Software" and finally click on "Add Site".
Use this URL to add m2eclipse update website: http://m2eclipse.sonatype.org/update-dev/
Once the site added, you will see "Maven Integration for eclipse Dev Update Site".
Select the right features to setup like below:
Follow the installation instructions then restart eclipse.
2.Subeclipse installation
(You can skip this part and checkout the project manually in your workspace from svn://128.8.135.114/svnrepos/gsoc, but Subeclipse is very convenient, especially for daily updates, commit and so on...)
The same way we installed Maven, we will now setup subeclipse which is a nice feature to use SVN embedded in the Eclipse framework.
The same way you added the Maven Update website, add the following for Subeclipse: http://subclipse.tigris.org/update_1.6.x
And select boxes like below:
Follow the installation instructions then restart eclipse.
Now we are able to import the project into our environment.
On eclipse, click on "file" -> "Import" -> "SVN"-> "checkout Projects from SVN" -> next (create a new SVN repository).
Type the following SVN url: https://projects.honeynet.org/svn/honeyweb/gsoc/, validate.
You should get a free access.
Chose the folder named "gsoc" and click on "Finish".
Congrats !!
3.Tomcat installation
HoneyWeb runs on Tomcat so....
Sometimes it doesn't work.... so install Tomcat manually, you can download it from http://tomcat.apache.org/, then extract the archive.
Do step 1,2,5,6 to finish the installation.
4.Mysql Installation
5.Hibernate configuration
First you need to install a hibernate tool for Eclipse. To do that go to help->install new softwares.
The update website is: http://download.jboss.org/jbosstools/updates/stable/
Restart Eclipse.
Finally you need to create a new hibernate console configuration, to tell hibernate how to communicate with your database.
To do that, in the workbench, click on new new->others, create a new hibernate console configuration and follow the steps:
Next, in Option chose Mysql (InnoDB) and click on OK.
IV)Running and Updating the project
1.Running
Just launch your Tomcat server, open your Internet browser and type http://localhost/gsoc/connect
2.Updating
If you want to update the project, right click on the project name, "gsoc". Then click on "team" and update to HEAD !!
If you get some Hibernate or MySQL errors, think about updating your MySQL dump from the SVN.
Downloading Maven plug-in for Eclipse:
On Eclipse click on "Help" -> "Software Updates" -> "Available Software" and finally click on "Add Site".
Use this URL to add m2eclipse update website: http://m2eclipse.sonatype.org/update-dev/
Once the site added, you will see "Maven Integration for eclipse Dev Update Site".
Select the right features to setup like below:
Follow the installation instructions then restart eclipse.
2.Subeclipse installation
(You can skip this part and checkout the project manually in your workspace from svn://128.8.135.114/svnrepos/gsoc, but Subeclipse is very convenient, especially for daily updates, commit and so on...)
The same way we installed Maven, we will now setup subeclipse which is a nice feature to use SVN embedded in the Eclipse framework.
The same way you added the Maven Update website, add the following for Subeclipse: http://subclipse.tigris.org/update_1.6.x
And select boxes like below:
Follow the installation instructions then restart eclipse.
Now we are able to import the project into our environment.
On eclipse, click on "file" -> "Import" -> "SVN"-> "checkout Projects from SVN" -> next (create a new SVN repository).
Type the following SVN url: https://projects.honeynet.org/svn/honeyweb/gsoc/, validate.
You should get a free access.
Chose the folder named "gsoc" and click on "Finish".
Congrats !!
3.Tomcat installation
HoneyWeb runs on Tomcat so....
- On Eclipse, Click on "file"->"new"->"Other"->"server"->"Apache"->"Tomcat6.0".
-
Browse and select the directory where you want Tomcat installation .
- then click on "Download and Install".
-
A background installation starts .
-
When it's done click on "next" .
-
Add our project named gsoc and click on "finish" .
Sometimes it doesn't work.... so install Tomcat manually, you can download it from http://tomcat.apache.org/, then extract the archive.
Do step 1,2,5,6 to finish the installation.
4.Mysql Installation
- Last step, get MySQL from http://dev.mysql.com/downloads/ . Set your own username and password
- You can get the dump SQL from the project in "gsoc"->"src"->"main"->"ressources"->(filename).sql
-
Honeyweb handle Java/MySQL communication with Hibernate. So you need to browse the project in Eclipse to edit the "hibernate.cfg.xml" located in :
"Java Resources"->"/src/main/resources/"
5.Hibernate configuration
First you need to install a hibernate tool for Eclipse. To do that go to help->install new softwares.
The update website is: http://download.jboss.org/jbosstools/updates/stable/
Restart Eclipse.
Finally you need to create a new hibernate console configuration, to tell hibernate how to communicate with your database.
To do that, in the workbench, click on new new->others, create a new hibernate console configuration and follow the steps:
Next, in Option chose Mysql (InnoDB) and click on OK.
IV)Running and Updating the project
1.Running
Just launch your Tomcat server, open your Internet browser and type http://localhost/gsoc/connect
2.Updating
If you want to update the project, right click on the project name, "gsoc". Then click on "team" and update to HEAD !!
If you get some Hibernate or MySQL errors, think about updating your MySQL dump from the SVN.