incubator-olio-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From klich...@apache.org
Subject svn commit: r816793 - /incubator/olio/docs/java_setup.html
Date Fri, 18 Sep 2009 21:43:41 GMT
Author: klichong
Date: Fri Sep 18 21:43:40 2009
New Revision: 816793

URL: http://svn.apache.org/viewvc?rev=816793&view=rev
Log:
Fixing reference to TopLink being the default JPA provider in GlassFish v2.1.  EclipseLink will NOT be bundled with v2UR3 as previously noted.

Modified:
    incubator/olio/docs/java_setup.html

Modified: incubator/olio/docs/java_setup.html
URL: http://svn.apache.org/viewvc/incubator/olio/docs/java_setup.html?rev=816793&r1=816792&r2=816793&view=diff
==============================================================================
--- incubator/olio/docs/java_setup.html (original)
+++ incubator/olio/docs/java_setup.html Fri Sep 18 21:43:40 2009
@@ -7,6 +7,8 @@
 
 
 
+
+  
   
   
   
@@ -18,6 +20,7 @@
 
 
 
+
   
 
 
@@ -30,6 +33,8 @@
   
   
   
+  
+  
   <title>Olio/Java Install and Setup Guide</title>
   <meta name="generator" content="Bluefish 1.0.7">
 
@@ -38,6 +43,8 @@
 
 
 
+
+  
   
   
   
@@ -50,6 +57,8 @@
 
 
 
+
+  
   
   
   
@@ -62,6 +71,8 @@
 
 
 
+
+  
   
   
   
@@ -74,6 +85,8 @@
 
 
 
+
+  
   
   
   
@@ -90,6 +103,7 @@
 
 
 
+
 <h1 align="center">Olio/Java<br>
 
 
@@ -97,6 +111,7 @@
 
 
 
+
 Install and Setup Guide From Source Tree</h1>
 
 
@@ -104,6 +119,7 @@
 
 
 
+
 <p><span style="font-weight: normal;">Note: The
 application currently does not use memcached. Please ignore the
 memcached related setup instructions</span><br>
@@ -113,6 +129,7 @@
 
 
 
+
 </p>
 
 
@@ -120,6 +137,7 @@
 
 
 
+
 <h2>Overview</h2>
 
 
@@ -127,6 +145,7 @@
 
 
 
+
 <p>Java Olio is a macro-level benchmark consisting of the
 following
 components:</p>
@@ -136,6 +155,7 @@
 
 
 
+
 <ol>
 
 
@@ -143,12 +163,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p style="margin-bottom: 0in;">The web application</p>
 
 
@@ -156,6 +178,7 @@
 
 
 
+
   </li>
 
 
@@ -163,12 +186,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p style="margin-bottom: 0in;">The main database </p>
 
 
@@ -176,6 +201,7 @@
 
 
 
+
   </li>
 
 
@@ -183,12 +209,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p style="margin-bottom: 0in;">Distributed storage
 servers (MogileFS or localFS)</p>
 
@@ -197,6 +225,7 @@
 
 
 
+
   </li>
 
 
@@ -204,12 +233,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p style="margin-bottom: 0in;">Storage metadata
 database (for MogileFS)</p>
 
@@ -218,6 +249,7 @@
 
 
 
+
   </li>
 
 
@@ -225,12 +257,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p style="margin-bottom: 0in;">Geocoder emulator </p>
 
 
@@ -238,6 +272,7 @@
 
 
 
+
   </li>
 
 
@@ -245,12 +280,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p>Workload driver</p>
 
 
@@ -258,6 +295,7 @@
 
 
 
+
   </li>
 
 
@@ -265,6 +303,7 @@
 
 
 
+
 </ol>
 
 
@@ -272,6 +311,7 @@
 
 
 
+
 <p>If your primary interest is in setting up the application
 alone, you need items 1-5 above and they can all be setup on a single
 system. If on the other hand, you would like to drive load against the
@@ -288,6 +328,7 @@
 
 
 
+
 <p>For a horizontally scaled workload, or to measure the
 performance of the individual components, you can deploy the SUT
 components on separate physical or virtual machines. &nbsp;Keep in
@@ -296,16 +337,19 @@
 
 
 
+
 <br>
 
 
 
+
 Java Olio is available either as a kit, or by downloading the source.
 &nbsp;There are two separate sections that describe how to get started,
 either by <a href="#Extracting_the_Contents">Extracting the Contents</a>, or by <a href="#Downloading_The_Source">Downloading the source</a>.<br>
 
 
 
+
 <br>
 
 
@@ -313,6 +357,7 @@
 
 
 
+
 In the following sections, we'll go over the steps
 needed to configure each component :</p>
 
@@ -321,10 +366,13 @@
 
 
 
+
 <a href="#Extracting_the_Contents">Extracting the Contents</a><br>
 
+
 <br>
 
+
 <a href="#Downloading_The_Source">Downloading the source</a>
 <p><a href="#setupDriver">Setting up the driver</a></p>
 
@@ -333,6 +381,7 @@
 
 
 
+
 <p><a href="#installWebApp">Installing the Web
 Application</a></p>
 
@@ -341,6 +390,7 @@
 
 
 
+
 <p><a href="#setupDB">Setting up the database</a></p>
 
 
@@ -348,6 +398,7 @@
 
 
 
+
 <p><a href="#loadDB">Loading the database</a></p>
 
 
@@ -355,6 +406,7 @@
 
 
 
+
 <p><a href="#setupFileStore">Setting up the filestore</a></p>
 
 
@@ -362,6 +414,7 @@
 
 
 
+
 <p><a href="#startMemCached">Starting memcached
 Server</a></p>
 
@@ -370,6 +423,7 @@
 
 
 
+
 <p><a href="#setupEmulator">Setting up the Geocoder
 Emulator</a></p>
 
@@ -378,6 +432,7 @@
 
 
 
+
 <p><a href="#testWebApp">Testing the web application</a></p>
 
 
@@ -385,6 +440,7 @@
 
 
 
+
 <p><a href="#startRun">Starting a benchmark run</a></p>
 
 
@@ -392,6 +448,7 @@
 
 
 
+
 <h2><a name="Prerequisite_Software:"></a>Prerequisite
 Software:</h2>
 
@@ -400,6 +457,7 @@
 
 
 
+
 <ul>
 
 
@@ -407,6 +465,7 @@
 
 
 
+
   <li><a href="http://java.sun.com/javase/downloads/index.jsp">Java
 SE 6</a></li>
 
@@ -415,6 +474,7 @@
 
 
 
+
   <li><a href="http://ant.apache.org/">Apache
 Ant&nbsp;</a></li>
 
@@ -423,6 +483,7 @@
 
 
 
+
   <li><a href="http://subversion.tigris.org/">Subversion:&nbsp;</a>
 an open source revision control system</li>
 
@@ -431,6 +492,7 @@
 
 
 
+
   <li><a href="http://faban.sunsource.net/">Faban</a>
 a facility for developing and running benchmarks.</li>
 
@@ -439,6 +501,7 @@
 
 
 
+
   <li>Java EE 5 compliant application server - eg. <a href="https://glassfish.dev.java.net/public/downloadsindex.html">GlassFish</a></li>
 
 
@@ -446,6 +509,7 @@
 
 
 
+
   <li>Java Persistence API (JPA) provider - eg. <a href="http://www.eclipse.org/eclipselink/">Eclipselink</a></li>
 
 
@@ -453,6 +517,7 @@
 
 
 
+
   <li>Database tier - eg. mySQL</li>
 
 
@@ -460,141 +525,176 @@
 
 
 
+
 </ul>
 
 
 
+
 <h2><a name="Extracting_the_Contents"></a>Extracting the Contents</h2>
 
 
 
+
 <br>
 
 
 
+
 The Olio/Java kit is packaged as a gzipped tar file. The first task is
 to unzip the file and untar it to extract it's contents. Because of the
 long pathnames, please use gtar to extract. This can be done as follows:<br>
 
 
 
+
 <br>
 
 
 
+
 # gzcat olio-java-&lt;version&gt;.tar.gz | gtar xvf -<br>
 
 
 
+
 <br>
 
 
 
+
 This will cause a directory named olio-java-&lt;version&gt; to be created whose contents should look like:<br>
 
 
 
