Requirements

FlightPath is a web-based application which requires the following:

Server Requirements

  • MySQL (5.1 tested)
  • PHP (5.2, 5.3, 5.4 tested)
    • Also requires the GD library be enabled for pie charts to be drawn.  This is usually on by default.  If not, see: http://www.php.net/manual/en/image.setup.php
  • Apache or LiteSpeed*
    • Nginx also tested and working, with optional configs
    • ​Possibly other webservers will work as well; albeit Clean URLs may not work.  See below.
  • Linux, Windows, Unix all tested (Linux recommended)
  • Minimum of 1GB system RAM**
  • Minimum of 10MB free disk space

* It is possible other webservers will work as well, so long as they can be configured to process "Clean URLs" described below.  As long as the server can read an .htaccess file, or can imitate the URL rewriting rules described within it, it should work with FlightPath.  Please see this forum post for tips on using Nginx.

** This will vary based on your system and amount of activity, but the PHP memory_limit should be set a little high, between 100MB and 500MB.

 

PHP memory_limit

FlightPath uses a little more memory than the average web application, due to the amount of data it must collect and work on while advising a student.  Edit your php.ini file, and look for the line which specifies memory_limit = XXXM.  Set this to 256M to start, and raise it if FlightPath dies during operations.  You will need to restart your webserver after making this change.

 

Clean URLs

Note: As of version 4.7, Clean URLs are now optional.  If your server does not support URL-rewriting, it should still be able to run FlightPath.

FlightPath uses URL rewrites (in its .htaccess file) to create "clean URLs".  You must configure your (Apache-based) web server to allow overrides for your FlightPath directory.  Many servers have this set up by default.  If you get a 500 Internal Server Error, or a 404 Page not Found while trying to install FlightPath, this is the problem.

  • To fix (with Apache), add this to your httpd.conf file:
    • <Directory "/path-to-flightpath/flightpath">   AllowOverride All  </Directory>
    • Remember to restart apache after making this change.
  • This assumes (with Apache) that you have the Mod Rewrite module enabled.  Typically, this module is already enabled, but if not, you will need to consult your server's administrator or other guides online for enabling Mod Rewrite.

If you are not using Apache (or compatible) web server, you may be able to configure your web server to imitate the Mod Rewrite rule used by FlightPath for Clean URLs. That is, that a URL in this format:

     http://example.com/flightpath/index.php?q=admin/config/etc
be rewritten into this format:
     http://example.com/flightpath/admin/config/etc

Notice the index.php?q= is eliminated from the URL, making it appear more clean and easier to read and type.

To disable from the database, should you get "locked out" of your site, you can edit the variables table, and remove the entry for "clean_urls".