incubator-tashi-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mry...@apache.org
Subject svn commit: r746335 - in /incubator/tashi/site: docs/ xdocs/ xdocs/stylesheets/
Date Fri, 20 Feb 2009 18:45:54 GMT
Author: mryan3
Date: Fri Feb 20 18:45:53 2009
New Revision: 746335

URL: http://svn.apache.org/viewvc?rev=746335&view=rev
Log:
Documentation about setting up Tashi on a single host for testing.
Updates to the stylesheets to do inline code more cleanly.
Updated the sidebar so that words will not be broken into separate lines.


Modified:
    incubator/tashi/site/docs/coding_standards.html
    incubator/tashi/site/docs/committers.html
    incubator/tashi/site/docs/dependencies.html
    incubator/tashi/site/docs/documentation.html
    incubator/tashi/site/docs/downloads.html
    incubator/tashi/site/docs/faq.html
    incubator/tashi/site/docs/index.html
    incubator/tashi/site/docs/issue_tracking.html
    incubator/tashi/site/docs/license.html
    incubator/tashi/site/docs/mailing_lists.html
    incubator/tashi/site/docs/road_map.html
    incubator/tashi/site/docs/source_code.html
    incubator/tashi/site/xdocs/documentation.xml
    incubator/tashi/site/xdocs/source_code.xml
    incubator/tashi/site/xdocs/stylesheets/project.xml
    incubator/tashi/site/xdocs/stylesheets/site.vsl

Modified: incubator/tashi/site/docs/coding_standards.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/coding_standards.html?rev=746335&r1=746334&r2=746335&view=diff
==============================================================================
--- incubator/tashi/site/docs/coding_standards.html (original)
+++ incubator/tashi/site/docs/coding_standards.html Fri Feb 20 18:45:53 2009
@@ -6,6 +6,7 @@
 	border-width: 0px 0px 0px 0px;
 	border-spacing: 0px;
 	border-collapse: collapse;
+	width: 50%;
 }
 table.simple th {
 	border-width: 1px 1px 1px 1px;
@@ -17,10 +18,11 @@
 	padding: 1px 1px 1px 1px;
 	border-style: outset outset outset outset;
 }
-.loffset {
+.lit {
 	font-family: courier;
+	font-size: 70%;
 	margin: 1em 2em 1em 2em;
-	padding: 1em 1em 1em 1em;
+	padding: 0em 1em 0em 1em;
 	border: 1px dashed #0000FF;
 	background-color: #D0D0FF;
 }
@@ -58,17 +60,17 @@
 </li>
                     <li>    <a href="./committers.html">Committers</a>
 </li>
-                    <li>    <a href="./mailing_lists.html">Mailing Lists</a>
+                    <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>    <a href="./road_map.html">Road Map</a>
 </li>
-                    <li>    <a href="./source_code.html">Source Code</a>
+                    <li>    <a href="./source_code.html">Source Code</a>
 </li>
-                    <li>    <a href="./coding_standards.html">Coding Standards</a>
+                    <li>    <a href="./coding_standards.html">Coding Standards</a>
 </li>
-                    <li>    <a href="./issue_tracking.html">Issue Tracking</a>
+                    <li>    <a href="./issue_tracking.html">Issue Tracking</a>
 </li>
                     <li>    <a href="./dependencies.html">Dependencies</a>
 </li>

Modified: incubator/tashi/site/docs/committers.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/committers.html?rev=746335&r1=746334&r2=746335&view=diff
==============================================================================
--- incubator/tashi/site/docs/committers.html (original)
+++ incubator/tashi/site/docs/committers.html Fri Feb 20 18:45:53 2009
@@ -6,6 +6,7 @@
 	border-width: 0px 0px 0px 0px;
 	border-spacing: 0px;
 	border-collapse: collapse;
+	width: 50%;
 }
 table.simple th {
 	border-width: 1px 1px 1px 1px;
@@ -17,10 +18,11 @@
 	padding: 1px 1px 1px 1px;
 	border-style: outset outset outset outset;
 }
-.loffset {
+.lit {
 	font-family: courier;
+	font-size: 70%;
 	margin: 1em 2em 1em 2em;
-	padding: 1em 1em 1em 1em;
+	padding: 0em 1em 0em 1em;
 	border: 1px dashed #0000FF;
 	background-color: #D0D0FF;
 }
@@ -58,17 +60,17 @@
 </li>
                     <li>    <a href="./committers.html">Committers</a>
 </li>
-                    <li>    <a href="./mailing_lists.html">Mailing Lists</a>
+                    <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>    <a href="./road_map.html">Road Map</a>
 </li>
-                    <li>    <a href="./source_code.html">Source Code</a>
+                    <li>    <a href="./source_code.html">Source Code</a>
 </li>
-                    <li>    <a href="./coding_standards.html">Coding Standards</a>
+                    <li>    <a href="./coding_standards.html">Coding Standards</a>
 </li>
-                    <li>    <a href="./issue_tracking.html">Issue Tracking</a>
+                    <li>    <a href="./issue_tracking.html">Issue Tracking</a>
 </li>
                     <li>    <a href="./dependencies.html">Dependencies</a>
 </li>

Modified: incubator/tashi/site/docs/dependencies.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/dependencies.html?rev=746335&r1=746334&r2=746335&view=diff
==============================================================================
--- incubator/tashi/site/docs/dependencies.html (original)
+++ incubator/tashi/site/docs/dependencies.html Fri Feb 20 18:45:53 2009
@@ -6,6 +6,7 @@
 	border-width: 0px 0px 0px 0px;
 	border-spacing: 0px;
 	border-collapse: collapse;
+	width: 50%;
 }
 table.simple th {
 	border-width: 1px 1px 1px 1px;
@@ -17,10 +18,11 @@
 	padding: 1px 1px 1px 1px;
 	border-style: outset outset outset outset;
 }
