Last updated: November 14, 2008
Author      : Robert Lor (robert.lor@sun.com)

1) Install PostgreSQL 8.2 or later on Solaris or OpenSolaris. This tool
   works with Solaris 10 10/07 (or later updates) or OpenSolaris 2008.05 (or later releases).

   a) For information on compiling PostgreSQL with DTrace enabled,
      see http://www.postgresql.org/docs/8.2/static/dynamic-trace.html or
      http://blogs.sun.com/robertlor/entry/user_level_dtrace_probes_in

   b) For information on using PostgreSQL on Solaris, see
      http://www.sun.com/software/solaris/howtoguides/postgresqlhowto.jsp

2) Setup the workload. If you just want to test the tool, you can use pgbench
   to generate the workload.

3) Install the GUI tool

   # pkgadd -d osolchime-i386-1.4-postgres.pkg (for x86)
   or
   # pkgadd -d osolchime-sparc-1.4-postgres.pkg (for SPARC)

4) Run the demo

   a) In one window, run the workload (you need to run this first before
      starting the GUI tool)

   b) In another window, as root, run the GUI tool

      # /opt/OSOL0chime/bin/chime &

   c) Currently, the following demos are available with the tool. More will
      be added later.

      1) PostgreSQL LWLock Acquires
      2) PostgreSQL LWLock Waits
      3) PostgreSQL Transaction Counts
      4) PostgreSQL Transaction Time

      Select any one of the above and click Run

   Instead of using the GUI tool, you can run the demo using the DTrace
   scripts in the dtrace_scripts directory. There are some scripts that 
   have not been integrated with the tool yet, but that will happen in the 
   next release.

If you have any questions, please send email to dtrace-general@pgfoundry.org or to me directly at robert.lor@sun.com.
