LOGICREATE INSTALL PROCEDURE


1. Unpacking

Copy the .tar.gz file to the directory above the web server's "document root" 
directory. For example, if the document root of the web server is 
/var/www/html, copy the .tar file to /var/www 

Next, run the commands:

tar -zxvf logicreate.tar.gz

The contents of the file are two directories - 
logicreate/ and public_html/. The contents of the 'public_html' folder 
will need to be copied to the installation's document root.  
Here is an example of a directory layout for a user hosted on a machine:
/
	home/
		user1/
			logicreate/
			public_html/
			logicreate.tar.gz

2.  Run the installer

WINDOWS:  If you are installing on a Windows PC, you MUST have PHP setup
as an apache module and not CGI.  LogiCreate will not work with
Windows under CGI mode.

LINUX:  If you are installing on a Linux PC (RH 8), you will need
to run apache 1.3.x.  Apache 2.0 is not supported and is not
considered stable with PHP at this time.

Step 1: 

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.  

Example:  chmod 777 public_html

Step 2:

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.

Example:  http://dev.foo.com/install.php OR http://dev.foo.com/public_html/install.php 


Step 3:  

Follow the steps in the installer.

3. Adjust file permissions (Linux only)

Allowing multiple users to run PHP scripts on any server is inherently 
insecure.  Adjusting the LogiCreate file permissions is just one step in 
keeping a secure server.  Here are recommended permissions for files.

LogiCreateBase/						770 user.webserver
		logicreate/				770 user.webserver
				services/ 		660 user.webserver
				lib/			660 user.webserver
				content/			770 user.webserver
				lcFiles/			770 user.webserver
		public_html/				660 user.webserver
				index.php
				templates/		550 user.webserver
				images/			470 user.webserver
					photos/			470 user.webserver
						thumbs/ 	470 user.webserver

				herc/			440 user.webserver

Note: Adjusting the file permissions like so may not allow you to delete 
modules from the HCC.

4. Setting up the Control Center

The Hercules Control Center requires you to define a username and password.  By 
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:

define(HERC_USER,'');
define(HERC_PASSWD,'');
//set to 1 to use md5 passwords
define(PASSWD_IS_MD5,0);

If you wanted Herc and HHH as your Control Center login you would edit the file 
like so:

define(HERC_USER,'Herc');
define(HERC_PASSWD,'HHH');
//set to 1 to use md5 passwords
define(PASSWD_IS_MD5,0);

Being that this file must be readable by the webserver, any other system user 
that can program the webserver (via php, perl, or similar scripts) can open 
the document and read it.  To bypass plain text passwords the option 
PASSWD_IS_MD5 has been added.  To hash your chosen password, type this command 
at a Unix command line:

echo 'HHH' | md5sum

The output should paste nicely into the auth.php file.  An md5 sum cannot be 
used as a valid login, it is only a means of protecting the original password.  
Here is a sample auth.php with has the user Herc and the password HHH but uses 
md5 hash protection:

define(HERC_USER,'Herc');
define(HERC_PASSWD,'62f3c4ba6cfdc13a43b6fd2a68b39f5e');
//set to 1 to use md5 passwords
define(PASSWD_IS_MD5,1);

Note: On some systems, the command line tool md5sum and php's md5() function 
are incompatible, in such instances writing a small php script to echo the md5 
instead of using the command line should work.


5.  Documentation

You will find additional documentation in the public_html/docs/ directory as follows.  All documentation is in HTML.  

	# Developer Documentation

	dev/ 	
		lcmanual.html 	# Main Developer Doc
		template_manual.html	# Setting up Templates in LogiCreate	


	# Hercules Control Center documentation

	herc/	
		all-chapters.html 			# Main Document
		/images				# Images
		#  Individual Sections
		filemanagement.html
		modules.html
		users.html
		banners.html
		forum.html
		intro.html
		news.html
		visualeditor.html
		cat.html
		groups.html
		login.html
		photos.html
		welcome.html
		faq.html
		html.html
		menu.html
		search.html


---------------------------
NOTE:
If this is a demo install, the 'shopping cart' module is not available in this demo.  
---------------------------