-.loffset {
+.lit {
 	font-family: courier;
+	font-size: 70%;
 	margin: 1em 2em 1em 2em;
-	padding: 1em 1em 1em 1em;
+	padding: 0em 1em 0em 1em;
 	border: 1px dashed #0000FF;
 	background-color: #D0D0FF;
 }
@@ -58,17 +60,17 @@
 </li>
                     <li>    <a href="./committers.html">Committers</a>
 </li>
-                    <li>    <a href="./mailing_lists.html">Mailing Lists</a>
+                    <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>    <a href="./road_map.html">Road Map</a>
 </li>
-                    <li>    <a href="./source_code.html">Source Code</a>
+                    <li>    <a href="./source_code.html">Source Code</a>
 </li>
-                    <li>    <a href="./coding_standards.html">Coding Standards</a>
+                    <li>    <a href="./coding_standards.html">Coding Standards</a>
 </li>
-                    <li>    <a href="./issue_tracking.html">Issue Tracking</a>
+                    <li>    <a href="./issue_tracking.html">Issue Tracking</a>
 </li>
                     <li>    <a href="./dependencies.html">Dependencies</a>
 </li>

Modified: incubator/tashi/site/docs/documentation.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/documentation.html?rev=746335&r1=746334&r2=746335&view=diff
==============================================================================
--- incubator/tashi/site/docs/documentation.html (original)
+++ incubator/tashi/site/docs/documentation.html Fri Feb 20 18:45:53 2009
@@ -6,6 +6,7 @@
 	border-width: 0px 0px 0px 0px;
 	border-spacing: 0px;
 	border-collapse: collapse;
+	width: 50%;
 }
 table.simple th {
 	border-width: 1px 1px 1px 1px;
@@ -17,10 +18,11 @@
 	padding: 1px 1px 1px 1px;
 	border-style: outset outset outset outset;
 }
