[Summary view] [Print] [Text view]

   1  LOGICREATE INSTALL PROCEDURE
   2  
   3  
   4  1. Unpacking
   5  
   6  Copy the .tar.gz file to the directory above the web server's "document root" 
   7  directory. For example, if the document root of the web server is 
   8  /var/www/html, copy the .tar file to /var/www 
   9  
  10  Next, run the commands:
  11  
  12  tar -zxvf logicreate.tar.gz
  13  
  14  The contents of the file are two directories - 
  15  logicreate/ and public_html/. The contents of the 'public_html' folder 
  16  will need to be copied to the installation's document root.  
  17  Here is an example of a directory layout for a user hosted on a machine:
  18  /
  19      home/
  20          user1/
  21              logicreate/
  22              public_html/
  23              logicreate.tar.gz
  24  
  25  2.  Run the installer
  26  
  27  WINDOWS:  If you are installing on a Windows PC, you MUST have PHP setup
  28  as an apache module and not CGI.  LogiCreate will not work with
  29  Windows under CGI mode.
  30  
  31  LINUX:  If you are installing on a Linux PC (RH 8), you will need
  32  to run apache 1.3.x.  Apache 2.0 is not supported and is not
  33  considered stable with PHP at this time.
  34  
  35  Step 0 (optional):
  36  
  37  There is a script called perms.sh that you can run to set up initial and, 
  38  possibly, insecure permissions. This script is only recommended for testing
  39  purposes. 
  40  
  41  Step 1: 
  42  
  43  For install purposes only, make sure your public_html directory is writable by the web server or by the user which your php scripts run as.   
  44  
  45  Example:  chmod 777 public_html
  46  
  47  Step 2:
  48  
  49  Open up your browser and run "install.php" (based on your document root) which will launch the LogiCreate installer.  Make sure that the public_html directory is your document_root directory or rename public_html to your document root directory.
  50  
  51  Example:  http://dev.foo.com/install.php OR http://dev.foo.com/public_html/install.php 
  52  
  53  
  54  Step 3:  
  55  
  56  Follow the steps in the installer.
  57  
  58  3. Adjust file permissions (Linux only)
  59  
  60  Allowing multiple users to run PHP scripts on any server is inherently 
  61  insecure.  Adjusting the LogiCreate file permissions is just one step in 
  62  keeping a secure server.  Here are recommended permissions for files.
  63  
  64  LogiCreateBase/                        770 user.webserver
  65          logicreate/                770 user.webserver
  66                  services/         660 user.webserver
  67                  lib/            660 user.webserver
  68                  content/            770 user.webserver
  69                  lcFiles/            770 user.webserver
  70          public_html/                660 user.webserver
  71                  index.php
  72                  templates/        550 user.webserver
  73                  images/            470 user.webserver
  74                      photos/            470 user.webserver
  75                          thumbs/     470 user.webserver
  76  
  77                  herc/            440 user.webserver
  78  
  79  Note: Adjusting the file permissions like so may not allow you to delete 
  80  modules from the HCC.
  81  
  82  4. Setting up the Control Center
  83  
  84  The Hercules Control Center requires you to define a username and password.  By 
  85  default it will not allow any access until the file public_html/herc/auth.php has been edited properly.  Open public_html/herc/auth.php in a text editor and you will see these lines:
  86  
  87  define(HERC_USER,'');
  88  define(HERC_PASSWD,'');
  89  //set to 1 to use md5 passwords
  90  define(PASSWD_IS_MD5,0);
  91  
  92  If you wanted Herc and HHH as your Control Center login you would edit the file 
  93  like so:
  94  
  95  define(HERC_USER,'Herc');
  96  define(HERC_PASSWD,'HHH');
  97  //set to 1 to use md5 passwords
  98  define(PASSWD_IS_MD5,0);
  99  
 100  Being that this file must be readable by the webserver, any other system user 
 101  that can program the webserver (via php, perl, or similar scripts) can open 
 102  the document and read it.  To bypass plain text passwords the option 
 103  PASSWD_IS_MD5 has been added.  To hash your chosen password, type this command 
 104  at a Unix command line:
 105  
 106  echo 'HHH' | md5sum
 107  
 108  The output should paste nicely into the auth.php file.  An md5 sum cannot be 
 109  used as a valid login, it is only a means of protecting the original password.  
 110  Here is a sample auth.php with has the user Herc and the password HHH but uses 
 111  md5 hash protection:
 112  
 113  define(HERC_USER,'Herc');
 114  define(HERC_PASSWD,'62f3c4ba6cfdc13a43b6fd2a68b39f5e');
 115  //set to 1 to use md5 passwords
 116  define(PASSWD_IS_MD5,1);
 117  
 118  Note: On some systems, the command line tool md5sum and php's md5() function 
 119  are incompatible, in such instances writing a small php script to echo the md5 
 120  instead of using the command line should work.
 121  
 122  
 123  5.  Documentation
 124  
 125  You will find additional documentation in the public_html/docs/ directory as follows.  All documentation is in HTML.  
 126  
 127      # Developer Documentation
 128  
 129      dev/     
 130          lcmanual.html     # Main Developer Doc
 131          template_manual.html    # Setting up Templates in LogiCreate    
 132  
 133  
 134      # Hercules Control Center documentation
 135  
 136      herc/    
 137          all-chapters.html             # Main Document
 138          /images                # Images
 139          #  Individual Sections
 140          filemanagement.html
 141          modules.html
 142          users.html
 143          banners.html
 144          forum.html
 145          intro.html
 146          news.html
 147          visualeditor.html
 148          cat.html
 149          groups.html
 150          login.html
 151          photos.html
 152          welcome.html
 153          faq.html
 154          html.html
 155          menu.html
 156          search.html
 157  
 158  
 159  ---------------------------
 160  NOTE:
 161  If this is a demo install, the 'shopping cart' module is not available in this demo.  
 162  ---------------------------