You are here

10.06 Upgrade Steps

Subscribe to Syndicate
The underlying technology for Theatre Manager has not changed. However, there have been upgrades to postgres and apache that may make this seem like a full install. Depending on your environment, it may not take long to do. The steps are repeated here for an overview.

Also, if you meet a number of prerequisites, you may be able to take the fast track which only needs Theatre Manager installed on each workstation, resulting in a 10-20 minute update process.

 

Take the easy path...

If you meet all of the following pre-requisites, you can take the fast track/easy path on the right of the diagram.

  • Your version of Postgres is
    • 9.5.4 or later, or
    • 9.4.9 or later, or
    • 9.3.14 or later
  • Your version of Apache is 2.4.18 with OpenSSL 1.0.2g
  • you have had your SSL re-issued with SHA2 encryption in the past 6 months
  • Your web pages are:
    • responsive pages and you already have google analytics set up, or don't need it yet.
    • the older traditional web pages and you don't want to update them at this time
    • You don't mind updating web pages later
The easy path means that all you should need to do is follow the steps on the web page describing how to download and install Theatre Manager.

In general, you should be able to install V10.06 on top of 10.05, 10.04 or 10.03 and it should work with your current web pages. There have been minor (not required) updates to responsive pages, so we suggest putting those in place with Apache updates at any time before, during or after updating to 10.06 - the changes are independent.

Always test a complete web sale and checkout after an update.

 

More than just Theatre Manager requires updating

The last major update was 18 months ago. There may be additional steps required if a simple update cannot be done. You many need to do one or more of the following:

  • Stop all services
  • Upgrade Postgres
  • Upgrade Theatre Manager
  • Upgrade Apache Server
  • Upgrade Web Services
  • Update web pages
  • Start all services

 

Upgrading Postgres

If you are using Postgres 9.3.8 or earlier, or 9.4.3 or earlier, then you must update the postgres database server. If you are at more recent versions (but not the latest) you can skip this step, or update if you wish. You will need to:

Contact us if your venue has been set up with streaming replication server. Do not attempt to update the database server..

Upgrade Theatre Manager

After the database sever is updated (if needed) follow the standard instructions to download and install Theatre Manager. Upgrading Theatre Manager automatically upgrades web services.

Optionally, you can install the following version 10.05 at any time on all workstations PRIOR to updating to version 10.06. They contain all the latest components that version 10.06 requires. If you do this, then Version 10.06 becomes a push out install for the machines where you physically ran the installers below.

Upgrade Web Services

Since the Theatre Manager server is paused, then automatically updates itself after updating Theatre Manager at a workstation, most upgrades can skip this step. However, there is one significant change for those venues running multiple outlets. If you have multiple outlets, you will need to:
  • Open System preferences->Web Options for all outlets and enable (or disable) the Enable Web Sales option. You must have all web pages directories in place on the Apache server for each enabled outlet AND language combination, otherwise the classic server will not start.
  • Open the Director and reconfigure the number of classic servers. In a single outlet situation, this will not change from before. In a multi-outlet server, you previously needed at least 1 server per outlet where as you may be able to have fewer set up. The number depends on load at each outlet and use of plugins. Generally, this number should be the same as the number of second generation listeners.

The classic listener service is now outlet aware.

You must have web pages for each language and outlet that is enabled - otherwise the classic listener will not start

Upgrade Apache

Updating Apache and updating TM are independent actions. You can do one or the other in any order. For this version, we suggest updating TM and resume normal operations -- and then update apache/openSSL after all systems are online.

Updating Apache to latest version installs Apache 2.4.17 with openSSL 1.0.2e. Since most venues currently using Apache 2.4.16 with openSSL 1.0.2d, and latest web pages, it is a small update, so be done at any time. Consequently, you can take two approaches:

  • If you are using Apache 2.4.16, skip the update temporarily. Simply update TM and do the openSSL upgrade at some later time
  • If you have an older version of apache, you can update TM now and get things online. However, we'd suggest doing the apache update in the very near future or as part of this update.
Regardless of when Apache is updated in the process, you will need to:
  • Change the conf/extra/httpd-balance.conf file and look for the line containing SSLProtocol. It needs to eliminate the use of TLSv1 and TLSv1.1 as well as SSLv2 and SSLv3. The line is automatically set in the latest apache update - and can be done manually as below and is best done immediately.

    SSLProtocol ALL -SSLv2 -SSLv3 -TLSv1 -TLSv1.1

  • If your SSL certificate has not been reissued to have SHA2 encryption, that will need to be done at some time in the future.

Updating Web Pages

Most venues have already updated to the responsive web pages. There are sufficient benefits in using the responsive pages such as:
  • cleaner and more modern interface,
  • updated technology and html5 page compliance, and
  • better online search page rankings by google

Updating pages is a matter of:

  • downloading the latest web page updates
  • compare the web pages to your existing pages. a number of minor tweaks have been made to the responsive pages. We suggest replacing all the standard ones - but you can probably use the existing ones just fine.
  • Configuring use of Google analytics by opening Company Preferences->Web Listener tab and entering your Google Analytics Account number if you are using google analytics. The web pages have been changed to recognize the existence of this value. If entered, analytics automatically starts.

There is NO REQUIREMENT to use the responsive pages despite a recommendation to do so.

You can still use the older web page design if you prefer. However, beginning with Version 10.06 of Theatre Manager, we will no longer be providing updates to those older style pages and all new features will be provided in the responsive pages only.

If you are not using responsive pages, we would be more than happy to help you convert - please just ask.