-.loffset {
+.lit {
 	font-family: courier;
+	font-size: 70%;
 	margin: 1em 2em 1em 2em;
-	padding: 1em 1em 1em 1em;
+	padding: 0em 1em 0em 1em;
 	border: 1px dashed #0000FF;
 	background-color: #D0D0FF;
 }
@@ -58,17 +60,17 @@
 </li>
                     <li>    <a href="./committers.html">Committers</a>
 </li>
-                    <li>    <a href="./mailing_lists.html">Mailing Lists</a>
+                    <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>    <a href="./road_map.html">Road Map</a>
 </li>
-                    <li>    <a href="./source_code.html">Source Code</a>
+                    <li>    <a href="./source_code.html">Source Code</a>
 </li>
-                    <li>    <a href="./coding_standards.html">Coding Standards</a>
+                    <li>    <a href="./coding_standards.html">Coding Standards</a>
 </li>
-                    <li>    <a href="./issue_tracking.html">Issue Tracking</a>
+                    <li>    <a href="./issue_tracking.html">Issue Tracking</a>
 </li>
                     <li>    <a href="./dependencies.html">Dependencies</a>
 </li>
@@ -77,7 +79,139 @@
                 <td align="left" valign="top" width="100%">
                                 
                                     <h2>Documentation</h2>
-                                                                        <p>
+                                                                        <h3>Setting
up Tashi on a single test machine</h3>
+                                                                                        
       <p>There are several dependencies you need to setup Tashi, they include:</p>
+                                                                                        
       <ul>
+<li>Apache Thrift</li>
+<li>Xen or Qemu/KVM</li>
+<li>Python 2.4 or greater</li>
+<li>MySQL or sqlite if you wish to use them as the data backend</li>
+</ul>
+                                                                                        
       <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
+</pre></div>
+                                                                                        
       <p>Then, run make:</p>
+                                                                                        
       <div class="lit"><pre>
+mryan3@mryan3-d4:~/scratch/tashi$ make
+Building tashi.services...
+Generating Python code for 'services.thrift'...
+Copying generated code to 'tashi.services' package...
+Generatign Python code for 'messagingthrift'...
+Copying generated code to 'tashi.messaging.messagingthrift' package...
+Symlinking in clustermanager...
+Symlinking in nodemanager...
+Symlinking in tashi-client...
+Building nmd...
+Done
+</pre></div>
+                                                                                        
       <p>Now, you may need to need to modify some configuration parameters to make
Tashi work in your environment.  If you place a file called Tashi.cfg in etc, it will override
settings in TashiDefaults.cfg.  Some pertinent options:</p>
+                                                                                        
       <ul>
+<li>[ClusterManager]data - This specifies whether you use a pickled data file or the
SQL backend</li>
+<li>[NodeManager]VmControl - This specifies which VMM backend you use</li>
+</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@mryan3-d4:~/scratch/tashi$ export PYTHONPATH=`pwd`/src
+</pre></div>
+                                                                                        
       <p>Start the cluster manager (CM) first:</p>
+                                                                                        
       <div class="lit"><pre>
+mryan3@mryan3-d4:~/scratch/tashi$ DEBUG=1 ./bin/clustermanager.py 
+2009-02-19 11:19:04,276 [./bin/clustermanager.py:INFO] Using configuration file(s) ['./etc/TashiDefaults.cfg']
+2009-02-19 11:19:04,276 [./bin/clustermanager.py:INFO] Starting cluster manager
+
+
+In [1]: 
+</pre></div>
+                                                                                        
       <p>I recommend running in debug mode if you haven't got it up and running yet.</p>
+                                                                                        
       <p>Then, add your first host to Tashi.  If your box's hostname was "mryan3-d4"
and you used the pickled data format, you'd do:</p>
+                                                                                        
       <div class="lit"><pre>
+In [1]: from tashi.services.ttypes import Host
+
+In [2]: from tashi.services.ttypes import HostState
+
+In [3]: data.hosts[1] = Host(d={'id':1,'name':'mryan3-d4','state': HostState.Normal,'up':False})
+
+In [4]: data.save()
+
+In [5]:
+</pre></div>
+                                                                                        
       <p>If you were using MySQL (or sqlite), you'd have to populate a row in the database
with columns named "id", "name", "state", and "up".</p>
+                                                                                        
       <p>Then quit the CM and restart it to force the creation of host locks.</p>
+                                                                                        
       <p>Add a user that matches both your user name and id:</p>
+                                                                                        
       <div class="lit"><pre>
+In [1]: from tashi.services.ttypes import User
+
+In [2]: data.users[13090] = User(d={'id':13090,'name':'mryan3'})
+
+In [3]: data.save()
+</pre></div>
+                                                                                        
       <p>Now, you can start the node manager (NM).  You may have to run this as root
if you have trouble gettings VMs to start as a normal user:</p>
+                                                                                        
       <div class="lit"><pre>
+root@mryan3-d4:/home/mryan3/scratch/tashi$ DEBUG=1 ./bin/nodemanager.py 
+2009-02-19 11:25:50,470 [__main__:INFO] Using configuration file(s) ['./etc/TashiDefaults.cfg']
+2009-02-19 11:25:50,475 [./src/tashi/nodemanager/vmcontrol/qemu.pyc:INFO] No vm information
found in /var/tmp/VmControlQemu/
+
+
+In [1]: 
+</pre></div>
+                                                                                        
       <p>After a few seconds, you should see no error messages on the NM and you should
be able to run "tashi-client getHosts":</p>
+                                                                                        
       <div class="lit"><pre>
+mryan3@mryan3-d4:~/scratch/tashi$ ./bin/tashi-client.py getHosts
+ id name      decayed up   state  version                      memory cores
+---------------------------------------------------------------------------
+ 1  mryan3-d4 False   True Normal Wed Feb  4 15:20:15 EST 2009 3894   4    
+</pre></div>
+                                                                                        
       <p>Now that those are running, you can start the scheduler:</p>
+                                                                                        
       <div class="lit"><pre>
+mryan3@mryan3-d4:~/scratch/tashi$ python ./src/tashi/agents/examplepolicy.py 
+
+</pre></div>
+                                                                                        
       <p>Make sure an image is placed in /var/tmp/images (or wherever you configured
it to be):</p>
+                                                                                        
       <div class="lit"><pre>
+mryan3@mryan3-d4:~/scratch/tashi$ ls -la /var/tmp/images/
+total 2385696
+drwxr-xr-x 2 mryan3 mryan3       4096 2009-02-19 12:21 .
+drwxrwxrwt 7 root   root         4096 2009-02-19 12:20 ..
+-rw-r--r-- 1 mryan3 mryan3 2440556544 2009-02-19 12:22 CentOS-5.2-i386.qcow2
+</pre></div>
+                                                                                        
       <p>And finally, you can use the client to try to create a VM:</p>
+                                                                                        
       <div class="lit"><pre>
+mryan3@mryan3-d4:~/scratch/tashi$ ./bin/tashi-client.py createVm --name foobar --disks CentOS-5.2-i386.qcow2
+{
+    hostObj: None
+    hostId: None
+    name: foobar
+    typeObj: {'cores': 1, 'memory': 128, 'id': 1, 'name': 'foo'}
+    userId: 13090
+    decayed: False
+    disks: [
+        {'uri': 'CentOS-5.2-i386.qcow2', 'persistent': False}
+    ]
+    vmId: None
+    userObj: None
+    state: Pending
+    nics: [
+        {'mac': '52:54:00:e5:1d:ca', 'network': 1}
+    ]
+    type: 1
+    id: 1
+    hints: {}
+}
+</pre></div>
+                                                                                        
       <p>The VM will use a TAP device on your system and will be accessible over it.
 If you statically configure the guest for this test, that will work.  It is also possible
to setup a bridge and run a DHCP server on the host to provide IP addresses to the guest.
 In either case, you should be able to log into your guest shortly after that command completes.</p>
+                                                                                        
       <div class="lit"><pre>
+mryan3@mryan3-d4:~/scratch/tashi$ ssh root@192.168.127.223
+The authenticity of host '192.168.127.223 (192.168.127.223)' can't be established.
+RSA key fingerprint is 3d:4b:43:25:05:d8:89:23:ec:9b:6c:1b:42:59:e7:70.
+Are you sure you want to continue connecting (yes/no)? yes
+Warning: Permanently added '192.168.127.223' (RSA) to the list of known hosts.
+root@192.168.127.223's password: 
+Last login: Thu Jan  8 10:25:10 2009
+[root@localhost ~]# 
+</pre></div>
+                                                                                        
       <h3>Setting up Tashi on a cluster</h3>
+                                                                                        
       <p>
 UNDER CONSTRUCTION
 </p>
                                                                             </td>

Modified: incubator/tashi/site/docs/downloads.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/downloads.html?rev=746335&r1=746334&r2=746335&view=diff
==============================================================================
--- incubator/tashi/site/docs/downloads.html (original)
+++ incubator/tashi/site/docs/downloads.html Fri Feb 20 18:45:53 2009
@@ -6,6 +6,7 @@
 	border-width: 0px 0px 0px 0px;
 	border-spacing: 0px;
 	border-collapse: collapse;
+	width: 50%;
 }
 table.simple th {
 	border-width: 1px 1px 1px 1px;
@@ -17,10 +18,11 @@
 	padding: 1px 1px 1px 1px;
 	border-style: outset outset outset outset;
 }
