BUG: osTicket 1.8rc2 upgrader clean up

If you're like me and want to play with the new osTicket 1.8rc2 you may encounter the following upgrade error:

Fatal error: Call to undefined method Upgrader::getPendingTask() 
in PATH\TO\scp\upgrade.php on line 38

I reported the bug this morning and the devs already patched and fixed it. If you use git simply do a "git pull" request and it will pull down the fix for you. Other wise re-download the latest 1.8 from github.

osTicket 1.8rc2 Released

Today osTicket 1.8RC2 has been released. This release fixes some bugs and introduces the following New Enhancements you can read about and download the new version at:
Git Hub

Here is a quick overview of the enhancements:

  • Company information page. Company info is usable in email templates (#104, #134)
  • Admin panel now has inline help tips (#144)
  • System information page in admin panel useful for bug submission (#98)
  • Ticket list page is sorted by effective date (#161, #179)

As a reminder this version is a release candidate and is not intended for production enviornments. Please report bugs at the 1.8 project at github.

osTicket 1.7.3 and 1.8rc1 Released

Today osTicket 1.7.3 has been released and is the fourth stable release of the 1.7 tree. This release fixes some bugs and introduces the following New Enhancements:

  • Ticket thread items are now available for email templates
  • Support MySQL servers on a non-standard port number, which is also not set in the php.ini file
  • FAQ search now hits category names and are sorted by article title now
  • CAPTCHA responses are now considered case-insensitive

Y you can read about the chandes and download 1.7.3 at osticket or github.

Additionally osTicket 1.8 rc1 was also released! This is the first release candidate for the new 1.8 tree and can be downloaded at 1.8 project at github. This version changes osTicket from fpdf to mpdf to enable utf-8 support and includes some bug fixes as well. As a reminder this version is a release candidate and is not intended for production enviornments. Please report bugs at github.

How to Upgrade from osTicket 1.7ST to 1.7.2

Now that osTicket 1.7.2 is out and has been for a little while its time to update the upgrade guide.

Before you start it is important to mention that if you have installed any mods or performed any custom coding (including changing graphics, translations, etc.) that upgrading will not be as simple as it sounds in this article and you will lose all the modifications that you made. You could very well break your site and at the very least lose some of the functionality that you now enjoy.

  1. Put the site into offline mode.

To do this log into your site and navigate to Admin panel -> Settings -> Helpdesk Status and toggle the radial to "Offline (Disabled)", scroll down and click "Save Changes".

note: I personally leave the site open, but navigated back to the Client panel.

  2. Make a back up of your database.

There are various ways to do this and I am not going to cover all of them, but my preferred way is to use command line. You can do this simply by issuing a command similar to:

mysqldump -u userName -p databaseName > fileName.sql

note: change userName to your DB username, databaseName to the name of your DB, and fileName to what ever you want to call the back up file.

Another easy way to do backups (on windows) is to use MySQL Admin (deprecated) or MySQL WorkBench.

  3. Make a back up of your site.

Once again there are various ways to achieve this. I trust that you know how you want to do it, just make sure that you do it.

NOTE: You should never rely on your ISPs automatic backups,
always make your own backups before upgrading!!!

While you are here, you may want to also make a separate copy of your /include/ost-config.php file. This file contains the database connection information.

  4. Download the latest version of OSTicket (v1.7.2) from github.

  5. Extract it to your OSTicket directory. Yes, you can and should have it over write existing files.

  6. re load your web page. When the page loads you should be looking at the image below. Since this is an upgrade you should be looking at the upgrader. This is important to note since the Upgrader looks different from the Installer.

fig 1 – upgrader
click image to enlarge

You should at this point be able to click the "Start Upgrade Now" button. The next screen should look like this:

fig 2 – upgrader, page 2
click image to enlarge

Unless you have a reason not to, go ahead and click the "Do It Now!" button. This should result in a small rectangle popping up in the middle of your screen like this:

fig 3 – upgrader, actual upgrading
click image to enlarge

Once it has completed you should be looking at the following page:

fig 4 – upgrader, upgrade completed
click image to enlarge

Now if you click on the Settings tab you should be looking at the following:

fig 5 – admin panel, version
click image to enlarge

While you are here if you put the site into Offline mode you should put it back in Online mode (don't forget to click Save Changes at the bottom of the page).

Congratulations! You've upgraded from 1.7ST to 1.7.2, however you are not quite finished yet.

  7. Time for post install clean up.

First go into your OSTicket directory and delete [or rename] the setup folder. It is not needed for a live or production site and should never be left on a publicly accessible server. I recommend that you delete it, but some people like renaming it to keep the files around should they need it again. For the record you should not need it again, and if you did you can always just re-download the distribution archive.

Next it's time to delete a few files that OSTicket no longer uses. The list is pretty short and taken directly from the UPGRADING.txt. Please be methodical and double check each file before you delete something. If you are concerned that you might make a mistake you might try moving the files into another folder before you delete them.

    Removed in v1.7.1
      include/class.mcrypt.php
      include/client/thankyou.inc.php
      include/upgrader/sql/*

    Removed in v1.7.2
      include/pear/Crypt/Random.php

That's it for the "hard" stuff. I would at this point recommend that you take another back up of your site (both database and files) since you just made major changes to the site.

As a side note, if you are upgrading from 1.7.1.x to 1.7.2 you will not see the upgrader because there were no database changes between 1.7.1 and 1.7.2.

Enjoy!

N