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/12/01 19:25:02 UTC
svn commit: r885882 - in /incubator/olio/docs: java_setup.html
java_setup_kit.html rails_setup.html rails_setup_kit.html
Author: shanti
Date: Tue Dec 1 19:25:01 2009
New Revision: 885882
URL: http://svn.apache.org/viewvc?rev=885882&view=rev
Log:
Updated docs based on feedback from 0.2build1
Modified:
incubator/olio/docs/java_setup.html
incubator/olio/docs/java_setup_kit.html
incubator/olio/docs/rails_setup.html
incubator/olio/docs/rails_setup_kit.html
Modified: incubator/olio/docs/java_setup.html
URL: http://svn.apache.org/viewvc/incubator/olio/docs/java_setup.html?rev=885882&r1=885881&r2=885882&view=diff
==============================================================================
--- incubator/olio/docs/java_setup.html (original)
+++ incubator/olio/docs/java_setup.html Tue Dec 1 19:25:01 2009
@@ -236,7 +236,8 @@
Workload"</p>
</li>
<li>
- <p>Copy MySQL Connector/J (JDBC Driver for MySQL) jar to
+ <p><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>
</li>
<li>To deploy the Faban driver, you can
@@ -448,7 +449,7 @@
Installation and Configuration</font></h2>
<ol>
<li>
- <p>Install Glassfish application server V2 UR2 from <a
+ <p>Install Glassfish application server V2.1 from <a
href="https://glassfish.dev.java.net/public/downloadsindex.html"><span
style="text-decoration: underline;">https://glassfish.dev.java.net/public/downloadsindex.html.</span></a>
<br>
@@ -463,15 +464,14 @@
$GLASSFISH_HOME/domains/domain1/lib/ext directory (or whatever you have
named your domain).</p>
</li>
- <li>The benchmark utilizes JPA (Java Persistence API) and has been
-benchmarked
-with the EclipseLink implementation. GlassFish v2
+ <li>The application utilizes JPA (Java Persistence API) and has been
+tested
+with the EclipseLink implementation. GlassFish v2.1.1
uses TopLink as the default JPA implementation so you will have to <a
- href="http://www.eclipse.org/eclipselink/downloads/previous_releases.php">download</a>
+ href="http://www.eclipse.org/eclipselink/downloads/">download</a>
the eclipselink.jar,
-and put this in $GLASSFISH_HOME/lib directory. An issue was
-found with the latest EclipseLink(1.1.2), so you will need to
-get EclipseLink 1.1.0. </li>
+and put this in $GLASSFISH_HOME/lib directory.<br>
+ </li>
<br>
<li>Instructions on how to use the Glassfish admin
interface is <a
Modified: incubator/olio/docs/java_setup_kit.html
URL: http://svn.apache.org/viewvc/incubator/olio/docs/java_setup_kit.html?rev=885882&r1=885881&r2=885882&view=diff
==============================================================================
--- incubator/olio/docs/java_setup_kit.html (original)
+++ incubator/olio/docs/java_setup_kit.html Tue Dec 1 19:25:01 2009
@@ -232,10 +232,10 @@
Workload"</p>
</li>
<li>
- <p>Copy MySQL Connector/J (JDBC Driver for MySQL) jar to
+ <p><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>
</li>
- <br>
<li>To deploy the Faban driver, you can either copy
$WORKLOAD/build/OlioDriver.jar to the
$FABAN_HOME/benchmarks directory, or execute <span
@@ -434,7 +434,7 @@
Installation and Configuration</font></h2>
<ol>
<li>
- <p>Install Glassfish application server V2 UR2 from <a
+ <p>Install Glassfish application server V2.1 from <a
href="https://glassfish.dev.java.net/public/downloadsindex.html"><span
style="text-decoration: underline;">https://glassfish.dev.java.net/public/downloadsindex.html.</span></a>
<br>
@@ -524,8 +524,9 @@
Extract the mysql-connector-java-5.1.X-bin.jar and put this your
application server classpath (or external library directory)</li>
<li>Download a Java Persistence API (JPA) provider, eg.
-EclipseLink. You will have to download the eclipselink.jar
-from <a href="http://www.eclipse.org/eclipselink">http://www.eclipse.org/eclipselink</a>,
+EclipseLink. You will have to <a
+ href="http://www.eclipse.org/eclipselink/downloads">download</a> the
+eclipselink.jar
and put this in your application server classpath.</li>
<li>Create JDBC connection pool and resource for connecting to
mySQL database. Below are examples for the properties used for
@@ -573,9 +574,9 @@
$GLASSFISH_HOME/domains/domain1/autodeploy directory. You can
also
deploy via different methods by referring to <a
- href="https://glassfish.dev.java.net/downloads/quickstart/index.html#Packaging_and_Deploying_Applications">https://glassfish.dev.java.net/downloads/quickstart/index.html#Packaging_and_Deploying_Applications</a>.
-<br>
-<br>
+ href="https://glassfish.dev.java.net/downloads/quickstart/index.html#Packaging_and_Deploying_Applications">https://glassfish.dev.java.net/downloads/quickstart/index.html#Packaging_and_Deploying_Applications</a>.<br>
+<span style="font-weight: bold;"></span><span
+ style="font-style: italic;"></span><br>
You must set the geocoderURL property to point to the URL where the
geocoder is deployed. The default value for this property is
http://localhost:8080/geocoder/geocode. Set
@@ -583,9 +584,10 @@
the application server's configuration. For glassfish, you can do this
by editing the domain.xml file (in domains/domain1/config/domain.xml).<br>
<br>
-NOTE: If you are deploying Olio to Oracle WebLogic Server 11g Release 1
+<span style="font-weight: bold;">NOTE</span>: If you are deploying Olio
+to Oracle WebLogic Server 11g Release 1
(10.3.1), there is a WebLogic bug (8448313) that results in a JPA
-exception because lazy fetching is being used. The Exception
+exception because lazy fetching is being used. The Exception
stack trace will appear:<br>
<br>
<span style="font-family: monospace;">javax.persistence.PersistenceException:
Modified: incubator/olio/docs/rails_setup.html
URL: http://svn.apache.org/viewvc/incubator/olio/docs/rails_setup.html?rev=885882&r1=885881&r2=885882&view=diff
==============================================================================
--- incubator/olio/docs/rails_setup.html (original)
+++ incubator/olio/docs/rails_setup.html Tue Dec 1 19:25:01 2009
@@ -296,14 +296,16 @@
</li>
</ol>
<h3>Additional Installation Steps</h3>
-<p>For Linux (debian or ubuntu), the following command can be used :</p>
+<p>For <span style="font-weight: bold;">Linux</span> (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>
+<p style="margin-bottom: 0in;">For <span style="font-weight: bold;">OpenSolaris</span>:</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;">If you are running on a version of
+OpenSolaris before 2009.06, upgrade your Ruby version to the
+latest in the pkg.opensolaris.org/dev repository.<br>
+ </p>
</li>
</ul>
<ul>
@@ -317,8 +319,8 @@
</ul>
<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>
+ <p style="margin-bottom: 0in;">If running on OpenSolaris before
+2009.06, edit <font face="Cumberland, monospace">/usr/ruby/1.8/lib/ruby/1.8/i386-solaris2.11/rbconfig.rb</font>
as follows :</p>
</li>
</ul>
@@ -337,8 +339,8 @@
</ul>
<p style="margin-bottom: 0in;">
<font face="Courier New, monospace"><font size="2">gem
-install mysql --with-mysql-lib=/usr/mysql/5.0/lib/mysql
---with-mysql-include=/usr/mysql/5.0/include</font></font></p>
+install mysql --with-mysql-lib=/usr/mysql/lib/mysql
+--with-mysql-include=/usr/mysql/include</font></font></p>
<ul>
<li>
<p style="margin-bottom: 0in;">Install nginx. You can build nginx
Modified: incubator/olio/docs/rails_setup_kit.html
URL: http://svn.apache.org/viewvc/incubator/olio/docs/rails_setup_kit.html?rev=885882&r1=885881&r2=885882&view=diff
==============================================================================
--- incubator/olio/docs/rails_setup_kit.html (original)
+++ incubator/olio/docs/rails_setup_kit.html Tue Dec 1 19:25:01 2009
@@ -208,7 +208,7 @@
<li><code>cp
samples/services/ApacheHttpdService/build/ApacheHttpdService.jar
services</code></li>
- <li><code>cp samples/services/MysqlService/build/MysqlService.jar
+ <li><code>cp samples/services/MysqlService/build/MySQLService.jar
services</code></li>
<li><code>cp
samples/services/MemcachedService/build/MemcachedService.jar services</code></li>
@@ -302,9 +302,10 @@
<p style="margin-bottom: 0in;">For <span style="font-weight: bold;">OpenSolaris</span>:</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;">If you are running on a version of
+OpenSolaris before 2009.06, upgrade your Ruby version to the
+latest in the pkg.opensolaris.org/dev repository.<br>
+ </p>
</li>
</ul>
<ul>
@@ -318,8 +319,8 @@
</ul>
<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>
+ <p style="margin-bottom: 0in;">If running on OpenSolaris before
+2009.06, edit <font face="Cumberland, monospace">/usr/ruby/1.8/lib/ruby/1.8/i386-solaris2.11/rbconfig.rb</font>
as follows :</p>
</li>
</ul>
@@ -338,8 +339,8 @@
</ul>
<p style="margin-bottom: 0in;"><font face="Courier New, monospace"><font
size="2"> gem
-install mysql --with-mysql-lib=/usr/mysql/5.0/lib/mysql
---with-mysql-include=/usr/mysql/5.0/include</font></font></p>
+install mysql --with-mysql-lib=/usr/mysql/lib/mysql
+--with-mysql-include=/usr/mysql/include</font></font></p>
<ul>
<li>
<p style="margin-bottom: 0in;">Install nginx. You can build nginx