Install guide
From Open-Realty Wiki
Contents |
Installation & Upgrade Guide
So you have decided to install Open-Realty 2.0. GREAT! Follow the steps below and you will be up and running in minutes.
Getting Ready
1. Make sure your web hosting provider meets these specifications.
A. Runs PHP 4.3.0 or higher.
B. Runs MySQL (4.0.2 or higher) or PostgreSQL 7(may work with older versions but is not tested)
C. Has Session and GD Support Compiled into PHP.
2. Download the latest official Open-Realty 2.0 release. You can also use SVN to get the latest work in progress. SVN Revisions are not official releases and may have bugs in them. Instructions for downloading SVN content are here
A. If you are using a WYSIWYG page editor then download the latest releases of those. (This is not needed if you use SVN)
3. Extract the downloaded file(s) and upload to your website, either to the root folder on your site, usually called www or public html, or to a subfolder of your root.
A. Extract the downloaded WYSIWYG editor. You should have a folder with the name of the editor for example "fckeditor".
B. Copy the WYSIWYG editor folder to your open-realty installation. You need to place the editor's folder in /include/class/ in your Open-Realty installtion.
C. Completed it should look like /include/class/fckeditor with the editor's files under this folder.
D. TIP: There should not be a second folder of the same name as your editor like /include/class/fckeditor/fckeditor. Some extraction software will extract the compressed files and folders to a folder of the same name as the archive thus putting your actual WYSIWYG editor folder inside a folder of the same name.
4. Set Permissions (chmod) on the following files. You can set permissions(chmod) using most FTP Clients, Web based File managers, or via a shell account.
A. Set Permissions 777 on the include/common.dist.php file
B. Set Permissions 777 on the images/listing_photos directory
C. Set Permissions 777 on the images/user_photos directory
D. Set Permissions 777 on the images/vtour_photos directory
E. Set Permissions 777 on the images/page_upload directory
5. Create a blank mysql or postgres database on your server. Most hosting providers provide a control panel interface for doing this, you should check with your hosting provider if you are not sure how to do this. You should also create a database user and assign them All Privileges to the database you created. Write down the database name, username, and password you just created.
6. Using your web browser, go to http://www.yourdomain.com/installpath/install/index.php. For example if you installed this on a domain called myrealestatecompany.com in a subdirectory called open-realty you would go to, http://www.myrealestatecompany.com/open-realty/install/index.php.
Running the installer
7. Read the license agreement and click the "Agree" button to continue.
8. Select the default language for your site and click submit.
9. The next screen verifies the permissions your set in step 4. If it finds any permission problems correct them and refresh the page. When all permissions are correct; Click "Click to Continue Installation".
10. You now need to select the type of installation you are doing. The options are as follows.
- New Install Of Open-Realty 2.0
- Upgrade from Open-Realty 2.0x (Beta 1 or higher) Read the Upgrade guide below
- Upgrade from Open-Realty 1.1.5 Read the Upgrade guide below
- Update Path and URL information only - This option should be used when you have moved your open-realty install to a new directory.
11. Select the type of database you created in step 5. Insert your database information from step 5 into the appropriate fields. The last four settings should not be changed unless you know what you are doing. Click next.
12. This step creates the common.php file, which stores the database configuration information for open-realty to use. Click "Continue to setup the database."
13. This step will create and populate the open-realty database tables.
14. Click "Click here to configure your installation". Next you will need to, at the minimum change the Admin email address in the configuration before the site will operate. To login to the admin area and start using Open-Realty use the login information below. This is the default admin user, you should change the password once logged in.
Default Username/Password
Username: admin Password: password
Please read the Administrators Guide for more information on how to configure open-realty.
15. Congratulations your open-realty install is complete you must delete the install directory and your site will be running.
Upgrade Guide
Already have Open-Realty installed and want to upgrade to the latest Open-Realty 2.0 release? GREAT! Follow the steps below and you will be up and running in minutes.
Getting Ready
BACKUP! Always backup your existing site and database prior to attempting an upgrade. Backing up your database can be done using your favorite database management tool usually provided by your hosting provider (Usually phpMyAdmin). In a future version of Open-Realty there will be built in database backup options.
Important! If you are upgrading from a version prior to 2.1, make sure your setup includes the 'type' field and that all of your listings are assigned a type. Failure to do this will result in the upgrade script not being able to properly convert your site to the property class system.
1. Make sure your web hosting provider meets these specifications.
A. Runs PHP 4.3.0 or higher.
B. Runs MySQL (4.0.2 or higher) or PostgreSQL 7(may work with older versions but is not tested)
C. Has Session and GD Support Compiled into PHP.
2. Download the latest official Open-Realty 2.0 release. You can also use SVN to get the latest work in progress. SVN Revisions are not official releases and may have bugs in them. Instructions for downloading SVN content are here
A. If you are using a WYSIWYG page editor then download the latest releases of those. (This is not needed if you use SVN)
3. Extract the downloaded file and upload all files to your existing website, overwriting all the old files. Leave any custom templates you are using in place. They will not be overwritten unless you are using a customized version of the vertical-menu template and did not change it's name. In this case don't upload the new vertical-menu template.
NOTE - In order to properly upgrade you MUST leave the existing /include/common.php intact and in place for the upgrade script to work properly. As of version 2.5.0 Open-Realty only includes a common.dist.php file and no longer includes a common.php file in order to prevent accidental overwrites of important server configuration settings.
4. Set Permissions (chmod) on the following files. You can set permissions(chmod) using most FTP Clients, Web based File managers, or via a shell account.
A. Set Permissions 777 on the include/common.php file
B. Set Permissions 777 on the images/listing_photos directory
C. Set Permissions 777 on the images/user_photos directory
D. Set Permissions 777 on the images/vtour_photos directory
E. Set Permissions 777 on the images/page_upload directory
5. Using your web browser, go to http://www.yourdomain.com/installpath/install/index.php. For example if you installed this on a domain called myrealestatecompany.com in a subdirectory called open-realty you would go to, http://www.myrealestatecompany.com/open-realty/install/index.php.
Running the installer
6. Read the license agreement and click the "Agree" button to continue.
7. Select the default language for your site and click submit.
8. The next screen verifies the permissions your set in step 4. If it finds any permission problems correct them and refresh the page. When all permissions are correct; Click "Click to Continue Installation".
9. You now need to select the type of installation you are doing. You should be selecting one of the two Upgrade options. The options are as follows.
- New Install Of Open-Realty 2.0
- Upgrade from Open-Realty 2.0x (Beta 1 or higher) BACKUP your site and database before you continue.
- Upgrade from Open-Realty 1.1.5 BACKUP your site and database before you continue.
- Update Path and URL information only - This option should be used when you have moved your open-realty install to a new directory.
10. Verify that the installer is using the correct settings for your database and paths. These are loaded from your existing common.php file that you left in place. None of these settings should need to be changed unless you are doing a path and url update and have moved servers, changed database information etc. Click next.
11. This step creates the common.php file, which stores the database configuration information for open-realty to use. Click "Continue to setup the database."
12. This step will perform any necessary database operations to upgrade you to the latest version.
13. Click "Click here to configure your installation". Your login information will be unchanged from the prior version you had installed. Please read the Administrators Guide for more information on how to configure open-realty.
14. Congratulations your Open-Realty upgrade is complete you must delete the install directory and your site will be running. Your previous templates and addons should remain in place and continue working as before.
Occasionally there will be changes to the addon or template system which may require existing addons or templates to be modified to continue working with the new specifications. Any changes of this sort will be listed in the release notes on the release announcement so you are aware of any changes prior to upgrading. Usually these changes will be isolated to new portions of Open-Realty being templated and additional template files being required.
