Theatre Manager Desktop Application

Installing or Updating??

Installing or Updating Theatre Manager is a similar process. If you do not already have the latest TM installer, you can obtain in one of three ways:

  • If you have Theatre Manager, you can check to see if an update is available which you can copy to any machine, even one without TM on it.
  • If TM notices an out-of-date component, it downloads the latest installer while you work and prompts for an update when you log in.
  • If you are new to Theatre Manager, you will have been provided a link in an email

Once you have the latest available version of the Theatre Manager installer/updater, please follow the specific instructions for:

  • Macintosh - macOS 11 Monterey and later recommended - MacOS 12 Big Sur and later will work with 64 bit -or-
  • Windows - Windows 11 recommended - Windows 8.1 or later will work for 64-bit
  • using the General Upgrade Steps as an overall guide.

 

If you set the PCI setting in Theatre Manager 'C', credit cards are never placed in the database. Thee card information is merely passed to the processor and immediately forgotten.
Running an upgrade will, if appropriate, automatically generate a random new PCI seed key and re-encrypt credit cards using the new key. In the process, this destroys any previous crypto keys per PCI DSS standard 3.6.

Credit cards that have been shredded are not affected by the re-encryption process.

Refer to re-encrypting cards if you wish to do this manually.

Theatre Manager has never stored CVV2, Track II or any other non PCI compliant information so removal is not necessary per PCI DSS standard 3.3.

  • Version 8 was certified under PABP 1.4. This audit provided verifiability that there was no CVV2 data.
  • Version 9 was certified under PA-DSS 1.2, also verifying there was no CVV2 data.
  • Version 10 was certified under PA-DSS 2.0, also verifying there was no CVV2 data
  • Version 10.6 was certified under PA-DSS 3.1, also verifying there was no CVV2 data
  • Version 11.0 was certified under PA-DSS 3.2.1, also verifying there was no CVV2 data
  • Future versions will never have any protected data as per PCI requirements.

Macintosh Theatre Manager

Now that the database server is setup and a sample database is imported, we can install Theatre Manager on the machine. These instructions are for installing on Macintosh. If you are using a mixed environment, please refer to the Windows instructions as well.
During a Full Install you will need to provide the administrator password to your machine. If you do not know this, contact your IT support or Systems Administrator.
You may need to go to Apple Menu >> System Preferences >> Security & Privacy to allow apps that are downloaded from anywhere.
If you are unable to install, you might need to use the following command in terminal before running the installer More info is under disable power saving settings - Step 1:

sudo spctl --master-disable

1. Download the Theatre Manager Mac installer if you have not done so. This link is supplied upon request.
When downloading any update for Theatre Manager, please make sure your personal firewall is turned on PCI requirement 1.4
2.
  • Double click on the TMSetup.zip program you downloaded to extract the TheatreManager.pkg file.
  • Double click on the TheatreManager.pkg that was just extracted to begin the install process and respond to the prompts as follows
In recent versions of macOS, you may need to make a change in System Preferences after attempting to run the installer the first time before it will work.

Click continue

Click continue and read the license agreement

Click 'Agree' to accept the agreement and continue

Click Install

Enter your password (or if you have a Mac with Touch ID, use your finger)

Click 'Close' when done.

3. After installation, look for Theatre Manager link on the desktop and double-click on it to start it up. There will also be a file called TMPreview.pdf on the desktop that illustrates some key features of TM.
4.
For databases on your local server: enter the IP address of your server and click search to see the list of databases.
If your real database is in the AMS cloud, follow these instructions.
For Demo databases: If you get asked to find a database, enter the IP address 127.0.0.1 below and click Search. Normally, you should not need to do this, as the Demo database is always assumed to be on the local machine.

If you cannot connect to the database, check the following settings:

  • make sure port 5432 is open on your machine
  • make sure that the TheatreManagerDemo database got installed by using pgAdmin as per the section below, then come back and try connecting again.
