You are viewing a plain text version of this content. The canonical link for it is here.
Posted to tashi-commits@incubator.apache.org by mr...@apache.org on 2009/06/12 17:05:52 UTC
svn commit: r784196 [1/2] - in /incubator/tashi/site: docs/ xdocs/
xdocs/stylesheets/
Author: mryan3
Date: Fri Jun 12 17:05:51 2009
New Revision: 784196
URL: http://svn.apache.org/viewvc?rev=784196&view=rev
Log:
A few minor website updates and quite a bit of documentation added. All the HTML pages were regenerated as well.
Added:
incubator/tashi/site/docs/documentation-cluster.html
incubator/tashi/site/docs/documentation-options.html
incubator/tashi/site/docs/documentation-qemu.html
incubator/tashi/site/docs/documentation-single.html
incubator/tashi/site/docs/documentation-xenpv.html
incubator/tashi/site/xdocs/documentation-cluster.xml
incubator/tashi/site/xdocs/documentation-options.xml
incubator/tashi/site/xdocs/documentation-qemu.xml
incubator/tashi/site/xdocs/documentation-single.xml
incubator/tashi/site/xdocs/documentation-xenpv.xml
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/faq.xml
incubator/tashi/site/xdocs/road_map.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=784196&r1=784195&r2=784196&view=diff
==============================================================================
--- incubator/tashi/site/docs/coding_standards.html (original)
+++ incubator/tashi/site/docs/coding_standards.html Fri Jun 12 17:05:51 2009
@@ -18,6 +18,24 @@
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%;
Modified: incubator/tashi/site/docs/committers.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/committers.html?rev=784196&r1=784195&r2=784196&view=diff
==============================================================================
--- incubator/tashi/site/docs/committers.html (original)
+++ incubator/tashi/site/docs/committers.html Fri Jun 12 17:05:51 2009
@@ -18,6 +18,24 @@
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%;
Modified: incubator/tashi/site/docs/dependencies.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/dependencies.html?rev=784196&r1=784195&r2=784196&view=diff
==============================================================================
--- incubator/tashi/site/docs/dependencies.html (original)
+++ incubator/tashi/site/docs/dependencies.html Fri Jun 12 17:05:51 2009
@@ -18,6 +18,24 @@
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%;
Added: incubator/tashi/site/docs/documentation-cluster.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/documentation-cluster.html?rev=784196&view=auto
==============================================================================
--- incubator/tashi/site/docs/documentation-cluster.html (added)
+++ incubator/tashi/site/docs/documentation-cluster.html Fri Jun 12 17:05:51 2009
@@ -0,0 +1,113 @@
+<!-- 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=iso-8859-1"/>
+ <title>Apache Tashi - Documentation</title>
+ </head>
+
+ <body bgcolor="#ffffff" text="#000000" link="#525D76">
+ <table border="0" width="100%" cellspacing="5">
+ <tr>
+ <td align="left" valign="top">
+ <img src="images/tashi-logo.png" align="left" valign="top"/>
+ </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>Setting up Tashi on a cluster</h2>
+ <p>
+UNDER CONSTRUCTION
+</p>
+ </td>
+ </tr>
+ </table>
+ </body>
+ </html>
+<!-- end the processing -->
+
+
+
+
+
Added: incubator/tashi/site/docs/documentation-options.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/documentation-options.html?rev=784196&view=auto
==============================================================================
--- incubator/tashi/site/docs/documentation-options.html (added)
+++ incubator/tashi/site/docs/documentation-options.html Fri Jun 12 17:05:51 2009
@@ -0,0 +1,603 @@
+<!-- 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=iso-8859-1"/>
+ <title>Apache Tashi - Documentation</title>
+ </head>
+
+ <body bgcolor="#ffffff" text="#000000" link="#525D76">
+ <table border="0" width="100%" cellspacing="5">
+ <tr>
+ <td align="left" valign="top">
+ <img src="images/tashi-logo.png" align="left" valign="top"/>
+ </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>Configuration Options for Tashi</h2>
+ <p>
+<table class="options">
+<tr>
+<td>Option</td>
+<td>Default</td>
+<td>Description</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[ClusterManager]
+</center>
+</td>
+</tr>
+<tr>
+<td>service</td>
+<td>tashi.clustermanager.ClusteManagerService</td>
+<td>This specifies the class name of the cluster manager service</td>
+</tr>
+<tr>
+<td>data</td>
+<td>tashi.clustermanager.data.GetentOverride</td>
+<td>This specifies the class name for the data backend. Available options are: GetentOverride, LdapOverride, Pickled, FromConfig, and SQL (all in tashi.clustermanager.data)</td>
+</tr>
+<tr>
+<td>dfs</td>
+<td>tashi.dfs.Vfs</td>
+<td>This specifies the class name of the DFS implementation used at the cluster manager</td>
+</tr>
+<tr>
+<td>publisher</td>
+<td>tashi.messaging.GangliaPublisher</td>
+<td>This specifies the class name of the publisher used at the cluster manager</td>
+</tr>
+<tr>
+<td>nodeManagerPort</td>
+<td>9883</td>
+<td>This specifies what port number to try to connect to Node Managers on</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[ClusterManagerService]
+</center>
+</td>
+</tr>
+<tr>
+<td>convertExceptions</td>
+<td>True</td>
+<td>Whether exceptions raised in ClusterManagerService should be converted to generic exceptions and passed along to the client</td>
+</tr>
+<tr>
+<td>port</td>
+<td>9882</td>
+<td>What port to listen on for client requests</td>
+</tr>
+<tr>
+<td>expireHostTime</td>
+<td>30.0</td>
+<td>The amount of time (in seconds) to let pass before considering a host down if the cluster manager has not heard from it</td>
+</tr>
+<tr>
+<td>allowDecayed</td>
+<td>30.0</td>
+<td>The amount of time to let an instance or a host be decayed before attempting to sync</td>
+</tr>
+<tr>
+<td>allowMismatchedVersions</td>
+<td>False</td>
+<td>Whether to allow Node Managers that have difference software versions to join the cluster</td>
+</tr>
+<tr>
+<td>maxMemory</td>
+<td>7680</td>
+<td>The maximum amount of memory any user can request for a VM</td>
+</tr>
+<tr>
+<td>maxCores</td>
+<td>8</td>
+<td>The maximum number of cores any user can request for a VM</td>
+</tr>
+<tr>
+<td>allowDuplicateNames</td>
+<td>False</td>
+<td>Whether VMs are allowed to have duplicate names</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[GetentOverride]
+</center>
+</td>
+</tr>
+<tr>
+<td>baseData</td>
+<td>tashi.clustermanager.data.Pickled</td>
+<td>The backend data class to use for data not related to users</td>
+</tr>
+<tr>
+<td>fetchThreshold</td>
+<td>60.0</td>
+<td>The minimum amount of time to wait between calling "getent"</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[LdapOverride]
+</center>
+</td>
+</tr>
+<tr>
+<td>baseData</td>
+<td>tashi.clustermanager.data.Pickled</td>
+<td>The backend data class to use for data not related to users</td>
+</tr>
+<tr>
+<td>fetchThreshold</td>
+<td>3600.0</td>
+<td>The minimum amount of time to wait between issuing LDAP queries</td>
+</tr>
+<tr>
+<td>nameKey</td>
+<td>sAMAccountName</td>
+<td>The variable name that represents usernames in the LDAP results</td>
+</tr>
+<tr>
+<td>idKey</td>
+<td>msSFU30UidNumber</td>
+<td>The variable name that represents user ids in the LDAP results</td>
+</tr>
+<tr>
+<td>ldapCommand</td>
+<td>ldapsearch -x -w password -h host -b searchbase -D binddn msSFU30LoginShell=* -z 0</td>
+<td>The ldap command to run to perform lookups</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[FromConfig]
+</center>
+</td>
+</tr>
+<tr>
+<td>host<i>n</i></td>
+<td>Host(d={'id':1,'name':'blade043'})</td>
+<td>Specifies a host object to be created</td>
+</tr>
+<tr>
+<td>network<i>n</i></td>
+<td>Network(d={'id':1,'name':'global'})</td>
+<td>Specifies a network object to be created</td>
+</tr>
+<tr>
+<td>user<i>n</i></td>
+<td>User(d={'id':1,'name':'mryan3'})</td>
+<td>Specifies a user object to be created</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[Pickled]
+</center>
+</td>
+</tr>
+<tr>
+<td>file</td>
+<td>/var/tmp/cm.dat</td>
+<td>The file to use to store pickled data for the cluster manager</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[SQL]
+</center>
+</td>
+</tr>
+<tr>
+<td>uri</td>
+<td>mysql://root@localhost/tashi</td>
+<td>The URI that describes what SQL backend to use -- examples include sqlite://<i>filename</i> and mysql://<i>user</i>@<i>host</i>/<i>dbname</i></td>
+</tr>
+<tr>
+<td>password</td>
+<td>changeme</td>
+<td>The password to use when connecting to a MySQL database</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[NodeManager]
+</center>
+</td>
+</tr>
+<tr>
+<td>dfs</td>
+<td>tashi.dfs.Vfs</td>
+<td>This specifies the class name of the DFS implementation used at the node manager</td>
+</tr>
+<tr>
+<td>vmm</td>
+<td>tashi.nodemanager.vmcontrol.Qemu</td>
+<td>This specifies the class name of the VMM backend used at the node manager</td>
+</tr>
+<tr>
+<td>service</td>
+<td>tashi.nodemanager.NodeManagerService</td>
+<td>This specifies the class name of the node manager service</td>
+</tr>
+<tr>
+<td>publisher</td>
+<td>tashi.messaging.GangliaPublisher</td>
+<td>This specifies the class name of the publisher used at the node manager</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[NodeManagerService]
+</center>
+</td>
+</tr>
+<tr>
+<td>convertExceptions</td>
+<td>True</td>
+<td>Whether exceptions raised in NodeManagerService should be converted to generic exceptions and passed along to the client</td>
+</tr>
+<tr>
+<td>port</td>
+<td>9883</td>
+<td>What port to listen on for client requests</td>
+</tr>
+<tr>
+<td>registerFrequency</td>
+<td>10.0</td>
+<td>How many seconds should the node manager wait between registering with the cluster manager?</td>
+</tr>
+<tr>
+<td>infoFile</td>
+<td>/var/tmp/nm.dat</td>
+<td>Where the node manager places pickled run-time information for crash or restart recovery</td>
+</tr>
+<tr>
+<td>clusterManagerHost</td>
+<td>localhost</td>
+<td>What host to connect to in order to find the cluster manager</td>
+</tr>
+<tr>
+<td>clusterManagerPort</td>
+<td>9882</td>
+<td>What port to connect to the cluster manager on</td>
+</tr>
+<tr>
+<td>statsInterval</td>
+<td>0.0</td>
+<td>How often should the node manager output per-VM statistics using the publisher</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[Qemu]
+</center>
+</td>
+</tr>
+<tr>
+<td>qemuBin</td>
+<td>/usr/local/bin/qemu-system-x86_64</td>
+<td>The location of the Qemu/Kqemu/KVM binary to be used?</td>
+</tr>
+<tr>
+<td>infoDir</td>
+<td>/var/tmp/VmControlQemu/</td>
+<td>A location into which the Qemu backend places per-VM control infromation?</td>
+</tr>
+<tr>
+<td>pollDelay</td>
+<td>1.0</td>
+<td>How often to check and see if a VM has exited</td>
+</tr>
+<tr>
+<td>migrationRetries</td>
+<td>10</td>
+<td>How many retries are allowed on failed migrations</td>
+</tr>
+<tr>
+<td>monitorTimeout</td>
+<td>60.0</td>
+<td>How long to wait before timing out on monitor command execution</td>
+</tr>
+<tr>
+<td>migrateTimeout</td>
+<td>300.0</td>
+<td>How long to wait before timing out a live migration</td>
+</tr>
+<tr>
+<td>maxParallelMigrations</td>
+<td>10</td>
+<td>How many parallel live migrations are allowed</td>
+</tr>
+<tr>
+<td>useMigrateArgument</td>
+<td>False</td>
+<td>An option to allow the use of "migrate=True" as an argument to KVM -- requires a patch to KVM</td>
+</tr>
+<tr>
+<td>statsInterval</td>
+<td>0.0</td>
+<td>How often to collect per-VM statistics</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[XenPV]
+</center>
+</td>
+</tr>
+<tr>
+<td>vmNamePrefix</td>
+<td>tashi</td>
+<td>The name prefix to use when dealing with Xen domains?</td>
+</tr>
+<tr>
+<td>transientdir</td>
+<td>/tmp</td>
+<td>A place to put transient deltas of disk images</td>
+</tr>
+<tr>
+<td>defaultVmType</td>
+<td>kernel</td>
+<td>This specifies the type and kernel loading mechanism for the VM -- options are "pvgrub", "pygrub", "kernel", and "hvm"</td>
+</tr>
+<tr>
+<td>defaultKernel</td>
+<td>/boot/vmlinuz-xen</td>
+<td>If the VmType is "kernel", this is the kernel to load for use in the guest</td>
+</tr>
+<tr>
+<td>defaultRamdisk</td>
+<td>/boot/initrd-xen</td>
+<td>If the VmType is "kernel", this is the initrd to load for use in the guest</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[Vfs]
+</center>
+</td>
+</tr>
+<tr>
+<td>prefix</td>
+<td>/var/tmp/</td>
+<td>A location into which all DFS access is directed -- this is usually a mount point</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[LocalityService]
+</center>
+</td>
+</tr>
+<tr>
+<td>host</td>
+<td>localityserver</td>
+<td>The hostname clients use to find the locality server</td>
+</tr>
+<tr>
+<td>port</td>
+<td>9884</td>
+<td>The port to listen on for requests</td>
+</tr>
+<tr>
+<td>staticLayout</td>
+<td>/location/of/layout/file</td>
+<td>The location of a layout specification file</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[Client]
+</center>
+</td>
+</tr>
+<tr>
+<td>clusterManagerHost</td>
+<td>localhost</td>
+<td>The hostname to use to find the cluster manager</td>
+</tr>
+<tr>
+<td>clusterManagerPort</td>
+<td>9882</td>
+<td>The port to use when communicating with the cluster manager</td>
+</tr>
+<tr>
+<td>clusterManagerTimeout</td>
+<td>5.0</td>
+<td>The number of seconds to wait before assuming an operation has timed out</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[Primitive]
+</center>
+</td>
+</tr>
+<tr>
+<td>hook<i>n</i></td>
+<td>tashi.agents.DhcpDns</td>
+<td>This allows the specification of an ordered list of agent hooks that perform actions when VMs are started and stopped</td>
+</tr>
+<tr>
+<td>scheduleDelay</td>
+<td>2.0</td>
+<td>How long to delay between scheduling cycles</td>
+</tr>
+<tr>
+<td>densePack</td>
+<td>False</td>
+<td>Should VMs be densely packed across hosts</td>
+</tr>
+<tr>
+<td>publisher</td>
+<td>tashi.messaging.GangliaPublisher</td>
+<td>The publisher to use for the scheduling agent</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[DhcpDns]
+</center>
+</td>
+</tr>
+<tr>
+<td>dnsKeyFile</td>
+<td>/location/of/private/key/for/dns</td>
+<td>The location of the privake key file for DNS updates</td>
+</tr>
+<tr>
+<td>dnsServer</td>
+<td>1.2.3.4 53</td>
+<td>The server to connect to to perform DNS updates</td>
+</tr>
+<tr>
+<td>dnsDomain</td>
+<td>your.domain.com</td>
+<td>The domain in which VM hostnames are inserted</td>
+</tr>
+<tr>
+<td>dnsExpire</td>
+<td>31536000</td>
+<td>How long are entries cacheable</td>
+</tr>
+<tr>
+<td>dhcpServer</td>
+<td>1.2.3.4</td>
+<td>The server with to which DHCP updates are sent</td>
+</tr>
+<tr>
+<td>dhcpKeyName</td>
+<td>OMAPI</td>
+<td>The name of the DHCP key being used</td>
+</tr>
+<tr>
+<td>dhcpSecretKey</td>
+<td>ABcdEf12GhIJKLmnOpQrsT==</td>
+<td>The DHCP secret key</td>
+</tr>
+<tr>
+<td>ipRange<i>n</i></td>
+<td>172.16.128.2-172.16.255.254</td>
+<td>For network <i>n</i>, this specifies the IP range to be used for allocations</td>
+</tr>
+<tr>
+<td>reverseDns</td>
+<td>True</td>
+<td>Should reverse DNS entries be inserted and removed</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[GangliaPublisher]
+</center>
+</td>
+</tr>
+<tr>
+<td>dmax</td>
+<td>60</td>
+<td>The amount of time that published messages are held on to before discarding</td>
+</tr>
+<tr>
+<td>retry</td>
+<td>3600</td>
+<td>How often, in seconds, to retry executing gmetric to see if it has been installed</td>
+</tr>
+</table>
+</p>
+ </td>
+ </tr>
+ </table>
+ </body>
+ </html>
+<!-- end the processing -->
+
+
+
+
+
Added: incubator/tashi/site/docs/documentation-qemu.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/documentation-qemu.html?rev=784196&view=auto
==============================================================================
--- incubator/tashi/site/docs/documentation-qemu.html (added)
+++ incubator/tashi/site/docs/documentation-qemu.html Fri Jun 12 17:05:51 2009
@@ -0,0 +1,141 @@
+<!-- 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=iso-8859-1"/>
+ <title>Apache Tashi - Documentation</title>
+ </head>
+
+ <body bgcolor="#ffffff" text="#000000" link="#525D76">
+ <table border="0" width="100%" cellspacing="5">
+ <tr>
+ <td align="left" valign="top">
+ <img src="images/tashi-logo.png" align="left" valign="top"/>
+ </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 Qemu backend of Tashi</h2>
+ <p>
+The Qemu backend allows the use of Qemu, Kqemu, and KVM as virtual machine managers. KVM is of particular interest since it utilizes Intel VT and AMD-V technologies, which greatly accelerate the performce of virtual machines.
+</p>
+ <p>
+The vmmSpecificCall options for Qemu are listed below:
+<ul>
+<li>startVnc</li>
+This option starts a VNC server that exposes the guest and returns a host:port pair that a user can connect to
+<li>stopVnc</li>
+This stops the above mentioned VNC server
+<li>changeCdrom:<target></li>
+This replaces the virtual cdrom drive in a guest with another ISO
+<li>startConsole</li>
+This opens a TCP port that a user can telnet to to get direct access to the Qemu control console
+<li>list</li>
+This lists the options available on this particular version of the Qemu backend
+</ul>
+</p>
+ <p>
+Additionally, the following hints are useful with the Qemu backend:
+<ul>
+<li>clock</li>
+This specifies the clock type to use for the VM -- options are "dynticks", "rtc", etc.
+<li>diskInterface</li>
+This specifies the disk interface to use for the VM -- options are "ide", "scsi", "virtio", etc.
+<li>nicModel</li>
+This specifies the NIC model to use on the VM -- options are "e1000", "rtl8139", "virtio", etc.
+<li>noAcpi</li>
+This is a boolean that specifies whether or not ACPI is emulated
+</ul>
+</p>
+ </td>
+ </tr>
+ </table>
+ </body>
+ </html>
+<!-- end the processing -->
+
+
+
+
+
Added: incubator/tashi/site/docs/documentation-single.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/documentation-single.html?rev=784196&view=auto
==============================================================================
--- incubator/tashi/site/docs/documentation-single.html (added)
+++ incubator/tashi/site/docs/documentation-single.html Fri Jun 12 17:05:51 2009
@@ -0,0 +1,242 @@
+<!-- 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=iso-8859-1"/>
+ <title>Apache Tashi - Documentation</title>
+ </head>
+
+ <body bgcolor="#ffffff" text="#000000" link="#525D76">
+ <table border="0" width="100%" cellspacing="5">
+ <tr>
+ <td align="left" valign="top">
+ <img src="images/tashi-logo.png" align="left" valign="top"/>
+ </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>Setting up Tashi on a single test machine</h2>
+ <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><i>Please note that due to changes made in Thrift recently, you may need to get an older version of the software. The version that Tashi was developed against was from April 11th, 2008.</i></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
+</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><i>If you get an error about "'unexpected keyword argument 'd'", you'll have to downgrade to an older version of Thrift. As noted above, the version that Tashi was built against was from April 11th, 2008, but there are many versions that will work with Tashi.</i></p>
+ <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>
+ </td>
+ </tr>
+ </table>
+ </body>
+ </html>
+<!-- end the processing -->
+
+
+
+
+
Added: incubator/tashi/site/docs/documentation-xenpv.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/documentation-xenpv.html?rev=784196&view=auto
==============================================================================
--- incubator/tashi/site/docs/documentation-xenpv.html (added)
+++ incubator/tashi/site/docs/documentation-xenpv.html Fri Jun 12 17:05:51 2009
@@ -0,0 +1,113 @@
+<!-- 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=iso-8859-1"/>
+ <title>Apache Tashi - Documentation</title>
+ </head>
+
+ <body bgcolor="#ffffff" text="#000000" link="#525D76">
+ <table border="0" width="100%" cellspacing="5">
+ <tr>
+ <td align="left" valign="top">
+ <img src="images/tashi-logo.png" align="left" valign="top"/>
+ </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 XenPV backend of Tashi</h2>
+ <p>
+UNDER CONSTRUCTION
+</p>
+ </td>
+ </tr>
+ </table>
+ </body>
+ </html>
+<!-- end the processing -->
+
+
+
+
+
Modified: incubator/tashi/site/docs/documentation.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/documentation.html?rev=784196&r1=784195&r2=784196&view=diff
==============================================================================
--- incubator/tashi/site/docs/documentation.html (original)
+++ incubator/tashi/site/docs/documentation.html Fri Jun 12 17:05:51 2009
@@ -18,6 +18,24 @@
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%;
@@ -79,142 +97,20 @@
<td align="left" valign="top" width="100%">
<h2>Documentation</h2>
- <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><i>Please note that due to changes made in Thrift recently, you may need to get an older version of the software. The version that Tashi was developed against was from April 11th, 2008.</i></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
-</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><i>If you get an error about "'unexpected keyword argument 'd'", you'll have to downgrade to an older version of Thrift. As noted above, the version that Tashi was built against was from April 11th, 2008, but there are many versions that will work with Tashi.</i></p>
- <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>
+<a href="documentation-single.html">Setting up Tashi on a single test machine</a>
+</p>
+ <p>
+<a href="documentation-cluster.html">Setting up Tashi on a cluster</a>
+</p>
+ <p>
+<a href="documentation-qemu.html">The Qemu backend of Tashi</a>
+</p>
+ <p>
+<a href="documentation-xenpv.html">The XenPV backend of Tashi</a>
+</p>
<p>
-UNDER CONSTRUCTION
+<a href="documentation-options.html">Configuration options for Tashi</a>
</p>
</td>
</tr>
Modified: incubator/tashi/site/docs/downloads.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/downloads.html?rev=784196&r1=784195&r2=784196&view=diff
==============================================================================
--- incubator/tashi/site/docs/downloads.html (original)
+++ incubator/tashi/site/docs/downloads.html Fri Jun 12 17:05:51 2009
@@ -18,6 +18,24 @@
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%;
Modified: incubator/tashi/site/docs/faq.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/faq.html?rev=784196&r1=784195&r2=784196&view=diff
==============================================================================
--- incubator/tashi/site/docs/faq.html (original)
+++ incubator/tashi/site/docs/faq.html Fri Jun 12 17:05:51 2009
@@ -18,6 +18,24 @@
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%;
@@ -80,7 +98,14 @@
<h2>FAQ</h2>
<p>
-UNDER CONSTRUCTION
+<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>
</td>
</tr>
Modified: incubator/tashi/site/docs/index.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/index.html?rev=784196&r1=784195&r2=784196&view=diff
==============================================================================
--- incubator/tashi/site/docs/index.html (original)
+++ incubator/tashi/site/docs/index.html Fri Jun 12 17:05:51 2009
@@ -18,6 +18,24 @@
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%;
Modified: incubator/tashi/site/docs/issue_tracking.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/issue_tracking.html?rev=784196&r1=784195&r2=784196&view=diff
==============================================================================
--- incubator/tashi/site/docs/issue_tracking.html (original)
+++ incubator/tashi/site/docs/issue_tracking.html Fri Jun 12 17:05:51 2009
@@ -18,6 +18,24 @@
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%;
Modified: incubator/tashi/site/docs/license.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/license.html?rev=784196&r1=784195&r2=784196&view=diff
==============================================================================
--- incubator/tashi/site/docs/license.html (original)
+++ incubator/tashi/site/docs/license.html Fri Jun 12 17:05:51 2009
@@ -18,6 +18,24 @@
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%;
Modified: incubator/tashi/site/docs/mailing_lists.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/mailing_lists.html?rev=784196&r1=784195&r2=784196&view=diff
==============================================================================
--- incubator/tashi/site/docs/mailing_lists.html (original)
+++ incubator/tashi/site/docs/mailing_lists.html Fri Jun 12 17:05:51 2009
@@ -18,6 +18,24 @@
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%;
Modified: incubator/tashi/site/docs/road_map.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/road_map.html?rev=784196&r1=784195&r2=784196&view=diff
==============================================================================
--- incubator/tashi/site/docs/road_map.html (original)
+++ incubator/tashi/site/docs/road_map.html Fri Jun 12 17:05:51 2009
@@ -18,6 +18,24 @@
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%;
@@ -79,8 +97,20 @@
<td align="left" valign="top" width="100%">
<h2>Road Map</h2>
- <p>
-UNDER CONSTRUCTION
+ <h3>Before an initial release</h3>
+ <p>
+<ul>
+<li>Replace Thrift with something that provides authentication and encryption (at least for the core communications in the system)</li>
+<li>Provide ACLs for disk images</li>
+<li>Demonstrate the ability to run HDFS on a set of hosts and the Hadoop JobTrackers in virtual machines while maintaining data-local performance</li>
+<li>Integrate with PRS</li>
+</ul>
+</p>
+ <h3>Long-term</h3>
+ <p>
+<ul>
+<li>Add support for atleast one slice-based virtual machine manager</li>
+</ul>
</p>
</td>
</tr>
Modified: incubator/tashi/site/docs/source_code.html
URL: http://svn.apache.org/viewvc/incubator/tashi/site/docs/source_code.html?rev=784196&r1=784195&r2=784196&view=diff
==============================================================================
--- incubator/tashi/site/docs/source_code.html (original)
+++ incubator/tashi/site/docs/source_code.html Fri Jun 12 17:05:51 2009
@@ -18,6 +18,24 @@
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%;
Added: incubator/tashi/site/xdocs/documentation-cluster.xml
URL: http://svn.apache.org/viewvc/incubator/tashi/site/xdocs/documentation-cluster.xml?rev=784196&view=auto
==============================================================================
--- incubator/tashi/site/xdocs/documentation-cluster.xml (added)
+++ incubator/tashi/site/xdocs/documentation-cluster.xml Fri Jun 12 17:05:51 2009
@@ -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="Setting up Tashi on a cluster">
+
+<p>
+UNDER CONSTRUCTION
+</p>
+
+</section>
+
+</body>
+</document>
Added: incubator/tashi/site/xdocs/documentation-options.xml
URL: http://svn.apache.org/viewvc/incubator/tashi/site/xdocs/documentation-options.xml?rev=784196&view=auto
==============================================================================
--- incubator/tashi/site/xdocs/documentation-options.xml (added)
+++ incubator/tashi/site/xdocs/documentation-options.xml Fri Jun 12 17:05:51 2009
@@ -0,0 +1,528 @@
+<?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="Configuration Options for Tashi">
+
+<p>
+<table class="options">
+<tr>
+<td>Option</td>
+<td>Default</td>
+<td>Description</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[ClusterManager]
+</center>
+</td>
+</tr>
+<tr>
+<td>service</td>
+<td>tashi.clustermanager.ClusteManagerService</td>
+<td>This specifies the class name of the cluster manager service</td>
+</tr>
+<tr>
+<td>data</td>
+<td>tashi.clustermanager.data.GetentOverride</td>
+<td>This specifies the class name for the data backend. Available options are: GetentOverride, LdapOverride, Pickled, FromConfig, and SQL (all in tashi.clustermanager.data)</td>
+</tr>
+<tr>
+<td>dfs</td>
+<td>tashi.dfs.Vfs</td>
+<td>This specifies the class name of the DFS implementation used at the cluster manager</td>
+</tr>
+<tr>
+<td>publisher</td>
+<td>tashi.messaging.GangliaPublisher</td>
+<td>This specifies the class name of the publisher used at the cluster manager</td>
+</tr>
+<tr>
+<td>nodeManagerPort</td>
+<td>9883</td>
+<td>This specifies what port number to try to connect to Node Managers on</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[ClusterManagerService]
+</center>
+</td>
+</tr>
+<tr>
+<td>convertExceptions</td>
+<td>True</td>
+<td>Whether exceptions raised in ClusterManagerService should be converted to generic exceptions and passed along to the client</td>
+</tr>
+<tr>
+<td>port</td>
+<td>9882</td>
+<td>What port to listen on for client requests</td>
+</tr>
+<tr>
+<td>expireHostTime</td>
+<td>30.0</td>
+<td>The amount of time (in seconds) to let pass before considering a host down if the cluster manager has not heard from it</td>
+</tr>
+<tr>
+<td>allowDecayed</td>
+<td>30.0</td>
+<td>The amount of time to let an instance or a host be decayed before attempting to sync</td>
+</tr>
+<tr>
+<td>allowMismatchedVersions</td>
+<td>False</td>
+<td>Whether to allow Node Managers that have difference software versions to join the cluster</td>
+</tr>
+<tr>
+<td>maxMemory</td>
+<td>7680</td>
+<td>The maximum amount of memory any user can request for a VM</td>
+</tr>
+<tr>
+<td>maxCores</td>
+<td>8</td>
+<td>The maximum number of cores any user can request for a VM</td>
+</tr>
+<tr>
+<td>allowDuplicateNames</td>
+<td>False</td>
+<td>Whether VMs are allowed to have duplicate names</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[GetentOverride]
+</center>
+</td>
+</tr>
+<tr>
+<td>baseData</td>
+<td>tashi.clustermanager.data.Pickled</td>
+<td>The backend data class to use for data not related to users</td>
+</tr>
+<tr>
+<td>fetchThreshold</td>
+<td>60.0</td>
+<td>The minimum amount of time to wait between calling "getent"</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[LdapOverride]
+</center>
+</td>
+</tr>
+<tr>
+<td>baseData</td>
+<td>tashi.clustermanager.data.Pickled</td>
+<td>The backend data class to use for data not related to users</td>
+</tr>
+<tr>
+<td>fetchThreshold</td>
+<td>3600.0</td>
+<td>The minimum amount of time to wait between issuing LDAP queries</td>
+</tr>
+<tr>
+<td>nameKey</td>
+<td>sAMAccountName</td>
+<td>The variable name that represents usernames in the LDAP results</td>
+</tr>
+<tr>
+<td>idKey</td>
+<td>msSFU30UidNumber</td>
+<td>The variable name that represents user ids in the LDAP results</td>
+</tr>
+<tr>
+<td>ldapCommand</td>
+<td>ldapsearch -x -w password -h host -b searchbase -D binddn msSFU30LoginShell=* -z 0</td>
+<td>The ldap command to run to perform lookups</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[FromConfig]
+</center>
+</td>
+</tr>
+<tr>
+<td>host<i>n</i></td>
+<td>Host(d={'id':1,'name':'blade043'})</td>
+<td>Specifies a host object to be created</td>
+</tr>
+<tr>
+<td>network<i>n</i></td>
+<td>Network(d={'id':1,'name':'global'})</td>
+<td>Specifies a network object to be created</td>
+</tr>
+<tr>
+<td>user<i>n</i></td>
+<td>User(d={'id':1,'name':'mryan3'})</td>
+<td>Specifies a user object to be created</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[Pickled]
+</center>
+</td>
+</tr>
+<tr>
+<td>file</td>
+<td>/var/tmp/cm.dat</td>
+<td>The file to use to store pickled data for the cluster manager</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[SQL]
+</center>
+</td>
+</tr>
+<tr>
+<td>uri</td>
+<td>mysql://root@localhost/tashi</td>
+<td>The URI that describes what SQL backend to use -- examples include sqlite://<i>filename</i> and mysql://<i>user</i>@<i>host</i>/<i>dbname</i></td>
+</tr>
+<tr>
+<td>password</td>
+<td>changeme</td>
+<td>The password to use when connecting to a MySQL database</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[NodeManager]
+</center>
+</td>
+</tr>
+<tr>
+<td>dfs</td>
+<td>tashi.dfs.Vfs</td>
+<td>This specifies the class name of the DFS implementation used at the node manager</td>
+</tr>
+<tr>
+<td>vmm</td>
+<td>tashi.nodemanager.vmcontrol.Qemu</td>
+<td>This specifies the class name of the VMM backend used at the node manager</td>
+</tr>
+<tr>
+<td>service</td>
+<td>tashi.nodemanager.NodeManagerService</td>
+<td>This specifies the class name of the node manager service</td>
+</tr>
+<tr>
+<td>publisher</td>
+<td>tashi.messaging.GangliaPublisher</td>
+<td>This specifies the class name of the publisher used at the node manager</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[NodeManagerService]
+</center>
+</td>
+</tr>
+<tr>
+<td>convertExceptions</td>
+<td>True</td>
+<td>Whether exceptions raised in NodeManagerService should be converted to generic exceptions and passed along to the client</td>
+</tr>
+<tr>
+<td>port</td>
+<td>9883</td>
+<td>What port to listen on for client requests</td>
+</tr>
+<tr>
+<td>registerFrequency</td>
+<td>10.0</td>
+<td>How many seconds should the node manager wait between registering with the cluster manager?</td>
+</tr>
+<tr>
+<td>infoFile</td>
+<td>/var/tmp/nm.dat</td>
+<td>Where the node manager places pickled run-time information for crash or restart recovery</td>
+</tr>
+<tr>
+<td>clusterManagerHost</td>
+<td>localhost</td>
+<td>What host to connect to in order to find the cluster manager</td>
+</tr>
+<tr>
+<td>clusterManagerPort</td>
+<td>9882</td>
+<td>What port to connect to the cluster manager on</td>
+</tr>
+<tr>
+<td>statsInterval</td>
+<td>0.0</td>
+<td>How often should the node manager output per-VM statistics using the publisher</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[Qemu]
+</center>
+</td>
+</tr>
+<tr>
+<td>qemuBin</td>
+<td>/usr/local/bin/qemu-system-x86_64</td>
+<td>The location of the Qemu/Kqemu/KVM binary to be used?</td>
+</tr>
+<tr>
+<td>infoDir</td>
+<td>/var/tmp/VmControlQemu/</td>
+<td>A location into which the Qemu backend places per-VM control infromation?</td>
+</tr>
+<tr>
+<td>pollDelay</td>
+<td>1.0</td>
+<td>How often to check and see if a VM has exited</td>
+</tr>
+<tr>
+<td>migrationRetries</td>
+<td>10</td>
+<td>How many retries are allowed on failed migrations</td>
+</tr>
+<tr>
+<td>monitorTimeout</td>
+<td>60.0</td>
+<td>How long to wait before timing out on monitor command execution</td>
+</tr>
+<tr>
+<td>migrateTimeout</td>
+<td>300.0</td>
+<td>How long to wait before timing out a live migration</td>
+</tr>
+<tr>
+<td>maxParallelMigrations</td>
+<td>10</td>
+<td>How many parallel live migrations are allowed</td>
+</tr>
+<tr>
+<td>useMigrateArgument</td>
+<td>False</td>
+<td>An option to allow the use of "migrate=True" as an argument to KVM -- requires a patch to KVM</td>
+</tr>
+<tr>
+<td>statsInterval</td>
+<td>0.0</td>
+<td>How often to collect per-VM statistics</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[XenPV]
+</center>
+</td>
+</tr>
+<tr>
+<td>vmNamePrefix</td>
+<td>tashi</td>
+<td>The name prefix to use when dealing with Xen domains?</td>
+</tr>
+<tr>
+<td>transientdir</td>
+<td>/tmp</td>
+<td>A place to put transient deltas of disk images</td>
+</tr>
+<tr>
+<td>defaultVmType</td>
+<td>kernel</td>
+<td>This specifies the type and kernel loading mechanism for the VM -- options are "pvgrub", "pygrub", "kernel", and "hvm"</td>
+</tr>
+<tr>
+<td>defaultKernel</td>
+<td>/boot/vmlinuz-xen</td>
+<td>If the VmType is "kernel", this is the kernel to load for use in the guest</td>
+</tr>
+<tr>
+<td>defaultRamdisk</td>
+<td>/boot/initrd-xen</td>
+<td>If the VmType is "kernel", this is the initrd to load for use in the guest</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[Vfs]
+</center>
+</td>
+</tr>
+<tr>
+<td>prefix</td>
+<td>/var/tmp/</td>
+<td>A location into which all DFS access is directed -- this is usually a mount point</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[LocalityService]
+</center>
+</td>
+</tr>
+<tr>
+<td>host</td>
+<td>localityserver</td>
+<td>The hostname clients use to find the locality server</td>
+</tr>
+<tr>
+<td>port</td>
+<td>9884</td>
+<td>The port to listen on for requests</td>
+</tr>
+<tr>
+<td>staticLayout</td>
+<td>/location/of/layout/file</td>
+<td>The location of a layout specification file</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[Client]
+</center>
+</td>
+</tr>
+<tr>
+<td>clusterManagerHost</td>
+<td>localhost</td>
+<td>The hostname to use to find the cluster manager</td>
+</tr>
+<tr>
+<td>clusterManagerPort</td>
+<td>9882</td>
+<td>The port to use when communicating with the cluster manager</td>
+</tr>
+<tr>
+<td>clusterManagerTimeout</td>
+<td>5.0</td>
+<td>The number of seconds to wait before assuming an operation has timed out</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[Primitive]
+</center>
+</td>
+</tr>
+<tr>
+<td>hook<i>n</i></td>
+<td>tashi.agents.DhcpDns</td>
+<td>This allows the specification of an ordered list of agent hooks that perform actions when VMs are started and stopped</td>
+</tr>
+<tr>
+<td>scheduleDelay</td>
+<td>2.0</td>
+<td>How long to delay between scheduling cycles</td>
+</tr>
+<tr>
+<td>densePack</td>
+<td>False</td>
+<td>Should VMs be densely packed across hosts</td>
+</tr>
+<tr>
+<td>publisher</td>
+<td>tashi.messaging.GangliaPublisher</td>
+<td>The publisher to use for the scheduling agent</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[DhcpDns]
+</center>
+</td>
+</tr>
+<tr>
+<td>dnsKeyFile</td>
+<td>/location/of/private/key/for/dns</td>
+<td>The location of the privake key file for DNS updates</td>
+</tr>
+<tr>
+<td>dnsServer</td>
+<td>1.2.3.4 53</td>
+<td>The server to connect to to perform DNS updates</td>
+</tr>
+<tr>
+<td>dnsDomain</td>
+<td>your.domain.com</td>
+<td>The domain in which VM hostnames are inserted</td>
+</tr>
+<tr>
+<td>dnsExpire</td>
+<td>31536000</td>
+<td>How long are entries cacheable</td>
+</tr>
+<tr>
+<td>dhcpServer</td>
+<td>1.2.3.4</td>
+<td>The server with to which DHCP updates are sent</td>
+</tr>
+<tr>
+<td>dhcpKeyName</td>
+<td>OMAPI</td>
+<td>The name of the DHCP key being used</td>
+</tr>
+<tr>
+<td>dhcpSecretKey</td>
+<td>ABcdEf12GhIJKLmnOpQrsT==</td>
+<td>The DHCP secret key</td>
+</tr>
+<tr>
+<td>ipRange<i>n</i></td>
+<td>172.16.128.2-172.16.255.254</td>
+<td>For network <i>n</i>, this specifies the IP range to be used for allocations</td>
+</tr>
+<tr>
+<td>reverseDns</td>
+<td>True</td>
+<td>Should reverse DNS entries be inserted and removed</td>
+</tr>
+<tr>
+<td colspan="3">
+<center>
+[GangliaPublisher]
+</center>
+</td>
+</tr>
+<tr>
+<td>dmax</td>
+<td>60</td>
+<td>The amount of time that published messages are held on to before discarding</td>
+</tr>
+<tr>
+<td>retry</td>
+<td>3600</td>
+<td>How often, in seconds, to retry executing gmetric to see if it has been installed</td>
+</tr>
+</table>
+</p>
+
+</section>
+
+</body>
+</document>
Added: incubator/tashi/site/xdocs/documentation-qemu.xml
URL: http://svn.apache.org/viewvc/incubator/tashi/site/xdocs/documentation-qemu.xml?rev=784196&view=auto
==============================================================================
--- incubator/tashi/site/xdocs/documentation-qemu.xml (added)
+++ incubator/tashi/site/xdocs/documentation-qemu.xml Fri Jun 12 17:05:51 2009
@@ -0,0 +1,66 @@
+<?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 Qemu backend of Tashi">
+
+<p>
+The Qemu backend allows the use of Qemu, Kqemu, and KVM as virtual machine managers. KVM is of particular interest since it utilizes Intel VT and AMD-V technologies, which greatly accelerate the performce of virtual machines.
+</p>
+<p>
+The vmmSpecificCall options for Qemu are listed below:
+<ul>
+<li>startVnc</li>
+This option starts a VNC server that exposes the guest and returns a host:port pair that a user can connect to
+<li>stopVnc</li>
+This stops the above mentioned VNC server
+<li>changeCdrom:<target></li>
+This replaces the virtual cdrom drive in a guest with another ISO
+<li>startConsole</li>
+This opens a TCP port that a user can telnet to to get direct access to the Qemu control console
+<li>list</li>
+This lists the options available on this particular version of the Qemu backend
+</ul>
+</p>
+<p>
+Additionally, the following hints are useful with the Qemu backend:
+<ul>
+<li>clock</li>
+This specifies the clock type to use for the VM -- options are "dynticks", "rtc", etc.
+<li>diskInterface</li>
+This specifies the disk interface to use for the VM -- options are "ide", "scsi", "virtio", etc.
+<li>nicModel</li>
+This specifies the NIC model to use on the VM -- options are "e1000", "rtl8139", "virtio", etc.
+<li>noAcpi</li>
+This is a boolean that specifies whether or not ACPI is emulated
+</ul>
+</p>
+
+</section>
+
+</body>
+</document>