short doc/INSTALL text added and var/conf.php reformatted

livesupport/modules/storageServer/var/GreenBox.php

@@ -23,7 +23,7 @@
  
  
     Author   : $Author: tomas $
-    Version  : $Revision: 1.4 $
+    Version  : $Revision: 1.5 $
     Location : $Source: /home/paul/cvs2svn-livesupport/newcvsrepo/livesupport/modules/storageServer/var/GreenBox.php,v $
 
 ------------------------------------------------------------------------------*/
@@ -48,7 +48,7 @@ require_once "Transport.php";
  *  LiveSupport file storage module
  *
  *  @author  $Author: tomas $
- *  @version $Revision: 1.4 $
+ *  @version $Revision: 1.5 $
  *  @see Alib
  */
 class GreenBox extends Alib{
@@ -479,9 +479,6 @@ class GreenBox extends Alib{
         $res4 = $tr->getTransportStatus($res2);
 #        return $res;
         return array($res, $res2, $res3, $res4);
-#        return PEAR::raiseError(
-#            'GreenBox::uploadFile: not implemented', GBERR_NOTIMPL
-#        );
     }
 
     /**
@@ -507,9 +504,6 @@ class GreenBox extends Alib{
         $res4 = $tr->getTransportStatus($res2);
 #        return $res;
         return array($res, $res2, $res3, $res4);
-#        return PEAR::raiseError(
-#            'GreenBox::downloadFile: not implemented', GBERR_NOTIMPL
-#        );
     }
     
 

livesupport/modules/storageServer/var/conf.php

@@ -23,23 +23,60 @@
  
  
     Author   : $Author: tomas $
-    Version  : $Revision: 1.3 $
+    Version  : $Revision: 1.4 $
     Location : $Source: /home/paul/cvs2svn-livesupport/newcvsrepo/livesupport/modules/storageServer/var/conf.php,v $
 
 ------------------------------------------------------------------------------*/
+
+/**
+ *  configuration structure:
+ *  <dl>
+ *   <dt>dsn<dd> datasource setting
+ *   <dt>tblNamePrefix <dd>prefix for table names in the database
+ *   <dt>authCookieName <dd>secret token cookie name
+ *   <dt>storageDir <dd>main directory for storing binary media files
+ *   <dt>bufferDir <dd>directory for temporary files
+ *   <dt>transDir <dd>directory for incomplete transferred files
+ *   <dt>accessDir <dd>directory for symlinks to accessed files
+ *   <dt>storageUrlPath<dd>path-URL-part of storageServer base dir
+ *   <dt>storageXMLRPC<dd>XMLRPC server script address relative to storageUrlPath
+ *   <dt>storageUrlHost, storageUrlPort<dd>host and port of storageServer
+ *   <dt>archiveUrlPath<dd>path-URL-part of archiveServer base dir
+ *   <dt>archiveXMLRPC<dd>XMLRPC server script address relative to archiveUrlPath
+ *   <dt>archiveUrlHost, archiveUrlPort<dd>host and port of archiveServer
+ *  </dl>
+ */
 $config = array(
+    /* ================================================== basic configuration */
     'dsn'           => array(
         'username'      => 'test',
         'password'      => 'test',
         'hostspec'      => 'localhost',
-#        'hostspec'     => '127.0.0.1',         // for bad resolver
         'phptype'       => 'pgsql',
         'database'      => 'LiveSupport-test',
     ),
     'tblNamePrefix' => 'ls_',
     'authCookieName'=> 'lssid',
-    'RootNode'	    => 'RootNode',
+    'storageDir'    =>  dirname(getcwd()).'/stor',
-    'tmpRootPass'   => 'q',
+    'bufferDir'     =>  dirname(getcwd()).'/stor/buffer',
+    'transDir'      =>  dirname(getcwd()).'/trans',
+    'accessDir'     =>  dirname(getcwd()).'/access',
+
+    /* ==================================================== URL configuration */
+    'storageUrlPath'        => '/livesupport/modules/storageServer/var',
+    'storageXMLRPC'         => 'xmlrpc/xrLocStor.php',
+    'storageUrlHost'        => 'localhost',
+    'storageUrlPort'        => 80,
+
+    /* ================================================ archive configuration */
+    'archiveUrlPath'        => '/livesupport/modules/archiveServer/var',
+    'archiveXMLRPC'         => 'xmlrpc/xrArchive.php',
+    'archiveUrlHost'        => 'localhost',
+    'archiveUrlPort'        => 80,
+    'archiveAccountLogin'   => 'root',
+    'archiveAccountPass'    => 'q',
+
+    /* ==================================== aplication-specific configuration */
     'objtypes'      => array(
         'RootNode'      => array('Folder'),
         'Storage'       => array('Folder', 'File', 'Replica'),
@@ -57,22 +94,9 @@ $config = array(
     'allActions'    =>  array(
         'editPrivs', 'write', 'read', 'classes', 'subjects'
     ),
-    'storageDir'    =>  dirname(getcwd()).'/stor',
-    'bufferDir'     =>  dirname(getcwd()).'/stor/buffer',
-    'transDir'      =>  dirname(getcwd()).'/trans',
-    'accessDir'     =>  dirname(getcwd()).'/access',
-
-    'storageUrlPath'        => '/livesupport/modules/storageServer/var',
-    'storageXMLRPC'         => 'xmlrpc/xrLocStor.php',
-    'storageUrlHost'        => 'localhost',
-    'storageUrlPort'        => 80,
-
-    'archiveUrlPath'        => '/livesupport/modules/archiveServer/var',
-    'archiveXMLRPC'         => 'xmlrpc/xrArchive.php',
-    'archiveUrlHost'        => 'localhost',
-    'archiveUrlPort'        => 80,
-    'archiveAccountLogin'   => 'root',
-    'archiveAccountPass'    => 'q',
 
+    /* ============================================== auxiliary configuration */
+    'RootNode'	    => 'RootNode',
+    'tmpRootPass'   => 'q',
 );
 ?>

livesupport/modules/storageServer/var/install/getGname.php

@@ -1,6 +1,6 @@
 <?
  header("Content-type: text/plain");
- $gid  = posix_getgid();
+# $gid  = posix_getgid();
  $egid = posix_getegid();
  $info = posix_getgrgid($egid);
  echo $info['name'];