|
QuickStartInstallGuide
Quick start setup guide for setting up the J2EE botlist web application (7/27/2008).
Quick start setupDate: 2/6/2008 OverviewThe botlist J2EE web frontend might be considered a medium sized web application. Make sure that you have a J2EE servlet container. Tomcat 5.5+ is recommended but not required. MySQL database server is required (expect a Postgres configuration in the future). The java build tool Ant is also required for building the project. Test Environment and Recommended Configuration
Download from Google Code (Botlist J2EE front-end)
There is an issue with hosting botlist on google-code. Botlist includes 50+MB of libraries and other modules. This is over google's upload limit and borders on the project limit. This means that the libraries needed to run botlist are broken into various download modules. (Especially the libraries needed for the botlist J2EE WEB-INF/lib directory). To remedy this problem, you need to download all the libraries and manually place them in the BOTLIST_WEBAPP_HOME/WEB-INF/lib. If any of the jar file libraries are missing then botlist may not function properly.
If you receive any errors while running botlist, first check if you downloaded all the libraries needed to run the web application. As of 7/2008; the following downloads are required: (Note: you can also download the libraries from Subversion)
Description of Downloads (as of 7/25/2008)
Subversion WEB-INF/lib directory Check out source from SubversionAs of 2/2/2008 Checking out the botlist source is the recommended way to get build and run the application. If you have access to SVN, use this method but you should also be able to download and run the botlist application from the code.google.com botlist homepage. In the future, regular releases and snapshots will be available, for now you can retrieve the latest source code. I extracted tomcat to my home directory for development. tomcat_home = ~/projects/tomcat/tomcat5526 cd ~/projects/tomcat/tomcat5526/webapps svn co http://openbotlist.googlecode.com/svn/trunk/openbotlist mv openbotlist botlist The project name is called openbotlist, it is best to change the directory name to just botlist because of URI references to 'botlist' in the web application. Run mysqld and setup the databaseStart the mysql daemon and create the databases.
Example output: Query OK, 1 row affected (0.00 sec) Query OK, 1 row affected (0.00 sec) Query OK, 1 row affected (0.00 sec) Query OK, 1 row affected (0.00 sec) mysql> source insert_link_groups.sql; At this point, you have created the MySQL database. Build the projectTo build the project, you simply need to enter the botlist web app directory and invoke the ant command.
Example output:
$ ant
Buildfile: build.xml
prepare:
[mkdir] Created dir: c:\projects\tools\home\projects\tomcat\tomcat5526\webap
ps\botlist\build
[mkdir] Created dir: c:\projects\tools\home\projects\tomcat\tomcat5526\webap
ps\botlist\build\classes
...
...Web application database configurationTo configure the application, you need to set the database parameters including username and password. cp example_botlist_config.properties botlist_config.properties Edit the botlist_config.properties file. botlist.db.url=jdbc:mysql:///openbotlist_development botlist.username=USER botlist.password=PASSWORD Run tomcat and navigate to the botlist siteAt this point, launch the tomcat server.
Resources |
Sign in to add a comment
