Requirements

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

Server Requirements

  • MySQL (5.1 and 8.0 tested) or MariaDB (10.3 and 10.4 tested)
  • PHP (5.2, 5.3, 5.4, 7.1, 7.2, 7.3, 7.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
    • Important Note: It is strongly recommended to use PHP version 7.2 or higher, with opcode caching enabled.
  • Apache, LiteSpeed, or Nginx*
    • ​Nginx will require optional configs to work with Clean URLs in FlightPath.
    • ​Possibly other webservers will work as well; albeit Clean URLs may not work.  See below.
  • Linux, Windows, Unix all tested (Linux recommended)
  • Minimum of 3GB system RAM, at least 4GB recommended**
  • Minimum of 20MB 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 these 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 1000M and 2000M.  As such, you will need to have at least double this amount of RAM for the entire system to run smoothly.

 

PHP memory_limit

FlightPath uses 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 1500M to start, and raise it if FlightPath dies with a 500 error during operations (or you just see a white screen with no errors).  You will need to restart your webserver after making this change.

 

Clean URLs

Note: Clean URLs are 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".