[Mapbender-commits] r3062 - in branches/spsneo_dev: build mapbender/update

Tue Sep 30 12:10:02 EDT 2008

Author: spsneo
Date: 2008-09-30 12:10:02 -0400 (Tue, 30 Sep 2008)
New Revision: 3062

Removed:
   branches/spsneo_dev/mapbender/update/README.txt
Modified:
   branches/spsneo_dev/build/build-checksum.php
Log:
Just updating

Modified: branches/spsneo_dev/build/build-checksum.php
===================================================================

--- branches/spsneo_dev/build/build-checksum.php	2008-09-30 14:42:25 UTC (rev 3061)
+++ branches/spsneo_dev/build/build-checksum.php	2008-09-30 16:10:02 UTC (rev 3062)
@@ -3,6 +3,8 @@
 #build-checksum.php 
 #@author Siddharth Prakash Singh (spsneo)
 #Google SoC 2008 Project
+# Copyright (C) 2002 CCGIS 
+#
 # This program is free software; you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
 # the Free Software Foundation; either version 2, or (at your option)
@@ -16,19 +18,21 @@
 # You should have received a copy of the GNU General Public License
 # along with this program; if not, write to the Free Software
 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+
 #
 # Update Script
-# To be executed from command line only.
+# To be executed from command line only for security reasons.
 
 
-#A constant for the path to the mapbender installation folder
+#A constant for the path to the mapbender installation folder. This constant is 
+#to be edited before executing this script.
 define("ROOTDIR", "../../2.5/");
 
 #check whether this file is being executed from command line or not
-#abort if it is not being executed from command line
+#abort if it is not being executed from command line. 
 require_once("commandLine.inc");
 
-#This file is required 
+#This file is required. Few functions are defined here. 
 require_once("checksum-utils.inc");
 
 #These are the directories which are not to be scanned and checksum not to be evaluated as these 

Deleted: branches/spsneo_dev/mapbender/update/README.txt
===================================================================
--- branches/spsneo_dev/mapbender/update/README.txt	2008-09-30 14:42:25 UTC (rev 3061)
+++ branches/spsneo_dev/mapbender/update/README.txt	2008-09-30 16:10:02 UTC (rev 3062)
@@ -1,60 +0,0 @@
---------------------------------------------------------------
-Mapbender Updater
---------------------------------------------------------------
-
-Database update script is now ready.
----------------------------------------------------------
-Build Process:
----------------------------------------------------------
->>There are three constants defined in the file update-utils.inc :
-1) MIN_PHP_VERSION : This constant defines the minimum version of PHP required on user's system.
-2) MIN_MYSQL_VERSION : As above for MySQL server
-3) MIN_PGSQL_VERSION : As above for PostgreSQL server
-
-During the process it is required to fill in the constants.
-
->> Database is updated by SQL files. These SQL files are to be located in db folder according to following rule:
-SQL update file for mysql server and utf8 encoding should be placed in the folder db/mysql/UTF-8
-similarly SQL update file for postgresql server and utf8 encoding should be placed in db/pgsql/UTF-8 directory.
-
-In general the sql files should be placed in db/SYS_DBTYPE/CHARSET  where SYS_DBTYPE is the database type as defined in mapbender.conf and CHARSET is the file encoding as defined in mapbender.conf file.
-
-SQL update files should have extension .sql
-
-Inline comments in SQL files are not supported as of now. Example of an inline comment is:
-INSERT into <tblname> VALUES (...., ......... ) ; 			/* Inline comment */
-
-Other comments : single line comment starting with two hyphens (--) and multi line comments (/*..............*/) are allowed.
-
-Inline comments are not present in SQL dump files. 
-
-
------------------------------------------------------------
-Usage:
------------------------------------------------------------
-The update script can only be executed from command line. For security reasons execution of script from browser has been restricted.
-In a linux system the script can be executed (php-cli package should be installed) as follows:
-$ php /path/to/update.php
-
------------------------------------------------------------
-Features of the update script:
------------------------------------------------------------
-It checks whether it is being executed from browser or command line. If it is being executed form browser, execution is aborted. (Try running it from the browser)
-
-It checks the minimum required version for PHP and database server MySQL or PostgreSQL according the database type defined by user in mapbender.conf file
-
-It automatically locates the correct files for updating according to the user preferences SYS_DBTYPE and CHARSET defined in mapbender.conf file.
-It can update from any number of sql files. Say for example, there are two updates available. And these two updates are contributed by different devs in different sql files. Then there is no need to merge these two files into a single one. Just place both the sql files in the correct directory (as mentioned above) and the update script will take care of rest.
-
-
-
-
------------------------------------------------------------
-Constraints of the update script 
------------------------------------------------------------
-
-At present the script does not check the version being updated. This feature will soon be implemented. I have already prepared the framework for this, need to discuss few things with Christoph Baudson and will then implement this feature.
-
-Inline comments are not supported in sql files, as mentioned above. Butr its not a big issue as sql dumps do not have inline comments and if sql files are written by devs then it can be taken care of.
-
-

