System Requirements for QARE

Qare requires:

• jdk1.2 or greater.
• MySql 3.23 data base installed in your system. It is available free.
• QARE software.
• PC with minimum Pentium® 166 MHz processor.
• Minimum of 64 MB RAM
• Standard Browser like Microsoft® Internet Explorer (IE) 5.x or above, Netscape® 6.x or Opera 6.0
• Windows or Linux Operating System.

How to Install and Configure QARE?

Qare Installation Guide For Windows:

• Download QARE.
• Unzip the downloaded zip in a directory of your choose.
• Go to bin directory and update the data.qconfig file. It must be configured either for web server(HTTP) or for email only.
• Make sure that MySql database is cofigured in your system and it's login name and password are specified in the data.qconfig file.
• Create a new database in mysql where all the QARE tables will be generated. For example, http_thing6_8080.
• Go to the bin directory and run resetDB.bat with the 'drop' argument at the end. The first time you run this, you will get a lot of exceptions. But then you will get a series of create messages at the end. First the program tries to drop all your old tables (which don't exist the first time you run it, thus the exceptions) and then it creates the new tables. It may seem to hang at the end of the program, but that's normal whenever you initialize the secure random number generator.
• Run startup.bat in the bin directory of qareOnTomcat.
• Direct your browser to http://hostName:8080/.Make sure that you don't type 'localhost' as hostName.It should be a specific name of your system.
• Go to login link and login as 'admin' with password as 'admin'.It will point to another page where you have to change password because username and password should not be same next time. After changing password, login with the new password. It will then point to the page displaying all the applications to which the admin user has privilege.
  

  Now you can create a new home account using createAccount application and then login with new account. You can then run other applica tions as well.

  You can run resetDB.bat for backup and restore:

  • Use 'drop' argument for dropping and then reinitializing all the tables from the database. (Normally only done once.) Note that drop does not change the public/private key pairs used for encryption and signing.
  • Use 'backup' argument for the backup of all tables.
  • Use 'restore' argument to restore the database.

Qare Installation Guide For Linux

• Download QARE.
• Unzip the downloaded zip in a directory of your choice.
• Go to bin directory and update the data.qconfig file. It must be configured either for web service or for email only.
• Make sure that MySql database is cofigured in your system and it's login name and password are specified in the data.qconfig file.
• Create a new database in mysql where all the qare tables will be generated. For example, http_thing6_8080 and then run mySql server.
• Go to the bin directory and run resetDB.sh with the 'drop' argument at the end. The first time you run this, you will get a lot of exceptions. But then you will get a series of create messages at the end. First the program tries to drop all your old tables (which don't exist the first time you run it, thus the exceptions) and then it creates the new tables. It may seem to hang at the end of the program, but that's normal whenever you initialize the secure random number generator.
• Run startup.sh in the bin directory of qareOnTomcat.
• Direct your browser to http://localhost:8080/.Make sure you don't type 'localhost' as hostName.It should be a specific name of your system.
• Go to login link and login as 'admin' with password as 'admin'. It will point to another page where you have to change password because username and password should not be same next time. After changing password, login with the new password. It will point to the page displaying all the applications to which admin user has privilege.

  Now you can create new home account using createAccount application and then login with the new account. Then you can test run other applica tions also.

  You can run resetDB.sh for backup and restore: .

  • Use 'drop' argument for dropping and then reinitializing all the tables from the database. (Normally only done once.) Note that drop does not change the public/private key pairs used for encryption and signing.
  • Use 'backup' argument for taking backup of all the tables.
  • Use 'restore' argument to restore the database.

Configuring Qare:

The data.qconfig resides in the bin of Tomcat-4.0. This file must be updated before running tomcat.

If you are using Dialup or LAN or a network configuration that doesn't hold static IPs or established domain name, you have to use E-Mail only configuration.

Example 1:Email Only Configuration

QARE gives you a virtual web service, given only an email address. The sample below includes the following configuration:

• Read mail every 30 seconds.
• Mail for QARE should be sent to fred@ispHost.net .
• The smtp server is smtp.ispHost.net.
• The pop server is pop.ispHost.net.
• The mail account name is fred.
• The mail account password is fredLikesFish.
• The driver name to access mysql is org.gjt.mm.mysql.Driver.
• The login name for mysql is freddy
• The mysql password is abc.
• The name of the database is http_thing6_8080.
• The time delay for refresh of web pages is 5.

<qconfig pollTime="30">
    <homeUrl>http://thing1:8080</homeUrl>
    <returnAddress>mailto:fred@ispHost.net</returnAddress>
    <smtp>smtp.ispHost.net</smtp>
    <pop>pop.ispHost.net</pop>
    <mailUserName>fred</mailUserName>
    <mailPassword>fredLikesFish</mailPassword>
    <dbClass>com.jxml.qare.qhome.db.DBAccount</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBAppData</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBAppTable</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBApplication</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBContentIdentifier</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBInbox</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBKeyPair</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBLocalPrivileges</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBPendingMessage</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBPrivilege</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBProject</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBRegisterInfo</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBRegisterPending</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBRemoteAccount</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBSession</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBSystem</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBUser</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBUserDelegations</dbClass>
    <sqlDriver>org.gjt.mm.mysql.Driver</sqlDriver>
    <sqlUser>freddy</sqlUser>
    <sqlPassword>abc</sqlPassword>
    <sqlUrl>jdbc:mysql://localhost/http_thing6_8080</sqlUrl>
    <spPriv>home</spPriv>
    <spPriv>login</spPriv>
    <spPriv>remote</spPriv>
    <limitWebService>500</limitWebService>
    <refreshInterval>5</refreshInterval>
 </qconfig>

Example 2:Web Server Configuration(HTTP)

If tomcat is running out on the internet itself, it can receive requests via HTTP POSTs. But it still needs to be able to send responses to systems which are only accessible via email.

The sample below includes the following configuration:

• The web address is http://www.goodFriends.com:8080.
• The email account is qare@goodFriends.com.
• The smtp server is smtp.goodFriends.com.
• The driver name to access mysql is org.gjt.mm.mysql.Driver.
• The login name for mysql is freddy
• The mysql password is abc.
• The name of the database is http_goodFriends_8080.
• The time delay for refresh of web pages is 25.

<qconfig >
    <homeUrl>http://www.goodFriends.com:8080</homeUrl>
    <emailAccount>qare@goodFriends.com</emailAccount>
    <smtp>smtp.goodFriends.com</smtp>
    <dbClass>com.jxml.qare.qhome.db.DBAccount</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBAppData</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBAppTable</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBApplication</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBContentIdentifier</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBInbox</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBKeyPair</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBLocalPrivileges</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBPendingMessage</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBPrivilege</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBProject</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBRegisterInfo</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBRegisterPending</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBRemoteAccount</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBSession</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBSystem</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBUser</dbClass>
    <dbClass>com.jxml.qare.qhome.db.DBUserDelegations</dbClass>
    <sqlDriver>org.gjt.mm.mysql.Driver</sqlDriver>
    <sqlUser>freddy</sqlUser>
    <sqlPassword>abc</sqlPassword>
    <sqlUrl>jdbc:mysql://localhost/http_goodFriends_8080</sqlUrl>
    <spPriv>home</spPriv>
    <spPriv>login</spPriv>
    <spPriv>remote</spPriv>
    <limitWebService>500</limitWebService>
    <refreshInterval>25</refreshInterval>
</qconfig>