WebInstant 0.5  README


Before installation, make sure you have

  1. A web server which supports Java servlet. For example, Apache and JRun.
  2. A database. For example, MS access, SQL, Oracle, Sybase, Mysql...
  3. NOTE: you can install all these on a computer seperate from your website
     server machine. 

      Apache can be downloaded free from: http://www.apache.org.
      JRun can be downloaded from http://www.livesoftware.com.


After installation, you should take the following steps:

  1. Copy the html files to the doc root of the webserver (where you installed 
     WebInstant) or create aliases for them in the conf file of the web server. 
     If your website is on a different computer, you need create the link to the
     chat urls which you want display to the outside. 
  2. Copy the instant.properties and instant.admin to the proper location where 
      the servlet run. For example, for JRun, it should be copied to 
      (the JRun root dir)/jsm-default/properties/.
  3. Add the instant.jar to the servlet class path. For example, in case of JRun,
      you can either add it manually to .../jsm-default/properties/jsm.properties 
      or you can do it with the JRun administrator: General->Java->Java Classpath.
  4. If you use a JDBC driver other than jdbc-odbc bridge you need add the corresponding 
      driver's java class jar file to the servlet path.
  
A case study:

  1. You have a website and is running apache or whatever web server.
  2. You have a spare computer: an NT workstation, THEN:
  3. install MS access on NT, and create a database. Add a System DSN linked to this 
     database you have created and call it "db_im" (or whatever name)
  4. install apache on NT, try http://localhost/, it should work.
  5. install JRun on NT, try http://localhost/servlet/HelloWorldServlet/, it should work.
  6. install WebInstant. for JDBC url, enter: jdbc:odbc:db-im and leave username and
          password empty. 
  7. copy instant.properties and instant.admin to the Jrun folder of jsm-defalut/properties/
  8. start admin of Jrun, add instant.jar to the servlet path.
  9. copy all the html files of WebInstant to the apache doc root. Then 
          try http://localhost/msg.html and click on "here". Please register.
 10. If it goes fine, you are almost done. Just add some links to these html files
          on your real webserver. THIS IS IT!

 

About instant.properties and instant.admin

  1. If you installed WebInstant by using the zip (tar) files (instead of Installer),
     you need manually add the jdbc information to the instant.properties. You also need
     add the admin information to the instant.admin file.
  2. Copy these two files to the proper directory as described above.

