• View
• Edit
• History
• Print

LinuxInstallation

Install pre-requisite software

If you are comfortable with Java development, generic tools can be used to replace the more advanced environments. You may also use your own editor for code modifications and configurations. These are the tools I've found best match the environment CONGO was developed in. In the future, I hope to be able to adapt the code to more traditional Java environments, using Eclipse for better IDE support, as well as using a normal servlet container, but for now, these are the pieces that have to be used.

• Sun Java JDK 1.5 or later
  Because CONGO is a product in constant development, a JDK is highly recommended to allow source code builds on the fly directly from the SVN repository. Download and install the Sun JDK from http://java.sun.com/. For clarification, you want the Sun Java SE JDK.
• Apache ANT
  Ant is a build tool developed specifically for building and manipulating Java products. Download a binary version 1.6 or later from http://ant.apache.org/ and install it in any directory
• MySQL?
  You'll need MySQL? v5.0 or later. Install according to your distribution.
• Apache Webserver
  Apache 2.x is highly recomended.
• PHP
  PHP v4.0 or later is highly recommended.
• SVN
  If you'll be running a source code distribution of CONGO, you'll need an SVN client.

Setting your system paths

Make sure the path to your JVM (or JDK for source code versions) is on your path, as well as a path to the Ant binary directory.

After setting the paths, check to make sure they work:

 $ ant
 Buildfile: build.xml does not exist!
 Build failed

The error message is fine, that's just Ant saying it can't start up in the current directory. Don't worry about it for now, we'll give it work to do later.

Checking out CONGO from SVN via svn command line

You will require a login and password to the SVN repository from Stonekeep. Contact info@stonekeep.com to receive a username and password.

Navigate to a directory where you'd like to unpack CONGO. Check out a working version from SVN using the following command:

 $ svn checkout http://svn.stonekeep.com/svn/congo/trunk

This will check out a working copy of the current 'trunk' version of CONGO.

Create the database instance

You should know how to do this already, but the basics for creating a MySQL? instance and setting grant permissions is:

 mysqladmin create congo  (you may need to be root, or supply an administrators credentials here)
 mysql congo
 grant all privileges on congo.* to congo@'localhost' identified by 'congo'
 flush privileges
 exit

Creating the database tables

Change to the congo subdirectory 'structs', and look for the 'do.sh' script. This is a skeleton script designed to load all the MySQL? tables into congo.

Depending on your permissions, you should be able to run the load script from the command line. Note you should replace 'congo' with whatever the name of your database instance is set to.

 $ ./do.sh congo

and the 'congo' MySQL? instance will be populated. If you have set up username and password settings, you may need to modify the 'mysql' line in the script to supply the credentials.

Once all the imports are complete, CONGO should be ready to run. Your next step should be setting up the server. See ServerConfiguration for details on that.