versaplexd/benchmarks/README

   1 NOTE!  You have to run this script as root, or sudo, whatever.  The reason
   2 is that it invokes tcpdump which needs escalated privileges in order to
   3 monitor your network interfaces.  There are ways around that, but I was too
   4 lazy to bother implementing them. So, be root.
   5
   6 Run this script just as "./versabench.pl" (or sudo ./versabench.pl, probably).
   7 for your own sanity, it's better to run with "./versabench.pl 2>/dev/null", or
   8 vxodbc will hurt you.
   9
  10 You'll need tcpdump.  I hope that goes without having said... that.
  11
  12 Note: In order to connect to an MS SQL database, I had to install (under
  13 Linux Ubuntu) the packages:
  14         freetds-dev
  15         libdbd-sybase-perl (as opposed to DBD::FreeTDS, which is unmaintained)
  16
  17 Add this to /etc/freetds/freetds.conf:
  18         [testdb]
  19                 host = $IP_ADDRESS_OF_YOUR_SQL_SERVER
  20                 port = 1433
  21                 tds version = 8.0
  22
  23 Now this can connect to an SQL database!
  24
  25
  26 For DBus purposes, you need:
  27         libnet-dbus-perl
  28
  29 Set the $dbus_moniker variable below to your DBus connection string, and off
  30 you go.
  31
  32
  33 To get VxODBC working right, you'll need:
  34         libdbd-odbc-perl
  35         unixodbc-dev
  36
  37 Now, this part is a little tricky.  You'll obviously need a VxODBC with its
  38 supporting libraries; easiest way to do that is check out a copy of the
  39 versaplex tree and compile it.
  40
  41 Add this to /etc/odbcinst.ini:
  42         [ODBC Drivers]
  43         VxODBC          = Installed
  44
  45         [VxODBC]
  46         Description     = The biggest pair you've ever seen twinkleberry
  47         Driver          = $ABSOLUTE_PATH_TO_VXODBC/vxodbc.so
  48         Setup           = $ABSOLUTE_PATH_TO_VXODBC/vxodbc.so
  49         UsageCount      = 1
  50
  51 Add this to /etc/odbc.ini:
  52         [testdb]
  53         Driver = VxODBC
  54         Database = $desired_name_of_connection_in_your_versaplexd.ini
  55         Servername = do_i_do_anything
  56         Username = lkosewsk
  57         DBus = dbus:session
  58
  59 Done and done.  You can test that this works by running:
  60         export DBUS_SESSION_BUS_ADDRESS=$vxodbc_dbus_moniker
  61         isql -v testdb $username $pw
  62
  63 Here, $vxodbc_dbus_moniker is the connection moniker to DBus, and
  64 username and pw are the database username and password respectively.
  65 Try some practice commands, and if they work, you're golden.
  66
  67 THEN: edit versabench.conf and modify the configuration variables to match
  68 the ones you want to use.