+
 <br>
 
 
 
+
 # ls olio-java-0.1*<br>
 
 
 
+
 <br>
 
 
 
+
 LICENSE JavaOlioDriver.jar RELEASE-NOTES-java-0.1.txt geocoder.war Java_setup.html<br>
 
 
 
+
 <br>
 
 
 
+
 NOTICE olioJava/ release<br>
 
 
 
+
 <br>
 
 
 
+
 #<br>
 
 
 
+
 <br>
 
 
 
+
 We will use $JAVA_OLIO_HOME to designate the name of this directory. A description of the contents follows :<br>
 
 
 
+
 <br>
 
 
 
+
 <ul>
 
 
 
+
   <li>&nbsp;The <span style="font-style: italic;">oliojava</span> directory contains the web application. This
 application will be deployed on the webserver. <br>
+
     <br>
 
 
 
+
   </li>
 
 
 
+
   <li>&nbsp;<span style="font-style: italic;">JavaOlioDriver.jar</span> contains the load generator/driver
 (which we typically refer to simply as <span style="font-style: italic;">driver</span>). The driver is
 implemented using <a href="http://sunsource.faban.net">Faban</a>, an open source benchmarking toolkit.<br>
 
 
 
+
     <br>
 
 
 
+
   </li>
 
 
 
+
   <li><span style="font-style: italic;">geocoder.war</span> contains the simple servlet used to emulate the geocoder.<br>
 
 
 
+
     <br>
 
 
 
+
   </li>
 
 
 
+
   <li><span style="font-style: italic;">java_setup.html</span> is this document.<br>
+
     <br>
 
 
 
+
   </li>
 
 
 
+
   <li><span style="font-style: italic;">release</span> contains the release name. LICENSE and NOTICE contain the licenses.<br>
 
 
 
+
   </li>
 
 
 
+
 </ul>
 
 
@@ -602,6 +702,7 @@
 
 
 
+
 <h2><a name="Downloading_The_Source"></a>Downloading
 The Source</h2>
 
@@ -610,6 +711,7 @@
 
 
 
+
 <span style="text-decoration: underline; font-weight: bold;"></span><br>
 
 
@@ -617,6 +719,7 @@
 
 
 
+
 The Olio source is available via SVN at <a href="https://svn.apache.org/repos/asf/incubator/olio/">https://svn.apache.org/repos/asf/incubator/olio/</a>.
 Please see the <a href="http://www.apache.org/dev/version-control.html#anon-svn">instructions</a>
 for downloading the source. We will use $OLIO_HOME to designate the
@@ -628,6 +731,7 @@
 
 
 
+
 <br>
 
 
@@ -635,6 +739,7 @@
 
 
 
+
 <ul>
 
 
@@ -642,6 +747,7 @@
 
 
 
+
   <li>The <span style="font-style: italic;">webapp</span> directory
 contains the web application. The java/trunk sub-directory
 contains the workspace for the Java application. The java source
@@ -655,6 +761,7 @@
 
 
 
+
 </ul>
 
 
@@ -662,6 +769,7 @@
 
 
 
+
 <ul>
 
 
@@ -669,6 +777,7 @@
 
 
 
+
   <li>The <span style="font-style: italic;">workload</span>
 directory contains the code for the load
 generator/driver (which we typically refer to simply as driver). The
@@ -681,14 +790,17 @@
 
 
 
+
   </li>
 
 
 
+
   <li>The geocoder directory contains the code for the geocoder emulator. This code is shared across all implementations of Olio.<br>
 
 
 
+
   </li>
 
 
@@ -696,6 +808,7 @@
 
 
 
+
 </ul>
 
 
@@ -703,6 +816,7 @@
 
 
 
+
 <p></p>
 
 
@@ -710,6 +824,7 @@
 
 
 
+
 <h2><a name="setupDriver"></a>Setting up the
 driver</h2>
 
@@ -718,6 +833,7 @@
 
 
 
+
 Even if you don't plan to drive load against the application, this
 setup is required as the database and file loaders are part of the
 workload driver&nbsp; - feel free to install the driver on the same
@@ -729,12 +845,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p align="left">See <a href="http://faban.sunsource.net/docs/guide/harness/install.html">http://faban.sunsource.net/docs/guide/harness/install.html</a>
 for Faban installation instructions. Note that faban needs to be
 installed on all the machines used for the benchmark. &nbsp; Please
@@ -748,6 +866,7 @@
 
 
 
+
   </li>
 
 
@@ -755,12 +874,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p align="left">To build the driver, do the following:<br>
 
 
@@ -768,6 +889,7 @@
 
 
 
+
     </p>
 
 
@@ -775,6 +897,8 @@
 
 
 
+
+    
     
     
     
@@ -787,6 +911,7 @@
 
 
 
+
       <li>cd $WORKLOAD/java/trunk<br>
 
 
@@ -794,6 +919,7 @@
 
 
 
+
         <br>
 
 
@@ -801,6 +927,7 @@
 
 
 
+
       </li>
 
 
@@ -808,6 +935,7 @@
 
 
 
+
       <li>Copy build.properties.template to build.properties. &nbsp;Edit this new file build.properties and set faban.home to
 $FABAN_HOME, faban.url to <span style="font-family: monospace;">http://driver_host:9980
         </span>where <span style="font-style: italic;">driver_host</span>
@@ -819,6 +947,7 @@
 
 
 
+
         <br>
 
 
@@ -826,6 +955,7 @@
 
 
 
+
       </li>
 
 
@@ -833,6 +963,7 @@
 
 
 
+
       <li>Set the environment variable JAVA_HOME to point to your
 JDK1.6 installation.<br>
 
@@ -841,6 +972,7 @@
 
 
 
+
         <br>
 
 
@@ -848,6 +980,7 @@
 
 
 
+
       </li>
 
 
@@ -855,10 +988,12 @@
 
 
 
+
       <li>Build the driver using the command: ant deploy.jar. If
 successful, you should see the file JavaWeb20Driver.jar in the build
 sub-directory.</li>
 
+
       <br>
 
 
@@ -866,6 +1001,8 @@
 
 
 
+
+    
     
     
     
@@ -873,8 +1010,10 @@
     
     </ul>
 
+
   </li>
 
+
   <li>Download MySQL Connector/J (JDBC Driver for MySQL) and install the jar in&nbsp;$FABAN_HOME/benchmarks/JavaOlioDriver/lib.</li>
 
 
@@ -882,6 +1021,7 @@
 
 
 
+
   
 
 
@@ -893,6 +1033,7 @@
     
     
     
+    
     <p align="left">For the driver to work, you will need
 JDK 1.6. Set JAVA_HOME to the path of the JDK in the faban user's
 environment.</p>
@@ -902,6 +1043,7 @@
 
 
 
+
   </li>
 
 
@@ -909,12 +1051,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p align="left">Start the faban master on the master
 driver machine :</p>
 
@@ -923,6 +1067,8 @@
 
 
 
+
+    
     
     
     
@@ -935,6 +1081,7 @@
 
 
 
+
   </li>
 
 
@@ -942,20 +1089,24 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p align="left">Test that you can connect to the
 master by pointing your browser at http://<i>&lt;driver_machine&gt;</i>:9980.
 &nbsp;You should see the Faban welcome page or if you have already
 deployed the driver, a page with the text "Welcome to Java Olio
 Workload"</p>
 
+
   </li>
 
+
   <li>To deploy the Faban driver, you can
 either copy $WORKLOAD/build/JavaOlioDriver.jar to the
 $FABAN_HOME/benchmarks directory, or execute <span style="font-family: monospace;">ant deploy</span>.
@@ -965,6 +1116,7 @@
 
 
 
+
   
 
 
@@ -977,6 +1129,7 @@
 
 
 
+
 <span style="font-weight: bold;"></span>
 <h2><a name="Setting_Up_the_Database"></a>Setting
 Up the Database</h2>
@@ -986,6 +1139,7 @@
 
 
 
