-*- text -*-

* HTTP server version

The HTTP server version is made up of two customzied HTTP servers
written in Python. They are:

  ipp-server.py which, without arguments, run on port 8000 on any
  network interface available. It depends on ipp.py for the
  paymentorder class.

and

  seller-server.py which,  without arguments, run on port 4000 on any
  network interface available. It depends on seller.py for its version
  of the paymentorder class.

Place all these files in the same directory and start them with
something like:

  $ ipp-server.py

and

  $ seller-server.py

this is depending on that your Python interpreter can be found in
/usr/bin/python. If it's not, you can either change the first line of
the scripts from

  #! /usr/bin/python

to show where the interpreter lives or you can start them by
explicitly calling the interpreter yourself, like this:

  $ python seller-server.py

Before attempting to run anything, please see the section Paths and
URLs below

* Pure CGI Version

For the pure CGI version, you provide your own HTTP server(s). Place
all these in the same directory:

  ipp-approval.cgi
  ipp-deal.cgi
  ipp-order.cgi
  ipp.py

  seller-deal.cgi
  seller-order.cgi
  seller.py

or, possibly, in the same directory on the IPP server and the seller
server, if you split them.

* Paths and URLs

For both the standalone and the CGI versions, you will need to change
some hardcoded paths and URLs in the scripts.

The ipp-seller.py needs to be run with a uid that has write access to
wherever you point the self.dbfile path in in ipp.py.

In the ipp.py file (as well as seller.py, but this is not currently
used) you will have to change self.dbfile into a path pointing to
where you want to store the transaction database.  You _will_ need to
change this.

You will then have to change the host names and paths pointing to each
other in the files. Search for "localhost" and change all occurences
to the real machines involved.

* Other Files

You will find a file called order.html which you can view with a web
browser to initiate a transaction. You will have to change the URL in
the form to match your installation.

There's a small performance test in perf.py. Change the URLs according
to your system. The script is dependent on perfmod.py.
