Skip to content

Upgrade

This page covers upgrading MT Showcase 26.x to a newer 26.x release, going back to an earlier release, and moving from MT Showcase 1.x.

Only one version of MT Showcase can be installed on a computer at a time. Installing a new version replaces the old one.

Before you upgrade

  1. Check the release notes for changes that affect you.
  2. Make sure your license covers the new version; see Licensing.
  3. Create a backup and copy it off the application computer. Do not rely on an automatic backup during the upgrade.
  4. Copy the files the backup does not include, if you use them: hosted sites, .auth-kek and, on Windows, production_users.yaml. See File locations.

Upgrade on Ubuntu

Install the new version as described in Install on Ubuntu, for example:

sudo apt update
sudo apt install mt-showcase-<new version>

apt removes the old version and installs the new one. Your data in /var/lib/mt-showcase-server and your /etc/MultiTaction/mt-showcase/server/production_users.yaml are kept. If apt asks whether to replace production_users.yaml, keep your version.

The server restarts with the new version and updates the database automatically.

Upgrade on Windows

  1. Save a copy of C:\Program Files\MT Showcase\server\production_users.yaml if you changed it.
  2. Sign in as the Windows user that runs MT Showcase, and run the new installer; see Install on Windows.
  3. When the installer reports that an old version was detected and asks whether to uninstall it, click Yes. Clicking No cancels setup.
  4. After installation, apply your changes to the new production_users.yaml again and restart the server.

Your data in %APPDATA%\mt-showcase-server, your backups, and the settings you made in the Editor are kept. The server updates the database automatically when it starts.

production_users.yaml is replaced on Windows

Upgrading removes the old installation folder, including your production_users.yaml, and installs a new template. Keep a copy, and prefer the Editor for settings it offers (public addresses, certificate and email).

Upgrade on macOS

  1. Quit MT Showcase and stop the server. If the old server is still running, the new app reuses it.
  2. Drag the new MT Showcase from the disk image onto the Applications folder, and replace the existing app.
  3. Start MT Showcase. Your data in ~/.mt-showcase is kept, and the server updates the database automatically.

Go back to an earlier version

A database that a newer version has updated cannot be used by an older version. To go back, you need a backup taken with the older version, or before the upgrade.

  1. Install the earlier version: on Ubuntu, sudo apt install mt-showcase-<earlier version>; on Windows, run the earlier installer and let it uninstall the newer version.
  2. Stop the MT Showcase server; see Start and stop MT Showcase.
  3. Restore the backup.
  4. Start the server.

Move from MT Showcase 1.x

MT Showcase 26.x replaces the 1.x server, and it does not use PostgreSQL. The supported way to move your content to 26.x is to export it from 1.x and import it into 26.x.

What carries over and what does not:

Carries over (in the export) Does not carry over
Apps, with their structures, themes and service sets User accounts and the 1.x shared Editor password. 26.x uses per-user accounts, created in the setup wizard and by invitation.
The media library Reporting data (data gathering history)
The Codice database Server settings. Set them again in 26.x; see Network, HTTPS and email.

Custom widget or service plugins built for 1.x must be rebuilt for 26.x; see Upgrading to Showcase 26.4.1.

Steps

  1. In the 1.x Editor, open Import & Export and export each app, together with the media library and the Codice database. Save the .showcase files off the application computer.

  2. Install MT Showcase 26.x; see Install on Ubuntu or Install on Windows.

    Ubuntu: installing 26.x removes 1.x

    On Ubuntu, MT Showcase 26.x cannot be installed alongside 1.x. Installing it removes the 1.x package. Export your content first.

  3. Complete the first-run setup and license MT Showcase.

  4. In the 26.x Editor, open Import & Export. Under Import, on the From File tab, click Select Import File and choose each .showcase file. See Import and export.
  5. Open each app in the Editor and run it on the wall to check it.
  6. Invite your designers.