Updating eduTrac SIS

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.

 

Warning: Updating eduTrac SIS affects core files. If you’ve modified any of the core files, your changes will be lost.

It is strongly recommended that you keep your eduTrac SIS installation up to date. This ensures that you are using the latest stable release as well as to make sure that all updates are applied and not skipped over due to the fact you are a few releases behind.

When a new release is available, you will see an update message via the dashboard and only the super administrator can see the message. When you see this message, there are two ways in which you can update your installation. You can use the one click update, or update using the manual process, both of which are described in more detail below.

Back Up eduTrac SIS

Before you attempt the update process, you should back up your current installation. Backing up your installation assures that you have a way to restore your website to what it was before attempting to upgrade. If creating backups is new to you, check out the resources under eduTrac SIS Backups.

One-click Update

One click update is now deprecated and has been removed. It has been replaced in favor of using the command line.

Manual Update

If you are leery about using the one-click update or you prefer to manually update your installation, carefully follow the instructions below.

Step 1: Replace Files

  • Get the latest eduTrac SIS zip file. If you have an account on this site, log into your dashboard to download the latest file or download from SourceForge. Download it to your desktop or somewhere else that is easily accessible.
  • Extract the zip file.
  • Deactivate all plugins.
  • FTP to your site using an FTP Client.
  • Replace all the current files with the new files from the extracted zip you downloaded. Do not delete any files or folders from your existing installation except for the one being overwritten by the new files and unless otherwise stated in the release’s changelog.

Step 2: Database Update

Updating the database is now handled via the command line. To learn more, checkout the Command Line article on the knowledge base.

Final Steps

Once the update is complete, make sure to download and update any plugins that need updating as well as modules that may need updating as well. Once the core, plugins and modules are updated, activate the plugins that were deactivated before the upgrade process. Also, you should check to see if there were any updates to the config.sample.php file. If so, you should implement the changes to your config.php file and make sure that config.php looks similar to config.sample.php.

Troubleshooting

Each release is thoroughly tested but humans do make errors from time to time. However, If you have a development environment, you should update and test your development environment first before updating your production/live environment.

If by chance you experience problems after the update, restore the database from your backup as well as FTP to your site and overwrite the files with the files from your backup. Next, you will need to report the issue in detail on Github.

Last Modified: Aug 9, 2017 @ 11:44 AM

Was this article helpful?

Yes No

