You are viewing a plain text version of this content. The canonical link for it is here.
Posted to olio-commits@incubator.apache.org by kl...@apache.org on 2009/09/18 21:43:41 UTC
svn commit: r816793 - /incubator/olio/docs/java_setup.html
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. Keep in
@@ -296,16 +337,19 @@
+
<br>
+
Java Olio is available either as a kit, or by downloading the source.
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 </a></li>
@@ -423,6 +483,7 @@
+
<li><a href="http://subversion.tigris.org/">Subversion: </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-<version>.tar.gz | gtar xvf -<br>
+
<br>
+
This will cause a directory named olio-java-<version> 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> 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> <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 - 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. 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. 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 $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><driver_machine></i>:9980.
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. 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 $MYSQL_HOME -g mysql -s /usr/bin/bash </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 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. 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;">$ </span><span style="font-family: monospace;">./mysqld_safe --defaults-file=/etc/my.cnf &</span><br style="font-family: monospace;">
@@ -1127,6 +1300,7 @@
+
<span style="font-family: monospace;">$ ./mysqladmin
-u root password <span style="font-style: italic;"><your-</span></span><i style="font-family: monospace;"><span style="font-style: italic;">password></span><br>
@@ -1135,6 +1309,7 @@
+
$ </i><span style="font-family: monospace;">./mysqladmin
-u root -h <machine-name> password</span><i style="font-family: monospace;">
<your-password></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>
create user 'olio'@'%' identified by 'olio';</span><br style="font-family: monospace;">
@@ -1180,6 +1360,7 @@
+
<span style="font-family: monospace;">mysql>
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>
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>
create database bpwebapp;</span><br style="font-family: monospace;">
@@ -1252,6 +1441,7 @@
+
<span style="font-family: monospace;">mysql>
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> \.</span><span style="font-style: italic; font-family: monospace;">
<location></span><span style="font-family: monospace;">/schema.sql<br>
@@ -1302,6 +1497,7 @@
+
mysql> exit</span><span style="font-family: monospace;"><br>
@@ -1309,6 +1505,7 @@
+
</span> 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
$FABAN_HOME/benchmarks/JavaOlioDriver/lib in step 3 of <a href="#setupDriver">Setting Up the Driver</a> section. On line 51 of dbloader.sh, the CLASSPATH is currently set to MySQL JDBC driver version 5.0.6. <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;"><dbserver>
<load_scale></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 &</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>
(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 –
@@ -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 ( 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. 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. <br>
@@ -1805,6 +2067,7 @@
+
<ol>
@@ -1812,6 +2075,7 @@
+
<li>Edit web.xml in the application war file to configure
the
geocoder URL. 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. Edit the
build.properties for the relevant build details.
@@ -1900,6 +2175,7 @@
+
<span style="font-family: monospace;">$ vi
<$WEBAPP>/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. 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
<$WEBAPP>/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. 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>
+
[echo] Compiling webapp<br>
+
[javac] Compiling 49 source files to
/Users/klichong/projects/java_testOlio/JavaOlio/webapp/java/trunk/ws/apps/webapp/build/classes<br>
+
[javac] Note: Some input files use unchecked or unsafe operations.<br>
+
[javac] Note: Recompile with -Xlint:unchecked for details.<br>
+
<br>
+
include-jmaki-local:<br>
+
<br>
+
include-jmaki:<br>
+
[echo] Copying jMaki Runtime to
/Users/klichong/projects/java_testOlio/JavaOlio/webapp/java/trunk/ws/apps/webapp/./build/web<br>
+
[mkdir] Created dir:
/Users/klichong/projects/java_testOlio/JavaOlio/webapp/java/trunk/ws/apps/webapp/build/web/temp<br>
+
[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>
+
[mkdir] Created dir:
/Users/klichong/projects/java_testOlio/JavaOlio/webapp/java/trunk/ws/apps/webapp/build/web/resources<br>
+
[delete] Deleting directory
/Users/klichong/projects/java_testOlio/JavaOlio/webapp/java/trunk/ws/apps/webapp/build/web/temp<br>
+
<br>
+
-post-compile:<br>
+
[copy] Copying 3 files to
/Users/klichong/projects/java_testOlio/JavaOlio/webapp/java/trunk/ws/apps/webapp/build/classes<br>
+
[mkdir] Created dir:
/Users/klichong/projects/java_testOlio/JavaOlio/webapp/java/trunk/ws/apps/webapp/build/web/WEB-INF/lib<br>
+
[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>
+
[mkdir] Created dir: /Users/klichong/projects/java_testOlio/JavaOlio/webapp/java/trunk/ws/apps/webapp/dist<br>
+
[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 <span style="font-family: monospace;"><$OLIO_HOME></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. <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. 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>
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. 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. Below are examples for the properties used for the
@@ -2202,6 +2546,7 @@
+
* Name: Use this name when you configure
the JDBC resource. eg. BPwebappPool<br>
@@ -2210,6 +2555,7 @@
+
* Resource Type: Specify the appropriate
value, eg. javax.sql.DataSource<br>
@@ -2218,6 +2564,7 @@
+
* Database Vendor: mysql<br>
@@ -2225,6 +2572,7 @@
+
* DataSource Classname: Specify one of
the following:<br>
@@ -2233,6 +2581,7 @@
+
o com.mysql.jdbc.jdbc2.optional.MysqlDataSource<br>
@@ -2241,6 +2590,7 @@
+
* Properties:<br>
@@ -2248,6 +2598,7 @@
+
o serverName -
Specify the host name or IP address of the database server.<br>
@@ -2257,6 +2608,7 @@
+
o port - Specify the port number of the database server eg. 3306<br>
@@ -2265,6 +2617,7 @@
+
o user - Set as appropriate.<br>
@@ -2273,6 +2626,7 @@
+
o password - Set as appropriate.<br>
@@ -2281,6 +2635,7 @@
+
o databaseName - Set as appropriate, eg. bpwebapp<br>
@@ -2289,6 +2644,7 @@
+
o URL - If you
are using global transactions, you can set this property instead of
@@ -2300,6 +2656,7 @@
+
o Keep the rest of properties created.<br>
@@ -2308,6 +2665,7 @@
+
<br>
@@ -2315,6 +2673,7 @@
+
6. 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> 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>
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. If you are using
-Glassfish v2
-UR3, EclipseLink is the JPA implementation bundled with Glassfish.
- If
-you are using an earlier build, you will have to download the
+with the EclipseLink implementation. 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 put this in $GLASSFISH_HOME/lib directory. This
+and put this in $GLASSFISH_HOME/lib directory. 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:
To use the admin interface, you will have to start Glassfish.
To do
@@ -2453,6 +2824,7 @@
+
To
stop Glassfish, use $GLASSFISH_HOME/bin/asadmin stop-domain domain1.</li>
@@ -2461,12 +2833,14 @@
+
<li>
+
<p>Create JDBC connection pool and resource. 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. 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. 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, eg. olio</li>
@@ -2656,6 +3057,7 @@
+
<li> 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. 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. 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 <filestore>. Any valid name
@@ -2906,6 +3339,7 @@
+
</font><font size="3"><span style="font-family: monospace;"># mkdir -p <span style="font-style: italic;"><filestore></span></span><br style="font-family: monospace;">
@@ -2913,6 +3347,7 @@
+
<span style="font-family: monospace;"># chmod a+rwx <span style="font-style: italic;"><filestore></span></span></font></p>
@@ -2920,6 +3355,7 @@
+
</li>
@@ -2927,12 +3363,14 @@
+
<li>
+
<p><font size="3">Now load the filestore.
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"># <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
<load_scale> $FILESTORE<br>
@@ -2972,6 +3414,7 @@
+
<br>
@@ -2979,6 +3422,7 @@
+
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"> <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. </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, webapp.image.directory. 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://<web_server>: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><driver_machine></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. <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 – 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. 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. 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>