changeset 130:32fd80375443

Moved Windows test to its own section.
author Martin Geisler <mg@daimi.au.dk>
date Wed, 16 Apr 2008 23:03:27 +0200
parents f778eb7dc98c
children 8d7ac214fb32
files install.txt
diffstat 1 files changed, 56 insertions(+), 44 deletions(-) [+]
line wrap: on
line diff
--- a/install.txt	Wed Apr 16 22:51:34 2008 +0200
+++ b/install.txt	Wed Apr 16 23:03:27 2008 +0200
@@ -58,55 +58,14 @@
 
 5) Download and install GMPY_.
 
-6) This should be enough to run VIFF with non-secured channels. To
-   verify the installation so far, try out one of the applications.
-   We will run the millionaires example with three players and a
-   threshold of one. For this test, we will let all players run on
-   localhost: Player 1 will run on port 9001, player 2 on port 9002,
-   and player 3 on port 9003.
-
-   a) Go to the ``viff/apps/`` directory and generate the the config
-      file for this setup by entering::
-
-	 python generate-config-files.py -n 3 -t 1
-         localhost:9001 localhost:9002 localhost:9003
-
-      Both lines should be entered as a single line.
-
-   b) Open three separate command prompts and go to the ``viff/apps/``
-      directory in each. In the first, type::
-
-	 python millionaires.py --no-tls player-3.ini
-
-      in the second, type::
-
-	 python millionaires.py --no-tls player-2.ini
-
-      and in the last, type::
-
-	 python millionaires.py --no-tls player-1.ini
-
-      Note that the order in wich you start the players is important:
-      The players must start in reverse order, e.g. the last player
-      first. If the installation works, you should see something like
-      this from e.g. player 3::
-
-	 C:\viff\apps> python millionaires.py --no-tls player-3.ini 
-	 Seeding random generator with random seed 7416
-	 Not using TLS
-	 I am Millionaire 3 and I am worth 20 millions.
-	 From poorest to richest:
-	   Millionaire 2
-	   Millionaire 3 (20 millions)
-	   Millionaire 1
-	 Initiating shutdown sequence.
-
-7) In order to secure the channels between the players using TLS, you
+6) In order to secure the channels between the players using TLS, you
    need to download and install python-gnutls_. However, we haven't
    had the time to test installation of this on Windows yet. Feel free
    to contribute with details about this by sending an email to the
    `VIFF mailing list`_.
 
+7) Proceed to `testing`_.
+
 
 Mac OS X
 --------
@@ -147,6 +106,8 @@
    (``viff/viff/``), as otherwise you need to re-install VIFF each time
    the project is modified.
 
+7) Proceed to `testing`_.
+
 
 GNU/Linux
 ---------
@@ -212,6 +173,56 @@
 environment variables are set.
 
 
+Testing
+-------
+
+To verify the installation, try out one of the applications. We will
+run the millionaires example with three players and a threshold of
+one. For this test, we will let all players run on localhost: Player 1
+will run on port 9001, player 2 on port 9002, and player 3 on port
+9003. The test is done on Windows, but it works the same on the other
+platforms. Do the following:
+
+1) Go to the ``viff/apps/`` directory and generate the needed
+   configuration files by entering::
+
+     python generate-config-files.py -n 3 -t 1
+     localhost:9001 localhost:9002 localhost:9003
+
+   Both lines should be entered as a single line.
+
+2) Open three separate command prompts and go to the ``viff/apps/``
+   directory in each. In the first, type::
+
+     python millionaires.py --no-tls player-3.ini
+
+   in the second, type::
+
+     python millionaires.py --no-tls player-2.ini
+
+   and in the last, type::
+
+     python millionaires.py --no-tls player-1.ini
+
+   Note that the order in wich you start the players is important: The
+   players must start in reverse order, e.g. the last player first. If
+   the installation works, you should see something like this from
+   e.g. player 3::
+
+      C:\viff\apps> python millionaires.py --no-tls player-3.ini 
+      Seeding random generator with random seed 7416
+      Not using TLS
+      I am Millionaire 3 and I am worth 20 millions.
+      From poorest to richest:
+        Millionaire 2
+        Millionaire 3 (20 millions)
+        Millionaire 1
+      Initiating shutdown sequence.
+
+   If something went wrong, then please `file a bug report`_ or report
+   it on the `VIFF mailing list`_. This will help us improve VIFF.
+
+
 .. _report back:
 .. _VIFF mailing list:
 .. _let us know: viff-devel@viff.dk
@@ -228,6 +239,7 @@
             #Downloading-and-Installing
 .. _package manager: `Using a Package Manager`_
 .. _from source: `Installing from Source`_
+.. _file a bug report: http://tracker.viff.dk/
 
 .. header:: `Return to the VIFF homepage <index.html>`__.
 .. include:: layout.rst