| KATO | Everyone needs a sidekick |
For those in a hurry, there is the getting started guide. Here, you will learn the quick commands for getting latest and how to code the ubiquitous Hello World agent in both PHP and Java.
Here is what you need to do in order to get KATO running on your developer box.
If you haven't already done so, you need to install Apache, PHP, and MySql on your machine. Make sure that both the web server and the database server is correctly running.
Create a directory somewhere under your home directory. Launch a command line terminal and change the current directory to the directory that you just created in the first step.
Get latest from the sourceforge subversion repository like this.
svn co https://kato.svn.sourceforge.net/svnroot/kato kato
You can create the database like this (assuming that you are running the database on the same machine).
mysql -h localhost -u root -p
create database kato;
Exit from that then change directory to the etc folder created by the subversion checkout command. Fire off the createDB SQL script to the newly created database like this.
mysql -h localhost -u root -p kato <createDB.sql
Change directory to the document root folder as proscribed in the httpd.conf file. This is an Apache file. Create a new directory under this directory. Copy the files from the htdocs folder created by the subversion checkout command to this newly created directory.
Edit the dbh.php file to specify your database connection settings.
Download version 2.7.0 of YUI and copy the build directory (and sub-directories) to your web project folder.
Java developers should follow these steps to get their first KATO agent running.
First of all, you are going to need to download and install JADE. Create or download your sample agent and compile it with the JADE environment. You will need to run the jade.Boot class with the -conf parameter which should cause this GUI to appear.
The host should be the name of your developer machine and the agents should start with test: and continue with the name of your class. Click the run button.
PHP developers should follow these steps to get their first KATO agent running. Create a PHP file containing something like this code.
Save this file in the kato folder that you created under the apache document root directory.
Point your web browser http://localhost:8180/kato where kato is your installation folder. This URL assumes that apache is listening on port 8180 so correct that if your instance of apache is listening somewhere else.
Click the sign in link and provide the following credentials. User Name: asdf Password: asdf
Click the Catalog menu along the left hand side and the Add button in the middle.
The code should be something unique like hello and the class name should be HelloWorldAgent. The include file should be whatever file name that you saved the above code as. Click the add button.
Click the Schedule link on the left hand side. Click the add button in the middle.
Select the newly created agent from the catalog drop down list (what you entered in the code field). The two check boxes should not be checked. Click the add button.
Click the process link located in the middle of the horizontal navigation bar along the top. After that page completes loading, you can check the message log.
Click the message log link along the left hand side. Near the bottom of the search results will be two messages, one that says watch and the other says hello, world.
Congratulations, you have just created your first KATO agent!