-.loffset {
+.lit {
 	font-family: courier;
+	font-size: 70%;
 	margin: 1em 2em 1em 2em;
-	padding: 1em 1em 1em 1em;
+	padding: 0em 1em 0em 1em;
 	border: 1px dashed #0000FF;
 	background-color: #D0D0FF;
 }
@@ -58,17 +60,17 @@
 </li>
                     <li>    <a href="./committers.html">Committers</a>
 </li>
-                    <li>    <a href="./mailing_lists.html">Mailing Lists</a>
+                    <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>    <a href="./road_map.html">Road Map</a>
 </li>
-                    <li>    <a href="./source_code.html">Source Code</a>
+                    <li>    <a href="./source_code.html">Source Code</a>
 </li>
-                    <li>    <a href="./coding_standards.html">Coding Standards</a>
+                    <li>    <a href="./coding_standards.html">Coding Standards</a>
 </li>
-                    <li>    <a href="./issue_tracking.html">Issue Tracking</a>
+                    <li>    <a href="./issue_tracking.html">Issue Tracking</a>
 </li>
                     <li>    <a href="./dependencies.html">Dependencies</a>
 </li>

Modified: incubator/tashi/site/docs/faq.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/faq.html?rev=746335&r1=746334&r2=746335&view=diff
==============================================================================
--- incubator/tashi/site/docs/faq.html (original)
+++ incubator/tashi/site/docs/faq.html Fri Feb 20 18:45:53 2009
@@ -6,6 +6,7 @@
 	border-width: 0px 0px 0px 0px;
 	border-spacing: 0px;
 	border-collapse: collapse;
+	width: 50%;
 }
 table.simple th {
 	border-width: 1px 1px 1px 1px;
@@ -17,10 +18,11 @@
 	padding: 1px 1px 1px 1px;
 	border-style: outset outset outset outset;
 }
-.loffset {
+.lit {
 	font-family: courier;
+	font-size: 70%;
 	margin: 1em 2em 1em 2em;
-	padding: 1em 1em 1em 1em;
+	padding: 0em 1em 0em 1em;
 	border: 1px dashed #0000FF;
 	background-color: #D0D0FF;
 }
@@ -58,17 +60,17 @@
 </li>
                     <li>    <a href="./committers.html">Committers</a>
 </li>
-                    <li>    <a href="./mailing_lists.html">Mailing Lists</a>
+                    <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>    <a href="./road_map.html">Road Map</a>
 </li>
-                    <li>    <a href="./source_code.html">Source Code</a>
+                    <li>    <a href="./source_code.html">Source Code</a>
 </li>
-                    <li>    <a href="./coding_standards.html">Coding Standards</a>
+                    <li>    <a href="./coding_standards.html">Coding Standards</a>
 </li>
-                    <li>    <a href="./issue_tracking.html">Issue Tracking</a>
+                    <li>    <a href="./issue_tracking.html">Issue Tracking</a>
 </li>
                     <li>    <a href="./dependencies.html">Dependencies</a>
 </li>

Modified: incubator/tashi/site/docs/index.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/index.html?rev=746335&r1=746334&r2=746335&view=diff
==============================================================================
--- incubator/tashi/site/docs/index.html (original)
+++ incubator/tashi/site/docs/index.html Fri Feb 20 18:45:53 2009
@@ -6,6 +6,7 @@
 	border-width: 0px 0px 0px 0px;
 	border-spacing: 0px;
 	border-collapse: collapse;
+	width: 50%;
 }
 table.simple th {
 	border-width: 1px 1px 1px 1px;
@@ -17,10 +18,11 @@
 	padding: 1px 1px 1px 1px;
 	border-style: outset outset outset outset;
 }
