incubator-olio-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From sha...@apache.org
Subject svn commit: r756217 - in /incubator/olio/docs: php_setup_kit.html rails_setup.html rails_setup_kit.html
Date Thu, 19 Mar 2009 21:34:04 GMT
Author: shanti
Date: Thu Mar 19 21:34:04 2009
New Revision: 756217

URL: http://svn.apache.org/viewvc?rev=756217&view=rev
Log:
Final tweaks to documents before 0.1 release

Modified:
    incubator/olio/docs/php_setup_kit.html
    incubator/olio/docs/rails_setup.html
    incubator/olio/docs/rails_setup_kit.html

Modified: incubator/olio/docs/php_setup_kit.html
URL: http://svn.apache.org/viewvc/incubator/olio/docs/php_setup_kit.html?rev=756217&r1=756216&r2=756217&view=diff
==============================================================================
--- incubator/olio/docs/php_setup_kit.html (original)
+++ incubator/olio/docs/php_setup_kit.html Thu Mar 19 21:34:04 2009
@@ -7,7 +7,7 @@
 	<META NAME="AUTHOR" CONTENT="Akara Sucharitakul">
 	<META NAME="CREATED" CONTENT="20070926;10111500">
 	<META NAME="CHANGEDBY" CONTENT="Shanti Subramanyam">
-	<META NAME="CHANGED" CONTENT="20090316;13122800">
+	<META NAME="CHANGED" CONTENT="20090318;9153900">
 	<META NAME="CHANGEDBY" CONTENT="Shanti Subramanyam">
 	<!-- Licensed to the Apache Software Foundation (ASF) under one
     or more contributor license agreements.  See the NOTICE file
@@ -94,9 +94,10 @@
 <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>
+OlioDriver.jar RELEASE-NOTES-php-0.1.txt 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>
+ 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>

Modified: incubator/olio/docs/rails_setup.html
URL: http://svn.apache.org/viewvc/incubator/olio/docs/rails_setup.html?rev=756217&r1=756216&r2=756217&view=diff
==============================================================================
--- incubator/olio/docs/rails_setup.html (original)
+++ incubator/olio/docs/rails_setup.html Thu Mar 19 21:34:04 2009
@@ -7,7 +7,9 @@
 	<META NAME="AUTHOR" CONTENT="Akara Sucharitakul">
 	<META NAME="CREATED" CONTENT="20070926;10111500">
 	<META NAME="CHANGEDBY" CONTENT="Shanti Subramanyam">
-	<META NAME="CHANGED" CONTENT="20090316;13050200">
+	<META NAME="CHANGED" CONTENT="20090319;14304900">
+	<META NAME="CHANGEDBY" CONTENT="Shanti Subramanyam">
+	<META NAME="CHANGEDBY" CONTENT="Shanti Subramanyam">
 	<META NAME="CHANGEDBY" CONTENT="Shanti Subramanyam">
 	<!-- Licensed to the Apache Software Foundation (ASF) under one
     or more contributor license agreements.  See the NOTICE file
@@ -39,6 +41,9 @@
 <H1>Olio/Rails<BR>Install and Setup Guide from Source Tree</H1>
 <P>Note: The application currently does not use memcached. Please
 ignore the memcached related setup instructions.</P>
+<P>This document assumes some familiarity with setting up Ruby on
+Rails. If you have never set up rails before, you may need to do some
+web searching if you get stuck in any of the steps.</P>
 <H2>Overview</H2>
 <P>Olio is a macro-level toolkit consisting of the following
 components:</P>
@@ -191,13 +196,15 @@
 	following gems: 
 	</P>
 	<UL>
-		<LI><P STYLE="margin-bottom: 0in">rails 
+		<LI><P STYLE="margin-bottom: 0in">rails</P>
+		<LI><P STYLE="margin-bottom: 0in">rake 
 		</P>
 		<LI><P STYLE="margin-bottom: 0in">thin (mongrel can be used if
 		desired) 
 		</P>
 		<LI><P STYLE="margin-bottom: 0in">mysql</P>
