This document was written to give new developers a quick way of setting up a complete local development environment. It is important that the process is easy and we will continue to make the process easier in the future.
This tutorial will initially describe how to get started with Eclipse as the development tool, Apache Tomcat as the servlet runner and MySQL as the database server.
This document is always a work in progress so mail any suggestions to info@infoglue.org and I will try to improve it as the platform evolves.
Download latest JDK (must be 5.x or higher) here http://java.sun.com/javase/downloads/index.jsp and install it. Afterwards you need to set some environment variables:
You add this to your profile or another appropriate script or run it directly on the command line:
export JAVA_HOME="/usr/local/jdk1.5.0_14"
export CATALINA_OPTS="-Djava.awt.headless=true -Dfile.encoding=ISO-8859-1 -XX:MaxPermSize=256m -Xms512M -Xmx1024M"
You add two variables in Environment variables (under Control panel --> System):
JAVA_HOME: c:\Program Files\Java\jdk1.5.0_09
CATALINA_OPTS: -Djava.awt.headless=true -Dfile.encoding=ISO-8859-1 -XX:MaxPermSize=256m -Xms512M -Xmx1024M
Fetch a late version (at least Tomcat 5.5.x) of Apache Tomcat.
Get it at http://tomcat.apache.org - http://ftp.solace.miun.se/pub/apache/tomcat/tomcat-5/v5.5.25/bin/apache-tomcat-5.5.25.zip for example.
Install it as usual and start it in console mode (on windows) so you see any errors etc in the output. If you run on linux – start it and tail catalina.out.
Test with the browser on http://localhost:8080/infoglueCMS.
Download mysql here: http://dev.mysql.com/downloads/mysql/5.0.html#downloads
Install as described by their document. If you want to have Unicode sites remember to state that when configuring the database.
A user contributed on the subject of mysql and unicode:
Do the following to make it work with MySQL 5.0 and UTF-8 before installing InfoGlue / creating it's database:
Add the following to the [mysqld] section of /etc/mysql/my.cnf:
default-character-set=utf8
This tutorial expects that you have downloaded and installed Eclipse already. It is available from http://www.eclipse.org. You must have the latest Eclipse 3.3 (Europa). We strongly suggest you download the Eclipse IDE for Java EE Developers.
The first thing to do is to fetch the InfoGlue projects you need from our cvs. It is done by first registering the cvs in question.
Switch to the CVS-view in eclipse by pressing the cvs-icon marked in red. The next view will look like this:
Now add a new repository location by pressing the marked button. The dialog will look like below. Use the values below and press “Finish” when you are done.
Now the repository location will be visible as below:
You can now browse the CVS by clicking on the plus-sign. Navigate to the module infoglue as below and right-click on it and select “Check out as..”.
Now you will be asked where to put the project and you can go with the default. Follow the wizard through – no need to specify much.
After you press “Finish” here the project will be downloaded to your location and the project registered in eclipse. Now you can switch over to the java-view again by clicking the java-button or in the way your version of Eclipse functions.
Now you will see the project in your left menu and you are about done.
For InfoGlue to work it has to have a database available. The easiest way to get a database is to run the commands in the file infoglue/src/sql/developerMYSQL/developersMYSQL.sql:
You must also create a database account for the user you want to use or use the root-account which is fine also on your development environment. Look at mysql-documentation on how to do create accounts if you want a special account for InfoGlue.
Then you edit build.properties in the infoglue-repository to reflect your local setup. The parameters of interest are:
These properties are those you need to modify to reflect your local setup:
deploy.dir.shared=c:\\Program Files\\Apache Software Foundation\\Tomcat 5.5\\shared\\
deploy.dir.cms=c:\\Program Files\\Apache Software Foundation\\Tomcat 5.5\\webapps\\infoglueCMS
deploy.dir.working=c:\\Program Files\\Apache Software Foundation\\Tomcat 5.5\\webapps\\infoglueDeliverWorking
database.url=jdbc:mysql://localhost/infoglue?autoReconnect=true&useUnicode=true&characterEncoding=UTF-8
database.user=youruser
database.password=yourpass
portletBase=c:\\Program Files\\Apache Software Foundation\\Tomcat 5.5\\webapps\\
portletBase.working=c:\\Program Files\\Apache Software Foundation\\Tomcat 5.5\\webapps\\
mail.smtp.host=mail.mydomain.com
systemEmailSender=xxxx@xxxx.xx
administratorUserName=root
administratorPassword=habba
administratorEmail=xxxxx@xxxxx.xx
When you save this file after modifying the settings to your environment Eclipse should build InfoGlue to the deployment directory.
Start/Restart Tomcat and try to browse http://localhost:8080/infoglueCMS
Now if everything works we suggest you also install the Eclipse IDE Plugin for InfoGlue.