Installation

Are you new to the eduTrac SIS online user's manual? If so, click here for a starting point. If you are looking for technical documentation, then check out the Wiki.

 

If you are looking for installation instructions for releases prior to 6.2.10, then click here.
 In order to successfully install and manage eduTrac SIS, you must install on a VPS or dedicated server and you must have shell access to that server.

Server Requirements

SoftwareRecommendedMinimumMore Information
PHP
(fastcgi, curl, bcmath, mbstring, mysqli, PDO, pdo_mysql, zip)
7.07.xphp.net
MySQL / MariaDb
(Innodb support)
5.7+ / 10+5.7 / 10mysql.com / mariadb.com
*Apache2.4+2.4apache.org
*Nginx1.8+1.8nginx.com

*You must have installed at least one out of the two web servers.

Also, etSIS must have permission to read/write to /tmp/ directory

Download

You can download etSIS in one of three ways:

You can either download from SourceForge, you can clone it from our git repository or create a free account in order to receive important updates as well as security alerts. By cloning the repository, you can use git pull in order to update/upgrade without downloading and ftp’ing files. There are default modules that are included with the standard distribution. However, there are other modules available for purchase, as well as free plugins to install.

eduTrac SIS is the most advanced open source student information system for higher education.
Forks: 24
Stars: 38
Open issues: 19
Latest tag: r6.3.4
git clone https://github.com/parkerj/eduTrac-SIS.git

 

Development Branch

git clone -b develop https://github.com/parkerj/eduTrac-SIS.git

Rewrite Rules

Before installing etSIS, make sure the rewrite rules exist. Not all server setups are the same, so the Apache rewrite rules may need adjusting.

.htaccess

RewriteEngine On

# Some hosts may require you to use the `RewriteBase` directive.
# If you need to use the `RewriteBase` directive, it should be the
# absolute physical path to the directory that contains this htaccess file.
#
# RewriteBase /

RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . index.php [L]

Nginx (root directory)

location / {
    try_files $uri /index.php$is_args$args;
}

Nginx (subdirectory)

location /sis {
    try_files $uri /sis/index.php$is_args$args;
}

Create a Database

Before starting with the installation, you must first create a database. When creating the database, make sure that it has the following collation/charset: utf8mb4_unicode_ci

Install eduTrac SIS

Now that you’ve uploaded the files to your server, need to log into your server via ssh and navigate to the root of etSIS. After creating an ssh session, follow the instructions below.

Note: Windows users will need to install Cygwin to give them Linux type functionality via the command line.

  • chmod +x etsis
  • chmod +x phinx (this is the file *without* the .php extension)
  • open phinx.php and edit the database details. You must create the database first. etSIS will not create the database for you. Your phinx.php file should look similar to below once you’ve edited it:
defined('DB_HOST') or define('DB_HOST', '127.0.0.1'); // Usually localhost or 127.0.0.1.
defined('DB_NAME') or define('DB_NAME', ''); // Database name.
defined('DB_USER') or define('DB_USER', ''); // Database username.
defined('DB_PASS') or define('DB_PASS', ''); // Database password.
defined('DB_PORT') or define('DB_PORT', 3306); // Database port.

After entering your database details, run the following command to start the install and database migration:

$ ./etsis core migrate

Once the installation is complete, you should see a message similar to below:

Phinx by Rob Morgan - https://phinx.org. version 0.6.4

using config file ./phinx.php
using config parser php
using migration path app/src/vendor/Phinx/migrations
using environment production
using adapter mysql
using database phinx

 == 20160916002812 InitialSchema: migrating
 == 20160916002812 InitialSchema: migrated 9.5899s

 == 20160916035404 CurrencyTable: migrating
 == 20160916035404 CurrencyTable: migrated 0.2374s

All Done. Took 9.9171s

Once installed, you can login as the super administrator with the login details below. If your installation is a accessible via the web, please make sure to update the login details with something more secure. You can change your username via PHPMyAdmin, or you can use the Username Changer plugin.

  • Username: etsis
  • Password: edutracsis

Cookies and File Savepath

After the initial migration, a config.php file should now exist in the root of your installation. You should open it and edit the following:

$app = new \Liten\Liten(
    [
    'cookies.lifetime' => '86400',
    'cookies.savepath' => ini_get('session.save_path') . DS . $subdomain . DS,
    'file.savepath' => ini_get('session.save_path') . DS . $subdomain . DS . 'files' . DS
    ]
);

The default session.save_path on most servers is /tmp/. However, if you restart your server, anything in the /tmp/ directory will be deleted. Also, sometimes the /tmp/ directory isn’t set, and you may get a warning that a certain set of directories cannot be created. So, you should change the path of where important files should be saved. Please note, that these files must *not* be saved in the public directory.

As an example, if your installation is installed at /home/username/public_html/etsis/, you will need to create a directory with the correct write permissions above the public directory (i.e. /home/username/etsis_tmp). Now that we have our new folder (etsis_tmp) created above the root and out of prying eyes, our new instantiated $app object will now look similar to below:

$app = new \Liten\Liten(
    [
    'cookies.lifetime' => '86400',
    'cookies.savepath' => '/home/username/etsis_tmp' . DS . $subdomain . DS,
    'file.savepath' => '/home/username/etsis_tmp' . DS . $subdomain . DS . 'files' . DS
    ]
);

Debugging

If you visit your new installation, and it doesn’t seem to load, check out Debugging eduTrac SIS.

 

Last Modified: Jul 11, 2017 @ 9:17 PM

Was this article helpful?

Related Articles