Last updated: March 29, 2009
Author      : Robert Lor (robert.lor@sun.com)

1) Install the GUI tool. The tool only works on OpenSolaris for now.

   # pkgadd -d OSOl0chime-i386.pkg (for x86)
   or
   # pkgadd -d OSOL0chime-sparc.pkg (for SPARC)

2) To test the tool, install PostgreSQL 8.2 or later compiled with DTrace
   on OpenSolaris. This tool works with 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

3) Setup a workload of your choice. Use pgbench if your don't have access to
   other workload.

4) Run the demo

   a) Start the GUI tool in one window.
      # /opt/OSOL0chime/bin/chime &

   b) In another window, run a workload

   c) Follow the instructions in the tool to execute various traces.

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 directly to me at robert.lor@sun.com.