-		<LI><P STYLE="margin-bottom: 0in">image_science</P>
+		<LI><P STYLE="margin-bottom: 0in">image_science (uses FreeImage
+		which needs to be downloaded and built)</P>
 		<LI><P STYLE="margin-bottom: 0in">rcov</P>
 		<LI><P STYLE="margin-bottom: 0in">will_paginate</P>
 		<LI><P STYLE="margin-bottom: 0in">FreeImage</P>
@@ -208,7 +215,7 @@
 <OL START=3>
 	<LI><P>MySQL 5 (5.1 recommended)</P>
 </OL>
-<P>For Linux (debian or ubunu), the following command can be used:</P>
+<P>For Linux (debian or ubuntu), the following command can be used :</P>
 <PRE STYLE="margin-bottom: 0.2in">     aptitude install build-essential subversion
ruby1.8 ruby1.8-dev nginx libmysqlclient-dev rubygems libgems-ruby1.8</PRE><P STYLE="margin-bottom:
0in">
 For OpenSolaris 2008.11:</P>
 <UL>
@@ -216,22 +223,88 @@
 	latest in the pkg.opensolaris.org/dev repository. This will give you
 	Rubygems 1.3.1 and Ruby 1.8.7p72. 
 	</P>
-	<LI><P STYLE="margin-bottom: 0in">Since some of the gems install in
-	/usr/local, edit
+</UL>
+<UL>
+	<LI><P STYLE="margin-bottom: 0in">Set the environment variable CXX
+	to /usr/sfw/bin/gcc. This is required to build eventmachine (a thin
+	dependency).</P>
+</UL>
+<P STYLE="margin-bottom: 0in"><BR>
+</P>
+<UL>
+	<LI><P STYLE="margin-bottom: 0in">Edit
 	<FONT FACE="Cumberland, monospace">/usr/ruby/1.8/lib/ruby/1.8/i386-solaris2.11/rbconfig.rb</FONT>
 	as follows :</P>
 </UL>
+<P STYLE="margin-left: 0.79in; margin-bottom: 0in">CONFIG[&quot;LDSHARED&quot;]
+= &quot;/usr/sfw/bin/gcc -G&quot;</P>
+<P STYLE="margin-bottom: 0in"><BR>
+</P>
+<UL>
+	<LI><P STYLE="margin-bottom: 0in">Download and build FreeImage.
+	Instructions are given in
+	<A HREF="http://wiki.joyent.com/accelerators:freeimage_imagescience">http://wiki.joyent.com/accelerators:freeimage_imagescience</A>.
+	Do not change the COMPILERFLAGS setting. Set INSTALLDIR to
+	/opt/local. The entries for the 'install' directive in
+	Makefile.solaris should read:</P>
+</UL>
+<P STYLE="margin-bottom: 0in">i<FONT FACE="Courier New, monospace"><FONT SIZE=2
STYLE="font-size: 11pt">nstall:</FONT></FONT></P>
+<P STYLE="margin-bottom: 0in"><FONT FACE="Courier New, monospace"><FONT SIZE=2
STYLE="font-size: 11pt">install
+-m 644 -u root -g root -f $(INSTALLDIR)/include Source/FreeImage.h </FONT></FONT>
+</P>
+<P STYLE="margin-bottom: 0in"><FONT FACE="Courier New, monospace"><FONT SIZE=2
STYLE="font-size: 11pt">install
+-m 644 -u root -g root -f $(INSTALLDIR)/lib $(STATICLIB) </FONT></FONT>
+</P>
+<P STYLE="margin-bottom: 0in"><FONT FACE="Courier New, monospace"><FONT SIZE=2
STYLE="font-size: 11pt">install
+-m 755 -u root -g root -f $(INSTALLDIR)/lib $(SHAREDLIB) </FONT></FONT>
+</P>
+<P STYLE="margin-bottom: 0in"><FONT FACE="Courier New, monospace"><FONT SIZE=2
STYLE="font-size: 11pt">ln
+-sf $(INSTALLDIR)/lib/$(SHAREDLIB) $(INSTALLDIR)/lib/$(LIBNAME)</FONT></FONT></P>
+<P STYLE="margin-bottom: 0in"><BR>
+</P>
+<UL>
+	<LI><P STYLE="margin-bottom: 0in">Now install these gems: 
+	</P>
+</UL>
+<P STYLE="margin-bottom: 0in"><FONT FACE="Courier New, monospace"><FONT SIZE=2
STYLE="font-size: 11pt">gem
+install rake rails thin rcov will_paginate image_science</FONT></FONT></P>
+<P STYLE="margin-bottom: 0in"><BR>
+</P>
+<UL>
+	<LI><P STYLE="margin-bottom: 0in">To install the mysql gem, you will
+	need to use the <A HREF="http://developers.sun.com/sunstudio/downloads/">Sun
+	Studio compiler</A>. Edit
+	<FONT FACE="Cumberland, monospace">/usr/ruby/1.8/lib/ruby/1.8/i386-solaris2.11/rbconfig.rb</FONT>
+	as follows :</P>
+</UL>
+<P STYLE="margin-left: 0.79in; margin-bottom: 0in">CONFIG[CC] = &quot;cc”</P>
 <P STYLE="margin-left: 0.79in; margin-bottom: 0in">CONFIG[CFLAGS] =