+
 Sun Web Stack (formerly known as Coolstack) is one pre-integrated suite of open source applications
 optimized for Solaris. If you're running on any other operating system,
 please install the mySQL on those systems. &nbsp;You can <a href="https://cds.sun.com/is-bin/INTERSHOP.enfinity/WFS/CDS-CDS_SMI-Site/en_US/-/USD/ViewProductDetail-Start?ProductRef=Web-Stack-1.4-OTH-G-F@CDS-CDS_SMI">download</a> the official Sun binaries for Sun Web Stack if you are on Solaris or Red Hat Linux.
@@ -997,6 +1151,7 @@
 
 
 
+
   <li>If you plan to run MySQL on a separate machine, install
 MySQL on
 that system. We will refer to the MySQL installation directory as
@@ -1007,12 +1162,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p>Setup the mysql user/group and permissions for its
 directories: <br>
 
@@ -1021,6 +1178,7 @@
 
 
 
+
     <span style="font-family: monospace;"></span><span style="font-family: monospace;"># groupadd mysql </span><br style="font-family: monospace;">
 
 
@@ -1028,6 +1186,7 @@
 
 
 
+
     <span style="font-family: monospace;"># useradd
 -d&nbsp;$MYSQL_HOME -g mysql -s /usr/bin/bash&nbsp;</span><span style="font-family: monospace;">mysql</span><span style="font-family: monospace;"><br>
 
@@ -1036,6 +1195,7 @@
 
 
 
+
 # chown -R
 mysql:mysql $MYSQL_HOME</span><br>
 
@@ -1044,6 +1204,7 @@
 
 
 
+
     <span style="font-family: monospace;"></span></p>
 
 
@@ -1051,6 +1212,7 @@
 
 
 
+
   </li>
 
 
@@ -1058,12 +1220,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p>Create the database :<br>
 
 
@@ -1071,6 +1235,7 @@
 
 
 
+
     <span style="font-family: monospace;"># su - mysql</span><br style="font-family: monospace;">
 
 
@@ -1078,6 +1243,7 @@
 
 
 
+
     <span style="font-family: monospace;">$ cd&nbsp;bin</span><br style="font-family: monospace;">
 
 
@@ -1085,19 +1251,23 @@
 
 
 
+
     <span style="font-family: monospace;">$
 ./mysql_install_db</span></p>
 
 
+
   </li>
 
 
+
   <li>A sample MySQL configuration file (my.cnf) is included in the
 $WEBAPP/etc. Please read the embedded comments and edit the file
 appropriately after copying it to /etc. &nbsp; Note that the data
 directory that the <span style="font-style: italic;">innodb_data_home_dir</span> variable refers to must be writable by the mysql user.<br>
 
 
+
   </li>
 
 
@@ -1105,12 +1275,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p>Start the mysql server. Substitute your own password for <i>pwd
     </i><span style="font-style: normal;">(we
 typically use</span><i> adminadmin</i><span style="font-style: normal;">)</span><br>
@@ -1120,6 +1292,7 @@
 
 
 
+
     <span style="font-family: monospace;">$&nbsp;</span><span style="font-family: monospace;">./mysqld_safe --defaults-file=/etc/my.cnf &amp;</span><br style="font-family: monospace;">
 
 
@@ -1127,6 +1300,7 @@
 
 
 
+
     <span style="font-family: monospace;">$ ./mysqladmin
 -u root password <span style="font-style: italic;">&lt;your-</span></span><i style="font-family: monospace;"><span style="font-style: italic;">password&gt;</span><br>
 
@@ -1135,6 +1309,7 @@
 
 
 
+
 $ </i><span style="font-family: monospace;">./mysqladmin
 -u root -h &lt;machine-name&gt; password</span><i style="font-family: monospace;">
 &lt;your-password&gt;</i></p>
@@ -1144,6 +1319,7 @@
 
 
 
+
   </li>
 
 
@@ -1151,12 +1327,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p>Create the olio user and grant privileges :<br>
 
 
@@ -1164,6 +1342,7 @@
 
 
 
+
     <span style="font-family: monospace;">$ ./mysql -uroot
 -p</span><i style="font-family: monospace;">pwd</i><br style="font-family: monospace;">
 
@@ -1172,6 +1351,7 @@
 
 
 
+
     <span style="font-family: monospace;">mysql&gt;
 create user 'olio'@'%' identified by 'olio';</span><br style="font-family: monospace;">
 
@@ -1180,6 +1360,7 @@
 
 
 
+
     <span style="font-family: monospace;">mysql&gt;
 grant all privileges </span><span style="font-family: monospace;">on *.* to 'olio'@'%'
 identified by 'olio' with grant option;</span><span style="font-family: monospace;"></span><span style="font-family: monospace;"><br>
@@ -1189,6 +1370,7 @@
 
 
 
+
     </span><span style="font-family: monospace;"></span><span style="font-family: monospace;"><br>
 
 
@@ -1196,6 +1378,7 @@
 
 
 
+
     <br>
 
 
@@ -1203,6 +1386,7 @@
 
 
 
+
     </span>In some cases the wildcard '%' does not work reliably
 as a
 substitution for all hosts. You need to grant the privileges to
@@ -1215,6 +1399,7 @@
 
 
 
+
     <span style="font-family: monospace;"></span>Eg.<span style="font-family: monospace;"> mysql&gt;
 grant all </span><span style="font-family: monospace;">privileges
     </span><span style="font-family: monospace;">on
@@ -1225,11 +1410,13 @@
 
 
 
+
     </p>
 
 
 
 
+
   </li>
 
 
@@ -1237,6 +1424,7 @@
 
 
 
+
   <li>Create database<br>
 
 
@@ -1244,6 +1432,7 @@
 
 
 
+
     <span style="font-family: monospace;">mysql&gt;
 create database bpwebapp;</span><br style="font-family: monospace;">
 
@@ -1252,6 +1441,7 @@
 
 
 
+
     <span style="font-family: monospace;">mysql&gt;
 use bpwebapp;<br>
 
@@ -1260,6 +1450,7 @@
 
 
 
+
     <br>
 
 
@@ -1267,6 +1458,7 @@
 
 
 
+
     </span></li>
 
 
@@ -1274,6 +1466,7 @@
 
 
 
+
   <li>Although it is possible to create the database schema
 automatically by JPA upon
 deployment or when the application server starts, it recommended to
@@ -1287,6 +1480,7 @@
 
 
 
+
     <br>
 
 
@@ -1294,6 +1488,7 @@
 
 
 
+
     <span style="font-family: monospace;">mysql&gt; \.</span><span style="font-style: italic; font-family: monospace;">
 &lt;location&gt;</span><span style="font-family: monospace;">/schema.sql<br>
 
@@ -1302,6 +1497,7 @@
 
 
 
+
 mysql&gt; exit</span><span style="font-family: monospace;"><br>
 
 
@@ -1309,6 +1505,7 @@
 
 
 
+
     </span>&nbsp;Now, if you login as the user olio, you
 should be able to see the
 database created by the root user.</li>
@@ -1318,6 +1515,7 @@
 
 
 
+
 </ol>
 
 
@@ -1325,6 +1523,7 @@
 
 
 
+
 <h2><a name="loadDB"></a> <font size="4">Loading
 the database</font></h2>
 
@@ -1333,6 +1532,7 @@
 
 
 
+
 <p><font size="3">It is best to load the database
 manually the first
 time so that we can test the web application. However, while doing
@@ -1344,6 +1544,7 @@
 
 
 
+
 <ol>
 
 
@@ -1351,12 +1552,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p><font size="3">Login to the machine running
 the Faban master driver. Only this machine has the loader at this time.</font></p>
 
@@ -1365,6 +1568,7 @@
 
 
 
+
   </li>
 
 
@@ -1372,6 +1576,7 @@
 
 
 
+
   <li><font size="3">Go to the directory containing
 the loader script:<br>
 
@@ -1380,6 +1585,7 @@
 
 
 
+
     </font><font size="3"><span style="font-family: monospace;"># cd </span></font><span style="font-family: monospace;"><span style="font-style: italic;">$FABAN_HOME</span>/benchmarks/JavaOlioDriver/bin</span></li>
 
 
@@ -1387,6 +1593,7 @@
 
 
 
+
   <li>Ensure the script has execute permissions. Faban takes care
 of this for the runs, but since we have not yet started the first run,
 we will need to change that ourselves:<br>
@@ -1396,15 +1603,18 @@
 
 
 
