[llvm-commits] [zorg] r99116 - in /zorg/trunk/lnt: README.txt viewer/zorg.cfg.sample viewer/zorg.wsgi

[Daniel Dunbar]

Author: ddunbar
Date: Sun Mar 21 06:36:53 2010
New Revision: 99116

URL: http://llvm.org/viewvc/llvm-project?rev=99116&view=rev
Log:
LNT: Sketch basic installation steps.

Modified:
    zorg/trunk/lnt/README.txt
    zorg/trunk/lnt/viewer/zorg.cfg.sample
    zorg/trunk/lnt/viewer/zorg.wsgi

Modified: zorg/trunk/lnt/README.txt
URL: http://llvm.org/viewvc/llvm-project/zorg/trunk/lnt/README.txt?rev=99116&r1=99115&r2=99116&view=diff
==============================================================================
--- zorg/trunk/lnt/README.txt (original)
+++ zorg/trunk/lnt/README.txt Sun Mar 21 06:36:53 2010
@@ -14,7 +14,7 @@
  lnt/db - Database schema, utilities, and examples of the LNT plist format.
 
  lnt/import - Utilities for converting to the LNT plist format for test data,
-              and for submitting plist to the server.
+              and for submitting plists to the server.
 
  lnt/test - Tests for the infrastructure; they currently assume they are running
             on a system with a live instance available at
@@ -31,8 +31,30 @@
 
 Internal Dependencies: MooTools
 
-These are the steps to get a working LNT installation:
+These are the rough steps to get a working LNT installation:
 
- 1. Figure it out yourself, write installation instructions, add to README.txt.
+ 1. Install external dependencies. FIXME: Elaborate.
 
- 2. M-x revert-buffer, goto 1.
+ 2. Choose a data directory and create the initial SQLite or MySQL
+    databases. SQLite databases need to be writable by the Apache user, as does
+    the directory they are contained in.
+
+ 3. Copy viewer/zorg.cfg.sample to viewer/zorg.cfg, and modify for your
+    installation.
+
+    a. Update the databases list.
+
+    b. Update the zorgURL.
+
+    c. Update the nt_emailer configuration.
+
+ 4. Add the zorg.wsgi app to your Apache configuration. You should set also
+    configure the WSGIDaemonProcess and WSGIProcessGroup variables if not
+    already done.
+
+ 5. Add a link or copy of the zorg.cgi app in the appropriate place if you want
+    to use the CGI script. The WSGI app is significantly faster, but currently
+    can't handle submissions.
+
+ 6. Create a zorg/lnt/viewer/resources/graphs directory, which the app uses to
+    hold temporary files, and make sure it is writable by the Apache user.

Modified: zorg/trunk/lnt/viewer/zorg.cfg.sample
URL: http://llvm.org/viewvc/llvm-project/zorg/trunk/lnt/viewer/zorg.cfg.sample?rev=99116&r1=99115&r2=99116&view=diff
==============================================================================
--- zorg/trunk/lnt/viewer/zorg.cfg.sample (original)
+++ zorg/trunk/lnt/viewer/zorg.cfg.sample Sun Mar 21 06:36:53 2010
@@ -10,7 +10,8 @@
 # Path to the LNT server.
 zorgURL = "http://llvm.org/perf/"
 
-# The list of available databases, and their properties.
+# The list of available databases, and their properties. At a minimum, there
+# should be a 'default' entry for the default database.
 databases = {
     'default' : { 'path' : '../data/default.db',
                   'showNightlytest' : 1 },
@@ -30,14 +31,14 @@
 # the submitted results is matched against the regular expressions to determine
 # which email address to use for the results.
 nt_emailer = {
-    'enabled' : True,
+    'enabled' : False,
     'host' : "llvm.org",
     'from' : "lnt at llvm.org",
 
     # This is a list of (filter-regexp, address) pairs -- it is evaluated in
     # order based on the machine name. This can be used to dispatch different
     # reports to different email address.
-    'to' : [(".*", "llvm-testresults at cs.uiuc.edu")]),
+    'to' : [(".*", "llvm-testresults at cs.uiuc.edu")],
     }
 
 # Enable automatic restart using the wsgi_restart module; this should be off in

Modified: zorg/trunk/lnt/viewer/zorg.wsgi
URL: http://llvm.org/viewvc/llvm-project/zorg/trunk/lnt/viewer/zorg.wsgi?rev=99116&r1=99115&r2=99116&view=diff
==============================================================================
--- zorg/trunk/lnt/viewer/zorg.wsgi (original)
+++ zorg/trunk/lnt/viewer/zorg.wsgi Sun Mar 21 06:36:53 2010
@@ -11,7 +11,7 @@
     # We expect the config file to be adjacent to the absolute path of
     # the cgi script.
     configPath = os.path.join(os.path.dirname(os.path.realpath(__file__)),
-                          "zorg.cfg")
+                              "zorg.cfg")
     configData = {}
     exec open(configPath) in configData