Version 7.32.00

This version is a complete revision to Theatre Manager that contains changes for OS-X Leopard interface compatibility and Vista interface. As such, it is a significant release - please read all release notes before installing

There have also been the usual number of enhancements and fixes in response to user requests.

Version 7.29 Updates

Released June 17, 2008

Key changes:
  • Improvements in Leopard Interface compatibility
  • Improvements in Vista install capability
  • Fix for web sales to prevent apache restarting if a server gets overloaded
  • Imporovements in word processing processes
  • Addition of search for primary/non-primary patron to mail lists and reports
  • Improved PABP compliance tracking

There are is one mandatory web change for this version - a new Apache Loadable module must be installed, changes should be made to the configuration file and 3 web pages must be put in place.

note: If running G4 mac mini web listeners at 10.4.11, you may need to upgrade the OS to 10.5.3. We've seen a couple mac minis that needed upgrading and some that do not in our beta testing.


Preparing for the Update

Theatre Manager will

The user will need to

Before upgrade
  • Read the release notes for any prior version and follow those directions, if applicable
  • Stop web sales and close all shopping carts.
  • Complete your end of day. Deposit all funds, create all sales entries and post to the GL.
  • Verify the database using data utilities and ensure that everything is ok.
  • Make a backup copy of the database
  • If running web sales on a Mac Mini - you may need to upgrade it to OSX 10.5.3. The web listener component runs on some (but not other) PowerPC G4 for some reason. Upgrading to 10.5.3 has corrected the issue on those that did not run.
  • If making changes to the web pages, make a backup of the web pages before changing any pages.
  • (optional) verify the credit card fees are correct in code tables for each credit card payment type and set those up.
After Upgrade
  • This upgrade requires that you install on each machine
  • If you are using web sales, you will need the latest TM apache module. To do so:
    • Download the file above and unzip the contents
    • Stop your apache server
    • Place the correct file from the zip archive into the correct directory for your platform in the Apache 'modules' folder and restart apache server.
      • WINDOWS: This is located in C:/Program Files/Apache Software Foundation/Apache2.2/Modules
      • MAC OSX: This is located in /Library/Apache2/Modules
    • Make the changes to the configuration as suggested below in the 'Web Section'
    • Put the 3 page changes in place as suggested below in the 'Web Section'
    • Restart the apache server
  • Always verify that your web listeners are running after any minor or major upgrade. TM automatically stops them when it notices a new version.
Optional Steps
  • Restore (manually) any toolbar preferences that you need to restore.
Time Required
  • A short time if you are version 7.19 or later

7.32.00 Changes & Enhancements

Interface

Reports

Form Letters

Tickets Sales

Donations

Miscellaneous

Web

Implementing the changes to the apache module and web listeners:

Step 1

The items below are the tail end of a sample httpd.conf file. You can make changes to this file while apache is running. The items in red will either need changed or added to the apache httpd.conf file. Items with the '#' in front of them are comments that you can add if you wish. In general, the comments and code changes should probably be exactly as is. The Blue line is commented out to avoid an error in the apache log. Just put a '#' & space in front of it.

After changing the httpd.conf file, restart apache. If it restarts fine, then the configuration change were ok.

# specify a default page in $DocumentRoot/{Dep#} for# when no listeners are running
SetEnv TM_CLOSED_PAGE TMsysNoListeners.html
# when all listeners are busy
SetEnv TM_WAIT_PAGE TMsysBusyListeners.html
# errors not handled by above - probably a timeout in a long running query
SetEnv TM_ERROR_PAGE TMsysErrorListeners.html

# specify the time in seconds TM is to wait when all listeners are busy
# before returning the page to the user specified in TM_WAIT_PAGE
# This page should be designed to tell the user you are busy and to try again.
SetEnv TM_WAIT_TIME 30

# specify the time in seconds TM is to allow the listeners to process a
# reuest before it will give up and return the page specified in TM_ERROR_PAGE.
# This should be long enough to allow the longest transaction to process
# on the slowest web listener in your stable and then a bit more
SetEnv TM_PROCESS_TIME 45

# export all variables so that they are passed to the modules
# PassEnv TM_LIB TM_CLASS TM_LISTENER_MASK TM_CLOSED_PAGE TM_WAIT_TIME

Step 2

Copy the 3 web pages contained in the downloaded apache file into the same folder as the 'WebPage' folder. i.e. put them in htdocs/1 folder, not in the htdocs/1/webpages folder. You may wish to edit the contents of the pages to handle closed, waiting and error conditions as described above. Generally what is in the enclosed template files should be sufficient. The files are:

  • TMsysNoListeners.html - this page is displayed if there are no listeners running and should simply be used to indicate to browsers that the online system is down.
  • TMsysBusyListeners.html - this page is displayed if no listeners are available after the TM_WAIT_TIMEOUT. Since it is displayed under conditions of high load, you could use this to indicate to the user that they've been dropped into a 'waiting room' or temporary place and that they should try again soon. This page protects both the user and the web listeners from overload conditions.
  • TMsysErrorListeners.html - this page is displayed for other conditions that are not handled by the above two conditions. Generally, you will get it if the listeners take longer than the TM_PROCESS_TIME to handle requests. In those cases, it simply means that apache gave up waiting for the listeners to respond.
Step 3

Up to now, the new functions have been set up ready to go, but are not effective yet. They will once apache is restarted. Now you need to:

  1. stop apache
  2. go to the htdocs/modules folder
  3. copy the new module into place
  4. go into the logs folder (in apache)
  5. throw out all the logs
  6. restart apache
  7. try hit a your main 'tickets' page to make sure everything is working