+
     <span style="font-family: monospace;"># chmod +x
 dbloader.sh</span></li>
 
 
+
   <li>You may have to edit the dbloader.sh to reflect your version of
 the JDBC Driver for MySQL that you downloaded and placed in the&nbsp;
 $FABAN_HOME/benchmarks/JavaOlioDriver/lib in step 3 of <a href="#setupDriver">Setting Up the Driver</a> section. &nbsp;On line 51 of dbloader.sh, the CLASSPATH is currently set to MySQL JDBC driver version 5.0.6. &nbsp;<br>
 
 
+
 Eg. <span style="font-family: monospace;">CLASSPATH=$B/mysql-connector-java-5.0.6-bin.jar</span></li>
 
 
@@ -1412,6 +1622,7 @@
 
 
 
+
   <li>Run the loader script:<br>
 
 
@@ -1419,6 +1630,7 @@
 
 
 
+
     <span style="font-family: monospace;"># ./dbloader.sh <span style="font-style: italic;">&lt;dbserver&gt;
 &lt;load_scale&gt;</span></span><br>
 
@@ -1427,6 +1639,7 @@
 
 
 
+
 For a fully loaded T2000 (8x1.2Ghz) we are currently running a scale of
 around 1000. You can start small with a SCALE of 50 or so for initial
 testing<span style="font-weight: bold;">.</span></li>
@@ -1436,6 +1649,7 @@
 
 
 
+
   <span style="font-family: monospace;"></span>
 </ol>
 
@@ -1444,6 +1658,7 @@
 
 
 
+
 <h2><a name="startMemCached"></a><font size="4">Setting up memcached
 server</font></h2>
 
@@ -1452,6 +1667,7 @@
 
 
 
+
 Note - for the current version of Olio Java, you will not have need to
 install memcached servers. <br>
 
@@ -1460,6 +1676,7 @@
 
 
 
+
 <br>
 
 
@@ -1467,6 +1684,7 @@
 
 
 
+
 The Olio application uses memcached for caching the home page which
 dramatically reduces the load on the database. If you are running Olio
 to stress MySQL, you may not want to have the caching tier. In this
@@ -1482,6 +1700,7 @@
 
 
 
+
   <li>Download and install memcached on the system you plan to
 use. </li>
 
@@ -1490,12 +1709,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p style="margin-bottom: 0in;"><font size="3">Start
 the memcached server thus :<br>
 
@@ -1504,6 +1725,7 @@
 
 
 
+
     </font><font size="3"><span style="font-family: monospace;">#
 nohup /opt/coolstack/bin/memcached -m 256 -u mysql &amp;</span></font></p>
 
@@ -1512,6 +1734,7 @@
 
 
 
+
   </li>
 
 
@@ -1519,12 +1742,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p style="margin-bottom: 0in;">Edit the web.xml to
 reflect where you have installed your memcached servers (see Installing
 Web Application for more details).<font size="3"><span style="font-family: monospace;"><br>
@@ -1534,6 +1759,7 @@
 
 
 
+
     </span></font><font size="3">Note that the
 Faban harness will start the memcached servers before each run.</font></p>
 
@@ -1542,6 +1768,7 @@
 
 
 
+
   </li>
 
 
@@ -1549,6 +1776,7 @@
 
 
 
+
 </ol>
 
 
@@ -1556,6 +1784,7 @@
 
 
 
+
 <h2><a name="setupEmulator"><font size="4">Setting
 up the Geocoder
 Emulator</font></a></h2>
@@ -1565,6 +1794,7 @@
 
 
 
+
 <p>The Geocoder Emulator is a simple J2EE application that you
 can deploy on
 Glassfish or Tomcat. It is typically run on a driver machine. The
@@ -1576,6 +1806,7 @@
 
 
 
+
 <p>To build the geocoder:</p>
 
 
@@ -1583,6 +1814,7 @@
 
 
 
+
 <ul>
 
 
@@ -1590,6 +1822,7 @@
 
 
 
+
   <li>Build the geocoder.war file by going to the 'geocoder'
 directory and following the instructions in the README file.</li>
 
@@ -1598,6 +1831,7 @@
 
 
 
+
 </ul>
 
 
@@ -1605,6 +1839,7 @@
 
 
 
+
 <p>
 For Glassfish:</p>
 
@@ -1613,6 +1848,7 @@
 
 
 
+
 <ol>
 
 
@@ -1620,6 +1856,7 @@
 
 
 
+
   <li>Download and install Glassfish V2 from <a href="https://glassfish.dev.java.net/public/downloadsindex.html">https://glassfish.dev.java.net/public/downloadsindex.html.</a>
 &nbsp;(alternatively, you can use any J2EE container like Tomcat to
 deploy - see below)</li>
@@ -1629,6 +1866,7 @@
 
 
 
+
   <li>Copy the geocoder.war from the geocoder directory ($OLIO_HOME/geocoder) to
 $GLASSFISH_HOME/domains/domain1/autodeploy (domain1 is the default
 domain created with Glassfish)</li>
@@ -1638,6 +1876,7 @@
 
 
 
+
   <li>Start Glassfish by using $GLASSFISH_HOME/bin/asadmin
 start-domain domain1.</li>
 
@@ -1646,6 +1885,7 @@
 
 
 
+
 </ol>
 
 
@@ -1653,6 +1893,7 @@
 
 
 
+
 For Tomcat:
 <ol>
 
