Troubleshooting Mingle Installation and Upgrade

Introduction

The following sections will guide you through some common installation and upgrade issues, suggesting possible problems and ways to resolve these issues.

If you are unable to resolve your issue please contact Studios Support who will provide further troubleshooting assistance.

Unable to Start Mingle

If you see the following message before Mingle has started this may be caused by an incorrect system set-up. Please refer to Mingle's system requirements to ensure your system is set-up correctly.

Possible cause: Incorrect Java version

This issue may be caused by running Mingle on a machine with an incorrect Java version. Currently Mingle only supports Java 1.6 (JDK 1.6).

All existing customers running the Mingle server on Mac OSX and General Linux/Unix using Java 5 (JDK version 1.5) will need to upgrade to Java 6 (JDK version 1.6) before upgrading to Mingle 3.3.

How to check your Java version

Mingle's Windows installer is packaged with it's own version of Java so this issue is more likely to occur on system's running Mingle from the Unix installer.

To confirm what version of Java you're run on your Unix based computer, execute java --version in the terminal.

How to resolve this issue

To upgrade to Java 6 on a Linux machine

Unfortunately there are too many variants of Linux for us to present accurate instructions for installing Java 6 on your particular distribution. However, Sun/Oracle Java 6 is definitely available for most all distributions of Linux. If you Google for "Install Sun/Oracle Java 6 [your linux distribution]" you should easily find clear instructions. Be sure to install Sun/Oracle Java and not an alternative. (We realize that Sun Java is now Oracle Java, but many Linux instructions and package repositories still refer to it as Sun Java.)

After installation of Java 6, be sure that PATH, symbolic links, start scripts and such are properly configured such that Mingle will be using Java 6 and not Java 5.

To change to a different version of Java on a Mac OS X machine

Use to SpotLight search for "Java Preferences"
Drag Java 6 to the top of your list of Java versions
Restart your terminal
Try to start Mingle again

Possible cause: Incorrect database

This issue may be caused by running Mingle on a machine with an unsupported database such as MySQL.

Please refer to Mingle's system requirements to find out which databases are supported. Mingle no longer supports MySQL. Please refer to Mingle's database migration help to research options on upgrading from MySQL.

How to resolve this issue

Please refer to Mingle's system requirements and how to configure a database to run with Mingle to ensure your system is set-up correctly.

Possible cause: GEM_HOME and/or GEM_PATH environment variables are set

This issue may be caused if you are using the general unix/linux build of Mingle on Linux or OS X and start Mingle in a shell with either GEM_HOME or GEM_PATH set as environment variables. This issue will particularly impact machines which have the RVM tool installed for purposes of managing multiple versions of Ruby.

If you are having this particular issue, you will see a stack trace along these lines in the mingle.log file:

      java.lang.RuntimeException: java.lang.RuntimeException: java.lang.NullPointerException
        at com.thoughtworks.mingle.G.A(Unknown Source)
        at com.thoughtworks.mingle.RuntimeStatusServlet.init(Unknown Source)
        at org.mortbay.jetty.servlet.ServletHolder.initServlet(ServletHolder.java:431)
        at org.mortbay.jetty.servlet.ServletHolder.doStart(ServletHolder.java:263)
        at org.mortbay.component.AbstractLifeCycle.start(AbstractLifeCycle.java:50)
        at org.mortbay.jetty.servlet.ServletHandler.initialize(ServletHandler.java:676)
        at org.mortbay.jetty.servlet.Context.startContext(Context.java:140)
        at org.mortbay.jetty.webapp.WebAppContext.startContext(WebAppContext.java:1239)
        at org.mortbay.jetty.handler.ContextHandler.doStart(ContextHandler.java:517)
        at org.mortbay.jetty.webapp.WebAppContext.doStart(WebAppContext.java:466)
        at org.mortbay.component.AbstractLifeCycle.start(AbstractLifeCycle.java:50)
        at org.mortbay.jetty.handler.HandlerCollection.doStart(HandlerCollection.java:152)
        at org.mortbay.component.AbstractLifeCycle.start(AbstractLifeCycle.java:50)
        at org.mortbay.jetty.handler.HandlerWrapper.doStart(HandlerWrapper.java:130)
        at org.mortbay.jetty.Server.doStart(Server.java:224)
        at org.mortbay.component.AbstractLifeCycle.start(AbstractLifeCycle.java:50)
        at com.thoughtworks.mingle.Server$1.run(Unknown Source)
      Caused by: java.lang.RuntimeException: java.lang.NullPointerException
        at com.thoughtworks.mingle.rack.D.getApplication(Unknown Source)
        at com.thoughtworks.mingle.rack.C.getApplication(Unknown Source)
        at com.thoughtworks.mingle.rack.C.borrowApplication(Unknown Source)
        at com.thoughtworks.mingle.G.B(Unknown Source)
        ... 17 more
      Caused by: java.lang.NullPointerException
        ... 21 more

How to resolve this issue

Before starting Mingle in the terminal, type:

unset GEM_HOME GEM_PATH

Need more help?

There are a variety of different ways to get help and information about administering and using Mingle:

Explore Mingle - use Mingle's "Explore Mingle" pages to guide you to help about Mingle's capabilities and features
Search Mingle help - use Mingle's online help search to find the specific help pages you need
Contextual help - use Mingle's inline contextual help to learn more about the view or admin page you're using
Contact Support - contact the Studios Support team for expert product advice and support
Studios Community - get access to the knowledge and help of the larger Mingle community at the Studios Community

Help documentation