Documentation‎ > ‎


Follow the instructions on this page to install and configure the MCT framework distribution.

The evaluation version does not require configuration.

Software Prerequisites

Before you can configure and run MCT, you must install and configure MySQL Server and Apache Ant. MySQL is used for the MCT database and Apache Ant is used to run the configuration scripts.

  • Java

MCT requires Java 1.6_16 or later. Windows developers need the JDK, as the JRE does not have the necessary plug-in support. The Mac JVM is equivalent to the JDK.

  • MySQL

MCT supports MySQL and Apache Derby. We recommend MySQL Server for mission control operations. You should use version 5.1.48 or later. When you install MySQL, note the username and password for a database user with permission to drop and create databases and users. You will need this information when you configure MCT

Note: The MCT evaluation version includes an embedded Derby database that does not require configuration.

  • Apache Ant

Apache Ant is used to run the MCT database configuration scripts and to start MCT. It is not included in the MCT distribution. Install the Ant tool and make sure it is referenced on your PATH environment. MCT has been tested on Ant 1.7.1 and 1.8.2 (the latest version).

MCT Installation

    1.    Download the MCT platform distribution from here.

    2.    Unzip and untar MCT to a directory of your choice. You should see the following subdirectory structure.

MCT directory structure

MCT Configuration

To configure MCT, you will edit two configuration files, then run an Apache Ant script to create the database user and database.

1.   Edit the file. is a config file that Apache Ant parses when executing MCT configuration scripts. It is located in the root directory of your MCT installation.
  • Set mct.admin_userName and mct.admin_password to the credentials of a database user with permissions to create and drop databases, create and drop users, and grant permissions to users. If you have root access, “root” is fine.
  • Set mct_database_userName and mct.database_password to the credentials of the database user that MCT should use to access the database at runtime. This user will be created when then database is created
  • Enter the name of the database that you want MCT to use.
  • Set mct.database_host and mct.database_port to your MySQL database host and port.
    (These parameters are not required for Derby.) values
You should not need to change the MCT runtime memory.

2.   Edit the /resources/properties/ file. The values entered here tell MCT how to connect to your database.
  • Change the database connection URL to contain the host:port for connecting to the database.
  • Change the database username to the user name you entered in
  • Change the database name to match the name of your MCT database
  • If you are using Derby rather than MySQL for your database, change the last line in the file from persistence/hibernate_mysql.cfg.xml to persistence/hibernate_derby.cfg.xml
3. Create the MCT database.

Run the createDatabase.xml Ant script to create a generic MCT database. You must run this script twice, first with a “create-database-user” argument to create the database user and then again with a “create-database” argument to create the database itself. createDatabase.xml  is run from the command line.
  • Start MySQL if it is not already running.
  • Open a command-line window and change to the MCT install directory (e.g., C:\mct-packaging-1.1.0)
  • Execute the Ant scripts using backslash relative to C:\mct-packaging-1.1.0\bin\createDatabase.xml.
    On the Windows OS platform, use backslashes ("\") instead of forward slashes for the file paths and escape the backslash with a second backslash (e.g., \\).
1.    Run the createDatabase.xml script with a "create-database-user" argument to create the database user.

       Windows OS:  ant -f bin\\createDatabase.xml create-database-user
       Linux/Mac OSX:  $ ant -f bin/createDatabase.xml create-database-user

2.    Run the createDatabase.xml script again with a "create-database" argument to create the database.

       Windows OS:  ant -f bin\\createDatabase.xml create-database
       Linux/Mac OSX:  $ ant -f bin/createDatabase.xml create-database

Launching  MCT

To launch MCT, you will run the createDatabase.xml Ant script again with two arguments, start-mct and the name of the MCT user. By default, the MCT platform ships with an admin user and six test users. The admin can create additional users at any time.

1.    Start MySQL if it is not already running.

2.    Run the createDatabase.xml script with "create-database-user"  and "-Dmct.user=<username>" arguments.

Windows OS:  ant -f bin\\createDatabase.xml -Dmct.user=admin start-mct
           ant -f bin\\createDatabase.xml -Dmct.user=testUser1 start-mct

Linux/Mac OSX:  ant -f bin/createDatabase.xml -Dmct.user=admin start-mct
                  ant -f bin/createDatabase.xml -Dmct.user=testUser1 start-mct

That's it. Welcome to the MCT platform. If you have not done so already, check out the Overview video on the Home page and the Quick Start Guide to help you get started.