Setup source repository integration

Your source files should be encoded in UTF-8 in order for Mingle's integration to work properly. Otherwise you may see odd characters showing up in the Mingle Source tab as Mingle is unable to decode the file correctly.

Getting started

To connect your project to your source repository, select the Project admin tab, Project repository settings link. Mingle will display the Configure project repository page

Select a version control system from the list presented

Then follow the instructions below to configure integration with your chosen repository

Subversion source integration

After choosing Subversion from the source repository list, Mingle will display the Subversion Repository settings page

Enter the URL for your subversion repository. Most standard SVN URL schemes are supported by Mingle 2.0, including local file access if the repository is located on the same filesystem as Mingle. New in 2.0, Mingle can integrate your project with a subdirectory of your SVN repository. This allows Mingle to work better with multi-project SVN repositories.
If your repository requires username and password authentication, be sure to enter that information as well. You must first click the Change login user password to enter a new password.

Subversion repository settings page - user password

Click the Save link to save the configuration and return to the Project admin page

svn+ssh key pair authentication

If you wish to use ssh key pair authentication (via an svn+ssh URL), please add the below code to the config/environment.rb file in your Mingle installation directory. At this time, Mingle supports only one key pair for use across all projects.

          java.lang.System.setProperty("svnkit.ssh2.key", "/path/to/private/key");
          java.lang.System.setProperty("svnkit.ssh2.username", "your_username");
          java.lang.System.setProperty("svnkit.ssh2.passphrase", "your_passphrase");

Perforce source integration

Before you can configure Perforce, you will have to make sure have the Perforce command line client, p4, installed on your machine. Once this is installed, and you can execute Perforce commands using it from the command line, you must enter the complete path to this file in the perforce_config.yml file in the Mingle data directory. Once this is done, you can continue with the rest if the steps in this section.

After choosing Perforce from the source repository list, Mingle will display the Perforce Repository settings page

Enter the depots that you wish to connect to. If you have multiple depot paths, separate each path with a space.
Enter the hostname or ip address of the Perforce server
Enter the port of the Perforce server
Enter the username/password to connect to the Perforce server. You must first click the Change login user password to enter a new password.

Perforce repository settings page - user password

Click the Save link to save the configuration and return to the Project admin page

Checking that source repository integration is working correctly

To verify that the source repository integration is correctly configured, open the Mingle Source. You should see a series of links that represent the subdirectories within your source repository. You can drill down inside these links to find specific files.

Within a few minutes of saving your new source configuration you will start seeing revisions in your project history. You can use the card keywords feature to integrate your revisions with individual Card history. You can change these keywords at any time and the revision-to-card links will be completely rebuilt, starting with the first revision. If you start with a working or legacy repository, you can tweak the keywords to match any patterns you may have used in those older commit messages.

Help