iRealty Installation Guide

iRealty Installation Guide Copyright © 2006 iRealty Software.

Express Installation Instructions For Experienced Users

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

System Requirements

Below are system requirements for iRealty:

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 iRealty includes the following steps:

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

Obtaining Software

After your order is processed, you will receive the iRealty installation package. You will either get it by email as an attachment, or download the package following the link in the confirmation email. iRealty system comes in a single tar-gz file. The file name will be something like iRealty-X.Y.Z.tgz, where X and Y indicate iRealty'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 iRealty 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/iRealty/installation/dir

b) Unpack files:

$ tar -xzf /path/to/package/iRealty-x.y.z.tz -C /path/to/iRealty/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 iRealty-x.y.z.tgz archive file to that directory. Using Cpanel's file manager, unpack the files and move iRealty-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 iRealty 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 iRealty

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 iRealty;
   • mysql> GRANT ALL PRIVILEGES ON iRealty.* TO iRealtyUser IDENTIFIED BY 'iRealtyPassword';

In this example, iRealty is the name of the database, iRealtyUser is the database user name, and iRealtyPassword 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 'iRealtyPassword'. To avoid resetting the password, omit IDENTIFIED BY 'iRealtyPassword' in the above command.

Running Installation Script to Complete Installation

Configure iRealty 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/iRealty-uri/ or http://www.yourdomain.com/ when installing iRealty 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 iRealty 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 iRealty, 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.