IBBS README FILE
==========================================
iBBS is a forum software that is written in JSP(java server page),So it can run on 
nearly every platform range from winX to Linux.This version v1.0 is totally free,
you can change the code as you like,and redistribute the code as you wish.


Prerequisites:
===============
a,You need a jsp server software,There are many these softwares you can get for free,I 
recommand Resin,the fastest jsp engine .and it's small and free,you can download it 
from www.caucho.com,iBBS is developed on Resin1.2.5 .Also ,you can choose 
Tomcat,Jrun,or huge ones like weblogic,webSphere...

b,Get the most recent jdk, New version of jdk means more speed and more function,iBBS 
need at least jdk1.3 .

c,Put more memory on your machine.We need at least 64M.


1)Installation:
======================
a. The installation is very simple.Just unzip the ibbs.zip to a temp directory,you 
will find 2 sub directories in it. They are "ibbs" and "dbcon" .

b."ibbs" is the main jsp directory.It includes all jsp files and some html files and 
a few pictures.Move "ibbs" into the jsp execute directory of your JSP server(if you 
are using Resin,the default path is /resin-1.x.x/doc/).After that,it looks like 
"/resin-1.x.x/doc/ibbs".

c."dbcon" is a directory contains several java beans(small component),it should be 
put into servlet execution directory of you jsp server.In Resin ,it is "/resin-
1.x.x/doc/Web-inf/classes". After that,it looks like "/resin-1.x.x/doc/Web-
inf/classes/dbcon".

d.Find a MS Access database file named "ibbs.mdb" in ibbs directory ,following 
control panel-->ODBC Data Source-->system DSN-->add a DSN named ibbs,link this 
dsn to the db file "ibbs.mdb".

e: Then it's done,type http:\\127.0.0.1\ibbs\index.html in your web browser.regist a new name
or just use username:"test",password:"test".Login and enjoy.the Administrator account is 
username:"admin",password:"admin".


2)Function discription:
===============================
a.Post and reply acticles.each user can have his own signature.

b.Send internal messages between each user,messages will arrive in 20 seconds and a red bar alert
"you got mail" in the left corner.

c.You can open multi boards concentrate on discussing different topics,each board can have it's
own board administrator.board administrators have the rights to delete and add "cool" to the 
articles in their boards.

d.Search all articles use a keyword.

e.The "admin" account is reserved as the administrator of the whole iBBS.he can delete and add "cool"
to all articles in iBBS. and many rights to manage the database,include:
.manage user account
.open and destory boards,alter board name,change board administrator.
.check where and when each user comes(system Log).
.use sql to manage database directly.


3)Need to know:
===============================
a.The administrator account is username:"admin",password:"admin".please change the password and
keep it ok.

b.Please keep all directory name and file name in low case.it's very important when you use iBBS
in *nix system.


FAQ :
==================

Q.How much is the full functional iBBS,is it free?
A.It's totally free.A email tell me that you are using it will make me very happy.

Q.I need run this bbs in my Linux-Mysql box,What should I do?
A.You can do it via 2 ways:
  1.Create a new database named "ibbs" in mySql,use mysql ibbs<ibbs.sql to import the structure into
    your new database.
  2.If you have already set your Jsp engine,you can first alter the jdbc link in mydb.java in dbcon
    directory,then run initdb.jsp in your ibbs directory.

Q.I use mm.mysql driver as my jdbc driver,but bbs throws exception ,why?
A.you need the new mm.mysql jdbc driver. 1.2 seems not support scrollable Resultset ,2.0b is ok.



Ji Wang
oasisor@163.com