Courselist - Check out development environment

How to create package

Until course list project release a war version package, users need to check out code from cvs and build war file with maven.

Check out from CVS

Pull out courselist module from cvs server by following this script. Make sure cvs client is properly installed before doing this.

                
                        
[...]$ cvs -d :pserver:anonymous@cvs.sourceforge.net:/cvsroot/cyclops-group login
(Logging in to anonymous@cvs.sourceforge.net)
CVS password:
[...]$ cvs -d :pserver:anonymous@cvs.sourceforge.net:/cvsroot/cyclops-group co courselist

This can also be done within wincvs . Download and install wincvs , check out the courselist project from sourceforge cvs server. CVSROOT is

                :pserver:anonymous@cvs.sourceforge.net:/cvsroot/cyclops-group

. If you have an account in sourceforge, change anonymous to the account name so that you will be able to change and commit the code. The module name is courselist.

Assume the project is checked out to C:/projects/courselist.

Install MySQL

Download and install mysql 4.1 from mysql.com . Mysql 5.0 is not fully supported by hibernate so far, so make sure to install version 4.1 or earlier version.

Create a database in mysql called courselist.

                
                        
[...]$ mysql -u root -p
Enter password:
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 3 to server version: 3.23.58

Type 'help;' or '\h' for help. Type '\c' to clear the buffer.

mysql> create database dummy;
Query OK, 1 row affected (0.09 sec)

mysql> quit
Bye

Then create a user "dev" in mysql, password is "dev" as well. You can download and install mysql adminsitrator to do it easily.

Install Apache Tomcat

Download and unzip apache tomcat 4.1.x from http://tomcat.apache.org/download-41.cgi . Assume the unzipped directory of tomcat is C:/java/apache/jakarta-apache-4.1.31.

Install Apache Maven

Maven is a building and project managing tool which can be considered as a replacement of ant. Currently the courselist project is managed and built by maven 1.0.2.

Download and unzip maven 1.0.2 from http://maven.apache.org/start/download.html , unzip it to a directory. Assume the directory is C:/java/apache/maven-1.0.2. Append C:/java/apache/maven-1.0.2/bin into the system path.

Create file C:/Documents and Settings/<your windows user name>/build.properties. Copy the following content into this file.

                
                        
maven.repo.remote=http://cyclopsgroup.com/lib,http://www.ibiblio.org/maven
maven.test.skip=true
maven.compile.encoding=UTF-8

maven.appserver.home=C:/java/apache/jakarta-apache-4.1.31
maven.appserver.name=tomcat
maven.appserver.version=4.1.x

maven.jar.override=on
maven.jar.tools=${java.home}/../lib/tools.jar

Deploy and run

The war file is completely container neutralized. This means technically it can run on any Java servlet container such as tomcat, weblogic or even jetty. To run it in tomcat, following the instruction.

                
                    
[...]$ cd C:/projects/courselist
[courselist]$ maven resetdb
//This command will create tables and insert init data in database
...
...
[courselist]$ maven appserver:install
//This command copies some necessary files from tomcat to local
//in order to run start development server.
...
...
[courselist]$ maven war:webapp
//This command copies the files in this project into local tomcat
...
...
[courselist]$ maven appserver:start
//This command start the development tomcat server
...
...

If the server is successfully started, visit http://localhost:7080/courselist to see the home page. Log in as admin(password is admin) to try the functions.