Download OSA

From OSA

Jump to: navigation, search

Open School Admin (OSA) is a web based application for managing school operations. OSA makes easy work of all aspects of school management from student enrolment, scheduling, locker assignments, mark reporting, attendance and much, much more. Through the use of plugins, OSA can be extended to manage student dorms, email announcements, government reporting, Alumni relations and processes yet to be explored.


This is the first public beta release of OSA. While OSA itself is very functional and has been used by schools successfully for years, the install process is very new and full of sharp edges. This download will get you started with the OSA code base. Completing the configuration to set up a functioning OSA application will involve some work. You may want to install the Aqualung sample app first to get a feel for how things are laid out.


OSA_install.pl download is a self installing perl script that checks for required packages, locates the webserver user/group information, confirms CGI/Document directories, then extracts both the Aqualung base and the OSA web app into the appropriate locations, creating paths and setting mode/permissions in the process.

Download: Latest OSA Beta August 15, 2013 v0.99b

Source: not available yet

How To Install

  1. Download the OSA beta and run the OSA_install.pl script.
    • Run the script in a terminal (from the command line).
    • It will create/populate cgi, html and data directories, generate a config file and create/setup any database requirements.
    • The script must be run as the root user:
    perl -T pathToScript/OSA_install.pl
    • On systems that require sudo type:
    sudo perl -T pathToScript/OSA_install.pl
  2. Verify the web app config file.
    • Snoop around the cgi directory and find the web app config directory, something like '/var/www/cgi-bin/OSA/main/etc'.
    • On the Mac the config files will likely be in '/Library/WebServer/CGI-Executables/OSA/main/etc'.
    • On the OpenSUSE the config files will likely be in '/srv/www/cgi-bin/OSA/main/etc'.
    • Verify/change the directory paths in the config.txt file if required.
    • You'll also find a config.default.txt file in the same location that contains all the configuration options in more detail (don't edit config.default.txt!).
  3. Initialise the OSA web app.
    • Find the main.pl script (something like /var/www/cgi-bin/OSA/main.pl).
    • Initialize the application by running the main.pl script with the '--init' option.
      • type the command:
      /var/www/cgi-bin/OSA/main.pl --init
      • On systems that require sudo type:
      sudo perl -T /var/www/cgi-bin/OSA/main.pl --init
    • If the config.txt file is correct and no errors occured, the default MySQL tables and a default 'superuser' user will be created for the OSA web app.
    someday the install script will take care of this for you
  4. Verify the Apache web server setup
    • A a sample Apache config file 'apache.conf' is generated in the OSA web app config directory by the init step.
    • If you've got the same Apache set up I do (CentOS), this file can be copied to the /etc/httpd/conf.d. You may have to customize it.
  5. Run the web app from a browser.
  6. Sit back and relax. You're done!
Personal tools