iAuto Installation Guide

iAuto Installation Guide Copyright © 2006 iAuto Software.

Express Installation Instructions For Experienced Users

1. Unpack the package into the installation directory
2. Create a database for iAuto
3. Direct your browser to the installation URL, i.e. http://www.yourdomain.com/iauto-uri/ or http://www.yourdomain.com/
4. Fill out and submit the form

System Requirements

Below are system requirements for iAuto:

1. Apache web server, 1.3.26 or higher or 2.0.45 or higher
2. mod_rewrite
3. PHP 4.3.0 or higher (the system may not work with PHP 5.0.0 or higher),
4. MySQL 3.23 or higher,
5. GD library
6. libiconv (optional, required for importing data from MS Excel files)

Detailed Installation Instructions

Overview

Installation of iAuto includes the following steps:

1. Obtaining the software package.
2. Unpacking files.
3. Creating a database for iAuto.
4. Running installation/configuration script to complete the installation.

Obtaining Software

After your order is processed, you will receive the iAuto installation package. You will either get it by email as an attachment, or download the package following the link in the confirmation email. iAuto system comes in a single tar-gz file. The file name will be something like iAuto-X.Y.Z.tgz, where X and Y indicate iAuto's major and minor version release numbers, and Z indicated the subversion number

Unpacking Files

Important notice: all files and folders will be unzipped into the current directory unless specified by you otherwise. Make sure you check the directory to which you are going to unzip the files to prevent any accidental damage to other files and/or folders.

Unless you are installing iAuto to the DocumentRoot, you need to create a new installation directory.

Unpacking Software under Windows

Under Windows, tar-gz files can be unpacked with either 7-Zip, WinZip, WinRAR or other popular archivers.

Unpacking Software under Linux/Unix Shell

Create installation directory:

$ mkdir -p /path/to/iAuto/installation/dir

b) Unpack files:

$ tar -xzf /path/to/package/iAuto-x.y.z.tz -C /path/to/iAuto/installation/dir

Unpacking Software Using Control Panel (Cpanel)

Usually public or commercial hosting providers offer web interface for managing hosted files and services called control panel or Cpanel. A typical Cpanel includes, among other features, a file manager that allows extraction of tar- gzipped files. Please note that the package files are extracted to the same directory by default. To avoid any accidental damage to your existing files and directories, you should first create the installation directory and then upload the iAuto-x.y.z.tgz archive file to that directory. Using Cpanel's file manager, unpack the files and move iAuto-x.y.z.tgz to a different location; otherwise, the package will be publicly accessible.

When your hosting provider does not offer any tools to extract iAuto files directly on the hosting server, extract the archive to a folder on your local computer and then upload the files and directories to your hosting server via ftp. This usually takes much longer than uploading the package file and extracting it on the server.

Creating MySQL Database for iAuto

Before you can run installation script, you need to have a MySQL database ready. If you use public hosting, then you probably already have it ready or it can be easily created with control panel. If you do not have a control panel for your hosting server, you will have to ask the server's administrator to create a database for you.

If you have root access to MySQL server, create the database following the steps below:

1. In shell, run mysql -u root -p, mysql will prompt for root's password.
2. In the MySQL prompt, type in the following (do not forget the semicolons (";") at end of each command):
   • mysql> CREATE DATABASE iAuto;
   • mysql> GRANT ALL PRIVILEGES ON iAuto.* TO iAutoUser IDENTIFIED BY 'iAutoPassword';

In this example, iAuto is the name of the database, iAutoUser is the database user name, and iAutoPassword is the password to access the database. These values do not have to be the same as in the example.

Important Notice: If this user already exists, this user's password will be reset to 'iAutoPassword'. To avoid resetting the password, omit IDENTIFIED BY 'iAutoPassword' in the above command.

Running Installation Script to Complete Installation

Configure iAuto before use. The installation script included in the root of the package will configure the system. This script performs the following actions:

1. Checks the PHP version
2. Checks whether required extensions are installed
3. Checks package integrity
4. Validates configuration data
5. Creates configuration files

Now launch the script by directing your browser to the installation URL, i.e. http://www.yourdomain.com/iauto-uri/ or http://www.yourdomain.com/ when installing iAuto to the root of your site. After the initial checks are complete, the system displays the configuration form.

Initially, the script runs all checks and prompts user for installation details. Below is a brief explanation of each field of the installation form:

Having validated the data, the script creates configuration files. If the installation is successful, you will see the following message: "Congratulations, you have iAuto installed". In case of installation errors, correct the mistakes outlined in red until you successfully complete the installation.

If you don't have FTP access, then you should change file permissions via the cpanel or run the following commands on your server:

• $ cd /path/to/installation/dir
• $ chmod a+w the list of the files divided by space which will be shown by the installation script to change their mode (e.g. config-site.php .htaccess admin/config-site.php admin/.htaccess)

Under Windows, files are typically writable. If not, adjust file permissions by right-clicking on the file(s) and opening the "Properties" tab to type in the correct values. Alternatively, have your systems administrator do it for you.

Accessing Admin Area:

After installing iAuto, you may start configuring the system using the administrative back-end console. To access the admin back-end console, login using the admin user name and password specified during the installation. In order to login to the admin panel, use the BaseURL/admin page.

After logging in, you now have access to all admin functions. For additional information on system configuration, please refer to the user manual.

Index

Table of Contents

About This Document

This document was generated by Automated Release Builder Script on January, 12 2007 using texi2html.

The buttons in the navigation panels have the following meaning:

where the Example assumes that the current position is at Subsubsection One-Two-Three of a document of the following structure:

• 1. Section One
  • 1.1 Subsection One-One
    • ...
  • 1.2 Subsection One-Two
    • 1.2.1 Subsubsection One-Two-One
    • 1.2.2 Subsubsection One-Two-Two
    • 1.2.3 Subsubsection One-Two-Three     <== Current Position
    • 1.2.4 Subsubsection One-Two-Four
  • 1.3 Subsection One-Three
    • ...
  • 1.4 Subsection One-Four

This document was generated by Automated Release Builder Script on January, 12 2007 using texi2html.