=========
 INSTALL
=========

0. Pre-Install:
    - Install and configure HTTP Server, PHP, MySQL
    - Download OpenConf

1. Extract (unzip) OpenConf archive inside Web (HTTP) document root directory

2. Ensure Web server can create or write to:
    openconf/config.php
    openconf/data/   (and sub-directories)

3. Browse to http://[HOST]/openconf/ and follow web instructions

See www.OpenConf.com/support/ for additional documentation, including a
Chair's Guide


=========
 UPGRADE
=========

From 3.x or later:

1. Backup your current OpenConf database and directory

2. Extract (unzip) OpenConf archive over top of current directory;
   your settings will remain intact, however code customizations 
   will be overwritten

3. Sign in as Chair and browse to 
      http://[HOST]/openconf/chair/upgrade.php
   Follow the instructions provided


From 2.x or earlier:

- Upgrade is not supported


============================
 ETCETERA / TROUBLESHOOTING
============================

* Tested with PHP 5.2, MySQL 5, Apache 2

* Email is handled through PHP's mail() function.  If email is not being
  received or you are seeing an error, check and test your PHP settings.

* OpenConf does not limit the size of papers that may be uploaded;
  PHP however does.  You will need to modify PHP's max file and form upload
  settings if you want to support larger files being uploaded; do not forget
  to restart the HTTP server when you update PHP setting.

* OpenConf was developed using Apache.  If you are using another
  HTTP server, you may need to modify the .htaccess files.

* If you are uncomfortable having a file (config.php) with the database
  password inside the Web document space, you can move it elsewhere
  and simply modify the OCC_CONFIG_FILE define in include.php.
  
* In order to use OpenConf's multilingual capability, PHP must be compiled 
   with gettext, and the system have the proper locale(s) installed.
   See lib/locale.inc for appropriate locales.

* If you are running multiple instances of OpenConf, you should ensure the
  value of OCC_SESSION_VAR_NAME in config.php is different for each.