You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@wookie.apache.org by bu...@apache.org on 2012/04/25 21:18:52 UTC

svn commit: r814475 - in /websites/staging/wookie/trunk/content: ./ wookie/docs/developer/release-testing.html

Author: buildbot
Date: Wed Apr 25 19:18:52 2012
New Revision: 814475

Log:
Staging update by buildbot for wookie

Added:
    websites/staging/wookie/trunk/content/wookie/docs/developer/release-testing.html
Modified:
    websites/staging/wookie/trunk/content/   (props changed)

Propchange: websites/staging/wookie/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Wed Apr 25 19:18:52 2012
@@ -1 +1 @@
-1330492
+1330493

Added: websites/staging/wookie/trunk/content/wookie/docs/developer/release-testing.html
==============================================================================
--- websites/staging/wookie/trunk/content/wookie/docs/developer/release-testing.html (added)
+++ websites/staging/wookie/trunk/content/wookie/docs/developer/release-testing.html Wed Apr 25 19:18:52 2012
@@ -0,0 +1,195 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<!--
+
+    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 to You under the Apache License, Version 2.0
+    (the "License"); you may not use this file except in compliance with
+    the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE- 2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+
+  <link href="/wookie/css/wookie.css" rel="stylesheet" type="text/css">
+  <link href="/wookie/css/code.css" rel="stylesheet" type="text/css">
+  <title>Apache Wookie (Incubating) - Testing a release</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+</head>
+
+<body>
+  <div id="banner">
+    <img alt="Apache Wookie (Incubating)" src="/wookie/images/logo.png"/>
+    <h1 class="title">Testing a release</h1>
+  </div>
+  
+  <div id="navigation">
+  <h1 id="general">General</h1>
+<ul>
+<li><a href="/wookie/index.html">Home</a></li>
+<li><a href="/wookie/news.html">News</a></li>
+<li><a href="/wookie/docs/download.html">Download</a></li>
+<li><a href="http://incubator.apache.org/projects/wookie.html">Incubator page</a></li>
+<li><a href="http://www.apache.org/licenses/LICENSE-2.0">License</a></li>
+</ul>
+<h1 id="documentation">Documentation</h1>
+<ul>
+<li><a href="/wookie/docs/download.html">Download and Quickstart</a></li>
+<li><a href="/wookie/docs/admin.html">Server Admin</a></li>
+<li><a href="/wookie/docs/embedding.html">Embedding</a></li>
+<li><a href="/wookie/docs/shindig.html">Integrating with Shindig</a></li>
+<li><a href="/wookie/docs/widgets.html">Building widgets</a></li>
+<li><a href="/wookie/docs/faq.html">FAQ</a></li>
+<li><a href="/wookie/docs/api.html">API Reference</a></li>
+</ul>
+<h1 id="community">Community</h1>
+<ul>
+<li><a href="/wookie/get-involved.html">Get Involved</a></li>
+<li><a href="/wookie/mailing-lists.html">Mailing Lists</a></li>
+<li><a href="/wookie/people.html">People</a></li>
+</ul>
+<h1 id="development">Development</h1>
+<ul>
+<li><a href="/wookie/docs/source.html">Getting Started</a></li>
+<li><a href="/wookie/docs/developer/running.html">Running</a></li>
+<li><a href="/wookie/docs/templates.html">Widget Templates</a></li>
+<li><a href="/wookie/docs/developer/features.html">Extension Features</a></li>
+<li><a href="/wookie/docs/developer/widgets.html">Deploying Widgets</a></li>
+<li><a href="/wookie/docs/develop.html">Environment</a></li>
+<li><a href="/wookie/docs/developer/release-management.html">Release Management</a></li>
+<li><a href="/wookie/docs/developer/issues.html">Issue Tracker</a></li>
+<li><a href="/wookie/docs/developer/index.html">Management</a></li>
+<li><a href="/wookie/docs/developer/parser.html">W3C Widget Parser</a></li>
+</ul>
+<h1 id="asf">ASF</h1>
+<ul>
+<li><a href="http://www.apache.org">Apache Software Foundation</a></li>
+<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+<li><a href="http://www.apache.org/foundation/sponsorship.html">Become a Sponsor</a></li>
+<li><a href="http://www.apache.org/security/">Security</a></li>
+</ul>
+  </div>
+
+  <div id="content">
+    <p>These are instructions to help community members with testing new releases.</p>
+<p>TODO - out of date instructions - need to update! - References to UI have been depricated</p>
+<h1 id="test-environment">Test Environment</h1>
+<p>Ideally the client will access from a different network machine to the server.</p>
+<h1 id="testing-the-build-and-run-scripts">Testing the Build and Run Scripts</h1>
+<p>There are three different types of build to test for release.  All should be available in the latest release branch 
+on svn and/or in the staging area as declared on the wookie-dev list.</p>
+<ul>
+<li>download the appropriate build (all builds should be tested, not just one)</li>
+<li>for source and standalone builds run in standalone mode using the run target in ant</li>
+<li>for the war build deploy the war in your chosen container</li>
+<li>check index page responds</li>
+</ul>
+<h1 id="widget-gallery">Widget Gallery</h1>
+<ul>
+<li>open a new browser window on the server home page</li>
+<li>click view widget gallery</li>
+<li>pick a random widget and click "Demo"</li>
+<li>ensure the widget behaves as expected</li>
+<li>refresh the page</li>
+<li>ensure the widget behaves as expected</li>
+<li>repeat above for at least one other widget (more is better)</li>
+</ul>
+<h1 id="features">Features</h1>
+<ul>
+<li>visit the widget gallery again</li>
+<li>select the Freeder widget (or a widget that you know uses a feature0</li>
+<li>ensure that the widget retrieves some RSS items and displays them correctly</li>
+</ul>
+<h1 id="administration">Administration</h1>
+<h2 id="widget-tests">Widget tests</h2>
+<ul>
+<li>open a new browser window on the server home page</li>
+<li>click "Administration menu"</li>
+<li>enter username and password (default is java, java)</li>
+<li>verify that there are no errors logged for deployed widgets (there may be some warnings about IE compatibility)</li>
+<li>click "View existing widgets"</li>
+<li>expand a few widgets and ensure page behaves as expected</li>
+</ul>
+<h2 id="widget-deployment">Widget Deployment</h2>
+<ul>
+<li>click back button</li>
+<li>click "add new widget"</li>
+<li>upload a test widget (we should provide a simple test widget 
+    in SVN that is packaged but not bundled with the release) </li>
+<li>repeat the "Widget Gallery" tests above with the test widget</li>
+<li>stop the server using CTRL-C</li>
+<li>restart the server and verify the uploaded widget is still present</li>
+</ul>
+<h2 id="gadget-deployment">Gadget Deployment</h2>
+<p>Note that Gadget deployment will only work if you have also installed Shindig 
+according to the instructions for Integrating Wookie with Shindig. If you 
+haven't installed and configured Shindig, skip this step.</p>
+<div class="codehilite"><pre><span class="o">*</span> <span class="n">Repeat</span> <span class="n">the</span> <span class="n">Widget</span> <span class="n">Deployment</span> <span class="n">above</span> <span class="n">but</span> <span class="n">with</span> <span class="n">a</span> <span class="n">Gadget</span> <span class="n">rather</span> <span class="n">than</span> <span class="n">a</span> <span class="n">Widget</span>
+</pre></div>
+
+
+<h2 id="remove-widget">Remove Widget</h2>
+<div class="codehilite"><pre><span class="o">*</span> <span class="n">Click</span> <span class="s">&quot;Remove widget&quot;</span>
+<span class="o">*</span> <span class="n">find</span> <span class="n">the</span> <span class="n">test</span> <span class="n">widget</span> <span class="ow">and</span> <span class="nb">delete</span> <span class="n">it</span>
+<span class="o">*</span> <span class="n">check</span> <span class="n">widget</span> <span class="n">is</span> <span class="ow">not</span> <span class="n">available</span> <span class="n">in</span> <span class="n">widget</span> <span class="n">gallery</span>
+</pre></div>
+
+
+<h2 id="service-types">Service Types</h2>
+<p>FIXME: How do we test this?</p>
+<h2 id="white-list">White List</h2>
+<p>Click White List then carry out the following actions</p>
+<h3 id="access-request-policies">Access request policies</h3>
+<ul>
+<li>click "Manage widget access request policies"</li>
+<li>revoke policies for weather widget</li>
+<li>check Weather widget does not work via the gallery (note it silently fails at present)</li>
+<li>add http://feeds.bbc.co.uk to the whitelist</li>
+<li>check weather widget works via widget gallery</li>
+</ul>
+<h3 id="instantiation">Instantiation</h3>
+<ul>
+<li>go back to the index page (Other - back to main menu)</li>
+<li>click "instantiate a widget"</li>
+<li>select a random widget in "Service Type"</li>
+<li>click submit</li>
+<li>copy URL from returned XML document</li>
+<li>enter URL into browser</li>
+<li>check widget works OK</li>
+</ul>
+<h3 id="reporting">Reporting</h3>
+<p>Thanks for testing. </p>
+<p>Please be sure to report your successes and failures in the developer mailing list. 
+Please include:</p>
+<p>Release versions tested: Source/Standalone/WAR
+Server OSs:
+Server and browser separate machines?:
+Servlet Engine:
+Java version:
+Browsers tests:
+Browser versions:
+Tested with Shindig integration?: Yes/No
+Results: All tests passed/I had the following problem(s)</p>
+  </div>
+
+  <div id="footer">
+    <div class="copyright">
+      <p>
+        Copyright &copy; 2011-2012 The Apache Software Foundation, Licensed under
+        the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+        <br />
+        Apache and the Apache feather logos are trademarks of The Apache Software Foundation.
+      </p>
+    </div>
+  </div>
+
+</body>
+</html>