5. (optional) If you are running a demonstration copy of Theatre Manager, you will see a first time setup screen asking you for your company information. All fields except the second line of address and the web site are mandatory. After you put this in the first time, you will not see it again.

These fields are used during the demo to show how Theatre Manager verifies information for you. For example, the city, state and country you enter becomes the default country for new patrons that you may add to the database. The area code for the phone number fields becomes the default for patron entry, etc.

Notice how Theatre Manager converts whatever you type into the proper case as it tries to assist in data entry.
6. Then, if you are able to connect to the database and enter the company information, you will see the login window below. The password for any of the users in the demo is 'master' (without the single quotes).
7. (Optional) if you are running Catalina, you may need to make a change to system preferences to allow permission.
  • Open System Preferences
  • Click on the Security & Privacy preferences
  • Click on the Privacy tab
  • click on Input Monitoring
  • Unlock the preferences to allow changes
  • Click on the checkbox beside Theatre Manager to enable the permission
8. In a production environment, once connected to the database in step 5, you can run the TMSetup file on any other machine in the network. After changing the pg_hba.conf file, and by editing the serial.txt file, you should be able to connect to the database.
You will need to use the IP address of the server to connect, instead of 127.0.0.1, and if you cannot connect to the server:
  • make sure port 5432 is open on the server
  • make sure that the real database is installed and setup using pgAdmin
  • there are no firewalls blocking access
  • the pg_hba.conf IP settings are correct and the server has been restarted

Windows Theatre Manager

Now that the database server is setup and a sample database is imported, we can install Theatre Manager on the machine. These instructions are for installing on Windows. If you are using a mixed environment, please refer to the Macintosh instructions as well.
During a Full Install you may need to:
  • provide the administrator password to your machine. If you do not know this, contact your IT support or Systems Administrator
  • Disable anti-virus software temporarily and/or provide an exclusion for the c:\Program Files\TheatreManager directory.

1. Download the TheatreManager PC installer if you have not done so. This link is supplied upon request
When downloading any update for Theatre Manager, please make sure your personal firewall is turned on PCI requirement 1.4
2. Run the TMSetup.exe program and respond to all prompts as follows.

Click 'Next'

Read the licence agreement and click 'Yes' to agree to its terms and conditions

Click 'Next'

The installer will begin putting Theatre Manager into the 'C:\Program Files' folder.

Click 'Close'

3. After installation, look for a TheatreManager icon on the desktop or in the Start Menu and open Theatre Manager
4.

If you get asked to find a database, enter the IP address 127.0.0.1 below and click search. Normally, you should not need to do this as the Demo database is always assumed to be on the local machine.

If you cannot connect to the database, check the following settings:

  • make sure port 5432 is open on your machine
  • make sure that 'everyone' has access to all files in the 'C:\Program Files\Theatre Manager' directory
  • make sure that the demo database was installed by using pgAdmin as per the section below... then come back and try connecting again.
5. (Optional) If you are running a demonstration copy of Theatre Manager, you will see a first time setup screen asking you for your company information. All fields except the second line of address and the web site are mandatory. After you put this in the first time, you will not see it again.

These fields are used during the demo to show how Theatre Manager verifies information for you. For example, the city, state, and country you enter becomes the default country for new patrons that you may add to the database. The area code for the phone number fields becomes the default for patron entry, etc.

Notice how Theatre Manager converts whatever you type into the proper case as it tries to assist in data entry.
6.

Then, if you are able to connect to the database and enter the company information, you will see the login window below. The password for any of the users in the demo is 'master'

7.

In a production environment, once you are connected to the database in step 5, you can run the TMSetup.exe file on any other machine in the network. After changing the pg_hba.conf file, you should be able to connect to the database.

You will need to use the IP address of the server to connect instead of 127.0.0.1 and if you cannot connect to the server:
  • make sure port 5432 is open on the server
  • make sure that 'everyone' has access to all files in the 'C:\Program Files\Theatre Manager' directory
  • make sure that the real database is installed and setup using pgAdmin
Make sure to also turn off power saving on your ethernet card on all servers and workstations.