This Guide is arranged in such a way that if you follow the sequential order, it will lead you through the installation, configuration, and initial use of QARE.

• What is in this Documents?
• Introduction
• Getting Started
• Using QARE

What is in this Documents?

Audience

This document is intended for users (administrators) who want to use QARE.

Contents in this Document

In this document, you will learn:

• How to Install QARE services.
• How to configure QARE services.
• How to use QARE services.
• All of the unique features of the QARE services, as well as help you trouble-shoot any problems that you might have.

Contact Us

Please post your message in the QARE Forum to contact us for support: QARE Forum

Other Documents

For more information please see the following Documents:

Qare Internals
Qare Applications
Delegation Trust Model

Top

Introduction

What is QARE

QARE is an open portal for B2B and B2C services that builds on push, asynchronous messaging and P2P technologies. QARE offers very fast, distributed and secure web services. QARE uses both HTTP and SMTP/POP3 for message exchanges. QARE plugins are Java Servlets, packaged as WAR files. QARE strictly follows the Model/View/Controller model. MySQL is the database that QARE uses (fast and free), so some knowledge of SQL is helpful.

What Systems Does QARE Run On?

QARE runs on both Windows and Linux Systems. It has been tested on NT 2000 and Linux 7.1 with Opera, Netscape and Internet Explorer.

What Doesn't QARE Do?

QARE does not support passing of code and scripts from one system to another for security reasons, but uses XML Binding and agent technology for extensibility.

QARE doesn't support SOAP and other API based protocol, as these force the user to wait for the completion of a series of interactions across the internet (the World Wide Wait). Instead, QARE uses asynchronous messages/agents and push for delay-free interactions. (And when a response from a remote system is unavoidable, you always have the option of viewing the result later, at your convenience.)

How to Obtain QARE?

QARE is free and Open Source Software. License is GNU Lesser General Public License(LGPL). There are no restrictions on the QARE applications (plugins) that you develop. A binary distribution and Source code are available for free down load. However, any improvements to QARE itself must be submitted back to the QARE development team.

Assistance is provided by reply message at QARE Forum

QARE Links

Top

Getting Started

Setting Up Your Environment

Before you can run QARE, you must set up your environment. For help with installing QARE, see the Installation Guide. Once you have installed QARE and set up your environment, the next step is to initialize the admin account and register. Just direct your browser to http://hostName:8080. Make sure you don't type 'localhost' as hostName. It should be a specific name of your system. You will be logged in as anonymous.

Create Your User Account

Qare provides three types of user acoounts. After installation as you run QARE by default you will be logged in as anonymous. The other two types of user accounts are the 'home user' account and the 'remote user' account.

Being an anonymous user you will be given the minimum access privileges to createAccount and login applications.

Create your home user account using createAccount application. Now if you enter as home user you can view all the privileges that have been granted by the Administrator using Delegation Display application by setting the project as home and delegation distance as 1. The Administrator has authority to assign new privileges or rescind assigned privileges. The home user has allmost all privileges that the anonymous and remote user have. As a home user you have the privilege to activate a remote account.

Create a remote account using remoteAccount application. As a remote user you can view all the privileges that have been granted by the Administrator from Delegation Display application by setting the project as home and delegation distance as 1. The Administrator has authority to assign new privileges or rescind assigned privileges.

Top

Using QARE

The QARE GUI system allows users to access many of the powerful features of the QARE to create interactive applications. Beginners will find it to be a very comfortable, yet powerful, interface to the many capabilities of QARE applications, one that does not require knowledge of object-oriented graphics programming.

Getting Applications

QARE has a number of applications that you can use for various purposes. You can use individual application separately. To know about various applications of QARE go to Application Page. "appDir" application is one of the important application that you encounter first. This application gives you a list of all the applications you have access permission. It also gives you the link to the application help pages where you will get information about how to use the application.

Since you are logged on as anonymous user you have the default access permission to login and create account applications. Hence go to the login application and login as 'admin' with password 'admin'. It will bring you another page that is "change password" where you have to change password because username and password should not be same next time for security purposes. Now if you login as admin user with the changed password you will get all the applications to which admin user has privilege.

You can also create your own home account using Create Account application to get a list of applications to which admin has granted access privilege.

Registration and Activation of Remote Account

Now you have list of all applications. Go to the registration application and register to connect with all other users. The next step is to activate an account on a remote system using remote account application. The delegation display gives you facility to view all the privileges you have been granted on that remote system and refreshes automatically to update the privileges.

Ping a Remote System

Ping application is one of the most important features of QARE that gives you facility to make a request to the remote system where you already have an account and view the response message synchronously. You can close the ping application. The ping request refreshes automatically and as soon as the response message is received it goes to the Inbox. Later at any time you can view the details of response message from the Inbox.

Delegate Privileges

Now you can delegate the required privileges which you have not on the remote system using Delegation application. You can view the delegated privileges with the help of delegation display.

Use Count application to view the top ten users on the basis of inbox message, open channels and total number of delegees.

Delete Remote Account

If you desire you can delete an account on remote system(s) using Delete Remote application.

Create User Groups

If you are not logged in as 'admin' user then you can create personal user groups using User Groups application. You can include other users in the personal group by delegating the group privilege to them.

Top