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 sh...@apache.org on 2009/09/30 17:35:33 UTC
svn commit: r820360 [4/7] - in /incubator/olio/docs: java_setup.html
java_setup_kit.html php_setup.html php_setup_kit.html rails_setup.html
rails_setup_kit.html
Modified: incubator/olio/docs/php_setup.html
URL: http://svn.apache.org/viewvc/incubator/olio/docs/php_setup.html?rev=820360&r1=820359&r2=820360&view=diff
==============================================================================
--- incubator/olio/docs/php_setup.html (original)
+++ incubator/olio/docs/php_setup.html Wed Sep 30 17:35:33 2009
@@ -1,13 +1,13 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<HTML>
-<HEAD>
- <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
- <TITLE>Olio/PHP Install and Setup Guide</TITLE>
- <META NAME="GENERATOR" CONTENT="NeoOffice 2.2 (Unix)">
- <META NAME="AUTHOR" CONTENT="Akara Sucharitakul">
- <META NAME="CREATED" CONTENT="20070926;10111500">
- <META NAME="CHANGED" CONTENT="20090331;16105100">
- <!-- Licensed to the Apache Software Foundation (ASF) under one
+<html>
+<head>
+ <meta http-equiv="CONTENT-TYPE" content="text/html; charset=utf-8">
+ <title>Olio/PHP Install and Setup Guide</title>
+ <meta name="GENERATOR" content="NeoOffice 2.2 (Unix)">
+ <meta name="AUTHOR" content="Akara Sucharitakul">
+ <meta name="CREATED" content="20070926;10111500">
+ <meta name="CHANGED" content="20090331;16105100">
+<!-- Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
regarding copyright ownership. The ASF licenses this file
@@ -24,36 +24,47 @@
specific language governing permissions and limitations
under the License.
-->
- <STYLE TYPE="text/css">
+ <style type="text/css">
<!--
H1 { color: #000000 }
P { color: #000000 }
H2 { color: #000000 }
-->
- </STYLE>
-</HEAD>
-<BODY LANG="en-US" TEXT="#000000" DIR="LTR">
-<H1 ALIGN=CENTER>Olio/PHP <BR>Install and Setup Guide from Source
-Tree</H1>
-<H2>Overview</H2>
-<P>Olio is a macro-level toolkit consisting of the following
-components:</P>
-<OL>
- <LI><P STYLE="margin-bottom: 0in">The web application
- </P>
- <LI><P STYLE="margin-bottom: 0in">The main database
- </P>
- <LI><P STYLE="margin-bottom: 0in">Distributed storage servers (NFS
- or MogileFS)</P>
- <LI><P STYLE="margin-bottom: 0in">The caching server (memcached)</P>
- <LI><P STYLE="margin-bottom: 0in">Storage metadata database (for
- MogileFS only)</P>
- <LI><P STYLE="margin-bottom: 0in">Geocoder emulator
- </P>
- <LI><P>Workload driver
- </P>
-</OL>
-<P>If your primary interest is in setting up the application alone,
+ </style>
+</head>
+<body dir="ltr" lang="en-US" text="#000000">
+<h1 align="center">Olio/PHP <br>
+Install and Setup Guide from Source<br>
+</h1>
+<h2>Overview</h2>
+<p>Olio is a macro-level toolkit consisting of the following
+components:</p>
+<ol>
+ <li>
+ <p style="margin-bottom: 0in;">The web application </p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0in;">The main database </p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0in;">Distributed storage servers (NFS or
+MogileFS)</p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0in;">The caching server (memcached)</p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0in;">Storage metadata database (for
+MogileFS only)</p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0in;">Geocoder emulator </p>
+ </li>
+ <li>
+ <p>Workload driver </p>
+ </li>
+</ol>
+<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 application, you will need at least 2 systems. At higher loads,
@@ -62,227 +73,335 @@
valid results. The non-SUT components are the Geocoder emulator and
the workload driver. It is best to connect the driver machine to the
SUT machine on a local private network. This ensures that latencies
-measured do not include arbitrary delays.</P>
-<P>For a horizontally scaled workload, or to measure the performance
+measured do not include arbitrary delays.</p>
+<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 mind though that the
-bulk of the CPU is consumed in the web application tier (apache/php).</P>
-<P STYLE="margin-bottom: 0in">In the following sections, we will go
-over the steps needed to configure each component :</P>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<P><A HREF="#Downloading The Source|outline">Downloading the source</A></P>
-<P><A HREF="#setupDriver"><U>Setting up the driver</U></A></P>
-<P><A HREF="#installWebApp">Installing the Web Application</A></P>
-<P><A HREF="#setupDB">Setting up the database</A></P>
-<P><A HREF="#loadDB">Loading the database</A></P>
-<P><A HREF="#setupFileStore">Setting up the filestore</A></P>
-<P><A HREF="#setupEmulator">Setting up the Geocoder Emulator</A></P>
-<P><A HREF="#testWebApp">Testing the web application</A></P>
-<P><A HREF="#startRun">Starting a performance test</A></P>
-<H2><A NAME="Downloading The Source|outline"></A>Downloading The
-Source</H2>
-<P>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>
+bulk of the CPU is consumed in the web application tier (apache/php).</p>
+<p style="margin-bottom: 0in;">In the following sections, we will go
+over the steps needed to configure each component :</p>
+<p style="margin-bottom: 0in;"><br>
+</p>
+<p><a href="#Downloading%20The%20Source%7Coutline">Downloading the
+Source</a></p>
+<p><a href="#setupDriver"><u>Setting up the Driver</u></a></p>
+<p><a href="#installWebApp">Installing the Web Application</a></p>
+<p><a href="#setupDB">Setting up the Database</a></p>
+<p><a href="#loadDB">Loading the Database</a></p>
+<p><a href="#setupFileStore">Setting up the Filestore</a></p>
+<p><a href="#setupEmulator">Setting up the Geocoder Emulator</a><br>
+</p>
+<p><a href="#Setting_up_Memcached">Setting up Memcached</a><br>
+</p>
+<p><a href="#testWebApp">Testing the Web Application</a></p>
+<p><a href="#startRun">Starting a Performance Test</a></p>
+<h2><a name="Downloading The Source|outline"></a>Downloading the
+Source</h2>
+<p>The Olio source is available in the source package
+(apache-olio-php-src-<version>.tar) from the Olio <a
+ href="http://incubator.apache.org/olio/downloads">Downloads</a> page
+or via SVN at
+<a href="https://svn.apache.org/repos/asf/incubator/olio/">https://svn.apache.org/repos/asf/incubator/olio/</a>.
+The source kit offers a stable release and the SVN repository has the
+latest code. If you choose to use SVN, 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
directory where the source is downloaded. The source is organized as
-follows :</P>
-<UL>
- <LI><P>The <I>webapp</I> directory contains the web application. The
- <I>php/trunk</I> sub-directory contains the web application for the
- PHP implementation. We will refer to <I>webapp/php/trunk</I> as
- $WEBAPP in this document.</P>
- <LI><P>The <I>workload</I> directory contains the code for the load
- generator/driver (which we typically refer to simply as <I>driver</I>).
- The driver is implemented using <A HREF="http://faban.sunsource.net/"><I>Faban</I></A>
- â an open source benchmarking toolkit. The <I>php/trunk</I>
- sub-directory has the faban driver code to drive the php
- application. In future, we plan to integrate the driver source for
- all implementations of the application. The <I>workload/php/trunk</I>
- directory is referred to as $WORKLOAD in this document.</P>
- <LI><P>The <I>geocoder</I> directory contains the code for the
- geocoder emulator. This code is shared across all implementations of
- Olio.</P>
-</UL>
-<H2><A NAME="setupDriver"></A>Setting up the driver</H2>
-<P>Even if you don't plan to drive load against the application, this
+follows :</p>
+<ul>
+ <li>
+ <p>The <i>webapp</i> directory contains the web application. The <i>php/trunk</i>
+sub-directory contains the web application for the PHP implementation.
+We will refer to <i>webapp/php/trunk</i> as $WEBAPP in this document.</p>
+ </li>
+ <li>
+ <p>The <i>workload</i> directory contains the code for the load
+generator/driver (which we typically refer to simply as <i>driver</i>).
+The driver is implemented using <a href="http://faban.sunsource.net/"><i>Faban</i></a>
+â an open source benchmarking toolkit. The <i>php/trunk</i>
+sub-directory has the faban driver code to drive the php application.
+In future, we plan to integrate the driver source for all
+implementations of the application. The <i>workload/php/trunk</i>
+directory is referred to as $WORKLOAD in this document.</p>
+ </li>
+ <li>
+ <p>The <i>geocoder</i> directory contains the code for the
+geocoder emulator. This code is shared across all implementations of
+Olio.</p>
+ </li>
+</ul>
+<h2><a name="setupDriver"></a>Setting up the driver</h2>
+<p>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
-system as the web application.</P>
-<OL>
- <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 test. Please also read
- the <I>Getting Started Guide</I> to get a high-level understanding
- of Faban terminology and how it works. From now on, we will refer to
- the faban install directory as $FABAN_HOME.</P>
- <LI><P ALIGN=LEFT>To build the driver, do the following:</P>
-</OL>
-<UL>
- <UL>
- <LI><P ALIGN=LEFT><FONT FACE="Cumberland, monospace"><FONT SIZE=3>cd
- $WORKLOAD; cp build.properties.template build.properties</FONT></FONT></P>
- <LI><P ALIGN=LEFT>Edit build.properties and set faban.home to
- $FABAN_HOME, faban.url to http://<I>driver_host</I>:9980 where
- <I>driver_host</I> is the name of the machine where the Faban
- master will run. This is usually the driver system.</P>
- <LI><P ALIGN=LEFT>Set the environment variable JAVA_HOME to point
- to your JDK1.6 installation.</P>
- <LI><P ALIGN=LEFT>Build the driver using the command: <I>ant
- deploy.jar. </I><SPAN STYLE="font-style: normal">If successful, you
- should see the file </SPAN><I>OlioDriver.jar</I> <SPAN STYLE="font-style: normal">in
- the </SPAN><I>build</I> <SPAN STYLE="font-style: normal">sub-directory.</SPAN></P>
- </UL>
-</UL>
-<OL START=3>
- <LI><P ALIGN=LEFT>Copy <FONT FACE="Cumberland, monospace">$WORKLOAD/build/Olio</FONT><FONT FACE="Cumberland, monospace"><SPAN STYLE="font-weight: medium">Driver</SPAN></FONT><FONT FACE="Cumberland, monospace"><I><SPAN STYLE="font-weight: medium">.</SPAN></I></FONT><FONT FACE="Cumberland, monospace"><SPAN STYLE="font-style: normal"><SPAN STYLE="font-weight: medium">jar</SPAN></SPAN></FONT>
- to the <FONT FACE="Cumberland, monospace">$FABAN_HOME/benchmarks</FONT>
- directory. Also copy the OlioDriver.jar file to the
- $FABAN_HOME/benchmarks directory on the web server system.</P>
- <LI><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>
- <LI><P ALIGN=LEFT>Start the faban master on the master driver
- machine :</P>
- <P ALIGN=LEFT>$FABAN_HOME/master/bin/startup.sh</P>
- <LI><P ALIGN=LEFT>Test that you can connect to the master by
- pointing your browser at http://<I><driver_machine></I>:9980.
- </P>
- <LI><P ALIGN=LEFT><A HREF="http://dev.mysql.com/downloads/connector/j/5.0.html">Download</A>
- MySQL Connector/J (JDBC Driver for MySQL) and install the jar in
- $FABAN_HOME/benchmarks/OlioDriver/lib.</P>
-</OL>
-<H2><A NAME="installWebApp"></A><FONT SIZE=4>Installing the Web
-Application</FONT></H2>
-<P>The web application is a PHP application. It requires the
-following components:</P>
-<OL>
- <LI><P STYLE="margin-bottom: 0in">A web server such as Apache2 or
- Lighttpd</P>
- <LI><P STYLE="margin-bottom: 0in">PHP 5 with extensions: apc.so,
- curl.so, gd.so, pdo_mysql.so</P>
- <LI><P STYLE="margin-bottom: 0in">MySQL 5 (5.1 recommended)</P>
- <LI><P STYLE="margin-bottom: 0in">Memcached
- </P>
-</OL>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<P>All of these applications are included in OpenSolaris. If you're
+workload driver â in this case feel free to install the driver on the
+same
+system as the web application.</p>
+<ol>
+ <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 test. Please also read the <i>Getting
+Started Guide</i> to get a high-level understanding of Faban
+terminology and how it works. From now on, we will refer to the faban
+install directory as $FABAN_HOME.</p>
+ </li>
+ <li>Install the required Faban services:</li>
+ <ul>
+ <li><code>cd $FABAN_HOME</code></li>
+ <li><code>cp
+samples/services/ApacheHttpdService/build/ApacheHttpdService.jar
+services</code></li>
+ <li><code>cp samples/services/MysqlService/build/MysqlService.jar
+services</code></li>
+ <li><code>cp
+samples/services/MemcachedService/build/MemcachedService.jar services</code><br>
+ </li>
+ </ul>
+ <li>
+ <p align="left">To build the driver, do the following:</p>
+ </li>
+</ol>
+<ul>
+ <ul>
+ <li>
+ <p align="left"><small><code><font face="Cumberland, monospace"><font
+ size="3"><small>cd $WORKLOAD; cp build.properties.template
+build.properties</small></font></font></code></small></p>
+ <small> </small></li>
+ <li>
+ <p align="left">Edit build.properties and set faban.home to
+$FABAN_HOME, faban.url to http://<i>driver_host</i>:9980 where <i>driver_host</i>
+is the name of the machine where the Faban master will run. This is
+usually the driver system.</p>
+ </li>
+ <li>
+ <p align="left">Set the environment variable JAVA_HOME to point
+to your JDK1.6 installation.</p>
+ </li>
+ <li><a href="http://dev.mysql.com/downloads/connector/j/5.0.html">Download</a>
+MySQL Connector/J (JDBC Driver for MySQL) and install the jar in
+$WORKLOAD/lib<br>
+ </li>
+ <li>
+ <p align="left">Build the driver using the command: <i>ant
+deploy.jar. </i><span style="font-style: normal;">If successful, you
+should see the file </span><i>OlioDriver.jar</i> <span
+ style="font-style: normal;">in the </span><i>build</i> <span
+ style="font-style: normal;">sub-directory.</span></p>
+ </li>
+ </ul>
+</ul>
+<ol start="3">
+ <li>
+ <p align="left">Copy <font face="Cumberland, monospace">$WORKLOAD/build/Olio</font><font
+ face="Cumberland, monospace"><span style="">Driver</span></font><font
+ face="Cumberland, monospace"><i><span style="">.</span></i></font><font
+ face="Cumberland, monospace"><span style="font-style: normal;"><span
+ style="">jar</span></span></font> to the <font
+ face="Cumberland, monospace">$FABAN_HOME/benchmarks</font> directory.
+Also copy the OlioDriver.jar file to the $FABAN_HOME/benchmarks
+directory on the web server system.</p>
+ </li>
+ <li>
+ <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>
+ </li>
+ <li>
+ <p align="left">Start the faban master on the master driver machine
+:</p>
+ <p align="left">$FABAN_HOME/master/bin/startup.sh</p>
+ </li>
+ <li>
+ <p align="left">Test that you can connect to the master by pointing
+your browser at http://<i><driver_machine></i>:9980. </p>
+ </li>
+ <li>
+ <p align="left"><span style="text-decoration: underline;"></span>Copy
+the MySQL Connector/J (JDBC Driver for MySQL) jar to
+$FABAN_HOME/benchmarks/OlioDriver/lib.</p>
+ </li>
+</ol>
+<h2><a name="installWebApp"></a><font size="4">Installing the Web
+Application</font></h2>
+<p>The web application is a PHP application. It requires the
+following components:</p>
+<ol>
+ <li>
+ <p style="margin-bottom: 0in;">A web server such as Apache2 or
+Lighttpd</p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0in;">PHP 5 with extensions: apc.so,
+curl.so, gd.so, pdo_mysql.so</p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0in;">MySQL 5 (5.1 recommended)</p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0in;">Memcached </p>
+ </li>
+</ol>
+<p>All of these applications are included in OpenSolaris. Sun Web Stack
+is one pre-integrated suite
+of open source applications
+optimized for Solaris and RHEL. 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
running on any other operating system, please install the above
-applications.<BR><BR>Once you have the application stack installed,
-follow the steps below to set up the application.
-</P>
-<OL>
- <LI><P>Decide where you want to install the web application. The
- default for apache is the htdocs sub-directory but a common location
- is /var/www. Create a sub-directory <I>oliophp</I> where the php
- application will reside. We will use $APP_DIR to refer to this
- location.</P>
- <LI><P>After installing all the above packages, edit the httpd.conf
- used by your system's apache installation. Set the <B>Listen</B>
- parameter to the hostname or ip address and set the <B>DocumentRoot</B>
- to $APP_DIR/public_html. See the <I>httpd.conf </I>file in
- $APP_DIR/etc for additional settings.</P>
- <LI><P STYLE="margin-bottom: 0in">See the php.ini provided in
- $APP_DIR/etc and copy the settings appropriately to the php.ini for
- your installation.</P>
-</OL>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<P STYLE="margin-bottom: 0in"><A NAME="setupDB"></A><BR><FONT SIZE=4><B>Setting
-up the database</B></FONT>
-</P>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<OL>
- <LI><P>If you plan to run MySQL on a separate machine, install MySQL
- on that system. We will refer to the MySQL installation directory as
- MYSQL_HOME.</P>
- <LI><P>Setup the mysql user/group and permissions for it's
- directories: <BR><FONT FACE="monospace"># groupadd mysql </FONT><BR><FONT FACE="monospace">#
- useradd -d $MYSQL_HOME -g mysql -s /usr/bin/bash mysql<BR>#
- chown -R mysql:mysql $MYSQL_HOME</FONT></P>
- <LI><P>Create the database :<BR><FONT FACE="monospace"># su -
- mysql</FONT><BR><FONT FACE="monospace">$ cd bin</FONT><BR><FONT FACE="monospace">$
- ./mysql_install_db</FONT></P>
- <LI><P><FONT FACE="Times New Roman, serif">A sample MySQL
- configuration file (my.cnf) is included in the $APP_DIR/etc. Please
- read the embedded comments and edit the file appropriately after
- copying it to /etc. </FONT>
- </P>
- <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><FONT FACE="monospace">$ ./mysqld_safe
- âdefaults-file=/etc/my.cnf &</FONT><BR><FONT FACE="monospace">$
- ./mysqladmin -u root password </FONT><FONT FACE="monospace"><I>pwd</I></FONT></P>
- <LI><P>Create the olio user and grant privileges:<BR><FONT FACE="monospace">$
- ./mysql -uroot -p</FONT><FONT FACE="monospace"><I>pwd</I></FONT><BR><FONT FACE="monospace">mysql>
- create user 'olio'@'%' identified by 'olio';</FONT><BR><FONT FACE="monospace">mysql>
- grant all privileges on *.* to 'olio'@'%' identified by 'olio' with
- grant option;<BR></FONT><BR>In some cases the wildcard '%' does not
- work reliably as a substitution for all hosts. You need to grant the
- privileges to 'olio'@'<hostname>' individually, where hostname
- is localhost, the name of the database system and any other names
- that are used to access the database system.
- </P>
- <LI><P STYLE="margin-bottom: 0in">Create database<BR><FONT FACE="monospace">mysql>
- create database olio;</FONT><BR><FONT FACE="monospace">mysql> use
- olio;</FONT>
- </P>
-</OL>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<OL START=7>
- <LI><P>To create the database schema, you first need to copy the
- schema script from the driver system. It is located in
- $FABAN_HOME/benchmarks/OlioDriver/bin/schema.sql. Copy the script
- anywhere on the database server and create the schema:</P>
-</OL>
-<P STYLE="margin-left: 0.55in"><FONT FACE="Monospace">$ mysql -uroot
--ppwd</FONT><BR><FONT FACE="monospace">mysql>
-\.</FONT><FONT FACE="monospace"><I><location></I></FONT><FONT FACE="monospace">/schema.sql<BR>mysql>
-exit</FONT><BR><FONT FACE="monospace">$</FONT><BR><BR>Now, if you
-login as the user <I>olio</I>, you should be able to see the database
-created by the root user.</P>
-<H2><A NAME="loadDB"></A><FONT SIZE=4>Loading the database</FONT></H2>
-<P><FONT SIZE=3>It is best to load the database manually the first
+applications.<br>
+<br>
+Once you have the application stack installed,
+follow the steps below to set up the application. </p>
+<ol>
+ <li>
+ <p>Decide where you want to install the web application. The
+default for apache is the htdocs sub-directory but a common location is
+/var/www. Create a sub-directory <i>oliophp</i> where the php
+application will reside. We will use $APP_DIR to refer to this location.</p>
+ </li>
+ <li>
+ <p>After installing all the above packages, edit the httpd.conf
+used by your system's apache installation. Set the <b>Listen</b>
+parameter to the hostname or ip address and set the <b>DocumentRoot</b>
+to $APP_DIR/public_html. See the <i>httpd.conf </i>file in
+$APP_DIR/etc for additional settings.</p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0in;">See the php.ini provided in
+$APP_DIR/etc and copy the settings appropriately to the php.ini for
+your installation.</p>
+ </li>
+</ol>
+<p style="margin-bottom: 0in;"><a name="setupDB"></a><br>
+<font size="4"><b>Setting
+up the database</b></font> </p>
+<ol>
+ <li>
+ <p>If you plan to run MySQL on a separate machine, install MySQL on
+that system. We will refer to the MySQL installation directory as
+MYSQL_HOME.</p>
+ </li>
+ <li>
+ <p>Setup the mysql user/group and permissions for it's directories:
+ <br>
+ <font face="monospace"># groupadd mysql </font><br>
+ <font face="monospace"># useradd -d $MYSQL_HOME -g mysql -s
+/usr/bin/bash mysql<br>
+# chown -R mysql:mysql $MYSQL_HOME</font></p>
+ </li>
+ <li>
+ <p>Create the database :<br>
+ <font face="monospace"># su - mysql</font><br>
+ <font face="monospace">$ cd bin</font><br>
+ <font face="monospace">$ ./mysql_install_db</font></p>
+ </li>
+ <li>
+ <p><font face="Times New Roman, serif">A sample MySQL configuration
+file (my.cnf) is included in the $APP_DIR/etc. Please read the embedded
+comments and edit the file appropriately after copying it to /etc. </font>
+ </p>
+ </li>
+ <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>
+ <font face="monospace">$ ./mysqld_safe
+âdefaults-file=/etc/my.cnf &</font><br>
+ <font face="monospace">$ ./mysqladmin -u root password </font><font
+ face="monospace"><i>pwd</i></font></p>
+ </li>
+ <li>
+ <p>Create the olio user and grant privileges:<br>
+ <font face="monospace">$ ./mysql -uroot -p</font><font
+ face="monospace"><i>pwd</i></font><br>
+ <font face="monospace">mysql> create user 'olio'@'%' identified
+by 'olio';</font><br>
+ <font face="monospace">mysql> grant all privileges on *.* to
+'olio'@'%' identified by 'olio' with grant option;<br>
+ </font><br>
+In some cases the wildcard '%' does not work reliably as a substitution
+for all hosts. You need to grant the privileges to
+'olio'@'<hostname>' individually, where hostname is localhost,
+the name of the database system and any other names that are used to
+access the database system. </p>
+ </li>
+ <li>
+ <p style="margin-bottom: 0in;">Create database<br>
+ <font face="monospace">mysql> create database olio;</font><br>
+ <font face="monospace">mysql> use olio;</font> </p>
+ </li>
+</ol>
+<p style="margin-bottom: 0in;"><br>
+</p>
+<ol start="7">
+ <li>
+ <p>To create the database schema, you first need to copy the schema
+script from the driver system. It is located in
+$FABAN_HOME/benchmarks/OlioDriver/bin/schema.sql. Copy the script
+anywhere on the database server and create the schema:</p>
+ </li>
+</ol>
+<p style="margin-left: 0.55in;"><font face="Monospace">$ mysql -uroot
+-ppwd</font><br>
+<font face="monospace">mysql>
+\.</font><font face="monospace"><i><location></i></font><font
+ face="monospace">/schema.sql<br>
+mysql>
+exit</font><br>
+<font face="monospace">$</font><br>
+<br>
+Now, if you
+login as the user <i>olio</i>, you should be able to see the database
+created by the root user.</p>
+<h2><a name="loadDB"></a><font size="4">Loading the database</font></h2>
+<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
performance tests, the load driver can be configured to automatically
-re-load the database before the run.</FONT></P>
-<OL>
- <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>
- <LI><P STYLE="margin-bottom: 0in"><FONT SIZE=3>Go to the directory
- containing the loader script:<BR></FONT><FONT FACE="monospace"><FONT SIZE=3>#
- cd </FONT></FONT><FONT FACE="monospace"><I>$FABAN_HOME</I></FONT><FONT FACE="monospace">/benchmarks/OlioDriver/bin</FONT></P>
-</OL>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<OL START=3>
- <LI><P STYLE="margin-bottom: 0in">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><FONT FACE="monospace"># chmod +x dbloader.sh</FONT></P>
-</OL>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<OL START=4>
- <LI><P>Run the loader script:<BR><FONT FACE="monospace">#
- ./dbloader.sh </FONT><FONT FACE="monospace"><I><dbserver>
- <load_scale></I></FONT><BR>You can start small with a SCALE of
- 50 for initial testing.
- </P>
- <LI><P>Edit the $APP_DIR/etc/config.php and set the database host
- name, replacing <I>localhost</I> in the dbTarget entry.</P>
-</OL>
-<OL START=4>
- <P STYLE="margin-bottom: 0.04in"><FONT FACE="Courier New, monospace"><FONT SIZE=2 STYLE="font-size: 11pt">$olioconfig['dbTarget']
- = 'mysql:host=localhost;dbname=olio'; // PDO target.</FONT></FONT></P>
-</OL>
-<H2><A NAME="setupFileStore"></A><FONT SIZE=4>Setting up the
-filestore</FONT></H2>
-<P><FONT SIZE=3>Olio can be configured to use either a local
+re-load the database before the run.</font></p>
+<ol>
+ <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>
+ </li>
+ <li>
+ <p style="margin-bottom: 0in;"><font size="3">Go to the directory
+containing the loader script:<br>
+ </font><font face="monospace"><font size="3"># cd </font></font><font
+ face="monospace"><i>$FABAN_HOME</i></font><font face="monospace">/benchmarks/OlioDriver/bin</font></p>
+ </li>
+</ol>
+<p style="margin-bottom: 0in;"><br>
+</p>
+<ol start="3">
+ <li>
+ <p style="margin-bottom: 0in;">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>
+ <font face="monospace"># chmod +x dbloader.sh</font></p>
+ </li>
+</ol>
+<p style="margin-bottom: 0in;"><br>
+</p>
+<ol start="4">
+ <li>
+ <p>Run the loader script:<br>
+ <font face="monospace"># ./dbloader.sh </font><font
+ face="monospace"><i><dbserver> <load_scale></i></font><br>
+You can start small with a SCALE of 50 for initial testing. </p>
+ </li>
+ <li>
+ <p>Edit the $APP_DIR/etc/config.php and set the database host name,
+replacing <i>localhost</i> in the dbTarget entry.</p>
+ </li>
+</ol>
+<ol start="4">
+ <p style="margin-bottom: 0.04in;"><font face="Courier New, monospace"><font
+ style="font-size: 11pt;" size="2">$olioconfig['dbTarget'] =
+'mysql:host=localhost;dbname=olio'; // PDO target.</font></font></p>
+</ol>
+<h2><a name="setupFileStore"></a><font size="4">Setting up the Filestore</font></h2>
+<p><font size="3">Olio can be configured to use either a local
filesystem or MogileFS for the object data. Our initial testing with
MogileFS found some severe performance issues, so for now we advice
using a local filesystem or network file system such as NFS. You will
@@ -292,234 +411,265 @@
spindles to avoid such bottlenecks. A local file system needs to be
setup on the same machine as the web application. A network file
system can reside on a separate server but needs to be exported and
-mounted on the system running the web application.</FONT></P>
-<OL>
- <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 for the OS should be fine.
- Ensure that everyone has read and write access to it:<BR></FONT><FONT FACE="monospace"><FONT SIZE=3>#
- mkdir -p </FONT></FONT><FONT FACE="monospace"><FONT SIZE=3><SPAN STYLE="font-style: normal">$FILESTORE</SPAN></FONT></FONT><FONT SIZE=3><BR></FONT><FONT FACE="monospace"><FONT SIZE=3>#
- chmod a+rwx </FONT></FONT><FONT FACE="monospace"><FONT SIZE=3><SPAN STYLE="font-style: normal">$FILESTORE</SPAN></FONT></FONT></P>
- <LI><P><FONT SIZE=3>Now load the filestore. You should have the
- $FABAN_HOME/benchmarks/OlioDriver.jar file on this system.<BR></FONT><FONT FACE="monospace"><FONT SIZE=3><BR>#
- JAVA_HOME</FONT></FONT><FONT FACE="mon"><FONT SIZE=3><I>=</I></FONT></FONT><FONT FACE="monospace"><FONT SIZE=3><I><java_install_dir></I></FONT></FONT><FONT FACE="monospace"><FONT SIZE=3>;
- export $JAVA_HOME</FONT></FONT></P>
-</OL>
-<P STYLE="text-indent: 0.5in; margin-bottom: 0.04in"><FONT FACE="monospace"><FONT SIZE=3>#
-cd $FABAN_HOME/benchmarks; mkdir olio</FONT></FONT></P>
-<P STYLE="margin-left: 0.52in"><FONT FACE="monospace"><FONT SIZE=3>#
-cd olio; jar xvf ../OlioDriver.jar; chmod a+x bin/*</FONT></FONT><FONT SIZE=3><BR></FONT><FONT FACE="monospace"><FONT SIZE=3>#
-$FABAN_HOME/benchmarks/olio/bin/fileloader.sh </FONT></FONT><FONT FACE="monospace"><FONT SIZE=3><I><load_scale>
-$FILESTORE</I></FONT></FONT>
-</P>
-<OL START=2>
- <P><FONT SIZE=3>This loads files for use for up to <FONT FACE="monospace"><I>load_scale</I></FONT>
- number of active users.</FONT></P>
- <LI><P><FONT SIZE=3>Edit the $APP_DIR/etc/config.php parameter
- </FONT><I>localfsRoot</I> and set it to $FILESTORE.
- </P>
-</OL>
-<H2><A NAME="setupEmulator"></A><FONT SIZE=4>Setting up the Geocoder
-Emulator</FONT></H2>
-<P>The Geocoder Emulator is a simple servlet deployed on Tomcat. It
+mounted on the system running the web application.</font></p>
+<ol>
+ <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 for the OS should be fine.
+Ensure that everyone has read and write access to it:<br>
+ </font><font face="monospace"><font size="3"># mkdir -p </font></font><font
+ face="monospace"><font size="3"><span style="font-style: normal;">$FILESTORE</span></font></font><font
+ size="3"><br>
+ </font><font face="monospace"><font size="3"># chmod a+rwx </font></font><font
+ face="monospace"><font size="3"><span style="font-style: normal;">$FILESTORE</span></font></font></p>
+ </li>
+ <li>
+ <p><font size="3">Now load the filestore. You should have the
+$FABAN_HOME/benchmarks/OlioDriver.jar file on this system.<br>
+ </font><font face="monospace"><font size="3"><br>
+# JAVA_HOME</font></font><font face="mon"><font size="3"><i>=</i></font></font><font
+ face="monospace"><font size="3"><i><java_install_dir></i></font></font><font
+ face="monospace"><font size="3">; export $JAVA_HOME</font></font></p>
+ </li>
+</ol>
+<p style="text-indent: 0.5in; margin-bottom: 0.04in;"><font
+ face="monospace"><font size="3">#
+cd $FABAN_HOME/benchmarks; mkdir olio</font></font></p>
+<p style="margin-left: 0.52in;"><font face="monospace"><font size="3">#
+cd olio; jar xvf ../OlioDriver.jar; chmod a+x bin/*</font></font><font
+ size="3"><br>
+</font><font face="monospace"><font size="3">#
+$FABAN_HOME/benchmarks/olio/bin/fileloader.sh </font></font><font
+ face="monospace"><font size="3"><i><load_scale>
+$FILESTORE</i></font></font> </p>
+<ol start="2">
+ <p><font size="3">This loads files for use for up to <font
+ face="monospace"><i>load_scale</i></font> number of active users.</font></p>
+ <li>
+ <p><font size="3">Edit the $APP_DIR/etc/config.php parameter </font><i>localfsRoot</i>
+and set it to $FILESTORE. </p>
+ </li>
+</ol>
+<h2><a name="setupEmulator"></a><font size="4">Setting up the Geocoder
+Emulator</font></h2>
+<p>The Geocoder Emulator is a simple servlet deployed on Tomcat. It
is typically run on a driver machine. The following steps describe
-how to install it :</P>
-<OL>
- <LI><P>Donwload and install Tomcat (from <A HREF="http://tomcat.apache.org/">http://tomcat.apache.org</A>)
- on the driver machine. The install directory doesn't matter â we
- will refer to it as $TOMCAT_HOME.
- </P>
- <LI><P>Build the <I>geocoder.war</I> file by going to the 'geocoder'
- directory and following the instructions in the README file.</P>
- <LI><P>Copy the geocoder.war file from the geocoder/dist directory
- to $TOMCAT_HOME/webapps.</P>
- <LI><P>Start Tomcat using $TOMCAT_HOME/bin/startup.sh.</P>
- <LI><P>Edit $APP_DIR/etc/config.php parameter <I>geocoderURL</I> and
- replace <I>GEOCODER_HOST:8080</I> with the host and port where
- Tomcat is running.</P>
-</OL>
-<H2><FONT SIZE=4>Setting up memcached</FONT></H2>
-<P><FONT SIZE=3>The Olio application uses memcached for caching the
+how to install it :</p>
+<ol>
+ <li>
+ <p>Donwload and install Tomcat (from <a
+ href="http://tomcat.apache.org/">http://tomcat.apache.org</a>) on the
+driver machine. The install directory doesn't matter â we will refer to
+it as $TOMCAT_HOME. </p>
+ </li>
+ <li>
+ <p>Build the <i>geocoder.war</i> file by going to the 'geocoder'
+directory and following the instructions in the README file.</p>
+ </li>
+ <li>
+ <p>Copy the geocoder.war file from the geocoder/dist directory to
+$TOMCAT_HOME/webapps.</p>
+ </li>
+ <li>
+ <p>Start Tomcat using $TOMCAT_HOME/bin/startup.sh.</p>
+ </li>
+ <li>
+ <p>Edit $APP_DIR/etc/config.php parameter <i>geocoderURL</i> and
+replace <i>GEOCODER_HOST:8080</i> with the host and port where Tomcat
+is running.</p>
+ </li>
+</ol>
+<h2><a name="Setting_up_Memcached"></a><font size="4">Setting up
+Memcached</font></h2>
+<p><font size="3">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 case, set the <I>CacheSystem</I> to <I>NoCache</I>
+caching tier. In this case, set the <i>CacheSystem</i> to <i>NoCache</i>
in $APP_DIRetc/config.php. This will eliminate the use of memcached
and all requests will directly go to the database. However, if you do
want to use memcached (scaling will be very difficult without it),
you need to setup an instance of memcached. This can typically run on
-the same system as the web server. </FONT>
-</P>
-<OL>
- <LI><P><FONT SIZE=3>Download and install memcached on the system you
- plan to use.</FONT></P>
- <LI><P><FONT SIZE=3>Start memcached : âmemcached -u mysql &â</FONT></P>
- <LI><P><FONT SIZE=3>Edit $APP_DIR/etc/config.php and replace
- MEMCACHED_HOST with the host name where memcached is running. </FONT>
- </P>
-</OL>
-<H2><A NAME="testWebApp"></A><FONT SIZE=4>Testing the web application</FONT></H2>
-<OL>
- <LI><P><FONT SIZE=3>Start apache. This can be done by executing
- â$APACHE_HOME/bin/apachectl startâ. Check that you can connect
- to it from your browser at the port apache is listening on
- (http://<I>host</I>:80).</FONT></P>
- <LI><P><FONT SIZE=3>Check the home page (HomePage) . If there are no
- error messages and all images get loaded, that's a great start ! If
- instead, the server does not display anything or the images don't
- get loaded, check the apache error_log and double-check that the
- application's etc/config.php file has been edited correctly.
- Remember that you will need to re-start apache after any edits to
- this file for them to take effect.</FONT></P>
- <LI><P><FONT SIZE=3>Click on an event (EventDetail). Make sure the
- whole page looks OK. </FONT>
- </P>
- <LI><P><FONT SIZE=3>Click on an attendee (PersonDetail) to see a
- person's profile. </FONT>
- </P>
- <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>
- <LI><P><FONT SIZE=3>Click on the sign up tab. 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/olio/resources. <BR>Submit
- the form. Make sure the form goes through. This completes the
- AddPerson transaction. </FONT>
- </P>
- <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>
- <LI><P><FONT SIZE=3>Select an event, go back to the EventDetail page
- but this time as a logged on user. <BR>Add yourself as an attendee.
- This is the EventDetail transaction with attendee added (about 8-9%
- of all EventDetail views). </FONT>
- </P>
- <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>$FABAN_HOME/benchmarks/olio/resources. Fill in
- the form and submit. This is the AddEvent transaction. </FONT>
- </P>
-</OL>
-<H2><A NAME="startRun"></A><FONT SIZE=4>Starting a performance test</FONT></H2>
-<P STYLE="margin-bottom: 0in">Now that we know that the web
+the same system as the web server. </font>
+</p>
+<ol>
+ <li>
+ <p><font size="3">Download and install memcached on the system you
+plan to use.</font></p>
+ </li>
+ <li>
+ <p><font size="3">Start memcached : âmemcached -u mysql &â</font></p>
+ </li>
+ <li>
+ <p><font size="3">Edit $APP_DIR/etc/config.php and replace
+MEMCACHED_HOST with the host name where memcached is running. </font> </p>
+ </li>
+</ol>
+<h2><a name="testWebApp"></a><font size="4">Testing the Web Application</font></h2>
+<ol>
+ <li>
+ <p><font size="3">Start apache. This can be done by executing
+â$APACHE_HOME/bin/apachectl startâ. Check that you can connect to it
+from your browser at the port apache is listening on (http://<i>host</i>:80).</font></p>
+ </li>
+ <li>
+ <p><font size="3">Check the home page (HomePage) . If there are no
+error messages and all images get loaded, that's a great start ! If
+instead, the server does not display anything or the images don't get
+loaded, check the apache error_log and double-check that the
+application's etc/config.php file has been edited correctly. Remember
+that you will need to re-start apache after any edits to this file for
+them to take effect.</font></p>
+ </li>
+ <li>
+ <p><font size="3">Click on an event (EventDetail). Make sure the
+whole page looks OK. </font> </p>
+ </li>
+ <li>
+ <p><font size="3">Click on an attendee (PersonDetail) to see a
+person's profile. </font> </p>
+ </li>
+ <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>
+ </li>
+ <li>
+ <p><font size="3">Click on the sign up tab. 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/olio/resources. <br>
+Submit the form. Make sure the form goes through. This completes the
+AddPerson transaction. </font> </p>
+ </li>
+ <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>
+ </li>
+ <li>
+ <p><font size="3">Select an event, go back to the EventDetail page
+but this time as a logged on user. <br>
+Add yourself as an attendee. This is the EventDetail transaction with
+attendee added (about 8-9% of all EventDetail views). </font> </p>
+ </li>
+ <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>
+$FABAN_HOME/benchmarks/olio/resources. Fill in the form and submit.
+This is the AddEvent transaction. </font> </p>
+ </li>
+</ol>
+<h2><a name="startRun"></a><font size="4">Starting a Performance Test</font></h2>
+<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
-kick off a test.
-</P>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<OL>
- <LI><P STYLE="margin-bottom: 0in">Shutdown apache and 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. The apache server is also automatically started at
- the start of a run and shutdown at the end of a run.</P>
-</OL>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<OL START=2>
- <LI><P>Point your browser at http://<I><driver_machine></I>:9980</P>
- <LI><P>Click on the <SPAN STYLE="font-style: normal"><B>Schedule Run</B></SPAN>
- link.</P>
- <LI><P>Under the JAVA tab, set the JAVA_HOME. You can accept the
- default value for JVM options. <B>DO NOT</B> click on the OK button
- yet!</P>
- <LI><P>Select the Driver tab.
- </P>
- <P STYLE="margin-bottom: 0in">Enter a Description for the run (say
- 'First test run' for this case). In general, the Description field
- is very useful to get a quick idea of what a particular run is
- testing.
- </P>
- <P STYLE="margin-bottom: 0in">Enter the name of your driver(s)
- machine for Host (when using more than one machine, simply separate
- them by a space).
- </P>
- <P STYLE="margin-bottom: 0in">Enter 10 for 'Concurrent Users' (we
- want to start small).</P>
- <P STYLE="margin-bottom: 0in">Enter 'vmstat 10' for Tools. This
- indicates the measurement tools that will be run on the driver
- machine. It's a good idea to keep an eye on the driver cpu
- utilization.</P>
- <P STYLE="margin-bottom: 0in">Now enter 30, 30, 30 for the Ramp up,
- Steady State and Ramp down times. This is a very short test run. For
- normal runs, you may need a ramp up of 200 seconds and a steady
- state of at least 600 seconds during which measurements are made.</P>
- <P STYLE="margin-bottom: 0in">For current systems, the time between
- client startup of 200 milliseconds is good enough. Some web servers
- or slower systems may not be able to accept connections very
- frequently. In that case we may want to increase this value to 1000
- milliseconds.</P>
-</OL>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<OL START=6>
- <LI><P>Select the Web Server tab.</P>
-</OL>
-<P STYLE="text-indent: 0.5in; margin-bottom: 0in">The number of
-Agents is best the same or multiple the number of driver machines â
-we start with 1.
-</P>
-<P STYLE="text-indent: 0.5in; margin-bottom: 0in">The Host:Port Pairs
+kick off a test. </p>
+<ol>
+ <li>
+ <p style="margin-bottom: 0in;">Shutdown apache and 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. The
+apache server is also automatically started at the start of a run and
+shutdown at the end of a run.</p>
+ </li>
+</ol>
+<ol start="2">
+ <li>
+ <p>Point your browser at http://<i><driver_machine></i>:9980</p>
+ </li>
+ <li>
+ <p>Click on the <span style="font-style: normal;"><b>Schedule Run</b></span>
+link.</p>
+ </li>
+ <li>
+ <p>Under the JAVA tab, set the JAVA_HOME. You can accept the
+default value for JVM options. <b>DO NOT</b> click on the OK button
+yet!</p>
+ </li>
+ <li>
+ <p>Select the Driver tab. </p>
+ <p style="margin-bottom: 0in;">Enter a Description for the run (say
+'First test run' for this case). In general, the Description field is
+very useful to get a quick idea of what a particular run is testing. </p>
+ <p style="margin-bottom: 0in;">Enter the name of your driver(s)
+machine for Host (when using more than one machine, simply separate
+them by a space). </p>
+ <p style="margin-bottom: 0in;">Enter 10 for 'Concurrent Users' (we
+want to start small).</p>
+ <p style="margin-bottom: 0in;">Enter 'vmstat 10' for Tools. This
+indicates the measurement tools that will be run on the driver machine.
+It's a good idea to keep an eye on the driver cpu utilization.</p>
+ <p style="margin-bottom: 0in;">Now enter 30, 30, 30 for the Ramp
+up, Steady State and Ramp down times. This is a very short test run.
+For normal runs, you may need a ramp up of 200 seconds and a steady
+state of at least 600 seconds during which measurements are made.</p>
+ <p style="margin-bottom: 0in;">For current systems, the time
+between client startup of 200 milliseconds is good enough. Some web
+servers or slower systems may not be able to accept connections very
+frequently. In that case we may want to increase this value to 1000
+milliseconds.</p>
+ </li>
+</ol>
+<p style="margin-bottom: 0in;">
+The number of
+Agents needs to be set based on the number of concurrent
+users - we start with 1 and add an agent for every 500 users.
+</p>
+<ol start="6">
+ <li>
+ <p>Select the Web Server tab.</p>
+ </li>
+</ol>
+<p style="text-indent: 0.5in; margin-bottom: 0in;">The Host:Port Pairs
field takes the host port pairs where the web applications are
-running. The host and port is separated by a colon.
-</P>
-<P STYLE="text-indent: 0.5in; margin-bottom: 0in">Each pair is
-separated by space.
-</P>
-<P STYLE="text-indent: 0.5in; margin-bottom: 0in">For the Webserver
-type field, enter either "apache" or "lighttpd"
-depending on which web server you're using.</P>
-<P STYLE="text-indent: 0.5in; margin-bottom: 0in">Leave the field
+running. The host and port is separated by a colon. </p>
+<p style="text-indent: 0.5in; margin-bottom: 0in;">Each pair is
+separated by space. </p>
+<p style="text-indent: 0.5in; margin-bottom: 0in;">For the Webserver
+type field, enter either "apache" or "lighttpd"
+depending on which web server you're using.</p>
+<p style="text-indent: 0.5in; margin-bottom: 0in;">Leave the field
blank if you're using servers other than these two. Only these two
-servers are supported at this time.
-</P>
-<P STYLE="text-indent: 0.5in; margin-bottom: 0in">Enter the
+servers are managed by faban. <br>
+ For
+any other servers, you must manually start/stop the servers. </p>
+<p style="text-indent: 0.5in; margin-bottom: 0in;">Enter the
webserver's bin, log, and config directories, and the directory
-containing the php.ini file in the respective fields.
-</P>
-<P STYLE="text-indent: 0.5in; margin-bottom: 0in">Next, choose the
-server type to be PHP.
-</P>
-<P STYLE="text-indent: 0.5in; margin-bottom: 0in">In the tools box,
+containing the php.ini file in the respective fields. </p>
+<p style="text-indent: 0.5in; margin-bottom: 0in;">In the tools box,
type the tools you want to run. Here are the tools we typically run :
-vmstat 10; mpstat 10; iostat -x 10</P>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<OL START=7>
- <LI><P STYLE="margin-bottom: 0in">Select the Data Servers tab.</P>
-</OL>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<OL START=7>
- <P STYLE="margin-bottom: 0in">For the database server, enter the
- Host name. (Olio also supports multiple hostnames if MySQL
- replication is being used).
- </P>
-</OL>
-<P STYLE="text-indent: 0.49in; margin-bottom: 0in">Edit the hostname
+vmstat 10; mpstat 10; nicstat 10; iostat -x 10</p>
+<ol start="7">
+ <li>
+ <p style="margin-bottom: 0in;">Select the Data Servers tab.</p>
+ </li>
+</ol>
+<ol start="7">
+ <p style="margin-bottom: 0in;">For the database server, enter the
+Host name. (Olio also supports multiple hostnames if MySQL replication
+is being used). </p>
+</ol>
+<p style="text-indent: 0.49in; margin-bottom: 0in;">Edit the hostname
part of the JDBC Connection URL. This is used by the loader program
-to reload the database before a run.
-</P>
-<P STYLE="text-indent: 0.49in; margin-bottom: 0in">Set the 'Load for
+to reload the database before a run. </p>
+<p style="text-indent: 0.49in; margin-bottom: 0in;">Set the 'Load for
Concurrent Users' to 25 (this is the minimum number of users we can
-load for and is good for up to 25 concurrent users).
-</P>
-<OL START=7>
- <P STYLE="margin-bottom: 0in">Set the Data Storage server. For local
- storage this is the same host as the web server.</P>
- <P STYLE="margin-bottom: 0in">Set the memcached server instances to
- the servers you've configured in config.php of the web application.
- </P>
-</OL>
-<P STYLE="text-indent: 0.48in; margin-bottom: 0in">The memcached
-server instances are given as host:port pairs, separated by space. If
-a port is not given, the default port of 11211 is assumed.</P>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<OL START=8>
- <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>
-</OL>
-</BODY>
-</HTML>
\ No newline at end of file
+load for and is good for up to 25 concurrent users). </p>
+<ol start="7">
+ <p style="margin-bottom: 0in;">Set the Data Storage server. For local
+storage this is the same host as the web server.</p>
+ <p style="margin-bottom: 0in;">Set the memcached server instances to
+the servers you've configured in config.php of the web application. </p>
+</ol>
+<p style="text-indent: 0.48in; margin-bottom: 0in;">The memcached
+server instances are given as <host:port pairs>, separated by
+space. If
+a port is not given, the default port of 11211 is assumed.</p>
+<ol start="8">
+ <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>
+ </li>
+</ol>
+</body>
+</html>