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/03/11 16:36:00 UTC
svn commit: r752505 - in /incubator/olio/docs: php_setup.html
php_setup_kit.html
Author: shanti
Date: Wed Mar 11 16:35:59 2009
New Revision: 752505
URL: http://svn.apache.org/viewvc?rev=752505&view=rev
Log:
Minor fixes to typos, fonts etc.
Modified:
incubator/olio/docs/php_setup.html
incubator/olio/docs/php_setup_kit.html
Modified: incubator/olio/docs/php_setup.html
URL: http://svn.apache.org/viewvc/incubator/olio/docs/php_setup.html?rev=752505&r1=752504&r2=752505&view=diff
==============================================================================
--- incubator/olio/docs/php_setup.html (original)
+++ incubator/olio/docs/php_setup.html Wed Mar 11 16:35:59 2009
@@ -7,7 +7,8 @@
<META NAME="AUTHOR" CONTENT="Akara Sucharitakul">
<META NAME="CREATED" CONTENT="20070926;10111500">
<META NAME="CHANGEDBY" CONTENT="Shanti Subramanyam">
- <META NAME="CHANGED" CONTENT="20090305;12352800">
+ <META NAME="CHANGED" CONTENT="20090311;9351100">
+ <META NAME="CHANGEDBY" CONTENT="Shanti Subramanyam">
<STYLE TYPE="text/css">
<!--
H1 { color: #000000 }
@@ -27,11 +28,11 @@
</P>
<LI><P STYLE="margin-bottom: 0in">The main database
</P>
- <LI><P STYLE="margin-bottom: 0in">Distributed storage servers
- (MogileFS or NFS)</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)</P>
+ MogileFS only)</P>
<LI><P STYLE="margin-bottom: 0in">Geocoder emulator
</P>
<LI><P>Workload driver
@@ -86,6 +87,9 @@
all implementations of the application. The
<I>workload/workload/php/trunk</I> 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
@@ -104,7 +108,7 @@
</OL>
<UL>
<UL>
- <LI><P ALIGN=LEFT>cd $WORKLOAD; cp build.properties.template
+ <LI><P ALIGN=LEFT>cd $WORKLOAD; cp build.properties.template
build.properties</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
@@ -114,7 +118,7 @@
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>Olio</I><I>Driver.jar</I> <SPAN STYLE="font-style: normal">in
+ 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>
@@ -161,7 +165,7 @@
<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
+ 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
@@ -169,18 +173,6 @@
</OL>
<P STYLE="margin-bottom: 0in"><BR>
</P>
-<OL START=4>
- <LI><P>Go to $APP_DIR/etc. Edit the file config.php and set the
- appropriate values for geocoderHost, localfsRoot. localfsRoot is the
- directory where the object filestore resides (either a local
- filesystem or nfs-mounted from a remote location â see the section
- <A HREF="#Setting up the filestore|outline"><SPAN STYLE="font-style: normal"><SPAN STYLE="font-weight: medium">Setting
- up the filestore</SPAN></SPAN></A>). The default location is
- /filestore. The geocoderHost is usually the driver system â see
- the section <A HREF="#Setting up the Geocoder Emulator|outline">Setting
- up the Geocoder Emulator</A>.</P>
- <LI><P></P>
-</OL>
<P STYLE="margin-bottom: 0in"><A NAME="setupDB"></A><BR><FONT SIZE=4><B>Setting
up the database</B></FONT>
</P>
@@ -197,19 +189,26 @@
<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
- &</FONT><BR><FONT FACE="monospace">$ ./mysqladmin -u root
- password </FONT><FONT FACE="monospace"><I>pwd</I></FONT></P>
- <LI><P>Create the web20 user and grant privileges:<BR><FONT FACE="monospace">$
+ â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
- are the names of the driver and apache systems.</P>
+ 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>
@@ -241,8 +240,6 @@
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">
-</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
@@ -257,9 +254,15 @@
<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><A NAME="Setting up the filestore|outline"></A>
-<FONT SIZE=4>Setting up the filestore</FONT></H2>
+<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
@@ -279,8 +282,7 @@
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>#
+ $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>
@@ -294,12 +296,12 @@
<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>Ensure the $APP_DIR/etc/config.php parameter
- </FONT>localfsRoot is pointing to $FILESTORE.
+ <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><A NAME="Setting up the Geocoder Emulator|outline"></A>
-<FONT SIZE=4>Setting up the Geocoder Emulator</FONT></H2>
+<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>
@@ -313,12 +315,15 @@
<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
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),
@@ -330,7 +335,7 @@
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 your host name. </FONT>
+ 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>
@@ -358,7 +363,7 @@
</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/web20/resources. <BR>Submit
+ 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>
@@ -373,7 +378,7 @@
</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/web20/resources. Fill in
+ the files from <BR>$FABAN_HOME/benchmarks/olio/resources. Fill in
the form and submit. This is the AddEvent transaction. </FONT>
</P>
</OL>
Modified: incubator/olio/docs/php_setup_kit.html
URL: http://svn.apache.org/viewvc/incubator/olio/docs/php_setup_kit.html?rev=752505&r1=752504&r2=752505&view=diff
==============================================================================
--- incubator/olio/docs/php_setup_kit.html (original)
+++ incubator/olio/docs/php_setup_kit.html Wed Mar 11 16:35:59 2009
@@ -3,10 +3,11 @@
<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="GENERATOR" CONTENT="StarOffice 8 (Solaris Sparc)">
<META NAME="AUTHOR" CONTENT="Akara Sucharitakul">
<META NAME="CREATED" CONTENT="20070926;10111500">
- <META NAME="CHANGED" CONTENT="20090310;17144700">
+ <META NAME="CHANGEDBY" CONTENT="Shanti Subramanyam">
+ <META NAME="CHANGED" CONTENT="20090311;9350500">
<STYLE TYPE="text/css">
<!--
H1 { color: #000000 }
@@ -62,7 +63,7 @@
<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>Extracting the Contents</H2>
+<H2><A NAME="Contents"></A>Extracting the Contents</H2>
<P>The Olio/PHP kit is packaged as a gzipped tar file. The first task
is to unzip the file and untar it to extract it's contents. This can
be done as follows:</P>
@@ -72,15 +73,14 @@
<P>This will cause a directory named
olio-php-<I><version></I>b<I><build_date></I><SPAN STYLE="font-style: normal">to
be created whose contents should look like:</SPAN></P>
-<P STYLE="margin-bottom: 0.04in"><FONT FACE="Courier New, monospace"><FONT SIZE=2 STYLE="font-size: 11pt"><SPAN STYLE="font-style: normal">#
-ls olio-php-0.1*</SPAN></FONT></FONT></P>
-<P STYLE="margin-bottom: 0.04in"><FONT FACE="Courier New, monospace"><FONT SIZE=2 STYLE="font-size: 11pt"><SPAN STYLE="font-style: normal">LICENSE
- OlioDriver.jar geocoder.war
-php_setup_kit.html</SPAN></FONT></FONT></P>
-<P STYLE="margin-bottom: 0.04in"><FONT FACE="Courier New, monospace"><FONT SIZE=2 STYLE="font-size: 11pt"><SPAN STYLE="font-style: normal">NOTICE
- OlioDriver_src.zip oliophp/ release</SPAN></FONT></FONT></P>
-<P STYLE="margin-bottom: 0.04in"><FONT FACE="Courier New, monospace"><FONT SIZE=2 STYLE="font-size: 11pt"><SPAN STYLE="font-style: normal">#
-</SPAN></FONT></FONT>
+<P STYLE="margin-bottom: 0.04in; font-style: normal"><FONT FACE="Courier New, monospace"><FONT SIZE=2 STYLE="font-size: 11pt">#
+ls olio-php-0.1*</FONT></FONT></P>
+<P STYLE="margin-bottom: 0.04in; font-style: normal"><FONT FACE="Courier New, monospace"><FONT SIZE=2 STYLE="font-size: 11pt">LICENSE
+OlioDriver.jar geocoder.war php_setup_kit.html</FONT></FONT></P>
+<P STYLE="margin-bottom: 0.04in; font-style: normal"><FONT FACE="Courier New, monospace"><FONT SIZE=2 STYLE="font-size: 11pt">NOTICE
+OlioDriver_src.zip oliophp/ release</FONT></FONT></P>
+<P STYLE="margin-bottom: 0.04in; font-style: normal"><FONT FACE="Courier New, monospace"><FONT SIZE=2 STYLE="font-size: 11pt">#
+</FONT></FONT>
</P>
<P>We will use $OLIO_HOME to designate the name of this directory. A
description of the contents follows :</P>
@@ -91,13 +91,13 @@
(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.</P>
- <LI><P><I>geocoder.war</I> contains the simple servlet used to
+ <LI><P><I>geocoder.war</I> contains the simple servlet used to
emulate the geocoder.</P>
- <LI><P> <I>php_setup_kit.html</I> is this document.</P>
+ <LI><P><I>php_setup_kit.html</I> is this document.</P>
<LI><P><I>release</I> contains the release name. LICENSE and NOTICE
contain the licenses.</P>
</UL>
-<H2>Setting up the Driver</H2>
+<H2><A NAME="setupDriver"></A>Setting up the Driver</H2>
<P>Even if you don't plan to drive load against the application,
steps 1 and 2 are required as the database and file loaders are part
of the workload driver â feel free to install the driver on the
@@ -196,8 +196,9 @@
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
- are the names of the driver, database (localhost) and web server
- systems.</P>
+ is localhost, the name of the database system and any other name
+ that's 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>
@@ -282,10 +283,10 @@
$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>
+ <P><FONT SIZE=3>This loads files for use for up to </FONT><FONT FACE="monospace"><FONT SIZE=3><I>load_scale</I></FONT></FONT><FONT SIZE=3>
number of active users.</FONT></P>
<LI><P><FONT SIZE=3>Edit the $APP_DIR/etc/config.php parameter
- </FONT>localfsRoot and set it to $FILESTORE.
+ </FONT><I>localfsRoot</I> and set it to $FILESTORE.
</P>
</OL>
<H2><A NAME="setupEmulator"></A><FONT SIZE=4>Setting up the Geocoder