Global Settings

The Global Settings page is where the general and database settings for the project server can be configured.

To get to the global settings page, just click Global Settings under Configure on the left menu of the project server page.

Global Settings

On the page that will open you will see that there are two panes in which you can configure: the Global Settings on the upper half of the page and the Database Settings on the lower half of the page. Each will be discussed below.

Configuring mail, servers, ports, and directories

To customize these settings:

  1. Click Global Settings.
  2. Edit the fields you want to customize under the Global Settings pane.
  3. Click Save and Restart.

    Note: Changing the global settings logs you out and restarts Maestro. It might take some time for the application to restart.

Under the Global Settings pane you can configure the settings used generally by the Maestro Project Server. There are four items that can be configured here:

  • Mail: This refers to the settings of your mail server. You will need to setup your mail server in order to be able to send email notifications for your projects builds. This is where you specify the following:
    1. SMTP Server: this is the fully qualified hostname of your email server, such as,
    2. SMTP Port: the port number on which your email server listens, almost always 25.
    3. SMTP Username: typically this is not needed.
    4. SMTP Password: typically not needed.
    5. Send Test Mail From: this is the sender's mail address that is used in the validation email sent to the registering user. By default, the value is set to maestro@[hostname], where hostname is the name of machine that is running Maestro. For example, maestro@machine1.

      Use SSL Connection, Use TLS to negotiate SSL: check these if applicable to your email server. Ask your email administrator if you need them.

    6. Use debug mode: check this if you want SMTP debugging turned on. These data will be stored in the [maestro_home]/projectserver/apps/root/WEB-INF/jetty-env.xml file.
    Project server global settings

    If you want to verify that you are setting the Mail server values correctly, click the Test Mail Settings link. This will display the Mail Tester page, where you can enter the values and send yourself a test email.

    Mail tester

    Enter a recipient in the Send Test Mail To text box. Click Send Test Mail and then check the recipient's inbox to see if you received the message. If you have received the message, then your settings are correct and you can use them on the Global Settings page.

    Note: This feature only works for SMTP configurations without SSL or TLS.

  • Servers: This refers to the location or machine where you installed and run Maestro. The default Base URL that is used is http://localhost:8080, but you can also specify another URL for your project server.

    The data will be stored in the [maestro_home]/projectserver/conf/maestro.xml file.

    The baseUrl configuration in maestro.xml precedes the application.url configuration in

    After Maestro restarts, if you changed the Base URL, you will have to browse to the new location. If you modified the hostname in the settings, for example from localhost to that of another machine called computer1 in your network, you will notice in the address bar of your browser that the URL now uses the new hostname:


    If you wish to change the port number as well, you have to change the value in the HTTP field with the new HTTP port number, too.

  • Ports: This refers to the different ports that are being used for some services of the project server.
    1. HTTP: This is the port on which the Maestro Project Server is listening. By default it listens to port 8080. You can change this in the field provided. This is further discussed in Port Configuration section.
    2. SLP: The Service Location Protocol (SLP) answers requests from Maestro Developer Clients, typically looking for a project server from which to download a settings.xml file. By default this is set to 8427. More about SLP is discussed in the Livetribe Service Location Protocol section.
  • Directories: This refers to the different directories used by the project server. These data will be stored in the [maestro_home]/projectserver/conf/maestro.xml file.
    1. Data Directory: This is where your data and database is stored. This directory should be backed up prior to an upgrade of Maestro.
    2. Integrated Sites Directory: This refers to the location where the deployed sites will be stored on the server. Sites will be accessible by a browser:


      If you have just installed Maestro, you probably do not have any project sites set up, so you will see an empty page here.

    3. Backups Directory: this is where the Backup and Restore feature will store the backups of your site specific data.

Configuring the user database and the builds database

Under Global Settings the Database Settings can be configured to set the databases that are being used by the project server:

  • Users Database: This refers to the database for the user accounts. You can use the embedded database or opt to specify a different database.
  • Builds Database: This refers to the database for the different projects and builds of each project. You can also opt to use a different database other than the one embedded in the MPS.

For details on configuring the databases please see Maestro Databases below.

Project server database settings