MasterControl Client Configuration

Welcome to MasterControl

In order to make your experience as smooth and hassle-free as possible, we have provided a few tips to help make sure that your system is ready for MasterControl.

By clicking the links below, you can expand each section to learn more about necessary configuration and browser settings.

• Check your minimum requirements

  Follow these steps to check minimum requirements to make sure that MasterControl runs smoothly on your machine.

  1. Access Properties by one of these methods:

  1. • Click the Start icon > Computer > System Properties

  OR

  • • For Windows 8 or later, click This PC > Properties

  2. Verify that your machine meets these minimum requirements:

  • • Windows 7 or higher

    • 1.6GHz (or faster) processor

    • 1 GB RAM

    • 500 MB free hard drive space

• Check your Java version for compatibility with RouteBuilder and Organizers

  Follow these steps to make sure you are running Java 1.7.55 or later (or 1.8.45 or later - only required for users creating/editing routes or Organizers), and to check your temporary file settings:

  1. Access Control Panel > Programs.

  2. Click the Java icon to open the Java Control Panel.

  3. On the General tab click the About... button and verify that you are running Java 1.7.55 (or 1.8.45).

  4. On the General tab, in the Temporary Internet Files section, select the Settings... button, and make sure that the checkbox for Keep temporary files on my computer is unchecked.

