iWare Professional 5.0.x

Installation Guide

System Requirements

iWare was built and tested on multiple platforms to ensure as much interoperability as possible.We recommend meeting the following system requirements at a minimum.

Windows Platform
Microsoft Internet Information Server (IIS) 5.0 +
PHP Version 4.3.1 +
MySQL Version 3.23.54 +
GDLib Support under PHP (optional)

UNIX / Linux Platform (recommended configuration)
Apache Web server
PHP Version 4.3.0 +
MySQL Version 3.23.54 +
GDLib Support under PHP (optional)

Recommended PHP Configuration

As of iWare Version 5.0.0 the coding standard has changed for the recommended setting of "register_globals" in your php.ini be set to "off".
"magic_quotes" set to enabled in your php.ini is also strongly recommended to protect SQL queries.

Unzipping the install package

Once you have downloaded the installation .zip file extract its contents to a directory beneath your web servers web tree. If you are on a Windows system you can use Winzip, if your using UNIX / Linux you can use zip & unzip, gzip, etc. If necessary, FTP the entire unzipped structure to your web hosting provider.

Setting necessary file & directory permissions

BEFORE running the included installation script you must change the directory permission settings for both the admin and files directories of your installation to read,write,execute to allow the install utility to write the needed config files. Under UNIX / Linux you can accomplish this with the chmod command:Example : chmod 777 admin

Using the install script

iWare includes a browser based installation tool that will automatically create the necessary database backend and write the needed configuration files for your installation. To access and use this utility simply visit the URL of where your software is installed. The admin/install/ directory of your installation contains the installation script:Example : http://www.yourwebsite.com/admin/install/You will then be presented with a simple form allowing you to specify your default language, database connection settings and default table names to create during the installation. The install procedure will also generate a configuration file in the admin directory of your installation. Upon a normal install the install script will drop / create the table names and populate those tables with the default data used by the install. Any existing data will be removed.

With the installation script you can also choose to perform an UPGRADE. In an upgrade situation the existing database tables and their data will remain untouched and only the needed configuration files will be re-created using the entered database table names. You can opt for an upgrade by checking the upgrade option checkbox.

Initial setup / first-time login

Once installed you can access the control panel using the default administrative account by entering admin as the username and setup as your password. To access the control panel simply visit the URL of where its is installed like so :Example : http://www.yourwebsite.com/admin/

Post-install tips

Once you have successfully setup your installation it is highly recommended that you :Change the default administrative root password to a more secure letter / number combination. Remove or password protect the install/ directory within your admin/ directory to prevent accidental re-installs and / or tampering with your site. And (if desired) change the directory permissions for the admin/ directory back to a more secure setting (755).

Installing Modules

By default when the initial software is installed any included modules will not automatically install. This is done to save disk space by not creating un-necessary database structure in the configured database. Upon first accessing a module from the Modules screen within the control panel each module will be checked for installation status. In the event a module has not yet been installed you will be presented with an option to do so.