-.loffset {
+.lit {
 	font-family: courier;
+	font-size: 70%;
 	margin: 1em 2em 1em 2em;
-	padding: 1em 1em 1em 1em;
+	padding: 0em 1em 0em 1em;
 	border: 1px dashed #0000FF;
 	background-color: #D0D0FF;
 }
@@ -58,17 +60,17 @@
 </li>
                     <li>    <a href="./committers.html">Committers</a>
 </li>
-                    <li>    <a href="./mailing_lists.html">Mailing Lists</a>
+                    <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>    <a href="./road_map.html">Road Map</a>
 </li>
-                    <li>    <a href="./source_code.html">Source Code</a>
+                    <li>    <a href="./source_code.html">Source Code</a>
 </li>
-                    <li>    <a href="./coding_standards.html">Coding Standards</a>
+                    <li>    <a href="./coding_standards.html">Coding Standards</a>
 </li>
-                    <li>    <a href="./issue_tracking.html">Issue Tracking</a>
+                    <li>    <a href="./issue_tracking.html">Issue Tracking</a>
 </li>
                     <li>    <a href="./dependencies.html">Dependencies</a>
 </li>

Modified: incubator/tashi/site/docs/issue_tracking.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/issue_tracking.html?rev=746335&r1=746334&r2=746335&view=diff
==============================================================================
--- incubator/tashi/site/docs/issue_tracking.html (original)
+++ incubator/tashi/site/docs/issue_tracking.html Fri Feb 20 18:45:53 2009
@@ -6,6 +6,7 @@
 	border-width: 0px 0px 0px 0px;
 	border-spacing: 0px;
 	border-collapse: collapse;
+	width: 50%;
 }
 table.simple th {
 	border-width: 1px 1px 1px 1px;
@@ -17,10 +18,11 @@
 	padding: 1px 1px 1px 1px;
 	border-style: outset outset outset outset;
 }
-.loffset {
+.lit {
 	font-family: courier;
+	font-size: 70%;
 	margin: 1em 2em 1em 2em;
-	padding: 1em 1em 1em 1em;
+	padding: 0em 1em 0em 1em;
 	border: 1px dashed #0000FF;
 	background-color: #D0D0FF;
 }
@@ -58,17 +60,17 @@
 </li>
                     <li>    <a href="./committers.html">Committers</a>
 </li>
-                    <li>    <a href="./mailing_lists.html">Mailing Lists</a>
+                    <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>    <a href="./road_map.html">Road Map</a>
 </li>
-                    <li>    <a href="./source_code.html">Source Code</a>
+                    <li>    <a href="./source_code.html">Source Code</a>
 </li>
-                    <li>    <a href="./coding_standards.html">Coding Standards</a>
+                    <li>    <a href="./coding_standards.html">Coding Standards</a>
 </li>
-                    <li>    <a href="./issue_tracking.html">Issue Tracking</a>
+                    <li>    <a href="./issue_tracking.html">Issue Tracking</a>
 </li>
                     <li>    <a href="./dependencies.html">Dependencies</a>
 </li>

Modified: incubator/tashi/site/docs/license.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/license.html?rev=746335&r1=746334&r2=746335&view=diff
==============================================================================
--- incubator/tashi/site/docs/license.html (original)
+++ incubator/tashi/site/docs/license.html Fri Feb 20 18:45:53 2009
@@ -6,6 +6,7 @@
 	border-width: 0px 0px 0px 0px;
 	border-spacing: 0px;
 	border-collapse: collapse;
+	width: 50%;
 }
 table.simple th {
 	border-width: 1px 1px 1px 1px;
@@ -17,10 +18,11 @@
 	padding: 1px 1px 1px 1px;
 	border-style: outset outset outset outset;
 }
-.loffset {
+.lit {
 	font-family: courier;
+	font-size: 70%;
 	margin: 1em 2em 1em 2em;
-	padding: 1em 1em 1em 1em;
+	padding: 0em 1em 0em 1em;
 	border: 1px dashed #0000FF;
 	background-color: #D0D0FF;
 }
@@ -58,17 +60,17 @@
 </li>
                     <li>    <a href="./committers.html">Committers</a>
 </li>
-                    <li>    <a href="./mailing_lists.html">Mailing Lists</a>
+                    <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>    <a href="./road_map.html">Road Map</a>
 </li>
-                    <li>    <a href="./source_code.html">Source Code</a>
+                    <li>    <a href="./source_code.html">Source Code</a>
 </li>
-                    <li>    <a href="./coding_standards.html">Coding Standards</a>
+                    <li>    <a href="./coding_standards.html">Coding Standards</a>
 </li>
-                    <li>    <a href="./issue_tracking.html">Issue Tracking</a>
+                    <li>    <a href="./issue_tracking.html">Issue Tracking</a>
 </li>
                     <li>    <a href="./dependencies.html">Dependencies</a>
 </li>

Modified: incubator/tashi/site/docs/mailing_lists.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/mailing_lists.html?rev=746335&r1=746334&r2=746335&view=diff
==============================================================================
--- incubator/tashi/site/docs/mailing_lists.html (original)
+++ incubator/tashi/site/docs/mailing_lists.html Fri Feb 20 18:45:53 2009
@@ -6,6 +6,7 @@
 	border-width: 0px 0px 0px 0px;
 	border-spacing: 0px;
 	border-collapse: collapse;
+	width: 50%;
 }
 table.simple th {
 	border-width: 1px 1px 1px 1px;
@@ -17,10 +18,11 @@
 	padding: 1px 1px 1px 1px;
 	border-style: outset outset outset outset;
 }
