Read Me

Swana Installation and User Guide


System Requirements
-------------------
* Microsoft Windows XP/Vista/2003 Server, Linux 2.4 or later, Mac OS X 10.4 or later
* JDK 6 Update 14 or later(http://java.sun.com/javase/downloads/index.jsp)
* MySQL 5.0.51 or later(http://dev.mysql.com/downloads/)


Setup Environment
-----------------
* Install JDK 1.6
* Install MySQL 5.0
* Create the MySQL database user ("swana") and database ("swana"), you can change them to any name you want.


Install Daemon of Swana
-----------------------
* Unzip SwanaDaemon.zip to any directory you want.
* Open "conf\datasource.properties" to change database connection URL, user name and password.
* Import IP address data:
	(1) Open a command line window and change to the installation directory
	(2) Type "mysql -u swana -p"
	(3) Enter password for user "swana"
	(4) Type "use swana"
	(5) Type "source data_ip_countries_code.sql"
	(6) Wait until importing is done, this will take long time
* Run startup.bat or startup.sh to launch daemon of swana to track the visit to your website.


Install Administrative Web App of Swana
-----------------------------------
* Copy SwanaAdmin.war to the directory "webapps" inside the Tomcat installation.
* Startup Tomcat to deploy the SwanaAdmin.war, you will see failure.
* Shutdown Tomcat.
* Open and edit file "webapps\SwanaAdmin\WEB-INF\classes\swana-config.properties", change "dataSource.url"úČ"dataSource.username" and "dataSource.password" with your own database parameters.
* Re-startup Tomcat.
* Visit URL http://localhost/SwanaAdmin/user/init in browser to init the "administrator" user, you will see login page when it is done.


User Guide for Swana
--------------------
* Login SwanaAdmin with username/password = admin/123456
* Set "Setting -> Host" to the domain of Swana daemon, like "www.swana.org"
* Register webpages:
	(1) Go to "Pages -> Register Webpages"
	(2) Enter page name, page URL, page group and etc.
	(3) Save the page registration.
	(4) You will see a script after you saved registration.
* Put the script you got from webpage registration to any part ot the HTML file(bottom of it is recommended)
* Repeat Webpage Registration to track other webpages.
* After everything is done, any visit to your webpages with script inside will be tracked.