Recent Changes - Search:

CONGO

PmWiki

edit SideBar

WindowsInstallation

Main.WindowsInstallation History

Hide minor edits - Show changes to output

Changed line 8 from:
XAMPP is an excellent 'all in one' Apache + MySQL + Perl + PHP environment for Windows.  Once installed, it gives an Apache server, a MySQL database, and a fully configured PHP environment.  Note: Skype uses the same port that MySQL wants, and if Skype is already started, the MySQL server will not start!
to:
XAMPP is an excellent 'all in one' Apache + `MySQL + Perl + PHP environment for Windows.  Once installed, it gives an Apache server, a `MySQL database, and a fully configured PHP environment.  XAMPPlite will also work.  Note: Skype uses the same port that `MySQL wants, and if Skype is already started, the `MySQL server will not start!
Changed line 8 from:
XAMPP is an excellent 'all in one' Apache + MySQL + Perl + PHP environment for Windows.  Once installed, it gives an Apache server, a MySQL database, and a fully configured PHP environment.
to:
XAMPP is an excellent 'all in one' Apache + MySQL + Perl + PHP environment for Windows.  Once installed, it gives an Apache server, a MySQL database, and a fully configured PHP environment.  Note: Skype uses the same port that MySQL wants, and if Skype is already started, the MySQL server will not start!
Changed line 48 from:
<pre>
to:
Changed lines 51-52 from:
   Options Indexes MultiViews
    AllowOverride None
to:
   Options Indexes `MultiViews
    `AllowOverride None
Changed lines 56-57 from:
</pre>
to:

Added line 48:
<pre>
Changed lines 56-57 from:
to:
</pre>
August 08, 2008, at 04:18 PM by dbs - added xampp configuration stuff.
Added lines 42-57:
!!Configuring XAMPP to point to the correct dir
XAMPP's default configuration won't be able to find where CONGO and Coconut are installed.  To change this, cd to where Apache's configuration files are store:

 cd C:\Program Files\xampp\apache\conf

Use your favorite editor to open up httpd.conf, and somewhere in the file (at the bottom should be fine), add the following text:
 Alias /congo "c:/My Documents/congo/"
 <Directory "D:/My Documents/congo">
    Options Indexes MultiViews
    AllowOverride None
    Order allow,deny
    Allow from all
 </Directory>

obviously, substituting the appropriate paths for where you installed CONGO.  Save the file, and restart Apache through the XAMPP control panel.  If you point your browser at http://localhost/congo/ you should see CONGO's top level directory.

August 08, 2008, at 09:39 AM by dbs - Fixed svn url.
Changed lines 36-37 from:
Open up your Windows explorer, and navigate to a directory where you'd like to put CONGO.  Right click on the panel, and you should see 'SVN Checkout...' as one of the options.  Select that, and for the SVN URL, use 'svn://svn.stonekeep.com/stonekeep/congo/trunk/'.  Select a checkout target directory, and click Ok, and you should get a checked out copy of CONGO copied to your computer.  Simple!
to:
Open up your Windows explorer, and navigate to a directory where you'd like to put CONGO.  Right click on the panel, and you should see 'SVN Checkout...' as one of the options.  Select that, and for the SVN URL, use:

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

Note that access to the repository as of mid-2008 now requires a username and a password.  If you don't have access to SVN, contact Stonekeep to get authorization
.  Select a checkout target directory, and click Ok, and you should get a checked out copy of CONGO copied to your computer.  Simple!
Changed line 45 from:
Once all the imports are complete, CONGO should be ready to run.
to:
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.
Changed line 4 from:
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/.
to:
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.
Added lines 33-37:
!!Checking out CONGO from SVN via TortoiseSVN
If you don't have an already checked out copy of CONGO, you can use Tortoise SVN to fetch it. 

Open up your Windows explorer, and navigate to a directory where you'd like to put CONGO.  Right click on the panel, and you should see 'SVN Checkout...' as one of the options.  Select that, and for the SVN URL, use 'svn://svn.stonekeep.com/stonekeep/congo/trunk/'.  Select a checkout target directory, and click Ok, and you should get a checked out copy of CONGO copied to your computer.  Simple!

Changed line 10 from:
All of CONGO is stored in a Subversion repository.  To access the repository, you'll need an SVN client.  For windows, Tortoise SVN, available at http://tortoisesvn.tigris.org/ is an excellent Explorer-embedded SVN system for working with SVN repositories directly from Windows.
to:
All of CONGO is stored in a Subversion repository.  To access the repository, you'll need an SVN client.  For windows, Tortoise SVN, available at http://tortoisesvn.tigris.org/ is an excellent Explorer-embedded SVN system for working with SVN repositories directly from Windows.  If you're downloading CONGO via a source tarball or zip file from the website, you won't need the Tortoise SVN client.
Added lines 14-32:
!!Setting your system paths
In order to work properly from the command line, your windows shell needs to have the JDK binary directory and the Ant binary directory on the system path.  To do this, right click on your "My Computer" icon and open System Properties.  On the Advanced tab, click on the button marked Environment Variables.

Under System Variables scroll to find the 'Path' variable, and double-click on it.  Be careful you do not wipe out the existing value here, and add to the value the path to the JDK you installed, something like:

 C:\Program Files\Java\jdk1.6.0_01\bin;

Make sure you leave a semicolon (;) between each path.  Also add in the path to the Ant binary directory, like this:

 C:\Program Files\ant\apache-ant-1.7.0\bin;

Click 'ok' on up through the windows to close everything out.  The path goes active immediately, so you can test to make sure it works by opening up a command shell (start->run, 'cmd'), and typing the word 'ant'.  You should see something similar to this:

 C:\>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.

August 01, 2007, at 09:08 PM by dbs - initial docs on prerequisites.
Added lines 1-13:
!!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/.
* '''Apache ANT'''\\
Ant is a build tool developed specifically for building and manipulating Java products.  Download a binary ZIP file of version 1.6 or later from http://ant.apache.org/ and install it in any directory (it has no Windows installation script, we'll reference it in a minute.
* '''XAMPP'''\\
XAMPP is an excellent 'all in one' Apache + MySQL + Perl + PHP environment for Windows.  Once installed, it gives an Apache server, a MySQL database, and a fully configured PHP environment.
* '''Tortoise SVN'''\\
All of CONGO is stored in a Subversion repository.  To access the repository, you'll need an SVN client.  For windows, Tortoise SVN, available at http://tortoisesvn.tigris.org/ is an excellent Explorer-embedded SVN system for working with SVN repositories directly from Windows.
* '''JEdit'''\\
Actually, any editor will do, I like using JEdit, a pure java editor available from http://www.jedit.org/, but really any decent text editor (even Notepad if you're particularly narcissistic) will do fine.

Added lines 1-8:
!!Creating the database with PHPMyAdmin
Part of the XAMPP installation included PHPMyAdmin, which can be used to create the tables CONGO requires.

After creating the database instance, select it, and click on the 'import' tab in PHPMyAdmin.  There will be a prompt for 'Location of the text file'.  You can use the Browse button to navigate to your CONGO installation directory, and select the subdirectory 'structs'.

Import and execute every file in that directory.  Unfortunately, you'll need to do it one at a time.

Once all the imports are complete, CONGO should be ready to run.
Edit - History - Print - Recent Changes - Search
Page last modified on August 17, 2008, at 11:54 AM