-&quot;-g -O3 -fPIC -R/usr/local/lib”</P>
+&quot;-xO4 -xtarget=generic”</P>
 <P STYLE="margin-left: 0.79in; margin-bottom: 0in">CONFIG[&quot;LDFLAGS&quot;]
-= &quot;-L/usr/sfw/lib -R/usr/sfw/lib -R/usr/local/lib&quot;</P>
+= &quot;&quot;</P>
 <P STYLE="margin-left: 0.79in; margin-bottom: 0in">CONFIG[&quot;LDSHARED&quot;]
-= &quot;gcc -G&quot;</P>
+= &quot;ld -G&quot;</P>
+<P STYLE="margin-left: 0.79in; margin-bottom: 0in"><BR>
+</P>
+<UL>
+	<LI><P STYLE="margin-bottom: 0in">Ensure the Studio compiler bin
+	directory is in your PATH, then run: <FONT FACE="Courier New, monospace">gem
+	install mysql</FONT>.</P>
+</UL>
+<P STYLE="margin-bottom: 0in"><BR>
+</P>
 <UL>
-	<LI><P STYLE="margin-bottom: 0in">Install nginx following the
+	<LI><P STYLE="margin-bottom: 0in">Install nginx. You can build nginx
+	from source by using the Makefile in
+	<A HREF="http://hg.opensolaris.org/sc/src/webstack/nginx/">http://hg.opensolaris.org/sc/src/webstack/nginx/</A>.
+	Alternatively, you can install a pre-build binary following the
 	instructions in 
 	</P>
-	<P STYLE="margin-bottom: 0in"><A HREF="http://blogs.sun.com/jyrivirkki/entry/nginx_package_updates">http://blogs.sun.com/jyrivirkki/entry/nginx_package_updates</A></P>
+</UL>
+<UL>
+	<P STYLE="margin-bottom: 0in"><A HREF="http://blogs.sun.com/jyrivirkki/entry/nginx_package_updates">http://blogs.sun.com/jyrivirkki/entry/nginx_package_updates</A><A
HREF="http://blogs.sun.com/jyrivirkki/entry/nginx_package_updates">.</A><A HREF="http://blogs.sun.com/jyrivirkki/entry/nginx_package_updates"><SPAN
STYLE="text-decoration: none">
+	</SPAN></A>
+	</P>
 </UL>
 <P STYLE="margin-bottom: 0in"><BR>
 </P>
