Upgrading osTicket 1.10.x to current (1.11.0)

So you’re running osTicket version 1.10.x and you want to upgrade it to current which as of this writing is 1.11.0, and you need a little help. Well, you’ve come to the right place.  This version supports PHP version 5.6 through 7.2. I did my upgrade on 5.6, and then later upgraded my PHP to 7.0, and today to 7.2.

If you have ever upgraded osTicket in the past your experience this time will not be much different than it was previously.

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 have made. You could very well break your site or at the very least lose some of the functionality that you currently 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 backup of your database.

There are various ways to do this and I am not going to cover all of them. My preferred way is to use command line. You can do this by simply 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 backup file.

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

  3. Make a backup 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. osticket.com/download.

Note: If you are running any plugins (especially any of the auth plugins), you should also download the new versions of those.

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

Note: If you also downloaded upgrade to your plugins make sure that you put there in /include/plugins at this point.

  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

At this point you should be able to click the “Start Upgrade Now” button. The next screen should look like this:
fig 2 – upgrader, page 2

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

fig 3 – upgrader upgrading

 

 

 

 

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

fig 4 – upgrader, upgrade completed
c

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

fig 5 – admin panel, version
c

While you are here, if you had previously 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.10.x to 1.11.x, however you are not quite finished yet.

  7. Time for post install clean up.

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. This will also get rid of the annoying nag screen at the top of the site.

Next go to your /include folder and make the ost-config.php read only. How to do this varies by OS.

That’s it for the “hard” stuff. I recommend that you take another backup of your site (both database and files) since you just made major changes to the site.

Enjoy!

N

tmib

p.s. the instructions for installing and configuring the LDAP/AD plugin really haven’t changed.

osTicket 1.11.0 Released!

After a long wait the new stable version of osTicket has just been released version 1.11.0.  For the security conscious this is great news since it finally adds support for PHP 7.1 and 7.2.  It also introduces some really useful new features including the long awaited Custom Queues that we saw the preview of back in the 1.11-rc1 (Release Candidate) and the long awaited whole thread template variable.

Here is an overview of all the new features introduced in rc1 and the new stable:

1.11.0-rc1 – Major New Features

  • Create Ticket or Task from Thread Entry
  • Custom Columns/Custom Queues
  • Inline Edit
  • Ticket Referral
  • Support CC (Collaborators)
  • Export Agent CSV
  • Department Access CSV
  • Archive Help Topics/Departments
  • Nested Knowledgebase Categories

1.11.0 – Major New Features

  • Release Ticket Assignment (d354e09)
  • Require Help Topic To Close Ticket (#4400)
  • Disable Collaborators On Reply (#4420)
  • Complete Thread Variable (#4613)
  • Public Mark As Answered/Unanswered (#4612)

The number of bug fixes and enhancements these two releases have is fairly staggering and too long to list here.  Please take a look at the github release notes for those.  They can be found here:

1.11.0-rc1 at:

https://github.com/osTicket/osTicket/releases/tag/v1.11.0-rc1

1.11.0 at

https://github.com/osTicket/osTicket/releases/tag/v1.11

But wait there is more!  They also released a maintenance release for the 1.10 series v1.10.5. The release notes for this are here: 

https://github.com/osTicket/osTicket/releases/tag/v1.10.5