Upgrading from Mingle 2.0

Before you get started

If you are currently using the LDAP plugin with Mingle, please note that the format of the file has changed since the 2.0.1 release:

It is no longer necessary to copy the LDAP plugin directory to vendor/plugins in order to install

A new requirement is that the authentication type must be explicitly specified in the config/auth_config.yml file:

  
              authentication: ldap
              ldap_settings:
                ldapserver: ...
                ...

If you have enabled basic authentication, and wish for basic authentication to use the LDAP plugin, you must also explicitly state the basic_authentication type:
```
  
              basic_authentication_enabled: true
              basic_authentication: ldap
              authentication: ldap 
              ldap_settings: 
                ldapserver: ...
                ...
            
```
Please look at the README file at <mingle_install_dir>/vendor/plugins/ldap_auth/README or online Mingle help at http://studios.thoughtworks.com/mingle/2.1/help/mingle_ldap_authentication.html for further detail.

The upgrade to 2.1 involves migration of your existing data which is a very sensitive process. We strongly recommend that you make a backup of the Mingle data directory and your database before starting the upgrade process. DO NOT SHUT DOWN THE SERVER IN THE MIDDLE OF THE UPGRADE PROCESS AT ANY COST.
ANY TEMPLATES THAT WERE INSTALLED WITH THE PREVIOUS RELEASES WILL BE REPLACED. This has no impact on any of your existing projects or any templates that you have created yourself. If you have modified the pre-installed templates and wish to keep them you must export them and then import them using a different name before the upgrade.
The Mingle database will be upgraded and any projects in your 2.0 database will be upgraded and fully usable as soon as you start a newly installed 2.1 Mingle server.
Any old project export files (.mingle files) can be directly imported into the 2.1 version of the application. They will be automatically upgraded upon import.

These instructions are for upgrading from Mingle 2.0 to Mingle 2.1. Look here to see how to upgrade from Mingle 2.0.1. Upgrades from earlier versions, specifically, 1.1, 1.0 and any Early Access releases, are not supported.

Installing the software

Windows

Note the location of the Mingle data directory and the port on which Mingle is currently running. Typically, the Mingle data directory is in your home directory (C:\Documents and Settings\[username]\Mingle) and the port is 8080.
Run the Mingle uninstaller to remove your current installation. The uninstaller will stop the Mingle service if it is currently running.
Run the new installer, specifying the same data directory and port as the previous installer. The installer will automatically start the new Mingle service when it completes.
Open your browser to any Mingle page. You will be walked through the upgrade steps. All existing project data will be upgraded for continued use.

OS X

Note the location of the Mingle data directory and the port on which Mingle is currently running. These are both visible from the Mingle launcher application window.
Stop Mingle and quit the Mingle launcher application.
Drag the new copy of the Mingle application (Mingle.app) into your Applications directory (overwriting the old Mingle).
Start Mingle, specifying the same data directory and port as before.
Open your browser to any Mingle page. You will be walked through the upgrade steps. All existing project data will be upgraded for continued use.

Linux/Unix (except Solaris)

Note the location of the Mingle data directory and the port on which Mingle is currently running. These are contained in the mingle.properties file in the 'mingle' application directory.
If the Mingle server is currently running, stop it using the './MingleServer stop' command inside the 'mingle' application directory.
Untar the newly downloaded archive.
Update the mingle.properties file in the new 'mingle' application directory to point to the previous data directory and port. (If you've backed up the old 'mingle' application directory, you can simply copy the file.)
Start Mingle, using './MingleServer start' inside the new 'mingle' application directory.
Open your browser to any Mingle page. You will be walked through the upgrade steps. All existing project data will be upgraded for continued use.

Solaris

The steps to install on Solaris are very similar to that on any other UNIX except

You would use the UNIX zip installer rather than the tar.gz installer due to the fact that the default Solaris tar command is incompatible with the format with GNU tar.
You will have to ensure that the MingleServer script in the application directory has execute permissions.

After installation is complete...

Formula properties which use Aggregate properties

Mingle 2.0.1 fixed a gap due to which it was possible to create a Formula property using Aggregate property types. This means that if you had created any such formulae, they will be deleted on upgrade. Any Mingle charts and tables that used these might will work anymore. You may go in and recreate the formula without using any Aggregate properties.

Using LDAP for authentication

The authentication settings for Mingle are controlled through the [mingle_data_directory]/config/auth_config.yml file. This file is created by default on all brand new installations. These settings mostly pertain to LDAP integration. For a detailed explanation of what the various properties of this file represent, you can read the LDAP authentication README file included with this distribution. The location of this file varies by distribution.

On OSX

Right click the Mingle application bundle and select 'Show package contents'
Once the Finder window opens, navigate to Contents/Resources/app/plugins/ldap_auth
The README file here contains details of how to configure the LDAP authentication plugin

On Unix

Navigate to the unizipped/untarred folder that contains the MingleServer script.
Under this directory, locate the plugins/ldap_auth directory
The README file here contains details of how to configure the LDAP authentication plugin

On Windows

Navigate to the directory where you installed the application (typically C:\Program Files\Mingle-2_0_1)
Under this directory, locate the plugins/ldap_auth directory
The README file here contains details of how to configure the LDAP authentication plugin

Setting password format restrictions

If you would like the password format for all your users to be a combination of numbers, letters and punctuation, and enforced strictly, set

password_format: :strict

The default, which is empty, places no restrictions on formats of the password.

Help