@@ -265,28 +338,7 @@
 to <CODE>root $APP_DIR;</CODE> 
 </P>
 <OL START=3>
-	<P STYLE="margin-bottom: 0.14in">Wait until the next step before
-	starting nginx. 
-	</P>
-</OL>
-<P STYLE="margin-bottom: 0in"><BR>
-</P>
-<OL START=4>
-	<LI><P>Start thin: 
-	</P>
-	<PRE>$ cd $APP_DIR
-$ thin -d -p 3000 -e production -s 4</PRE><P>
-	This will start four thin servers on ports 3000, 3001, 3002, and
-	3004. You can change the port and number of servers if you want, the
-	<CODE>nginx.conf</CODE> file will need to be modified as well. You
-	can also change to unix domain sockets by using the --socket option
-	and <CODE>server unix:/tmp/projects.0.sock;</CODE> for each of the
-	sockets. 
-	</P>
-	<LI><P>Start nginx. Check that you can connect to it from your
-	browser (http://<I>host</I>:80), but don't try to access any of the
-	application pages yet ! 
-	</P>
+	<P STYLE="margin-bottom: 0.14in">Do not start nginx yet.</P>
 </OL>
 <H2><A NAME="setupDB"></A>Setting up the database</H2>
 <OL>
@@ -326,11 +378,16 @@
 <OL START=6>
 	<LI><P>Create database: 
 	</P>
-	<PRE>mysql&gt; create database olio;
-mysql&gt; use olio;</PRE>
-	<LI><P>Create database schema:</P>
-	<PRE STYLE="margin-bottom: 0.2in">rake db:migrate</PRE>
+	<PRE STYLE="margin-bottom: 0.2in">mysql&gt; create database olio;</PRE>
+</OL>
+<OL START=6>
+	<LI><PRE STYLE="margin-bottom: 0.2in"><FONT FACE="Times New Roman, serif"><FONT
SIZE=3>In the web application directory, go to the config directory. Copy database.yml.template
to database.yml and edit it to set the hostname running the database.</FONT></FONT></PRE>
+</OL>
+<OL START=6>
+	<LI><PRE STYLE="margin-bottom: 0.2in"><FONT FACE="Times New Roman, serif"><FONT
SIZE=3>Create database schema from the rails application :</FONT></FONT></PRE>
 </OL>
+<P><FONT FACE="Cumberland, monospace"><FONT SIZE=2>cd $APP_DIR; rake
+db:migrate</FONT></FONT></P>
 <H2><A NAME="loadDB"></A>Loading the database</H2>
 <P>It is best to load the database manually the first time so that we
 can test the web application. However, while doing performance tests,
@@ -382,9 +439,9 @@
 <FONT FACE="Times New Roman, serif"><FONT SIZE=3>This loads files for use for
up to </FONT></FONT><CODE><FONT FACE="Times New Roman, serif"><FONT
SIZE=3><I>load_scale</I></FONT></FONT></CODE> <FONT FACE="Times
New Roman, serif"><FONT SIZE=3>number of concurrent users. </FONT></FONT></PRE>
 	<LI><P>Edit $APP_DIR/config/environment.rb and modify the values of
 	<CODE>IMAGE_STORE_PATH</CODE> and <CODE>DOCUMENT_STORE_PATH </CODE><CODE><FONT
FACE="Times New Roman, serif">to
-	point to $FILESTORE</FONT></CODE><CODE>.</CODE><CODE><FONT
FACE="Times New Roman, serif">Alternatively,
-	create a symbolic link from the default IMAGE_STORE_PATH to
-	$FILESTORE.</FONT></CODE></P>
+	point to $FILESTORE</FONT></CODE><CODE>.</CODE><CODE><FONT
FACE="Times New Roman, serif">Note
+	that $FILESTORE is relative to $APP_DIR. Alternatively, create a
+	symbolic link from the default IMAGE_STORE_PATH to $FILESTORE.</FONT></CODE></P>
 </OL>
 <H2><A NAME="setupEmulator"></A>Setting up the Geocoder Emulator</H2>
 <P>The Geocoder Emulator is a simple servlet deployed on Tomcat. It
@@ -423,16 +480,32 @@
 	the geocoder emulator is running.</P>
 </OL>
 <H2><A NAME="testWebApp"></A>Testing the web application</H2>
-<OL>
-	<LI><P STYLE="margin-bottom: 0in">Check the home page (HomePage)
-	http://&lt;web_server&gt;:8080/index.php . If there are no error
-	messages and all images get loaded, that's a great start! 
+<UL>
+	<LI><P STYLE="margin-bottom: 0.04in">Start thin: 
 	</P>
-	<LI><P STYLE="margin-bottom: 0in">Click on an event (EventDetail).
-	Make sure the whole page looks OK. 
+</UL>
+<PRE STYLE="margin-top: 0.02in; margin-bottom: 0.2in">      $ cd $APP_DIR
+      $ thin -d -p 3000 -e production -l /var/log/thin.log –-pid /var/run/thin.pid -s
4 start</PRE>
+<UL>
+	<LI><P>This will start four thin servers on ports 3000, 3001, 3002,
+	and 3004. You can change the port and number of servers if you want,
+	the <CODE>nginx.conf</CODE> file will need to be modified as well.
+	You can also change to unix domain sockets by using the --socket
+	option and <CODE>server unix:/tmp/projects.0.sock;</CODE> for each
+	of the sockets. 
 	</P>
-	<LI><P STYLE="margin-bottom: 0in">Click on an attendee
-	(PersonDetail) to see a person's profile. 
+	<LI><P>Start nginx. Check that you can connect to it from your
+	browser (<A HREF="http://host:80/">http://<I>host</I>:80</A>). Check
+	the home page (HomePage). If there are no error messages and all
+	images get loaded, that's a great start! If not, check the rails
+	application log (in $APP_DIR/log), thin and nginx error logs to
+	debug. 
+	</P>
+	<LI><P>Click on an event (EventDetail). Make sure the whole page
+	looks OK. 
+	</P>
+	<LI><P>Click on an attendee (PersonDetail) to see a person's
+	profile. 
 	</P>
 	<LI><P STYLE="margin-bottom: 0in">Go back to the home page and click
 	on a tag in the tag cloud. Choose a big tag and check that we have
@@ -453,12 +526,12 @@
 	an attendee. This is the EventDetail transaction with attendee added
 	(about 8-9% of all EventDetail views). 
 	</P>
-	<LI><P>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 <CODE>$FABAN_HOME/benchmarks/web20/resources</CODE>. Fill in
-	the form and submit. This is the AddEvent transaction. 
+	<LI><P STYLE="margin-bottom: 0in">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 <CODE>$FABAN_HOME/benchmarks/web20/resources</CODE>.
+	Fill in the form and submit. This is the AddEvent transaction. 
 	</P>
-</OL>
+</UL>
 <H2><A NAME="startRun"></A>Starting a performance test</H2>
 <P>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>
@@ -476,35 +549,40 @@
 	<LI><P STYLE="margin-bottom: 0in">Select the Driver tab. 
 	</P>
 </OL>
-<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</P>
-<P STYLE="margin-bottom: 0in">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</P>
-<P STYLE="margin-bottom: 0in">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</P>
-<P STYLE="margin-bottom: 0in">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 
-</P>
-<P STYLE="margin-bottom: 0in">accept connections very frequently. In
-that case we may want to increase this value to 1000 milliseconds. 
+<UL>
+	<UL>
+		<LI><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>
+		<LI><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>
+		<LI><P STYLE="margin-bottom: 0in">Enter 10 for 'Concurrent Users'
+		(we want to start small). 
+		</P>
+		<LI><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>
+		<LI><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>
+		<LI><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>
+	</UL>
+</UL>
+<P STYLE="margin-bottom: 0in"><BR>
 </P>
 <OL START=5>
 	<LI><P>Select the Web Server tab. 

Modified: incubator/olio/docs/rails_setup_kit.html
URL: http://svn.apache.org/viewvc/incubator/olio/docs/rails_setup_kit.html?rev=756217&r1=756216&r2=756217&view=diff
==============================================================================
--- incubator/olio/docs/rails_setup_kit.html (original)
+++ incubator/olio/docs/rails_setup_kit.html Thu Mar 19 21:34:04 2009
@@ -3,10 +3,11 @@
 <HEAD>
 	<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
 	<TITLE>Olio/Rails 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="20090317;16320600">
+	<META NAME="CHANGEDBY" CONTENT="Shanti Subramanyam">
+	<META NAME="CHANGED" CONTENT="20090319;14293500">
 	<!-- 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
@@ -116,7 +117,7 @@
 <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 rails_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
- RELEASE-NOTES-rails-0.1.txt oliorails/ release</FONT></FONT></P>
+RELEASE-NOTES-rails-0.1.txt oliorails/ 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>
@@ -196,14 +197,13 @@
 <OL START=3>
 	<LI><P>MySQL 5 (5.1 recommended)</P>
 </OL>
-<P>For Linux (debian or ubunu), the following command can be used:</P>
+<P>For Linux (debian or ubuntu), the following command can be used:</P>
 <PRE STYLE="margin-bottom: 0.2in">     aptitude install build-essential subversion
ruby1.8 ruby1.8-dev nginx libmysqlclient-dev rubygems libgems-ruby1.8</PRE><P STYLE="margin-bottom:
0in">
 For OpenSolaris 2008.11:</P>
 <UL>
 	<LI><P STYLE="margin-bottom: 0in">Upgrade your Ruby version to the
 	latest in the pkg.opensolaris.org/dev repository. This will give you
 	Rubygems 1.3.1 and Ruby 1.8.7p72.</P>
-	<P STYLE="margin-bottom: 0in"></P>
 </UL>
 <UL>
 	<LI><P STYLE="margin-bottom: 0in">Set the environment variable CXX
@@ -229,17 +229,17 @@
 	/opt/local. The entries for the 'install' directive in
 	Makefile.solaris should read:</P>
 </UL>
-<P STYLE="margin-bottom: 0in">            i<FONT FACE="Courier New, monospace"><FONT
SIZE=2 STYLE="font-size: 11pt">nstall:</FONT></FONT></P>
-<P STYLE="margin-bottom: 0in">            <FONT FACE="Courier New, monospace"><FONT
SIZE=2 STYLE="font-size: 11pt">install
+<P STYLE="margin-bottom: 0in">i<FONT FACE="Courier New, monospace"><FONT SIZE=2
STYLE="font-size: 11pt">nstall:</FONT></FONT></P>
+<P STYLE="margin-bottom: 0in"><FONT FACE="Courier New, monospace"><FONT SIZE=2
STYLE="font-size: 11pt">install
 -m 644 -u root -g root -f $(INSTALLDIR)/include Source/FreeImage.h </FONT></FONT>
 </P>
-<P STYLE="margin-bottom: 0in">            <FONT FACE="Courier New, monospace"><FONT
SIZE=2 STYLE="font-size: 11pt">install
+<P STYLE="margin-bottom: 0in"><FONT FACE="Courier New, monospace"><FONT SIZE=2
STYLE="font-size: 11pt">install
 -m 644 -u root -g root -f $(INSTALLDIR)/lib $(STATICLIB) </FONT></FONT>
 </P>
-<P STYLE="margin-bottom: 0in">            <FONT FACE="Courier New, monospace"><FONT
SIZE=2 STYLE="font-size: 11pt">install
+<P STYLE="margin-bottom: 0in"><FONT FACE="Courier New, monospace"><FONT SIZE=2
STYLE="font-size: 11pt">install
 -m 755 -u root -g root -f $(INSTALLDIR)/lib $(SHAREDLIB) </FONT></FONT>
 </P>
-<P STYLE="margin-bottom: 0in">            <FONT FACE="Courier New, monospace"><FONT
SIZE=2 STYLE="font-size: 11pt">ln
+<P STYLE="margin-bottom: 0in"><FONT FACE="Courier New, monospace"><FONT SIZE=2
STYLE="font-size: 11pt">ln
 -sf $(INSTALLDIR)/lib/$(SHAREDLIB) $(INSTALLDIR)/lib/$(LIBNAME)</FONT></FONT></P>
 <P STYLE="margin-bottom: 0in"><BR>
 </P>
@@ -247,7 +247,7 @@
 	<LI><P STYLE="margin-bottom: 0in">Now install these gems: 
 	</P>
 </UL>
-<P STYLE="margin-bottom: 0in">                    <FONT FACE="Courier New, monospace"><FONT
SIZE=2 STYLE="font-size: 11pt">gem
+<P STYLE="margin-bottom: 0in"><FONT FACE="Courier New, monospace"><FONT SIZE=2
STYLE="font-size: 11pt">gem
 install rake rails thin rcov will_paginate image_science</FONT></FONT></P>
 <P STYLE="margin-bottom: 0in"><BR>
 </P>
@@ -269,7 +269,7 @@
 </P>
 <UL>
 	<LI><P STYLE="margin-bottom: 0in">Ensure the Studio compiler bin
-	directory is in your PATH, then run:  <FONT FACE="Courier New, monospace">gem
+	directory is in your PATH, then run: <FONT FACE="Courier New, monospace">gem
 	install mysql</FONT>.</P>
 </UL>
 <P STYLE="margin-bottom: 0in"><BR>
@@ -321,7 +321,7 @@
 path to your rails app's public directory: </CODE>
 </P>
 <PRE STYLE="margin-bottom: 0.2in"><CODE>       root /var/www/virtual/example.com/rails/railsapp/public;</CODE></PRE><P
STYLE="margin-bottom: 0.04in">
-             to         <CODE>root $APP_DIR/public;</CODE> 
+to <CODE>root $APP_DIR/public;</CODE> 
 </P>
 <OL START=3>
 	<P STYLE="margin-bottom: 0.14in">Do not start nginx yet.</P>
@@ -348,7 +348,7 @@
 	</P>
 	<PRE>$ ./mysqld_safe &amp;
 $ ./mysqladmin -u root password <I>pwd</I></PRE>
-	<LI><P>Create the web20 user and grant privileges: 
+	<LI><P>Create the olio user and grant privileges: 
 	</P>
 	<PRE> $ ./mysql -u root -p <I>pwd</I>
  mysql&gt; create user 'olio'@'%' identified by 'olio';
@@ -364,15 +364,11 @@
 <OL START=6>
 	<LI><P>Create database: 
 	</P>
-	<PRE>mysql&gt; create database olio;</PRE>
+	<PRE STYLE="margin-bottom: 0.2in">mysql&gt; create database olio;</PRE>
+	<LI><PRE STYLE="margin-bottom: 0.2in"><FONT FACE="Times New Roman, serif"><FONT
SIZE=3>In the web application directory, go to the config directory. Copy database.yml.template
to database.yml and edit it to set the hostname running the database.</FONT></FONT></PRE>
+	<LI><PRE STYLE="margin-bottom: 0.2in"><FONT FACE="Times New Roman, serif"><FONT
SIZE=3>Create database schema from the rails application :</FONT></FONT></PRE>
 </OL>
-<PRE></PRE>
 <OL START=6>
-	<LI><PRE><FONT FACE="Times New Roman, serif"><FONT SIZE=3>In the
web application directory, go to the config directory. Copy database.yml.template to database.yml
and edit it to set the hostname running the database.</FONT></FONT></PRE>
-</OL>
-<PRE STYLE="margin-bottom: 0.2in"></PRE>
-<OL START=6>
-	<LI><P>Create database schema from the rails application :</P>
 	<PRE STYLE="margin-bottom: 0.2in">cd $APP_DIR; rake db:migrate</PRE>
 </OL>
 <H2><A NAME="loadDB"></A>Loading the database</H2>
@@ -426,10 +422,9 @@
 <FONT FACE="Times New Roman, serif"><FONT SIZE=3>This loads files for use for
up to </FONT></FONT><CODE><FONT FACE="Times New Roman, serif"><FONT
SIZE=3><I>load_scale</I></FONT></FONT></CODE> <FONT FACE="Times
New Roman, serif"><FONT SIZE=3>number of concurrent users. </FONT></FONT></PRE>
 	<LI><P>Edit $APP_DIR/config/environment.rb and modify the values of
 	<CODE>IMAGE_STORE_PATH</CODE> and <CODE>DOCUMENT_STORE_PATH </CODE><CODE><FONT
FACE="Times New Roman, serif">to
-	point to $</FONT></CODE><CODE><FONT FACE="Times New Roman, serif">FILESTORE.
-	Note that $FILESTORE is relative to $APP_DIR. Alternatively</FONT></CODE><CODE><FONT
FACE="Times New Roman, serif">,
-	create a symbolic link from the default IMAGE_STORE_PATH to
-	$FILESTORE. </FONT></CODE>
+	point to $FILESTORE. Note that $FILESTORE is relative to $APP_DIR.
+	Alternatively, create a symbolic link from the default
+	IMAGE_STORE_PATH to $FILESTORE. </FONT></CODE>
 	</P>
 </OL>
 <H2><A NAME="setupEmulator"></A>Setting up the Geocoder Emulator</H2>
@@ -467,10 +462,13 @@
 </OL>
 <H2><A NAME="testWebApp"></A>Testing the web application</H2>
 <UL>
-	<LI><P>Start thin: 
+	<LI><P STYLE="margin-bottom: 0.04in">Start thin: 
 	</P>
-	<LI><PRE>$ cd $APP_DIR</PRE>
-	<LI><PRE STYLE="margin-bottom: 0.2in">$ thin -d -p 3000 -e production -l /var/log/thin.log
–-pid /var/run/thin.pid -s 4 start</PRE>
+</UL>
+<PRE STYLE="margin-top: 0.02in">      $ cd $APP_DIR
+      $ thin -d -p 3000 -e production -l /var/log/thin.log –-pid /var/run/thin.pid -s
4 start
+</PRE>
+<UL>
 	<LI><P>This will start four thin servers on ports 3000, 3001, 3002,
 	and 3004. You can change the port and number of servers if you want,
 	the <CODE>nginx.conf</CODE> file will need to be modified as well.
@@ -479,10 +477,11 @@
 	of the sockets. 
 	</P>
 	<LI><P>Start nginx. Check that you can connect to it from your
-	browser (<A HREF="http://host:80/">http://<I>host</I>:80</A>). 
-	Check the home page (HomePage).  If there are no error messages and
-	all images get loaded, that's a great start! If not, check the thin
-	and nginx error logs to debug. 
+	browser (<A HREF="http://host:80/">http://<I>host</I>:80</A>). Check
+	the home page (HomePage). If there are no error messages and all
+	images get loaded, that's a great start! If not, check the rails
+	application log (in $APP_DIR/log), thin and nginx error logs to
+	debug. 
 	</P>
 	<LI><P>Click on an event (EventDetail). Make sure the whole page
 	looks OK. 



Mime
View raw message