-.loffset {
+.lit {
 	font-family: courier;
+	font-size: 70%;
 	margin: 1em 2em 1em 2em;
-	padding: 1em 1em 1em 1em;
+	padding: 0em 1em 0em 1em;
 	border: 1px dashed #0000FF;
 	background-color: #D0D0FF;
 }
@@ -58,17 +60,17 @@
 </li>
                     <li>    <a href="./committers.html">Committers</a>
 </li>
-                    <li>    <a href="./mailing_lists.html">Mailing Lists</a>
+                    <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>    <a href="./road_map.html">Road Map</a>
 </li>
-                    <li>    <a href="./source_code.html">Source Code</a>
+                    <li>    <a href="./source_code.html">Source Code</a>
 </li>
-                    <li>    <a href="./coding_standards.html">Coding Standards</a>
+                    <li>    <a href="./coding_standards.html">Coding Standards</a>
 </li>
-                    <li>    <a href="./issue_tracking.html">Issue Tracking</a>
+                    <li>    <a href="./issue_tracking.html">Issue Tracking</a>
 </li>
                     <li>    <a href="./dependencies.html">Dependencies</a>
 </li>

Modified: incubator/tashi/site/docs/road_map.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/road_map.html?rev=746335&r1=746334&r2=746335&view=diff
==============================================================================
--- incubator/tashi/site/docs/road_map.html (original)
+++ incubator/tashi/site/docs/road_map.html Fri Feb 20 18:45:53 2009
@@ -6,6 +6,7 @@
 	border-width: 0px 0px 0px 0px;
 	border-spacing: 0px;
 	border-collapse: collapse;
+	width: 50%;
 }
 table.simple th {
 	border-width: 1px 1px 1px 1px;
@@ -17,10 +18,11 @@
 	padding: 1px 1px 1px 1px;
 	border-style: outset outset outset outset;
 }
-.loffset {
+.lit {
 	font-family: courier;
+	font-size: 70%;
 	margin: 1em 2em 1em 2em;
-	padding: 1em 1em 1em 1em;
+	padding: 0em 1em 0em 1em;
 	border: 1px dashed #0000FF;
 	background-color: #D0D0FF;
 }
@@ -58,17 +60,17 @@
 </li>
                     <li>    <a href="./committers.html">Committers</a>
 </li>
-                    <li>    <a href="./mailing_lists.html">Mailing Lists</a>
+                    <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>    <a href="./road_map.html">Road Map</a>
 </li>
-                    <li>    <a href="./source_code.html">Source Code</a>
+                    <li>    <a href="./source_code.html">Source Code</a>
 </li>
-                    <li>    <a href="./coding_standards.html">Coding Standards</a>
+                    <li>    <a href="./coding_standards.html">Coding Standards</a>
 </li>
-                    <li>    <a href="./issue_tracking.html">Issue Tracking</a>
+                    <li>    <a href="./issue_tracking.html">Issue Tracking</a>
 </li>
                     <li>    <a href="./dependencies.html">Dependencies</a>
 </li>

Modified: incubator/tashi/site/docs/source_code.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/source_code.html?rev=746335&r1=746334&r2=746335&view=diff
==============================================================================
--- incubator/tashi/site/docs/source_code.html (original)
+++ incubator/tashi/site/docs/source_code.html Fri Feb 20 18:45:53 2009
@@ -6,6 +6,7 @@
 	border-width: 0px 0px 0px 0px;
 	border-spacing: 0px;
 	border-collapse: collapse;
+	width: 50%;
 }
 table.simple th {
 	border-width: 1px 1px 1px 1px;
@@ -17,10 +18,11 @@
 	padding: 1px 1px 1px 1px;
 	border-style: outset outset outset outset;
 }