• Set up your browser(s)

  For all browsers, add the URL to MasterControl as an exception to the browser's pop-up blocker. Then expand the links below to see each browser's necessary settings.

  • Internet Explorer

    MasterControl supports Internet Explorer versions 10 and up. Make sure that Compatibility Mode is disabled.

    Tabbed Browsing Settings

    1. 1. Select Tools > Internet Options.

       2. For IE 10 & 11 - On the General tab, in the Tabs section, click the Tabs button.

       3. In the Open links from other programs in: section, select A new tab in the current window.

       4. Click OK.

    To turn off Compatibility Mode

    1. 1. Select Tools > Compatibility View Settings.

       2. Uncheck "Display intranet sites in Compatibility View."

       3. Click Close.

    Note: If the MasterControl URL was added to the Compatibility list, it should be removed.

    To add MasterControl to your local intranet:

    1. 1. Select Tools > Internet Options.

       2. Select the Security tab.

       3. Select Local Intranet.

       4. Click the Sites button.

       5. Click the Advanced button.

       6. Add the name of the MasterControl server (i.e. http://mcserver.mastercontrol.com)

    To disable browser password saving functionality:

    1. 1. Select Internet Options.

       2. Select Content.

       3. Select AutoComplete Settings.

       4. Either select Disable or click Manage Passwords and disable for MasterControl.

  • Firefox

    Configuration Settings

    1. Open a new tab, and enter about: config into the browser address bar in order to open the configuration page.

    2. Double-click the browser.cache.check_doc_frequency variable, set it to 1, and click OK.

    3. Double-click the signed.applets.codebase_principal_support variable to enable it.

    4. Open the network.automatic-ntlm-auth.trusted-uris variable, add the address of your intranet site, and click OK.

    Note: You can enter multiple domains separated by commas.

    5. If MasterControl is supposed to automatically log you in using your Windows credentials, do the following:

       1. Open the network.negotiate-auth.trusted-uris variable, add the address of your intranet site, and click OK.

    Note: You can enter multiple domains separated by commas.

    Options

    Cookie Exceptions

    1. Open the Firefox Option page.

    2. Click the Privacy tab.

    3. Click the Exceptions button.

    4. Add your MasterControl Web server address to the browser's cookie exceptions.

    Enable the Adobe PDF Reader

    A built-in HTML5 PDF viewer was introduced with the release of version 19 of the Firefox web browser. This viewer does not support all of the JavaScript that MasterControl uses to display the previously listed features. It is recommended to disable this new viewer. Only Adobe PDF viewers are validated and fully-supported.

    My Files

    If you are using My Files, enable My Files by doing the following:

    1. Create a .txt file containing the following lines:

    1. • user_pref("capability.policy.policynames","localfilelinks");

       • user_pref("capability.policy.localfilelinks.sites","http://<YourMCServerName>");

       • user_pref("capability.policy.localfilelinks.checkloaduri.enabled", "allAccess");

    2. Save the file as user.js.

    3. Place the file in your Firefox Profile folder (C:\Users\<USERNAME>\%APPDATA%\Roaming\Mozilla\Firefox\Profiles\<some random characters>.default\)

    Disable Password Saving Functionality

    To disable browser password saving functionality:

    1. Select Options.

    2. Select Security.

    3. Select Disable or click Exceptions and add MasterControl.

     

     

  • Chrome

    A built-in HTML5 PDF viewer was introduced with the release of version 45 of the Chrome web browser. This viewer does not support all of the JavaScript that MasterControl uses to display the previously listed features. It is recommended to disable this new viewer. Only Adobe PDF viewers are validated and fully-supported.

    Selecting your PDF viewer:

    1. Open a new tab in Chrome.

    2. Enter chrome://plugins in the address bar.

    3. Disable the Chrome PDF Viewer.

    4. Enable Adobe Reader.

    To disable browser password saving functionality:

    1. Select Settings.

    2. Select Advanced Settings.

    3. Select Passwords and Forms.

    4. Select Disable or select Manage Passwords and set MasterControl to Never.

     

     

  • Mobile

    Minimum Mobile system requirements:

    • Operating system: iOS 7.x+, Android 4.x+, Windows

    • A-grade or B-grade browsers recommended: Internet Explorer, Safari, Firefox, Chrome, and Android Browser have been specifically tested

    • At least 12 Mbps connectivity speed

    For Mobile PDF viewing:

    • Adobe Reader 11/DC

    • PDF Forms is only supported in Internet Explorer

    • For non-PDF Form users, browsers should be configured to open published files outside of the browser (in Adobe Reader)

• Configure PDF viewing

  Unless you are using PDF Forms, MasterControl recommends viewing published documents in Adobe Reader, rather than in the browser. Process PDF Forms are only supported in Internet Explorer. To configure your system for external PDF viewing, do the following:

  Adobe 11 or before:

  1. Go to Edit > Preferences > Internet.

  2. Uncheck “Display PDF in browser”

  Google Chrome:

  1. Enter “Chrome://plugins” in the browser address bar.

  2. Disable the Chrome PDF Viewer.

  Mozilla Firefox:

  1. Open the browser Options page.

  2. Click the Applications tab.

  3. In the Content Type column, find Portable Document Format (PDF).

  4. In the Action column, select Use Adobe Reader (default).

  Internet Explorer:

  1. Go to “Manage Add-ons”.

  2. Disable “Adobe PDF Reader”.

  Make sure you are using Adobe 10.0 or higher.

  Follow these steps to configure Adobe's security settings:

  1. Open Adobe Reader.

  2. Select Edit > Preferences.

  3. From the Categories menu, select Security (Enhanced).

  4. Click the Add Host button.

  5. Add the MasterControl Server address, and click OK.

• Install language support if needed

  If you are viewing MasterControl in another language, follow these steps:

  1. Open the computer's Control Panel.

  2. Click Regional and Language Settings.

  3. On the Language and Advanced tabs, install the languages you need.

• Read a few more good-to-know items before starting up

  Mircosoft Office Version

  Make sure you are using Microsoft Office 2010 or higher.

  Security Settings

  If MasterControl prompts you with a security message when you visit the site, add an exception for the security certificate as prompted by the browser.

  Login Prompts

  If you get a login prompt when viewing a file, your company may be using a technology called WebDAV. To view the file follow these steps:

  1. In the prompt, enter your network login information.

  2. Click the checkbox to remember the credentials.

  3. Click OK.