incubator-tashi-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From strou...@apache.org
Subject svn commit: r1296746 - in /incubator/tashi/site: docs/ xdocs/
Date Sun, 04 Mar 2012 05:22:55 GMT
Author: stroucki
Date: Sun Mar  4 05:22:54 2012
New Revision: 1296746

URL: http://svn.apache.org/viewvc?rev=1296746&view=rev
Log:
add documentation for accounting service
do general updates before the publishing procedure changes. :)

Added:
    incubator/tashi/site/docs/documentation-accounting.html
    incubator/tashi/site/xdocs/documentation-accounting.xml
Modified:
    incubator/tashi/site/docs/dependencies.html
    incubator/tashi/site/docs/documentation-single.html
    incubator/tashi/site/docs/documentation.html
    incubator/tashi/site/docs/faq.html
    incubator/tashi/site/docs/road_map.html
    incubator/tashi/site/docs/source_code.html
    incubator/tashi/site/xdocs/dependencies.xml
    incubator/tashi/site/xdocs/documentation-single.xml
    incubator/tashi/site/xdocs/documentation.xml
    incubator/tashi/site/xdocs/faq.xml
    incubator/tashi/site/xdocs/road_map.xml
    incubator/tashi/site/xdocs/source_code.xml

Modified: incubator/tashi/site/docs/dependencies.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/dependencies.html?rev=1296746&r1=1296745&r2=1296746&view=diff
==============================================================================
--- incubator/tashi/site/docs/dependencies.html (original)
+++ incubator/tashi/site/docs/dependencies.html Sun Mar  4 05:22:54 2012
@@ -104,12 +104,6 @@ table.options td {
                                                                                         
       <p>
 "rpyc (Remote Python Call) is a transparent and symmetrical python library for remote procedure
calls, clustering and distributed-computing. RPyC makes use of object-proxying, a technique
that employs python's dynamic nature, to overcome the physical boundaries between processes
and computers, so that remote objects can be manipulated as if they were local."
 </p>
-                                                                                        
       <p>
-<a href="http://incubator.apache.org/thrift/">Apache Thrift</a>
-</p>
-                                                                                        
       <p>
-Thrift is a software framework for scalable cross-language services development. It combines
a software stack with a code generation engine to build services that work efficiently and
seamlessly between C++, Java, Python, PHP, Ruby, Erlang, Perl, Haskell, C#, Cocoa, Smalltalk,
and OCaml.
-</p>
                                                                             </td>
                 </tr>
             </table>

Added: incubator/tashi/site/docs/documentation-accounting.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/documentation-accounting.html?rev=1296746&view=auto
==============================================================================
--- incubator/tashi/site/docs/documentation-accounting.html (added)
+++ incubator/tashi/site/docs/documentation-accounting.html Sun Mar  4 05:22:54 2012
@@ -0,0 +1,125 @@
+<!-- Content Stylesheet for Site -->
+
+    
+<style type="text/css">
+table.simple {
+	border-width: 0px 0px 0px 0px;
+	border-spacing: 0px;
+	border-collapse: collapse;
+	width: 50%;
+}
+table.simple th {
+	border-width: 1px 1px 1px 1px;
+	padding: 1px 1px 1px 1px;
+	border-style: outset outset outset outset;
+}
+table.simple td {
+	border-width: 1px 1px 1px 1px;
+	padding: 1px 1px 1px 1px;
+	border-style: outset outset outset outset;
+}
+table.options {
+	border-width: 0px 0px 0px 0px;
+	border-spacing: 0px;
+	border-collapse: collapse;
+	width: 100%;
+	font-size: 70%;
+}
+table.options th {
+	border-width: 1px 1px 1px 1px;
+	padding: 1px 1px 1px 1px;
+	border-style: outset outset outset outset;
+}
+table.options td {
+	border-width: 1px 1px 1px 1px;
+	padding: 1px 1px 1px 1px;
+	border-style: outset outset outset outset;
+	vertical-align: top;
+}
+.lit {
+	font-family: courier;
+	font-size: 70%;
+	margin: 1em 2em 1em 2em;
+	padding: 0em 1em 0em 1em;
+	border: 1px dashed #0000FF;
+	background-color: #D0D0FF;
+}
+</style>
+
+<!-- start the processing -->
+    <html>
+        <head>
+            <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+            <title>Apache Tashi - Documentation</title>
+        </head>
+
+        <body bgcolor="#ffffff" text="#000000" link="#525D76">
+            <table border="0" width="100%" cellspacing="5">
+                <tr>
+                <td align="center" valign="top">
+                    <img src="images/tashi-logo.png"/>
+                    <img src="images/tashi-photo-small.jpg" height=100 alt="Tashi: Your
Faithful Cluster Manager"/>
+                </td>
+                <td align="right" valign="top" width="100%">
+                    <img src="images/apache-incubator-logo.png" align="right" valign="top"/>
+                </td>
+                </tr>
+                <tr>
+                <td align="left" valign="top">
+                    
+            <strong>Apache Tashi</strong>
+        <ul>
+                    <li>    <a href="./index.html">Home</a>
+</li>
+                    <li>    <a href="./license.html">License</a>
+</li>
+                    <li>    <a href="./downloads.html">Downloads</a>
+</li>
+                    <li>    <a href="./documentation.html">Documentation</a>
+</li>
+                    <li>    <a href="./committers.html">Committers</a>
+</li>
+                    <li>    <a href="./mailing_lists.html">Mailing Lists</a>
+</li>
+                    <li>    <a href="./faq.html">FAQ</a>
+</li>
+                    <li>    <a href="./road_map.html">Road Map</a>
+</li>
+                    <li>    <a href="./source_code.html">Source Code</a>
+</li>
+                    <li>    <a href="./coding_standards.html">Coding Standards</a>
+</li>
+                    <li>    <a href="./issue_tracking.html">Issue Tracking</a>
+</li>
+                    <li>    <a href="./dependencies.html">Dependencies</a>
+</li>
+                </ul>
+                    </td>
+                <td align="left" valign="top" width="100%">
+                                
+                                    <h2>The accounting service of Tashi</h2>
+                                                                        <p>
+The accounting service will periodically query the cluster manager for a list of virtual
machines under management. The accounting service also receives status updates from the cluster
manager and the node managers. The logs generated from this information can be used for cluster
analysis and billing purposes.
+</p>
+                                                                            </td>
+                </tr>
+            </table>
+	<h2>Disclaimer</h2>
+	<p>
+		Apache Tashi is an effort undergoing incubation at The Apache Software 
+Foundation (ASF), sponsored by the Apache Incubator PMC.
+Incubation is required of all newly accepted projects until a further 
+review indicates that the infrastructure, communications, and decision 
+making process have stabilized in a manner consistent with other 
+successful ASF projects. While incubation status is not necessarily a 
+reflection of the completeness or stability of the code, it does 
+indicate that the project has yet to be fully endorsed by the ASF.
+	</p>
+        </body>
+    </html>
+<!-- end the processing -->
+
+
+
+
+

Modified: incubator/tashi/site/docs/documentation-single.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/documentation-single.html?rev=1296746&r1=1296745&r2=1296746&view=diff
==============================================================================
--- incubator/tashi/site/docs/documentation-single.html (original)
+++ incubator/tashi/site/docs/documentation-single.html Sun Mar  4 05:22:54 2012
@@ -101,11 +101,12 @@ table.options td {
                                                                         <h3>Installation</h3>
                                                                                         
       <p>There are several dependencies you need to setup Tashi, they include:</p>
                                                                                         
       <ul>
-<li>Xen or Qemu/KVM</li>
-<li>Python 2.4 or greater</li>
-<li>RPyC</li>
-<li>MySQL or sqlite if you wish to use them as the data backend</li>
+<li>Qemu/KVM or Xen</li>
+<li>Python 2.6 or greater</li>
+<li>RPyC (version 3.1)</li>
+<li>MySQL or sqlite, with their python interfaces, if you wish to use them as the data
backend</li>
 </ul>
+                                                                                        
       <p>Please note that the code distribution contains an installation walkthrough,
which is more up to date than this document.</p>
                                                                                         
       <p>Once these are setup and configured, check out the Tashi code:</p>
                                                                                         
       <div class="lit"><pre>
 svn co http://svn.apache.org/repos/asf/incubator/tashi/trunk ./tashi
@@ -130,7 +131,7 @@ Done
 </ul>
                                                                                         
       <p>If you haven't installed Tashi in /usr/lib/python2.5/site-packages/ or the
equivalent folder, you must set the PYTHONPATH environment variable so that python can find
the Tashi code:</p>
                                                                                         
       <div class="lit"><pre>
-mryan3@firsthost:~/scratch/tashi$ export PYTHONPATH=`pwd`/src
+mryan3@firsthost:~/scratch/tashi$ export PYTHONPATH=/usr/local/tashi/src
 </pre></div>
                                                                                         
       <p>Start the cluster manager (CM) first:</p>
                                                                                         
       <div class="lit"><pre>
@@ -154,6 +155,7 @@ In [3]: data.baseDataObject.save()
 
 In [4]:
 </pre></div>
+                                                                                        
       <p>The name "default" for the network here is significant; automatic placement
will only take place to the network called "default".</p>
                                                                                         
       <p>If you were using MySQL (or sqlite), you'd have to populate the
 relevant tables in the database.</p>
                                                                                         
       <div class="lit"><pre>
@@ -191,6 +193,7 @@ mryan3@firsthost:~/scratch/tashi$ ./bin/
 
 </pre></div>
                                                                                         
       <h3>VM deployment (XEN)</h3>
+                                                                                        
       <p>Most Tashi users and developers currently use the Qemu interface, so the Xen
interface may be more buggy. Please report any problems observed.</p>
                                                                                         
       <p>Have your networking environment set up, so that the virtual machines
 may be attached to the proper virtual bridges.</p>
                                                                                         
       <p>In Xen 3, virtual disks are attached using <tt>blktap</tt>, so
make sure that

Modified: incubator/tashi/site/docs/documentation.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/documentation.html?rev=1296746&r1=1296745&r2=1296746&view=diff
==============================================================================
--- incubator/tashi/site/docs/documentation.html (original)
+++ incubator/tashi/site/docs/documentation.html Sun Mar  4 05:22:54 2012
@@ -114,6 +114,9 @@ table.options td {
 <a href="documentation-primitive.html">The primitive scheduler</a>
 </p>
                                                                                         
       <p>
+<a href="documentation-accounting.html">The accounting service</a>
+</p>
+                                                                                        
       <p>
 <a href="documentation-options.html">Configuration options for Tashi</a>
 </p>
                                                                             </td>

Modified: incubator/tashi/site/docs/faq.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/faq.html?rev=1296746&r1=1296745&r2=1296746&view=diff
==============================================================================
--- incubator/tashi/site/docs/faq.html (original)
+++ incubator/tashi/site/docs/faq.html Sun Mar  4 05:22:54 2012
@@ -99,15 +99,13 @@ table.options td {
                                 
                                     <h2>FAQ</h2>
                                                                         <p>
-<b>Q: Why does Tashi complain about "unexpected keyword argument 'd'"?</b>
-<br />
-A: Tashi was originally developed against an older version of Thrift.  This is mentioned
on the <a href="documentation.html">documentation</a> page.  You will have to
downgrade to an older version of Thrift.
-</p>
-                                                                                        
       <p>
 <b>Q: Why does Tashi have the error message "Failed to exec gmetric, disabling"</b>
 <br />
 A: This happens because Tashi was unable to find gmetric on your system.  gmetric is a part
of Ganglia.  It is not necessary to use Ganglia in order to use Tashi, but Tashi has the ability
to output per-VM statistics and log messages a Ganglia metrics.  If you don't care about either
of those features, you can safely ignore this message -- or turn of the use of the GangliaPublisher
class in the config file.
 </p>
+                                                                                        
       <p>
+<b>Please submit additional candidates via the issue tracking system</b>
+</p>
                                                                             </td>
                 </tr>
             </table>

Modified: incubator/tashi/site/docs/road_map.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/road_map.html?rev=1296746&r1=1296745&r2=1296746&view=diff
==============================================================================
--- incubator/tashi/site/docs/road_map.html (original)
+++ incubator/tashi/site/docs/road_map.html Sun Mar  4 05:22:54 2012
@@ -103,7 +103,7 @@ table.options td {
 <ul>
 <li>Demonstrate the ability to run HDFS on a set of hosts and the Hadoop JobTrackers
in virtual machines while maintaining data-local performance: <b>Done at CMU in 2010.</b></li>
 <li>Integrate with Zoni: <b>Done by Richard Gass</b></li>
-<li>Have at least a rudimentary resource log to permit billing: <b>Michael Stroucken</b></li>
+<li>Have at least a rudimentary resource log to permit billing: <b>Done by Michael
Stroucken</b></li>
 </ul>
 </p>
                                                                                         
       <h3>Current issues</h3>

Modified: incubator/tashi/site/docs/source_code.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/source_code.html?rev=1296746&r1=1296745&r2=1296746&view=diff
==============================================================================
--- incubator/tashi/site/docs/source_code.html (original)
+++ incubator/tashi/site/docs/source_code.html Sun Mar  4 05:22:54 2012
@@ -107,6 +107,9 @@ Or from a command prompt:
 svn co http://svn.apache.org/repos/asf/incubator/tashi
 </pre></div>
 </p>
+                                                                                        
       <p>
+By Apache Incubator policy, the tags directory hold branches that were used to generate releases
(or release candidates). The branches directory hold general purpose tracking and development
branches. The "stable" branch tracks stability and security fixes from the trunk, but excludes
new features or protocols. The "oldstable" branch tracks the branch previously held to be
the stable branch. Only in rare instances will this branch be updated.
+</p>
                                                                                 <h2>ViewVC</h2>
                                                                         <p>
 If you're looking to browse it, you can use ViewVC at: <a href="http://svn.apache.org/viewvc/incubator/tashi">http://svn.apache.org/repos/asf/incubator/tashi</a>

Modified: incubator/tashi/site/xdocs/dependencies.xml
URL: http://svn.apache.org/viewvc/incubator/tashi/site/xdocs/dependencies.xml?rev=1296746&r1=1296745&r2=1296746&view=diff
==============================================================================
--- incubator/tashi/site/xdocs/dependencies.xml (original)
+++ incubator/tashi/site/xdocs/dependencies.xml Sun Mar  4 05:22:54 2012
@@ -33,14 +33,10 @@
 <p>
 "rpyc (Remote Python Call) is a transparent and symmetrical python library for remote procedure
calls, clustering and distributed-computing. RPyC makes use of object-proxying, a technique
that employs python's dynamic nature, to overcome the physical boundaries between processes
and computers, so that remote objects can be manipulated as if they were local."
 </p>
-<p>
-<a href="http://incubator.apache.org/thrift/">Apache Thrift</a>
-</p>
-<p>
-Thrift is a software framework for scalable cross-language services development. It combines
a software stack with a code generation engine to build services that work efficiently and
seamlessly between C++, Java, Python, PHP, Ruby, Erlang, Perl, Haskell, C#, Cocoa, Smalltalk,
and OCaml.
-</p>
-
 </section>
 
+<p>
+Certain Tashi modules may require additional interfaces and system libraries be installed.
+</p>
 </body>
 </document>

Added: incubator/tashi/site/xdocs/documentation-accounting.xml
URL: http://svn.apache.org/viewvc/incubator/tashi/site/xdocs/documentation-accounting.xml?rev=1296746&view=auto
==============================================================================
--- incubator/tashi/site/xdocs/documentation-accounting.xml (added)
+++ incubator/tashi/site/xdocs/documentation-accounting.xml Sun Mar  4 05:22:54 2012
@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ 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.    
+-->
+
+<document>
+
+  <properties>
+    <title>Documentation</title>
+  </properties>
+
+<body>
+
+<section name="The accounting service of Tashi">
+
+<p>
+The accounting service will periodically query the cluster manager for a list of virtual
machines under management. The accounting service also receives status updates from the cluster
manager and the node managers. The logs generated from this information can be used for cluster
analysis and billing purposes.
+</p>
+
+</section>
+
+</body>
+</document>

Modified: incubator/tashi/site/xdocs/documentation-single.xml
URL: http://svn.apache.org/viewvc/incubator/tashi/site/xdocs/documentation-single.xml?rev=1296746&r1=1296745&r2=1296746&view=diff
==============================================================================
--- incubator/tashi/site/xdocs/documentation-single.xml (original)
+++ incubator/tashi/site/xdocs/documentation-single.xml Sun Mar  4 05:22:54 2012
@@ -32,11 +32,13 @@
 
 <p>There are several dependencies you need to setup Tashi, they include:</p>
 <ul>
-<li>Xen or Qemu/KVM</li>
-<li>Python 2.4 or greater</li>
-<li>RPyC</li>
-<li>MySQL or sqlite if you wish to use them as the data backend</li>
+<li>Qemu/KVM or Xen</li>
+<li>Python 2.6 or greater</li>
+<li>RPyC (version 3.1)</li>
+<li>MySQL or sqlite, with their python interfaces, if you wish to use them as the data
backend</li>
 </ul>
+<p>Please note that the code distribution contains an installation walkthrough, which
is more up to date than this document.</p>
+
 <p>Once these are setup and configured, check out the Tashi code:</p>
 <div class="lit"><pre>
 svn co http://svn.apache.org/repos/asf/incubator/tashi/trunk ./tashi
@@ -63,7 +65,7 @@ Done
 </ul>
 <p>If you haven't installed Tashi in /usr/lib/python2.5/site-packages/ or the equivalent
folder, you must set the PYTHONPATH environment variable so that python can find the Tashi
code:</p>
 <div class="lit"><pre>
-mryan3@firsthost:~/scratch/tashi$ export PYTHONPATH=`pwd`/src
+mryan3@firsthost:~/scratch/tashi$ export PYTHONPATH=/usr/local/tashi/src
 </pre></div>
 <p>Start the cluster manager (CM) first:</p>
 <div class="lit"><pre>
@@ -87,6 +89,8 @@ In [3]: data.baseDataObject.save()
 
 In [4]:
 </pre></div>
+<p>The name "default" for the network here is significant; automatic placement will
only take place to the network called "default".</p>
+
 <p>If you were using MySQL (or sqlite), you'd have to populate the
 relevant tables in the database.</p>
 <div class="lit"><pre>
@@ -126,6 +130,8 @@ mryan3@firsthost:~/scratch/tashi$ ./bin/
 
 <h3>VM deployment (XEN)</h3>
 
+<p>Most Tashi users and developers currently use the Qemu interface, so the Xen interface
may be more buggy. Please report any problems observed.</p>
+
 <p>Have your networking environment set up, so that the virtual machines
 may be attached to the proper virtual bridges.</p>
 

Modified: incubator/tashi/site/xdocs/documentation.xml
URL: http://svn.apache.org/viewvc/incubator/tashi/site/xdocs/documentation.xml?rev=1296746&r1=1296745&r2=1296746&view=diff
==============================================================================
--- incubator/tashi/site/xdocs/documentation.xml (original)
+++ incubator/tashi/site/xdocs/documentation.xml Sun Mar  4 05:22:54 2012
@@ -44,6 +44,9 @@
 <a href="documentation-primitive.html">The primitive scheduler</a>
 </p>
 <p>
+<a href="documentation-accounting.html">The accounting service</a>
+</p>
+<p>
 <a href="documentation-options.html">Configuration options for Tashi</a>
 </p>
 

Modified: incubator/tashi/site/xdocs/faq.xml
URL: http://svn.apache.org/viewvc/incubator/tashi/site/xdocs/faq.xml?rev=1296746&r1=1296745&r2=1296746&view=diff
==============================================================================
--- incubator/tashi/site/xdocs/faq.xml (original)
+++ incubator/tashi/site/xdocs/faq.xml Sun Mar  4 05:22:54 2012
@@ -29,17 +29,14 @@
 <section name="FAQ">
 
 <p>
-<b>Q: Why does Tashi complain about "unexpected keyword argument 'd'"?</b>
-<br/>
-A: Tashi was originally developed against an older version of Thrift.  This is mentioned
on the <a href="documentation.html">documentation</a> page.  You will have to
downgrade to an older version of Thrift.
-</p>
-
-<p>
 <b>Q: Why does Tashi have the error message "Failed to exec gmetric, disabling"</b>
 <br/>
 A: This happens because Tashi was unable to find gmetric on your system.  gmetric is a part
of Ganglia.  It is not necessary to use Ganglia in order to use Tashi, but Tashi has the ability
to output per-VM statistics and log messages a Ganglia metrics.  If you don't care about either
of those features, you can safely ignore this message -- or turn of the use of the GangliaPublisher
class in the config file.
 </p>
 
+<p>
+<b>Please submit additional candidates via the issue tracking system</b>
+</p>
 </section>
 
 </body>

Modified: incubator/tashi/site/xdocs/road_map.xml
URL: http://svn.apache.org/viewvc/incubator/tashi/site/xdocs/road_map.xml?rev=1296746&r1=1296745&r2=1296746&view=diff
==============================================================================
--- incubator/tashi/site/xdocs/road_map.xml (original)
+++ incubator/tashi/site/xdocs/road_map.xml Sun Mar  4 05:22:54 2012
@@ -34,7 +34,7 @@
 <ul>
 <li>Demonstrate the ability to run HDFS on a set of hosts and the Hadoop JobTrackers
in virtual machines while maintaining data-local performance: <b>Done at CMU in 2010.</b></li>
 <li>Integrate with Zoni: <b>Done by Richard Gass</b></li>
-<li>Have at least a rudimentary resource log to permit billing: <b>Michael Stroucken</b></li>
+<li>Have at least a rudimentary resource log to permit billing: <b>Done by Michael
Stroucken</b></li>
 </ul>
 </p>
 

Modified: incubator/tashi/site/xdocs/source_code.xml
URL: http://svn.apache.org/viewvc/incubator/tashi/site/xdocs/source_code.xml?rev=1296746&r1=1296745&r2=1296746&view=diff
==============================================================================
--- incubator/tashi/site/xdocs/source_code.xml (original)
+++ incubator/tashi/site/xdocs/source_code.xml Sun Mar  4 05:22:54 2012
@@ -36,6 +36,9 @@ Or from a command prompt:
 svn co http://svn.apache.org/repos/asf/incubator/tashi
 </pre></div>
 </p>
+<p>
+By Apache Incubator policy, the tags directory hold branches that were used to generate releases
(or release candidates). The branches directory hold general purpose tracking and development
branches. The "stable" branch tracks stability and security fixes from the trunk, but excludes
new features or protocols. The "oldstable" branch tracks the branch previously held to be
the stable branch. Only in rare instances will this branch be updated.
+</p>
 </section>
 
 <section name="ViewVC">



Mime
View raw message