[Summary view] [Print] [Text view]

   1  SYNTAX CMS INSTALLATION
   2  
   3  Dependencies:
   4  - Apache
   5      - mod_rewrite
   6  - PHP4 
   7      - Register Globals on *sigh*
   8      - PEAR::DB
   9      - PEAR::Cache
  10      - AdoDB
  11      - Smarty
  12  - MySQL
  13  
  14  
  15  1) Extract Syntax CMS distribution to your filesystem
  16  
  17  Assuming you have Apache configures and waiting for requests at your domain.
  18  The entire Syntax CMS distributable is not meant to be extracted to your public
  19  root.  Only the public directory should be exposed as your sites document root.
  20  
  21  NOTE: Your Apache configuration must at least allow you to override Options
  22  and FileInfo via htaccess files
  23  
  24  tar -xzvf SYNTAX.tar syntax
  25  
  26  *** If your webserver is set up to handle PHP correctly, you can open
  27  http://yoursite.com/admin/testing/ in a browser to view and verify critical
  28  Syntax CMS settings.
  29  
  30  
  31  2) Verify PEAR files are in your include_path
  32  
  33  Make sure that the PHP include path has the directory where the PEAR classes are
  34  located.
  35  
  36  If you need to, you can point php_include path to your PEAR installation by 
  37  Edit public/.htaccess and add the path to PEAR on your filesystem to the
  38  php_include path
  39  
  40  
  41  3) Verify smarty Symlink
  42  
  43  Syntax CMS expects a symbolic link named 'smarty' in
  44  private/lib/ext/PxDB/resources pointing at the libs folder of the Smarty
  45  distributable.  You will need to create it if necessary.
  46  
  47  cd /PATH/TO/YOUR/INSTALLATION/private/lib/ext/PxDB/resources
  48  ln -s Smarty-2.6.1/libs smarty
  49  
  50  
  51  4) Verify pxdb_www Symlink
  52  
  53  For certain form widgets, Syntax CMS expects a symlink from your public root to
  54  a subdirectory in the library. You will need to create it.
  55  
  56  cd /PATH/TO/YOUR/INSTALLATION/public
  57  ln -s /PATH/TO/YOUR/INSTALLATION/private/lib/ext/PxDB/pxdb_www pxdb_www
  58  
  59  
  60  5) Create Database and Database user
  61  
  62  In MySQL, create your database and execute the private/dump.sql script
  63  Create a user with access to just your database.  This user should have at least
  64  SELECT,INSERT,UPDATE,DELETE,CREATE,ALTER privileges.
  65  
  66  At the MySQL command line:
  67  
  68  create database <SYNTAXDB>
  69  grant select,insert,update,delete,create,alter on <SYNTAXDB>.* to
  70  <DBUSER>@localhost identified by '<DB_PASSWORD>';
  71  
  72  
  73  6) Database Settings
  74  
  75  Update private/config/db.conf.php to reflect the settings needed to connect to
  76  the MySQL server
  77  based on the user you created in step 3 above.
  78  
  79  
  80  7) Load Initial Data Dump
  81  
  82  Run the database script dump.sql into your database.  On MySQL it will be
  83  something like the following, assuming you are in the folder where the dump.sql
  84  file is.
  85  
  86  mysql -r mydbuser -p mydatabase < dump.sql
  87  
  88  
  89  8) File-system Permissions
  90  
  91  The user Apache runs as will need write access to the following directories:
  92   - private/tmp (and all directories beneath)
  93   - private/files (and all directories beneath)
  94   - private/lib/ext/PxDB/templates/templates_c
  95   
  96  The easiest way to do so is make your Apache user the owner of those
  97  directories:
  98  
  99  chown -R www-data private/tmp
 100  
 101  On Redhat distributions this user is named 'apache', Debian uses 'www-data'.
 102  
 103  
 104  9) Update preference keys, admin password
 105  
 106  The DBasis tool should now be working on your site test by going to:
 107  
 108  http://yoursite.com/admin/dbasis/
 109  
 110  Login as admin/secret.
 111  
 112  In the data tab, select "person" as current datatype.  Edit the admin user and
 113  change the password to something only you will know.
 114  
 115  In the preferences tab, update the datastore.path value with the full path of
 116  your private/files directory.
 117  
 118  
 119  10) Test your installation
 120  
 121  To test your installation and guard against common problems, go to:
 122  
 123  http://yoursite.com/admin/testing/
 124  
 125  The tests will look for the most common problems and flag issues of permissions
 126  or database access, as well as give you hints on how to fix them.
 127  
 128  You should have a working Syntax CMS installation.
 129  
 130  
 131  
 132  VERSION HISTORY
 133  --------------
 134  June 11, 2004: Oscar Merida, Initial Release
 135  
 136  June 14, 2004: Moved INSTALL & dump.sql to root, added instructions to perform
 137  db dump, added comments to db config file, updated dump.sql .
 138  
 139  September 13, 2004: Additional clarification for PEAR path, smarty symlink,
 140  database dump.
 141  
 142  November 18, 2004: Added note regarding new installation testing in
 143  public/admin/testing
 144  
 145  December 8, 2004: Added additional step including the new installation testing,
 146  as well as missing step of pxdb_www symlink, and some formatting.