Skip to content
Browse files

Improve LANTorrent docs, and sync HTML and README

  • Loading branch information...
1 parent d06d070 commit aa6a4177f642fea356190093324ef21dcc2854c2 @priteau priteau committed Oct 30, 2010
Showing with 33 additions and 25 deletions.
  1. +15 −9 docs/src/admin/reference.html
  2. +18 −16 lantorrent/README.txt
View
24 docs/src/admin/reference.html
@@ -2105,13 +2105,17 @@
additional steps are required to enable it.
</p>
<p>
-The following software is required on VMM nodes:
+The following software is required on both service and VMM nodes:
<ol>
- <li>xinetd</li>
<li>python2.4</li>
<li>python simplejson</li>
</ol>
</p>
+
+<p>
+Lantorrent is run out of xinetd thus it must also be installed on all VMMs.
+</p>
+
<p>
To install LANTorrent you must take the following steps:
@@ -2122,11 +2126,9 @@
<li>edit $NIMBUS_HOME/services/etc/nimbus/workspace-service/other/common.conf</li>
change the value of propagate.extraargs:
propagate.extraargs=$NIMBUS_HOME/lantorrent/bin/lt-request
+ <br />
be sure to expand $NIMBUS_HOME to its full and actual path.
-<li>xinetd</li>
- LANTorrent is run out of xinetd thus it must be installed on all VMMs.
-
<li>install lantorrent on VMM</li>
<ul>
<li>recursively copy $NIMBUS_HOME/lantorrent to /opt/nimbus/lantorrent.</li>
@@ -2136,7 +2138,7 @@
</ul>
<li>install LANTorrent into xinetd</li>
- the vmm-install,sh script creates the file lantorrent.inet. This
+ the vmm-install.sh script creates the file lantorrent. This
file is ready to be copied into /etc/xinetd.d/. Once this is done
restart xinetd (/etc/init.d/xinetd restart).
@@ -2146,18 +2148,24 @@
$NIMBUS_HOME/services/etc/nimbus/workspace-service/other/authz-callout-ACTIVE.xml
and change:
+ <ul>
<li><tt class="literal">
&lt;property name="repoScheme" value="scp" /&gt;
</tt></li>
to:
<li><tt class="literal">
&lt;property name="repoScheme" value="lantorrent" /&gt;
</tt></li>
+ </ul>
+
+<li>restart the service:</li>
+$NIMBUS_HOME/bin/nimbusctl restart
<li>[optional] if the path to nimbus on the workspace control nodes (VMMs)
is not /opt/nimbus you will also need to edit a configuration file on
all backends.</li>
+ <ul>
In the file:
<li><tt class="literal">
&lt;workspace control path&gt;/control/etc/workspace-control/propagation.conf
@@ -2172,9 +2180,7 @@
points to the proper location of you ltclinet.sh script. This should
be a simple matter of changing /opt/nimbus to the path where you chose
to install workspace control.
-
-
-
+ </ul>
<div class="note">
<p class="note-title">cumulus.ini in Nimbus</p>
View
34 lantorrent/README.txt
@@ -49,36 +49,36 @@ endpoint to write it to multiple files if needed.
Enabling Lantorrent in Nimbus
-----------------------------
-Lan torrent is part of the nimbus distribution as of Nimbus 2.XXX.
-However, due to system administrative overhead it is not enabled by
-default. To enable Lantorrent in nimbus there are a few configurations
+Lan torrent is part of the Nimbus distribution as of Nimbus 2.6.
+However, due to system administrative overhead it is not enabled by
+default. To enable Lantorrent in Nimbus there are a few configurations
changes that must be made.
-1) install Lantorrent dependencies
- - Lantorrent is run out of xinetd thus it must be installed on all VMMs.
- - Lantorrent depends on the Python simplejson module, and must be installed
- on both the service node and the VMMs:
- - on Debian, package python-simplejson
+The following software is required on both service and VMM nodes:
+ - python 2.4
+ - python simplejson
-2) edit $NIMBUS_HOME/nimbus-setup.conf
+Lantorrent is run out of xinetd thus it must also be installed on all VMMs.
+
+To install LANTorrent you must take the following steps:
+
+1) edit $NIMBUS_HOME/nimbus-setup.conf
change lantorrent.enabled: False -> lantorrent.enabled: True
-3) edit $NIMBUS_HOME/services/etc/nimbus/workspace-service/other/common.conf
+2) edit $NIMBUS_HOME/services/etc/nimbus/workspace-service/other/common.conf
change the value of propagate.extraargs:
propagate.extraargs=$NIMBUS_HOME/lantorrent/bin/lt-request
be sure to expand $NIMBUS_HOME to its full and actual path.
-3.1) restart the service: $NIMBUS_HOME/bin/nimbusctl restart
-
-4) install lantorrent on VMM
+3) install lantorrent on VMM
- recursively copy $NIMBUS_HOME/lantorrent to /opt/nimbus/lantorrent.
- run ./vmm-install.sh on each node
either run it as your workspace control user or specify the workspace
control user as the first and only argument to the script.
-4.1) install lantorrent into xinetd
- - the vmm-install,sh script creates the file lantorrent. This
+4) install lantorrent into xinetd
+ - the vmm-install.sh script creates the file lantorrent. This
file is ready to be copied into /etc/xinetd.d/. Once this is done
restart xinetd (/etc/init.d/xinetd restart).
@@ -91,7 +91,9 @@ changes that must be made.
to:
<property name="repoScheme" value="lantorrent" />
-6) [optional] if the path to nimbus on the workspace control nodes (VMMs)
+6) restart the service: $NIMBUS_HOME/bin/nimbusctl restart
+
+7) [optional] if the path to Nimbus on the workspace control nodes (VMMs)
is not /opt/nimbus you will also need to edit a configuration file on
all backends.

0 comments on commit aa6a417

Please sign in to comment.
Something went wrong with that request. Please try again.