Related Articles

  • 5 years, 4 months ago Teja Majety
    Moderator
    • Topics: 12
    • Replies: 204
    • Total Posts: 216

    Hi,

    I have been trying to update Edu Trac SIS but I don’t see any change. Auto update is not working for days and it’s giving me daily some error logs. So thought of doing the manual update.

    I installed 6.2.2 version in the beginning and I think it updated to 6.2.5 but after that it is giving me auto updates failed. So downloaded 6.2.8 version and extracted it and through winSCP replaced all the files.

    But when I came back to SIS nothing changed, it didn’t ask me to update the database or anything it’s same as it was before replacing files. I thought it may be the big difference between updates and replaced the files with 6.2.6 and 6.2.7. in both cases, nothing happened.

    So am i missing something or is it already updated but i couldn’t notice. Generally, where we can check the current version in SIS?

    I really appreciate any help you can provide

     

    • This reply was modified 5 years, 4 months ago by  Teja Majety.
    5 years, 4 months ago Joshua Parker
    Keymaster
    • Topics: 4
    • Replies: 638
    • Total Posts: 642

    There is no database upgrade needed, only file upgrades. If you look at the very bottom of the footer, it will tell you what release is currently installed (see screenshot for example).

    Attachments:
    You must be logged in to view attached files.

    Joshua Parker
    Twitter | Facebook | DigitalOcean | tinyCampaign

    5 years, 4 months ago Teja Majety
    Moderator
    • Topics: 12
    • Replies: 204
    • Total Posts: 216

    Thanks for the reply, so is it the number in parentheses the current version?

    like © 2013 – r6.2.0 (t6.2.6)   Built with Liten Framework  — the current version is 6.2.6

    © 2013 – r6.2.0 (t6.2.7)   Built with Liten Framework    ——- the current version is 6.2.6

    Is that it right..

    5 years, 4 months ago Joshua Parker
    Keymaster
    • Topics: 4
    • Replies: 638
    • Total Posts: 642

    Yes.

    Joshua Parker
    Twitter | Facebook | DigitalOcean | tinyCampaign

    5 years, 4 months ago Teja Majety
    Moderator
    • Topics: 12
    • Replies: 204
    • Total Posts: 216

    Thank you, I think it upgraded fine and it’s showing 6.2.7 in the bottom.

    But I tried to replace all the files from 6.2.8 version, I think it’s ok for now i will try again with 6.2.8 later.

    I just want to install hidden fields, but it’s asking for 6.2.8 version.

    Thanks again.

    5 years, 4 months ago Joshua Parker
    Keymaster
    • Topics: 4
    • Replies: 638
    • Total Posts: 642

    You want to install hidden fields?

    Joshua Parker
    Twitter | Facebook | DigitalOcean | tinyCampaign

    5 years, 4 months ago Teja Majety
    Moderator
    • Topics: 12
    • Replies: 204
    • Total Posts: 216

    Sorry, hidden fields plugin..

    5 years, 4 months ago Joshua Parker
    Keymaster
    • Topics: 4
    • Replies: 638
    • Total Posts: 642

    Oh, you can manually upgrade to 6.2.8 by logging in via FTP and override the old files with the new ones.

    Joshua Parker
    Twitter | Facebook | DigitalOcean | tinyCampaign

    5 years ago Teja Majety
    Moderator
    • Topics: 12
    • Replies: 204
    • Total Posts: 216

    Hi,

    The command line interface is really good and I am sure it will be handy for SSH users. I updated it and it was going really well.

    But for some reason I am getting PHP error with the command, I mean the result/output of the command is fine but with it, i am getting PHP error as well. Actually, it doesn’t matter if we are getting good results. But I am really curious to know the reason. I have attached the screenshot of my result. Please have a look.

    One more thing to ask about one-click updates. Though it never worked for me, but it generates core-update logs daily. Is there any way to stop them or any way to workout that.

     

    • This reply was modified 5 years ago by  Teja Majety. Reason: attachment error
    Attachments:
    You must be logged in to view attached files.
    5 years ago Joshua Parker
    Keymaster
    • Topics: 4
    • Replies: 638
    • Total Posts: 642

    I think I may know what the issue is. Can you run the following command in your terminal and tell me if you get the same error message?

    php -v

     

    Joshua Parker
    Twitter | Facebook | DigitalOcean | tinyCampaign

    5 years ago Teja Majety
    Moderator
    • Topics: 12
    • Replies: 204
    • Total Posts: 216

    Yes, I am getting the same error. But as far as I remember this didn’t generate when I last checked PHP version a few months back.

    Though recently I installed Memcache.

     

    5 years ago Joshua Parker
    Keymaster
    • Topics: 4
    • Replies: 638
    • Total Posts: 642

    Yes, so I am assuming the php module memcache is being loaded twice. I found this article with regards to the issue. It may or may not be able to help you figure out your issue.

    Joshua Parker
    Twitter | Facebook | DigitalOcean | tinyCampaign

    5 years ago Joshua Parker
    Keymaster
    • Topics: 4
    • Replies: 638
    • Total Posts: 642

    With regards to automatic core updates, the reason they might not work is that etSIS doesn’t have permission to create new directories. So if new libraries are added, the system can’t create the new directories to house those libraries, so manual upgrade is needed.

    However, update checking and upgrades will be available via command line as well in the upcoming release.

    I am glad that you like the command line feature. Now, moving to command line will probably upset some people. Also, it will turn away potential users who are not administrators or techies. But others have been turned away more because they were unable to install the system via the browser. Either because of timeout issues or functions loaded due to the way their server is setup. Also, moving some of the work etSIS does to background processes will make it a better system overtime.

    Also, overtime users will have a better experience with installation and the way the system runs. Theses changes are not made off the cuff. Lots of research is done as well as weighing the pros and cons.

    Nevertheless, regular users can install r6.2.9, do manual upgrades from there, and database upgrades are coming back, so they are not completely left out in the cold. All of this should probably be in a blog post for general population though and linked it to the command line article.

    At the moment, there is no automatic way to turn off checking, but you could setup a cronjob to remove the old core-update files from the log.

    Joshua Parker
    Twitter | Facebook | DigitalOcean | tinyCampaign

    5 years ago Teja Majety
    Moderator
    • Topics: 12
    • Replies: 204
    • Total Posts: 216

    Thanks @Parker that worked like a charm, thanks a lot.

    As you said the command line feature may upset some people, but I think at least for installation part the people should give the job to techies, and I hope they will love it.

    Who doesn’t love the feature, which makes things easy….and I don’t think it’s too much complicated, maybe with proper notes/commands to follow anyone can  perform basic installation/update.

Viewing 14 posts - 1 through 14 (of 14 total)

You must be logged in to reply to this topic.