@@ -1661,12 +1902,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p>Download and install Tomcat (either from Cool Stack
 CSKtomcat package or directly from <a href="http://tomcat.apache.org/">http://tomcat.apache.org</a>)
 on the driver machine. The install directory doesn't matter &ndash;
@@ -1677,6 +1920,7 @@
 
 
 
+
   </li>
 
 
@@ -1684,20 +1928,24 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p>Build the geocoder.war file by going to the 'geocoder' directory and following the instructions in the README file.</p>
 
 
 
+
   </li>
 
 
 
+
   <li>Copy the geocoder.war file from the geocoder/dist directory to $TOMCAT_HOME/webapps.</li>
 
 
@@ -1705,20 +1953,24 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p>Start Tomcat using $TOMCAT_HOME/bin/startup.sh.</p>
 
 
 
+
   </li>
 
 
 
+
 </ol>
 
 
@@ -1726,6 +1978,7 @@
 
 
 
+
 <h2><a name="Installing_the_Web_Application_"></a>Installing
 the Web Application</h2>
 
@@ -1734,6 +1987,7 @@
 
 
 
+
 <br>
 
 
@@ -1741,6 +1995,7 @@
 
 
 
+
 The web application is a J2EE 5 web application. It requires the
 following
 components:<br>
@@ -1750,6 +2005,7 @@
 
 
 
+
 <br>
 
 
@@ -1757,6 +2013,7 @@
 
 
 
+
 <ol>
 
 
@@ -1764,6 +2021,7 @@
 
 
 
+
   <li>J2EE compliant application server (eg. <a href="https://glassfish.dev.java.net/public/downloadsindex.html">GlassFish
 v2.1</a>)</li>
 
@@ -1772,6 +2030,7 @@
 
 
 
+
   <li>JPA provider &nbsp;( eg. <a href="http://www.eclipse.org/eclipselink/">Eclipselink</a>)</li>
 
 
@@ -1779,6 +2038,7 @@
 
 
 
+
 </ol>
 
 
@@ -1786,6 +2046,7 @@
 
 
 
+
 Install the necessary components outlined above. &nbsp;For
 GlassFish
 specific instructions, see section on GlassFish Installation and
@@ -1796,6 +2057,7 @@
 
 
 
+
 Before building the WAR file to deploy on the application server, you
 will first have to edit the web descriptors to point to your database
 and geocoder that you set up in the previous steps. &nbsp;<br>
@@ -1805,6 +2067,7 @@
 
 
 
+
 <ol>
 
 
@@ -1812,6 +2075,7 @@
 
 
 
+
   <li>Edit web.xml in the application war file to configure
 the&nbsp;
 geocoder URL. &nbsp;This is found in
@@ -1822,6 +2086,8 @@
 
 
 
+
+  
   
   
   
@@ -1834,6 +2100,7 @@
 
 
 
+
     <li>Edit the env-entry for Geocoder URL to point to where
 your geocoder application is deployed.</li>
 
@@ -1842,6 +2109,8 @@
 
 
 
+
+  
   
   
   
@@ -1854,6 +2123,7 @@
 
 
 
+
 </ol>
 
 
@@ -1861,6 +2131,7 @@
 
 
 
+
 <h2><a name="Building_the_codebase"></a>Building
 the web application from the codebase</h2>
 
@@ -1869,6 +2140,7 @@
 
 
 
+
 <ol>
 
 
@@ -1876,12 +2148,14 @@
 
 
 
+
   <li>Set JAVA_HOME, ANT_HOME accordingly in your environment.<br>
 
 
 
 
 
+
   </li>
 
 
@@ -1889,6 +2163,7 @@
 
 
 
+
   <li>In the $WEBAPP/ws/bp-project directory, copy the
 build.properties.template to build.properties. &nbsp;Edit the
 build.properties for the relevant build details.
@@ -1900,6 +2175,7 @@
 
 
 
+
     <span style="font-family: monospace;">$ vi
 &lt;$WEBAPP&gt;/ws/bp-project/build.properties<br>
 
@@ -1907,6 +2183,7 @@
 
 
 
+
     <br>
 
 
@@ -1914,6 +2191,7 @@
 
 
 
+
     </span>Note that javaee.home needs to be pointed to the
 your Java EE 5 application server home directory, or if you're using
 GlassFish, the $GLASSFISH_HOME directory. &nbsp;It will look for the
@@ -1924,6 +2202,7 @@
 
 
 
+
   </li>
 
 
@@ -1931,6 +2210,7 @@
 
 
 
+
   <li>Change directories to the level of the webapp directory:<br>
 
 
@@ -1938,6 +2218,7 @@
 
 
 
+
     <span style="font-family: monospace;">$ cd
 &lt;$WEBAPP&gt;/ws/apps/webapp<br>
 
@@ -1945,6 +2226,7 @@
 
 
 
+
     </span></li>
 
 
@@ -1952,6 +2234,7 @@
 
 
 
+
   <li>Compile and jar the WAR file by executing the default
 "ant"command. &nbsp;You should see messages that the build is
 compiling:<br>
@@ -1961,6 +2244,7 @@
 
 
 
+
     <span style="font-family: monospace;"><br>
 
 
@@ -1968,6 +2252,7 @@
 
 
 
+
 $ ant<br>
 
 
@@ -1975,6 +2260,7 @@
 
 
 
+
 Buildfile: build.xml<br>
 
 
@@ -1982,104 +2268,148 @@
 
 
 
+
     <br>
 
+
 build:<br>
 
+
     <br>
 
+
 default:<br>
 
+
     <br>
 
+
 default-ear:<br>
 
+
     <br>
 
+
 init:<br>
 
+
     <br>
 
+
 -pre-compile:<br>
 
+
     <br>
 
+
 bpp-actual-compilation:<br>
 
+
 &nbsp;&nbsp;&nbsp;&nbsp; [echo] Compiling webapp<br>
 
+
 &nbsp;&nbsp;&nbsp; [javac] Compiling 49 source files to
 /Users/klichong/projects/java_testOlio/JavaOlio/webapp/java/trunk/ws/apps/webapp/build/classes<br>
 
+
 &nbsp;&nbsp;&nbsp; [javac] Note: Some input files use unchecked or unsafe operations.<br>
 
+
 &nbsp;&nbsp;&nbsp; [javac] Note: Recompile with -Xlint:unchecked for details.<br>
 
+
     <br>
 
+
 include-jmaki-local:<br>
 
+
     <br>
 
+
 include-jmaki:<br>
 
+
 &nbsp;&nbsp;&nbsp;&nbsp; [echo] Copying jMaki Runtime to
 /Users/klichong/projects/java_testOlio/JavaOlio/webapp/java/trunk/ws/apps/webapp/./build/web<br>
 
+
 &nbsp;&nbsp;&nbsp; [mkdir] Created dir:
 /Users/klichong/projects/java_testOlio/JavaOlio/webapp/java/trunk/ws/apps/webapp/build/web/temp<br>
 
+
 &nbsp;&nbsp;&nbsp; [unzip] Expanding:
 /Users/klichong/projects/java_testOlio/JavaOlio/webapp/java/trunk/ws/lib/ajax-wrapper-comp-1.8.1.jar
 into
 /Users/klichong/projects/java_testOlio/JavaOlio/webapp/java/trunk/ws/apps/webapp/build/web/temp<br>
 
+
 &nbsp;&nbsp;&nbsp; [mkdir] Created dir:
 /Users/klichong/projects/java_testOlio/JavaOlio/webapp/java/trunk/ws/apps/webapp/build/web/resources<br>
 
+
 &nbsp;&nbsp; [delete] Deleting directory
 /Users/klichong/projects/java_testOlio/JavaOlio/webapp/java/trunk/ws/apps/webapp/build/web/temp<br>
 
+
     <br>
 
+
 -post-compile:<br>
 
+
 &nbsp;&nbsp;&nbsp;&nbsp; [copy] Copying 3 files to
 /Users/klichong/projects/java_testOlio/JavaOlio/webapp/java/trunk/ws/apps/webapp/build/classes<br>
 
+
 &nbsp;&nbsp;&nbsp; [mkdir] Created dir:
 /Users/klichong/projects/java_testOlio/JavaOlio/webapp/java/trunk/ws/apps/webapp/build/web/WEB-INF/lib<br>
 
+
 &nbsp;&nbsp;&nbsp;&nbsp; [copy] Copying 7 files to
 /Users/klichong/projects/java_testOlio/JavaOlio/webapp/java/trunk/ws/apps/webapp/build/web/WEB-INF/lib<br>
 
+
     <br>
 
+
 ......<br>
 
+
 ......<br>
 
+
     <br>
 
+
 bpp-copy-dist:<br>
 
+
 &nbsp;&nbsp;&nbsp; [mkdir] Created dir: /Users/klichong/projects/java_testOlio/JavaOlio/webapp/java/trunk/ws/apps/webapp/dist<br>
 
+
 &nbsp;&nbsp;&nbsp;&nbsp; [copy] Copying 1 file to
 /Users/klichong/projects/java_testOlio/JavaOlio/webapp/java/trunk/ws/apps/webapp/dist<br>
 
+
     <br>
 
+
 default-not-ear:<br>
 
+
     <br>
 
+
 default:<br>
 
+
     <br>
 
+
 BUILD SUCCESSFUL<br>
 
+
     </span></li>
 
 
@@ -2087,6 +2417,7 @@
 
 
 
+
   <li>The resulting <span style="font-weight: bold;">webapp.wa</span>r
 file should be located in the&nbsp;<span style="font-family: monospace;">&lt;$OLIO_HOME&gt;</span><span style="font-family: monospace;">/ws/apps/webapp/dist </span>directory.</li>
 
@@ -2095,6 +2426,7 @@
 
 
 
+
 </ol>
 
 
@@ -2102,6 +2434,7 @@
 
 
 
+
 <h2>Deploying the Web Application</h2>
 
 
@@ -2109,6 +2442,7 @@
 
 
 
+
 The Java Olio web application can be deployed on any Java EE compliant
 application server with a JPA provider.
 <ol>
@@ -2118,12 +2452,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p>Deploy
 the webapp.war from the $WEBAPP/ws/apps/webapp/dist directory to your
 Java EE 5 application server. &nbsp;<br>
@@ -2133,6 +2469,7 @@
 
 
 
+
 If you are using GlassFish, you can do so by
 either dropping the war file in the
 $GLASSFISH_HOME/domains/domain1/autodeploy directory. &nbsp;You can
@@ -2145,6 +2482,7 @@
 
 
 
+
   </li>
 
 
@@ -2152,6 +2490,7 @@
 
 
 
+
 </ol>
 
 
@@ -2159,6 +2498,7 @@
 
 
 
+
 <h2><a name="installWebApp"></a><font size="4">Configuring the Application Server</font></h2>
 
 
@@ -2166,6 +2506,7 @@
 
 
 
+
 <ol>
 
 
@@ -2173,6 +2514,7 @@
 
 
 
+
   <li>Download the JDBC driver for mysql from <a href="http://dev.mysql.com/downloads/connector/j/5.1.html">http://dev.mysql.com/downloads/connector/j/5.1.html.</a>&nbsp;
 Extract the mysql-connector-java-5.1.X-bin.jar and put this your
 application server classpath (or external library directory)</li>
@@ -2182,6 +2524,7 @@
 
 
 
+
   <li>Download a Java Persistence API (JPA) provider, eg.
 EclipseLink. &nbsp;You will have to download the eclipselink.jar
 from <a href="http://www.eclipse.org/eclipselink">http://www.eclipse.org/eclipselink</a>,
@@ -2192,6 +2535,7 @@
 
 
 
+
   <li>Create JDBC connection pool and resource for connecting to
 mySQL
 database. &nbsp;Below are examples for the properties used for the
@@ -2202,6 +2546,7 @@
 
 
 
+
 &nbsp;&nbsp;&nbsp; * Name: Use this name when you configure
 the JDBC resource.&nbsp; eg. BPwebappPool<br>
 
@@ -2210,6 +2555,7 @@
 
 
 
+
 &nbsp;&nbsp;&nbsp; * Resource Type: Specify the appropriate
 value, eg. javax.sql.DataSource<br>
 
@@ -2218,6 +2564,7 @@
 
 
 
+
 &nbsp;&nbsp;&nbsp; * Database Vendor: mysql<br>
 
 
@@ -2225,6 +2572,7 @@
 
 
 
+
 &nbsp;&nbsp;&nbsp; * DataSource Classname: Specify one of
 the following:<br>
 
@@ -2233,6 +2581,7 @@
 
 
 
+
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 o com.mysql.jdbc.jdbc2.optional.MysqlDataSource<br>
 
@@ -2241,6 +2590,7 @@
 
 
 
+
 &nbsp;&nbsp;&nbsp; * Properties:<br>
 
 
@@ -2248,6 +2598,7 @@
 
 
 
+
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 o serverName -
 Specify the host name or IP address of the database server.<br>
@@ -2257,6 +2608,7 @@
 
 
 
+
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 o port - Specify the port number of the database server eg. 3306<br>
 
@@ -2265,6 +2617,7 @@
 
 
 
+
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 o user - Set as appropriate.<br>
 
@@ -2273,6 +2626,7 @@
 
 
 
+
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 o&nbsp; password - Set as appropriate.<br>
 
@@ -2281,6 +2635,7 @@
 
 
 
+
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 o databaseName - Set as appropriate, eg. bpwebapp<br>
 
@@ -2289,6 +2644,7 @@
 
 
 
+
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 o URL - If you
 are using global transactions, you can set this property instead of
@@ -2300,6 +2656,7 @@
 
 
 
+
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 o Keep the rest of properties created.<br>
 
@@ -2308,6 +2665,7 @@
 
 
 
+
     <br>
 
 
@@ -2315,6 +2673,7 @@
 
 
 
+
 6.&nbsp; Create the JDBC resource with the JNDI name
 jdbc/BPWebappDB pointing to new resource created above.<br>
 
@@ -2323,6 +2682,7 @@
 
 
 
+
   </li>
 
 
@@ -2330,6 +2690,7 @@
 
 
 
+
 </ol>
 
 
@@ -2337,6 +2698,7 @@
 
 
 
+
 <h2><font size="4"><a name="Glassfish_Installation_and_Configuration"></a>&nbsp;Glassfish
 Installation and Configuration</font></h2>
 
@@ -2345,6 +2707,7 @@
 
 
 
+
 <ol>
 
 
@@ -2352,12 +2715,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p>Install Glassfish application server V2 UR2 from <a href="https://glassfish.dev.java.net/public/downloadsindex.html"><span style="text-decoration: underline;">https://glassfish.dev.java.net/public/downloadsindex.html.</span></a>
     <br>
 
@@ -2366,6 +2731,7 @@
 
 
 
+
 The directory where Glassfish has been installed will now be referred
 to as $GLASSFISH_HOME. </p>
 
@@ -2374,6 +2740,7 @@
 
 
 
+
   </li>
 
 
@@ -2381,12 +2748,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p>Download the JDBC driver for mysql from <a href="http://dev.mysql.com/downloads/connector/j/5.1.html">http://dev.mysql.com/downloads/connector/j/5.1.html.</a>
 &nbsp; Extract the mysql-connector-java-5.1.X-bin.jar and drop this
 is
@@ -2398,6 +2767,7 @@
 
 
 
+
   </li>
 
 
@@ -2405,17 +2775,15 @@
 
 
 
+
   <li>The
 benchmark utilizes JPA (Java Persistence API) and has been benchmarked
-with the EclipseLink implementation. &nbsp;If you are using
-Glassfish v2
-UR3, EclipseLink is the JPA implementation bundled with Glassfish.
-&nbsp;If
-you are using an earlier build, you will have to download the
+with the EclipseLink implementation. &nbsp;GlassFish v2
+uses TopLink as the default JPA implementation so you will have to download the
 eclipselink.jar from <a href="http://www.eclipse.org/eclipselink">http://www.eclipse.org/eclipselink</a>,
-and &nbsp;put this in $GLASSFISH_HOME/lib directory. &nbsp;This
+and &nbsp;put this in $GLASSFISH_HOME/lib directory.&nbsp;&nbsp;This
 is a concurrency <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=238696">bug
-filed</a> on EclipseLink so you will need to get a build after
+filed</a> on EclipseLink so you will need to get an EclipseLink build after
 July 2008. </li>
 
 
@@ -2423,6 +2791,7 @@
 
 
 
+
   <br>
 
 
@@ -2430,6 +2799,7 @@
 
 
 
+
   <li>Instructions on how to use the
 Glassfish admin
 interface is <a href="https://glassfish.dev.java.net/javaee5/admin-gui/admin-gui.html#Usage">https://glassfish.dev.java.net/javaee5/admin-gui/admin-gui.html#Usage</a>.
@@ -2441,6 +2811,7 @@
 
 
 
+
 Note:
 &nbsp;To use the admin interface, you will have to start Glassfish.
 &nbsp;To do
@@ -2453,6 +2824,7 @@
 
 
 
+
 &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;To
 stop Glassfish, use $GLASSFISH_HOME/bin/asadmin stop-domain domain1.</li>
 
@@ -2461,12 +2833,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p>Create JDBC connection pool and resource. &nbsp;Please
 consult <a href="https://glassfish.dev.java.net/javaee5/docs/AG/ablih.html">https://glassfish.dev.java.net/javaee5/docs/AG/ablih.html</a>
 for details. &nbsp;MM MySQL Type 4 Driver (Non-XA)<br>
@@ -2476,6 +2850,7 @@
 
 
 
+
 The JAR file for the MySQL driver is
 mysql-connector-java-version-bin.jar, for example,
 mysql-connector-java-5.1.6-bin.jar. Configure the connection pool
@@ -2486,6 +2861,7 @@
 
 
 
+
     </p>
 
 
@@ -2493,6 +2869,8 @@
 
 
 
+
+    
     
     
     
@@ -2505,6 +2883,7 @@
 
 
 
+
       <li>Name: Use this name when you configure the JDBC
 resource. &nbsp;eg. BPwebappPool</li>
 
@@ -2513,6 +2892,7 @@
 
 
 
+
       <li>Resource Type: Specify the appropriate value, eg.
 javax.sql.DataSource</li>
 
@@ -2521,6 +2901,7 @@
 
 
 
+
       <li>Database Vendor: mysql</li>
 
 
@@ -2528,6 +2909,7 @@
 
 
 
+
       <li>DataSource Classname: Specify one of the following:</li>
 
 
@@ -2535,6 +2917,8 @@
 
 
 
+
+      
       
       
       
@@ -2547,6 +2931,7 @@
 
 
 
+
         <li>com.mysql.jdbc.jdbc2.optional.MysqlDataSource</li>
 
 
@@ -2554,6 +2939,8 @@
 
 
 
+
+      
       
       
       
@@ -2566,6 +2953,7 @@
 
 
 
+
       <li>Properties:</li>
 
 
@@ -2573,6 +2961,8 @@
 
 
 
+
+      
       
       
       
@@ -2585,6 +2975,7 @@
 
 
 
+
         <li>serverName - Specify the host name or IP address of
 the database server.</li>
 
@@ -2593,6 +2984,8 @@
 
 
 
+
+      
       
       
       
@@ -2605,6 +2998,8 @@
 
 
 
+
+      
       
       
       
@@ -2617,6 +3012,7 @@
 
 
 
+
         <li>port - Specify the port number of the database server
 eg. 3306</li>
 
@@ -2625,6 +3021,8 @@
 
 
 
+
+      
       
       
       
@@ -2637,6 +3035,8 @@
 
 
 
+
+      
       
       
       
@@ -2649,6 +3049,7 @@
 
 
 
+
         <li>user - Set as appropriate, &nbsp;eg. olio</li>
 
 
@@ -2656,6 +3057,7 @@
 
 
 
+
         <li>&nbsp;password - Set as appropriate, eg. olio</li>
 
 
@@ -2663,6 +3065,7 @@
 
 
 
+
         <li>databaseName - Set as appropriate, eg. bpwebapp</li>
 
 
@@ -2670,6 +3073,7 @@
 
 
 
+
         <li>URL
 - If you are using global transactions, you can set this property
 instead of serverName, port, and databaseName, eg.
@@ -2680,6 +3084,7 @@
 
 
 
+
         <li>Keep the rest of properties created.</li>
 
 
@@ -2687,6 +3092,8 @@
 
 
 
+
+      
       
       
       
@@ -2699,6 +3106,8 @@
 
 
 
+
+    
     
     
     
@@ -2711,6 +3120,7 @@
 
 
 
+
 6. &nbsp;Create the JDBC resource with the JNDI name
 jdbc/BPWebappDB pointing to new resource created above. </li>
 
@@ -2719,6 +3129,7 @@
 
 
 
+
 </ol>
 
 
@@ -2726,6 +3137,7 @@
 
 
 
+
 <h2><a name="installWebApp"></a><font size="4">Tuning Glassfish</font></h2>
 
 
@@ -2733,6 +3145,7 @@
 
 
 
+
 <ol>
 
 
@@ -2740,6 +3153,7 @@
 
 
 
+
   <li>Go to the administration interface, eg.
 http://localhost:4848.</li>
 
@@ -2748,12 +3162,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p>Ensure that you have the JVM option "-server" and the heap
 size
 has been adequately sized. &nbsp;For benchmarking purposes, we have
@@ -2764,6 +3180,7 @@
 
 
 
+
   </li>
 
 
@@ -2771,12 +3188,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p>Start Glassfish. Check that you can connect to it from
 your
 browser (http://<i>host</i>:8080), but don't try to access
@@ -2788,6 +3207,7 @@
 
 
 
+
     </p>
 
 
@@ -2795,6 +3215,8 @@
 
 
 
+
+    
     
     
     
@@ -2807,6 +3229,7 @@
 
 
 
+
       <li>use $GLASSFISH_HOME/bin/asadmin start-domain domain1
 (or
 whatever your
@@ -2817,6 +3240,7 @@
 
 
 
+
       <li>To
 stop Glassfish, use $GLASSFISH_HOME/bin/asadmin stop-domain domain1.</li>
 
@@ -2825,6 +3249,8 @@
 
 
 
+
+    
     
     
     
@@ -2837,6 +3263,7 @@
 
 
 
+
   </li>
 
 
@@ -2844,6 +3271,7 @@
 
 
 
+
 </ol>
 
 
@@ -2851,6 +3279,7 @@
 
 
 
+
 <h2><font size="4">Setting up the
 filestore</font></h2>
 
@@ -2859,6 +3288,7 @@
 
 
 
+
 <p><font size="3">Olio for Java EE can be configured to
 use either a local
 filesystem or MogileFS for the object data. Our initial testing with
@@ -2881,6 +3311,7 @@
 
 
 
+
 <ol>
 
 
@@ -2888,12 +3319,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p><font size="3">Create a directory (or mount a
 filesystem) designated for storing the image and binary files. This
 directory is referred to as &lt;filestore&gt;. Any valid name
@@ -2906,6 +3339,7 @@
 
 
 
+
     </font><font size="3"><span style="font-family: monospace;"># mkdir -p <span style="font-style: italic;">&lt;filestore&gt;</span></span><br style="font-family: monospace;">
 
 
@@ -2913,6 +3347,7 @@
 
 
 
+
     <span style="font-family: monospace;"># chmod a+rwx <span style="font-style: italic;">&lt;filestore&gt;</span></span></font></p>
 
 
@@ -2920,6 +3355,7 @@
 
 
 
+
   </li>
 
 
@@ -2927,12 +3363,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p><font size="3">Now load the filestore.
 &nbsp;You should have the $FABAN_HOME/benchmarks/JavaOlioDriver.jar
 file on this system.</font><br>
@@ -2942,6 +3380,7 @@
 
 
 
+
     <font size="3"><font style="font-family: monospace;" size="3">#&nbsp;<span style="font-style: italic;"></span></font></font>cd
 $FABAN_HOME/benchmarks; mkdir olio<br>
 
@@ -2950,6 +3389,7 @@
 
 
 
+
     <br>
 
 
@@ -2957,6 +3397,7 @@
 
 
 
+
 # cd olio; jar xvf ../JavaOlioDriver.jar; chmod a+x bin/*<br>
 
 
@@ -2964,6 +3405,7 @@
 
 
 
+
 # $FABAN_HOME/benchmarks/olio/bin/fileloader.sh
 &lt;load_scale&gt; $FILESTORE<br>
 
@@ -2972,6 +3414,7 @@
 
 
 
+
     <br>
 
 
@@ -2979,6 +3422,7 @@
 
 
 
+
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; This loads files for
 use for up to<span style="font-style: italic;"> load_scale</span> number of active users.<font size="3"><font style="font-family: monospace;" size="3">&nbsp;<br>
 
@@ -2987,6 +3431,7 @@
 
 
 
+
     <br>
 
 
@@ -2994,6 +3439,7 @@
 
 
 
+
     </font></font><font size="3"><font size="3"><span style="font-family: monospace;"></span></font></font><font size="3"><font size="3"><font>Eg.
 To load the filestore for 1000 users, you would do the following:</font></font></font><font size="3"><font size="3"><span style="font-family: monospace;"></span></font></font><br>
 
@@ -3002,6 +3448,7 @@
 
 
 
+
     <span style="font-family: monospace;"># cd
 /filestore/artifacts</span><br style="font-family: monospace;">
 
@@ -3010,6 +3457,7 @@
 
 
 
+
     <span style="font-family: monospace;">#
 /opt/faban/benchmarks/JavaOlioDriver/bin/fileloader.sh 1000 .</span></p>
 
@@ -3018,12 +3466,14 @@
 
 
 
+
     <font size="3"><font size="3"><span style="font-family: monospace;"></span></font></font>
     
     
     
     
     
+    
     <p><font size="3"><font size="3">This
 loads files for use for up to <span style="font-family: monospace; font-style: italic;">load_scale</span>
 number of concurrent users.&nbsp;</font></font></p>
@@ -3033,6 +3483,7 @@
 
 
 
+
   </li>
 
 
@@ -3040,6 +3491,7 @@
 
 
 
+
   <li><font size="3"><font size="3">The filestore location is read
 from the application server as a Java environment
 variable,&nbsp;webapp.image.directory. &nbsp;To set the value of the
@@ -3053,10 +3505,12 @@
 
 
 
+
     </font></font><font size="3"><font size="3"><span style="font-family: monospace;"><br>
 
 
 
+
     </span></font></font><font size="3"><font size="3"><span style="font-family: monospace;"></span></font></font></li>
 
 
@@ -3064,6 +3518,7 @@
 
 
 
+
 </ol>
 
 
@@ -3071,6 +3526,7 @@
 
 
 
+
 <font size="3"><font size="3"><span style="font-family: monospace;"></span></font></font>
 <h2><font><font size="4">Testing the
 Application</font></font></h2>
@@ -3080,6 +3536,7 @@
 
 
 
+
 <ol>
 
 
@@ -3087,12 +3544,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p><font size="3">Check the home page (HomePage)
 http://&lt;web_server&gt;:8080/webapp/index.jsp. If there are
 no
@@ -3103,6 +3562,7 @@
 
 
 
+
   </li>
 
 
@@ -3110,12 +3570,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p><font size="3">Click on an event
 (EventDetail). Make sure the whole page looks OK. </font> </p>
 
@@ -3124,6 +3586,7 @@
 
 
 
+
   </li>
 
 
@@ -3131,12 +3594,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p><font size="3">Click on an attendee
 (PersonDetail) to see a person's profile. </font> </p>
 
@@ -3145,6 +3610,7 @@
 
 
 
+
   </li>
 
 
@@ -3152,12 +3618,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p><font size="3">Go back to the home page and
 click on a tag in the tag cloud. Choose a big tag and check that we
 have good results and images get loaded OK. </font> </p>
@@ -3167,6 +3635,7 @@
 
 
 
+
   </li>
 
 
@@ -3174,12 +3643,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p><font size="3">Click on the Register button on the top left of the home page. Fill
 in the form and create a user. Make sure you find some jpeg images to
 upload. If not, take them from $FABAN_HOME/benchmarks/JavaOlioDriver/resources. <br>
@@ -3189,6 +3660,7 @@
 
 
 
+
 Submit the form. Make sure the form goes through. This completes the
 AddPerson transaction. </font> </p>
 
@@ -3197,6 +3669,7 @@
 
 
 
+
   </li>
 
 
@@ -3204,12 +3677,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p><font size="3">Login using your new login
 name you just created. The top right of the screen should show that
 you're logged on. </font> </p>
@@ -3219,6 +3694,7 @@
 
 
 
+
   </li>
 
 
@@ -3226,12 +3702,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p><font size="3">Select an event, go back to
 the EventDetail page but this time as a logged on user. <br>
 
@@ -3240,6 +3718,7 @@
 
 
 
+
 Add yourself as an attendee. This is the EventDetail transaction with
 attendee added (about 8-9% of all EventDetail views). </font> </p>
 
@@ -3248,6 +3727,7 @@
 
 
 
+
   </li>
 
 
@@ -3255,12 +3735,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p><font size="3">Click on the add event tab and
 add an event. Make sure to include an image and some literature. You
 can also use the files from <br>
@@ -3270,6 +3752,7 @@
 
 
 
+
 $FABAN_HOME/benchmarks/JavaOlioDriver/resources. Fill in the form and submit.
 This is the AddEvent transaction. <br>
 
@@ -3278,6 +3761,7 @@
 
 
 
+
     <br>
 
 
@@ -3285,6 +3769,7 @@
 
 
 
+
     </font> </p>
 
 
@@ -3292,6 +3777,7 @@
 
 
 
+
   </li>
 
 
@@ -3299,6 +3785,7 @@
 
 
 
+
 </ol>
 
 
@@ -3306,6 +3793,7 @@
 
 
 
+
 <h2><a name="startRun"></a><font size="4">Starting
 a benchmark run</font></h2>
 
@@ -3314,6 +3802,7 @@
 
 
 
+
 <p style="margin-bottom: 0in;">Now that we know that the
 web
 application is running and the faban harness is up, it is time to
@@ -3324,6 +3813,7 @@
 
 
 
+
 <ol>
 
 
@@ -3331,6 +3821,7 @@
 
 
 
+
   <li>Kill memcached. Memcached is always started by the driver
 before the run to ensure a clean cache and will cause port conflicts if
 it is already running.</li>
@@ -3340,12 +3831,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p>Point your browser at http://<i>&lt;driver_machine&gt;</i>:9980</p>
 
 
@@ -3353,6 +3846,7 @@
 
 
 
+
   </li>
 
 
@@ -3360,12 +3854,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p>Click on the <span style="font-style: normal;"><b>Schedule
 Run</b></span> link.</p>
 
@@ -3374,6 +3870,7 @@
 
 
 
+
   </li>
 
 
@@ -3381,12 +3878,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p>Under the JAVA tab, set the JAVA_HOME. You can accept the
 default value for JVM options. <span style="font-weight: bold;">DO
 NOT</span> click on the OK button yet !</p>
@@ -3396,6 +3895,7 @@
 
 
 
+
   </li>
 
 
@@ -3403,12 +3903,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p>Select the Driver tab. </p>
 
 
@@ -3416,6 +3918,8 @@
 
 
 
+
+    
     
     
     
@@ -3431,6 +3935,8 @@
 
 
 
+
+    
     
     
     
@@ -3445,6 +3951,8 @@
 
 
 
+
+    
     
     
     
@@ -3458,6 +3966,8 @@
 
 
 
+
+    
     
     
     
@@ -3473,6 +3983,8 @@
 
 
 
+
+    
     
     
     
@@ -3488,6 +4000,8 @@
 
 
 
+
+    
     
     
     
@@ -3504,6 +4018,7 @@
 
 
 
+
   </li>
 
 
@@ -3511,12 +4026,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p>Select the Web Server tab.<br>
 
 
@@ -3524,8 +4041,10 @@
 
 
 
+
     <br>
 
+
 The number of Agents is best the same or multiple the number of driver
 machines - we start with 1. The Host:Port Pairs field takes the host
 port pairs where the web applications are running. The host and port is
@@ -3533,8 +4052,10 @@
 you cannot use the string "localhost" - you must specify a valid
 hostname or IP number. <br>
 
+
     <br>
 
+
 For the
 Webserver type field, enter either "GlassFish" dependent on which web
 server you're using, or leave the field blank if you're using servers
@@ -3542,14 +4063,18 @@
 time. Then provide the application server's bin, log, and config
 directories. &nbsp;<br>
 
+
     <br>
 
+
 You can ignore the box for the directory
 containing
 the php.ini file in the respective fields - that field is for the PHP version of Olio. <br>
 
+
     <br>
 
+
 Next, choose the server type
 to be Java, if it is not already that way. Then, in the tools box, type
 the tools you want to run. Here are the tools we typically run : vmstat
@@ -3560,6 +4085,8 @@
 
 
 
+
+    
     
     
     
@@ -3574,8 +4101,10 @@
 start the GlassFish server and assume that you have already started it
 before the run.<br>
 
+
     <br>
 
+
 The number of Agents is
 the same as the number of driver machines &ndash; we start with 1.</p>
 
@@ -3584,6 +4113,8 @@
 
 
 
+
+    
     
     
     
@@ -3594,6 +4125,7 @@
 use the string "localhost" - you must specify a valid hostname or IP
 number. <br>
 
+
  </p>
 
 
@@ -3601,6 +4133,8 @@
 
 
 
+
+    
     
     
     
@@ -3614,6 +4148,7 @@
 
 
 
+
   </li>
 
 
@@ -3621,12 +4156,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p style="margin-bottom: 0in;">Select the Data Servers
 tab.</p>
 
@@ -3635,6 +4172,8 @@
 
 
 
+
+    
     
     
     
@@ -3644,6 +4183,7 @@
 server, enter the Host name. Edit the hostname part along of the JDBC
 Connection URL. &nbsp; &nbsp;Note that you cannot use the string "localhost" - you must specify a valid hostname or IP number. <br>
 
+
  This is used by the loader program to reload the
 database before a run. Set the 'Loader for Concurrent Users' to 25
 (this is the minimum number of users we can load for and is good for up
@@ -3658,6 +4198,8 @@
 
 
 
+
+    
     
     
     
@@ -3672,6 +4214,8 @@
 
 
 
+
+    
     
     
     
@@ -3689,6 +4233,7 @@
 
 
 
+
     <span style="font-weight: bold;">*NOTE - the memcache
 server information is not necessary in this release of Java Olio. &nbsp;You can leave these fields blank</span></p>
 
@@ -3697,6 +4242,7 @@
 
 
 
+
   </li>
 
 
@@ -3704,12 +4250,14 @@
 
 
 
+
   <li>
     
     
     
     
     
+    
     <p>That's it. Click OK and the run should be scheduled. You
 can click on the View Results link on the left to monitor the run.</p>
 
@@ -3718,6 +4266,7 @@
 
 
 
+
   </li>
 
 
@@ -3725,6 +4274,7 @@
 
 
 
+
 </ol>
 
 
@@ -3732,6 +4282,7 @@
 
 
 
+
 <br>
 
 
@@ -3739,5 +4290,6 @@
 
 
 
+
 </body>
 </html>



Mime
View raw message