-.loffset {
+.lit {
 	font-family: courier;
+	font-size: 70%;
 	margin: 1em 2em 1em 2em;
-	padding: 1em 1em 1em 1em;
+	padding: 0em 1em 0em 1em;
 	border: 1px dashed #0000FF;
 	background-color: #D0D0FF;
 }
@@ -58,17 +60,17 @@
 </li>
                     <li>    <a href="./committers.html">Committers</a>
 </li>
-                    <li>    <a href="./mailing_lists.html">Mailing Lists</a>
+                    <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>    <a href="./road_map.html">Road Map</a>
 </li>
-                    <li>    <a href="./source_code.html">Source Code</a>
+                    <li>    <a href="./source_code.html">Source Code</a>
 </li>
-                    <li>    <a href="./coding_standards.html">Coding Standards</a>
+                    <li>    <a href="./coding_standards.html">Coding Standards</a>
 </li>
-                    <li>    <a href="./issue_tracking.html">Issue Tracking</a>
+                    <li>    <a href="./issue_tracking.html">Issue Tracking</a>
 </li>
                     <li>    <a href="./dependencies.html">Dependencies</a>
 </li>
@@ -82,9 +84,9 @@
 </p>
                                                                                         
       <p>
 Or from a command prompt:
-<div class="loffset">
+<div class="lit"><pre>
 svn co http://svn.apache.org/repos/asf/incubator/tashi
-</div>
+</pre></div>
 </p>
                                                                                 <h2>ViewVC</h2>
                                                                         <p>

Modified: incubator/tashi/site/xdocs/documentation.xml
URL: http://svn.apache.org/viewvc/incubator/tashi/site/xdocs/documentation.xml?rev=746335&r1=746334&r2=746335&view=diff
==============================================================================
--- incubator/tashi/site/xdocs/documentation.xml (original)
+++ incubator/tashi/site/xdocs/documentation.xml Fri Feb 20 18:45:53 2009
@@ -28,6 +28,140 @@
 
 <section name="Documentation">
 
+<h3>Setting up Tashi on a single test machine</h3>
+
+<p>There are several dependencies you need to setup Tashi, they include:</p>
+<ul>
+<li>Apache Thrift</li>
+<li>Xen or Qemu/KVM</li>
+<li>Python 2.4 or greater</li>
+<li>MySQL or sqlite if you wish to use them as the data backend</li>
+</ul>
+<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
+</pre></div>
+<p>Then, run make:</p>
+<div class="lit"><pre>
+mryan3@mryan3-d4:~/scratch/tashi$ make
+Building tashi.services...
+Generating Python code for 'services.thrift'...
+Copying generated code to 'tashi.services' package...
+Generatign Python code for 'messagingthrift'...
+Copying generated code to 'tashi.messaging.messagingthrift' package...
+Symlinking in clustermanager...
+Symlinking in nodemanager...
+Symlinking in tashi-client...
+Building nmd...
+Done
+</pre></div>
+<p>Now, you may need to need to modify some configuration parameters to make Tashi
work in your environment.  If you place a file called Tashi.cfg in etc, it will override settings
in TashiDefaults.cfg.  Some pertinent options:</p>
+<ul>
+<li>[ClusterManager]data - This specifies whether you use a pickled data file or the
SQL backend</li>
+<li>[NodeManager]VmControl - This specifies which VMM backend you use</li>
+</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@mryan3-d4:~/scratch/tashi$ export PYTHONPATH=`pwd`/src
+</pre></div>
+<p>Start the cluster manager (CM) first:</p>
+<div class="lit"><pre>
+mryan3@mryan3-d4:~/scratch/tashi$ DEBUG=1 ./bin/clustermanager.py 
+2009-02-19 11:19:04,276 [./bin/clustermanager.py:INFO] Using configuration file(s) ['./etc/TashiDefaults.cfg']
+2009-02-19 11:19:04,276 [./bin/clustermanager.py:INFO] Starting cluster manager
+
+
+In [1]: 
+</pre></div>
+<p>I recommend running in debug mode if you haven't got it up and running yet.</p>
+<p>Then, add your first host to Tashi.  If your box's hostname was "mryan3-d4" and
you used the pickled data format, you'd do:</p>
+<div class="lit"><pre>
+In [1]: from tashi.services.ttypes import Host
+
+In [2]: from tashi.services.ttypes import HostState
+
+In [3]: data.hosts[1] = Host(d={'id':1,'name':'mryan3-d4','state': HostState.Normal,'up':False})
+
+In [4]: data.save()
+
+In [5]:
+</pre></div>
+<p>If you were using MySQL (or sqlite), you'd have to populate a row in the database
with columns named "id", "name", "state", and "up".</p>
+<p>Then quit the CM and restart it to force the creation of host locks.</p>
+<p>Add a user that matches both your user name and id:</p>
+<div class="lit"><pre>
+In [1]: from tashi.services.ttypes import User
+
+In [2]: data.users[13090] = User(d={'id':13090,'name':'mryan3'})
+
+In [3]: data.save()
+</pre></div>
+<p>Now, you can start the node manager (NM).  You may have to run this as root if you
have trouble gettings VMs to start as a normal user:</p>
+<div class="lit"><pre>
+root@mryan3-d4:/home/mryan3/scratch/tashi$ DEBUG=1 ./bin/nodemanager.py 
+2009-02-19 11:25:50,470 [__main__:INFO] Using configuration file(s) ['./etc/TashiDefaults.cfg']
+2009-02-19 11:25:50,475 [./src/tashi/nodemanager/vmcontrol/qemu.pyc:INFO] No vm information
found in /var/tmp/VmControlQemu/
+
+
+In [1]: 
+</pre></div>
+<p>After a few seconds, you should see no error messages on the NM and you should be
able to run "tashi-client getHosts":</p>
+<div class="lit"><pre>
+mryan3@mryan3-d4:~/scratch/tashi$ ./bin/tashi-client.py getHosts
+ id name      decayed up   state  version                      memory cores
+---------------------------------------------------------------------------
+ 1  mryan3-d4 False   True Normal Wed Feb  4 15:20:15 EST 2009 3894   4    
+</pre></div>
+<p>Now that those are running, you can start the scheduler:</p>
+<div class="lit"><pre>
+mryan3@mryan3-d4:~/scratch/tashi$ python ./src/tashi/agents/examplepolicy.py 
+
+</pre></div>
+<p>Make sure an image is placed in /var/tmp/images (or wherever you configured it to
be):</p>
+<div class="lit"><pre>
+mryan3@mryan3-d4:~/scratch/tashi$ ls -la /var/tmp/images/
+total 2385696
+drwxr-xr-x 2 mryan3 mryan3       4096 2009-02-19 12:21 .
+drwxrwxrwt 7 root   root         4096 2009-02-19 12:20 ..
+-rw-r--r-- 1 mryan3 mryan3 2440556544 2009-02-19 12:22 CentOS-5.2-i386.qcow2
+</pre></div>
+<p>And finally, you can use the client to try to create a VM:</p>
+<div class="lit"><pre>
+mryan3@mryan3-d4:~/scratch/tashi$ ./bin/tashi-client.py createVm --name foobar --disks CentOS-5.2-i386.qcow2
+{
+    hostObj: None
+    hostId: None
+    name: foobar
+    typeObj: {'cores': 1, 'memory': 128, 'id': 1, 'name': 'foo'}
+    userId: 13090
+    decayed: False
+    disks: [
+        {'uri': 'CentOS-5.2-i386.qcow2', 'persistent': False}
+    ]
+    vmId: None
+    userObj: None
+    state: Pending
+    nics: [
+        {'mac': '52:54:00:e5:1d:ca', 'network': 1}
+    ]
+    type: 1
+    id: 1
+    hints: {}
+}
+</pre></div>
+<p>The VM will use a TAP device on your system and will be accessible over it.  If
you statically configure the guest for this test, that will work.  It is also possible to
setup a bridge and run a DHCP server on the host to provide IP addresses to the guest.  In
either case, you should be able to log into your guest shortly after that command completes.</p>
+<div class="lit"><pre>
+mryan3@mryan3-d4:~/scratch/tashi$ ssh root@192.168.127.223
+The authenticity of host '192.168.127.223 (192.168.127.223)' can't be established.
+RSA key fingerprint is 3d:4b:43:25:05:d8:89:23:ec:9b:6c:1b:42:59:e7:70.
+Are you sure you want to continue connecting (yes/no)? yes
+Warning: Permanently added '192.168.127.223' (RSA) to the list of known hosts.
+root@192.168.127.223's password: 
+Last login: Thu Jan  8 10:25:10 2009
+[root@localhost ~]# 
+</pre></div>
+<h3>Setting up Tashi on a cluster</h3>
+
 <p>
 UNDER CONSTRUCTION
 </p>

Modified: incubator/tashi/site/xdocs/source_code.xml
URL: http://svn.apache.org/viewvc/incubator/tashi/site/xdocs/source_code.xml?rev=746335&r1=746334&r2=746335&view=diff
==============================================================================
--- incubator/tashi/site/xdocs/source_code.xml (original)
+++ incubator/tashi/site/xdocs/source_code.xml Fri Feb 20 18:45:53 2009
@@ -32,9 +32,9 @@
 </p>
 <p>
 Or from a command prompt:
-<div class="loffset">
+<div class="lit"><pre>
 svn co http://svn.apache.org/repos/asf/incubator/tashi
-</div>
+</pre></div>
 </p>
 </section>
 

Modified: incubator/tashi/site/xdocs/stylesheets/project.xml
URL: http://svn.apache.org/viewvc/incubator/tashi/site/xdocs/stylesheets/project.xml?rev=746335&r1=746334&r2=746335&view=diff
==============================================================================
--- incubator/tashi/site/xdocs/stylesheets/project.xml (original)
+++ incubator/tashi/site/xdocs/stylesheets/project.xml Fri Feb 20 18:45:53 2009
@@ -29,12 +29,12 @@
             <item name="Downloads" href="/downloads.html"/>
             <item name="Documentation" href="/documentation.html"/>
             <item name="Committers" href="/committers.html"/>
-            <item name="Mailing Lists" href="/mailing_lists.html"/>
+            <item name="Mailing&#160;Lists" href="/mailing_lists.html"/>
             <item name="FAQ" href="/faq.html"/>
-            <item name="Road Map" href="/road_map.html"/>
-            <item name="Source Code" href="/source_code.html"/>
-            <item name="Coding Standards" href="/coding_standards.html"/>
-            <item name="Issue Tracking" href="/issue_tracking.html"/>
+            <item name="Road&#160;Map" href="/road_map.html"/>
+            <item name="Source&#160;Code" href="/source_code.html"/>
+            <item name="Coding&#160;Standards" href="/coding_standards.html"/>
+            <item name="Issue&#160;Tracking" href="/issue_tracking.html"/>
             <item name="Dependencies" href="/dependencies.html"/>
         </menu>
     </body>

Modified: incubator/tashi/site/xdocs/stylesheets/site.vsl
URL: http://svn.apache.org/viewvc/incubator/tashi/site/xdocs/stylesheets/site.vsl?rev=746335&r1=746334&r2=746335&view=diff
==============================================================================
--- incubator/tashi/site/xdocs/stylesheets/site.vsl (original)
+++ incubator/tashi/site/xdocs/stylesheets/site.vsl Fri Feb 20 18:45:53 2009
@@ -30,6 +30,7 @@
 	border-width: 0px 0px 0px 0px;
 	border-spacing: 0px;
 	border-collapse: collapse;
+	width: 50%;
 }
 table.simple th {
 	border-width: 1px 1px 1px 1px;
@@ -41,10 +42,11 @@
 	padding: 1px 1px 1px 1px;
 	border-style: outset outset outset outset;
 }
-.loffset {
+.lit {
 	font-family: courier;
+	font-size: 70%;
 	margin: 1em 2em 1em 2em;
-	padding: 1em 1em 1em 1em;
+	padding: 0em 1em 0em 1em;
 	border: 1px dashed #0000FF;
 	background-color: #D0D0FF;
 }



Mime
View raw message