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