Installation

From FestOS wiki

Jump to: navigation, search

Installing FestOS involves a these phases:

  1. Pre-installation
  2. FestOS installation
  3. Configuration

1. Pre-installation

Prior to installing, you will need to:

  • Create a MySQL database on your web host using the control panel or other tools they provide
  • Determine the server address for your database server (localhost, mysql.yourdomain.com, etc.)
  • Record the MySQL user name and password for your database access
  • Determine if you're running an Windows/IIS or Apache web server.
    • If Windows/IIS, obtain the php.ini file
    • If Apache, check with your host to determine if you can set PHP options via the .htaccess file

2.FestOS Installation

To install FestOS:

  1. Unzip the distribution file on your local hard drive
  2. Using a text editor (Notepad, Dreamweaver, etc.) edit the core/config.php file:
    1. Enter the database name, server, and credentials you determined above. Optionally, enter a prefix that will be appended to all the table names used by FestOS. This enables you to install FestOS into a database that contains other tables
    2. Enter the full URL to where you will be installing FestOS on your web site (e.g. http://www.yourwebsite.com/festos/)
    3. Don't change anything below the part where it says "DO NOT CHANGE ANYTHING BELOW THIS POINT!!!"
  3. Save your changes.
  4. Edit the PHP configuration file appropriate to your server:
    1. Windows/IIS server, edit your php.ini file to specify these values (find the current settings for each and change as shown)
      Safe_mode = Off
      display_errors = Off
      register_global = Off
    2. Apache server, use the provided .htaccess file or edit your own to specify these values
      php_flag safe_mode off
      php_flag display_errors Off (overrides the FestOS config setting to display errors)
      php_flag register_globals off
  5. Upload all of the files to your web server. You may put the files into a folder or right at your web root. Just make sure it matches what you set in the config.php file. The php.ini file must go in your web site's root directory, regardless of where you install FestOS. The .htaccess should probably go there too, but could be placed in the FestOS directory to control settings for just FestOS.
  6. (Linux/UNIX systems) Set 777 file permissions on the following directories and files (where path is the directory in which you installed FestOS):
    • path/cache/ (directory and the files & directories it contains)
    • path/vendorimages/ (directory and the files it contains)
  7. With your browser, load http://www.yourwebsite.com/path/install/index.php substituting the directory name of where you put the FestOS files for path. The installer adds the database tables and starting information.
  8. Delete the install directory and all the files and directories it contains.

Suggestion

We suggest you create a robots.txt file (or edit your existing file) and place it in the root directory of your web space. In this file, add these lines:

User-agent: *
Disallow: /addons/
Disallow: /admin/
Disallow: /core/
Disallow: /css/
Disallow: /images/
Disallow: /js/
Disallow: /templates/
Disallow: /includes/
Disallow: /cache/

These will limit the amount of scanning that the search engine robots perform on FestOS components that don't really need to be searchable.

3. Configuration

  1. Visit http://www.yourwebsite.com/path/admin/login.php and log in using the credentials that you specified during the installation.
  2. From the left-most tab (the blue "orb" menu) choose choose Site Configuration.
  3. Configure the various fields on the configuration page and click the Submit button at the bottom.
  4. From the orb menu, choose Site Admins. You can either modify the existing admin account or create a new one for yourself. Make sure to change the password or delete the default admin account if you use a different administrator account.
  5. From the orb menu, choose Language Editor - General. Edit the general language settings.
  6. From the orb menu, choose Language Editor - Photos. Edit the photo requirements related language settings.
  7. On the Fest Config tab, click Categories. These are the categories under which your applicants will be listed. Edit as required.
  8. On the Applications tab, click Applicant types & forms. Configure the types appropriate to your festival.
  9. For each valid type, click the Edit Application button. Enable, disable, and configure application form fields to mimic the paper-based applications you typically use.
  10. On the Applications tab, click Fees & deadlines. Configure the fees and application deadlines for each of the applicant types.
  11. On the Fest Config tab, click Contacts/Organizers. If you use the contacts page, these are the people who will be listed. Edit as required.
  12. On the Fest Config tab, click Preflight. This report summarizes your FestOS settings to give you an at-a-glance confirmation that you have all the settings correct.

Some sample artist and exhibitor records have been included. You can use these to practice editing, displaying, and so forth. Most likely you will want to delete these before publishing your site.

Further Information

Main FestOS Page : Installation : Customization  : Configuration : Administration : Payment Modules

Personal tools