
  How to compile gnuplot and its prerequisites and 
  how to download base64 binary
  --------------------------------------------
  (Solaris 10 OS platform instructions)

  gnuplot/compoents     Source file URLs
 ----------------------------------------------------
   1. gnuplot 4.1        http://www.gnuplot.info
 * 2. gd library 2.0.33  http://www.boutell.com/gd
 * 3. automake 1.9       http://www.gnu.org/software/automake
 * 4. autoconf 2.59      http://www.gnu.org/software/autoconf

 *-- prerequisite components

  Step-by-Step procedure to compile gnuplot:
  ------------------------------------------

  This instruction uses GCC compiler to compile
  gnuplot and its required components.
  Solaris 10 system bundles the GCC compiler
  in /usr/sfw/bin directory. Add both GCC 
  and /usr/ccs/bin to your search $PATH to do all the
  compilations.

  e.g. (in Bourne shell syntax)
  PATH=/usr/sfw/bin:/usr/ccs/bin:$PATH
  export PATH

  Set a temporary install directory
  to install gnuplot, gd, automake and autoconf 
  for all compilations.
  e.g. /tmp/gd, /tmp/automake etc..



  1. download gd graphics library from http://www.boutell.com/gd
  2. compile and install gd graphic library to your temporary
     install directory, e.g. /tmp/gd

     e.g. configure --prefix=/tmp/gd
          make
          install

  3. download automake from  http://www.gnu.org/software/automake
  4. compile and install automake tool to your temporary
     install directory, e.g. /tmp/automake

     e.g. configure --prefix=/tmp/automake
          make
          install

  5. download autoconf from http://www.gnu.org/software/autoconf
  6. compile and install autoconf to your temporary install
     directory, e.g. /tmp/autoconf

     e.g. configure --prefix=/tmp/autoconf
          make
          install

  7. download gnuplot from http://www.gnuplot.info.
  8. add autoconf and automake tools to your $PATH for
     gnuplot compilation preparation script: configure.

     e.g. using Bourne shell syntax:
     PATH=/tmp/automake/bin:/tmp/autoconf/bin:/tmp/gd/bin:$PATH;
     export PATH

  9. add gd library to LDFLAGS for "configure" script.

     e.g. using Bourne shell syntax:
     LDFLAGS=-L/tmp/gd/lib; export LDFLAGS

  10. compile gnuplot, e.g.

      configure --prefix=/tmp/gnuplot --disable--wxwidgets --with-gd=$GD/lib --without-lisp-files
      make
      make install


   11. copy gnuplot binary and lib to your SSMA server installation directory.

       e.g. if you install SSMA server to /app/canary

       cp /tmp/gd/bin/gnuplot  /app/canary/components/bin
       cp /tmp/gd/lib/*        /app/canary/components/lib

   12. copy additional Solaris 10 libraries to /app/canary/components/lib
       cp /usr/lib/libpng* /app/canary/components/lib
       cp /usr/lib/libjpeg* /app/canary/components/lib
       cp /usr/lib/libfont* /app/canary/components/lib
       cp /usr/lib/libXpm*  /app/canary/components/lib
       cp /usr/sfw/lib/libfreetype* /app/canary/components/lib
       cp /usr/sfw/lib/libexpat* /app/canary/components/lib
       cp /usr/sfw/lib/libgcc*  /app/canary/compoents/lib
       cp /usr/sfw/lib/libstdc* /app/canary/components/lib
       cp ./lib/locale/iso_8859_8/X11/fonts/TrueType/arial__h.ttf /app/canary/compoents/font/arial.ttf

   13. if email upload method is selected for SSMA install, download
       and compile base64 source from:

       http://www.fourmilab.ch/webtools/base64/#Download

       follow instruction to compile a copy of base64 and
       copy it to /app/canary/components/bin (if /app/canary is
       your SSMA install root directory).


   Where to download mini_httpd and vncserver for User Experience Components
   -----------------------------------------------------------------------------

   The optional User Experience Component requires mini_httpd and vncserver
   software to run. Note both components are required by the SSMA client but not
   the server. Source/binaries can be downloaded and compiled from:

   mini_httpd: http://www.acme.com/software/mini_httpd

   vncserver: http://www.realvnc.com

   How-to compile/build and setup vncserver software
   -------------------------------------------------

   You can compile vnc from source
   If you choose to compile/build vnc software yourself,
   or you can download a compiled sparc binary copy if one
   is available. For mini_httpd you need to follow instruction
   to build the software from source.

   Compile and build vncserver software and distribute the entire vncserver
   binaries set to all clients. Add the vncserver binary to the client's
   search path before launching the User Experience cclient scripts.
   (e.g. cbt.sh for browser test or csot for staroffice test).

   Step to setup mini_httpd software 
   ---------------------------------
   (note: need to add add to probe.tar for client distribution)

   After successful compile and build mini_httpd software,
   copy mini_httpd binary to /app/canary/probe/capps/cbt directory of
   the server installation. Then build/rebuild probe.tar tarball
   to include mini_httpd and REDISTRIBUTE probe.tar to all clients
   before User Experience test can be launched from client startup
   script.


   e.g. (Bourne shell syntax)
   PATH=/tmp/vncserver/bin:$PATH; export PATH

   ## launch client script 
   ## that will find vncserver as well as launching 
   ## User Experience tests.
   ##
   ./canary_probe_start.sh  
    

How to add UNIX tools for Windows?
-----------------------------------

The Simple System Monitoring Application probe for Windows requires 3
UNIX tools:

   gawk.exe
   gzip.exe
   tar.exe

Fetch the following tools collections into an empty directory, say
'unxutils'
   http://unxutils.sourceforge.net/UnxUtils.zip
   http://unxutils.sourceforge.net/UnxUpdates.zip

in directory 'unxutils' unzip in the following order:
   unzip UnxUtils.zip
   unzip UnxUpdates.zip

Copy gawk.exe, gzip.exe and tar.exe to the SSMA winprobe directory.




