Copyright BRAEWORKS (R) 2013

BRAEWORKS LINKS MANAGER INSTALLATION NOTES
==========================================

Prerequisites:

*	Apache Web Server 2.2.x installed on LINUX or MS Windows.
	(other PHP compatible web servers should be suitable)
*	PHP 5.3 with PHP SQLite installed,
	or PHP 5.4 with php-pecl-sqlite installed.
*	Links Manager can be setup as an adjunct to an existing web site, or as a new web site. If a
	new web site, the apache web server configuration needs to be setup for the new web site.
*	An SSL certificate, self signed or registered for SSL/https web site encryption.
*	http (port 80) for default home/links page and https (port 443) for login and user designated pages.
*	Links Manager is not designed to operate inside a frame or iframe.

Installation:

1.	If updating the web site, backup the web site.

2.	Download Links Manager from "http://www.braeworks.org/download/LM/Links_Manager-latest.zip" to a folder
	in your web sites directory.

3.	Execute the following in your web sites directory;-
		unzip -u -o "Links_Manager-latest.zip"
			(-u = update, -o = overwrite)
	This will unzip the updates to Links Manager file structure into the containing directory.
	If you wish to restore Links Manager to it's default file structure contents, execute;
		unzip -o "Links_Manager-latest.zip"
		NOTE: This does not change existing settings. Run Rebuild Setup, see below.

4.	Pointer your browser at	"http://your.web.site/site_alias/index.php" (site_alias/ is part of your server setup, usually empty).
	Note that the CMS will also work in an aliased folder.
	When the Links Manager is first accessed, will create an empty SQLite database.

5.	When no users are setup, a default admin user is;-
	Username: admin
	Paswword: password
	Suggest you disable the admin username after you have setup another, more secure, user (with admin rights).

6.	Recommended VirtualHost server configuration for Links Manager;-
	* SSLStrictSNIVHostCheck off (on https VirtualHost),
	* AccessFileName .htaccess (on both http and https VirtualHosts)

7.	Suggest checking out the "Config" page first.
	Enter/change the default settings to more appropiate values.
	The "Install" page contains installation settings. When updating, goto "Install" (/index.php?action=edit_install) and save to update new values.
	The "Theme" page contains theme values. When updating, goto "Theme" (/index.php?action=edit_theme) and save to update new values.
	The hard coded installation constants are contained in the "includes/configure.php" file. It is recommended
	that this file is made read only.

8.	After updating a site, is is highly recommended that you login as an administrator, the site version number checking will run the Rebuild Setup functionality automatically (will take upto a 1 minute to respond while the checking is completed).
	If you need to run the Rebuild Setup manually, goto "http://your.web.site/site_alias/index.php?action=rebuild_setup" as an administrator.

9.	Enjoy.

IMPORTANT NOTE:
If after an update the web site is non functional, there is a recovery command available to help fix this.
On a LINUX host, in a console shell, goto the web site's cli/ directory and run "./rebuild.sh".
On a Windows host, in a command shell, goto the web site's root folder and run "cli/rebuild.cmd".

Enjoy.