Installing Mingle
Introduction
There are three steps to install Mingle:
- Configure a database.
- Download and Install Mingle (this topic).
- Configure Mingle
How to install Mingle for Windows
You must be logged in as a user with Admin privileges to install the Mingle service under Windows.
Installing Mingle for the first time
- Double-click the Mingle installer file and follow the prompts to install Mingle.
-
During installation, Mingle will ask you to:
- select a data directory to store data. This is where Mingle will store project data including configuration files and attachments. It is not the database location.
- select a swap directory to store temporary data. This will act as a tmp space in which to store intermediate data such as project exports (.mingle files) while they are being created, project import files that are being imported, excel import content that is being processed for preview and excel import content that is being processed for import. This is not the database location.
- select a port from which to run Mingle. The default for this is '8080' but you can set it to any port that is not currently being used.
If you have already installed Mingle in selected directory, all Mingle files of this existing instance will be deleted except log files, revision cache and any contents in /vendor/plugins.
-
At the end of the installation, Mingle opens the configuration wizard in your default web browser.
Installed any version of Mingle before
Beginning with 2.3, Mingle allows user to follow Mingle installation process without restarting the computer even though Mingle is already installed.
When you install same or newer version Mingle any existing version of Mingle will be uninstalled.
- If any version of Mingle is already installed and is currently running, the server will be stopped and uninstalled the existing Mingle.
- If any version of Mingle is already installed but server is not running, the existing Mingle will be uninstalled.
-
Uninstalling Mingle involves deleting all related Mingle files except items listed below -
- The data directory and database used
- The activemq-data directory
- The tmp directory - contains cache, project import/export information
- The log directory - contains all mingle log files
- The public directory - contains any custom plugin files (if there are any)
How to install Mingle for Mac OSX
- Double-click the downloaded file to unzip the contents.
- Drag the Mingle icon to the Applications folder.
- Double-click on the Mingle icon to open the launcher.
- From the launcher you can:
- select a data directory to store data. This is where Mingle will store project data including configuration files and attachments. This is not the database location.
- select a swap directory to store temporary data. This will act as a tmp space in which to store intermediate data such as project exports (.mingle files) while they are being created, project import files that are being imported, excel import content that is being processed for preview and excel import content that is being processed for import. This is not the database location.
- select a network port from which to run Mingle. The default for this is '8080' but you can set it to any port that is not currently being used.
- Click the Open browser button to start the configuration wizard in your default web browser.
How to install Mingle for general Unix
During installation of Mingle you will need to set the location of the Mingle data directory (dataDir).
The dataDir is where Mingle will store project data including configuration files and attachments. This is not the database location.
This directory should not be within the Mingle installation folder. To avoid problems with future upgrades, keep these directory separate from the Mingle installation.
Installation steps:
- Move the downloaded unix installer file into the directory where you want to install Mingle.
- Untar the file using tar -xzvf mingle_unix_X_X_XXXX.tar.gz (where the Xs should be replaced with the downloaded file's revision number as shown in the filename).
-
Start the Mingle server and specify the data directory
cd into the Mingle install directory and type:
./MingleServer --mingle.dataDir=/path/to/your/data start
where /path/to/your/data is the location of your data directory.
You will need to be logged in as a user with the appropriate permissions to create the data directory in the location you specify. Otherwise when the Mingle Server starts up, it will not be able to create the data directory or swap directory.
-
Open a browser to the Mingle root.
If you were configuring Mingle on the same machine the server was running on, this would be http://localhost:8080. Open your browser to the correct host and port for your installation.
The browser displays the configuration wizard.
If Safari was used to download the file you may find that the file was already unzipped. If this is the case the file will now have the extension .tar and you can use the command tar -xvf mingle_unix_X_X_XXXX.tar to extract the files.
You may also optionally, set other advanced configuration options when starting Mingle or by editing the mingle.properties file located in the data directory. Refer to the mingle.properties.example file in your Mingle installation folder to see other properties that can be set to configure Mingle. If you do not manually set these options defaults will be used.
How to install Mingle for Solaris
Follow the instructions for installing Mingle on general Unix, with the following exceptions:
- 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.
- Ensure that the MingleServer script in the application directory has execute permissions.
How to install Mingle from the LiveCD
The Mingle LiveCD is a modified Ubuntu 7.10 LiveCD. If you want to install the LiveCD to a HDD, then you should ensure that you have backed up the contents of your HDD before installation. The install process will by default wipe the contents of the HDD and replace them with the installed files (you can override this during the install process). Alternately you can choose to create a separate partition and install the LiveCD into the new partition.
- Make sure there is nothing on the target HDD that you want to keep, as noted above - the install will by default wipe the contents of your HDD
- Ensure that the machine you are installing to has access to the internet, the install will attempt to download the latest Ubuntu patches to ensure any security patches are applied.
- Put the Mingle LiveCD into a bootable CD-ROM drive
- Boot from the CD and double-click on the install icon
- Follow the prompts
-
Open a browser to the Mingle root. In this case it will be http://localhost:4343
The browser displays the Current projects page.
To create and configure your first project, refer to the Quick project setup guide.