Configuring FCS Routing with MQL

FCS routing is a way to manage FCS access for both local and remote users. Remote users include users using the central FCS site, an FCS deployed at their site, or a central FCS site through a private network. To configure FCS routing, you must add an FCS route to the store or location in your environment.

A route includes an external FCS URL and an internal FCS URL. An internal URL is used for direct FCS access and an external URL is used for reverse-proxy FCS access. A reverse-proxy is a gateway for incoming network HTTP traffic. The FCSURLSolver, an MCS component, determines the appropriate URL to use for each FCS request depending on the user's site and the store or location's site.


  • If the user's site and the store or location's site are the same, the internal URL is used.
  • If the user's site and the store or location's site are different and there is no site specific URL defined for that store or location, the external URL is used.

A site specific FCS URL can be defined for a store or location which gives all users associated with that site access to the store or location through that URL. For details, see Add a Site Specific FCS URL.

This task shows you how to:

Add an FCS Route to a Store or Location

You can add an FCS route to a store or location.

  1. In MQL, execute the following commands for each store or location in your environment. The syntax for locations is shown:

    modify location NAME fcs "${CLASS:com.matrixone.fcs.backend.FCSURLSolver}";

    add property externalURL on location NAME value URL;

    add property internalURL on location NAME value URL;

    Where NAME is the name of the location to which you are adding the route and URL is the internal or external URL.

  2. Next, you can verify that the store or location has been configured correctly by printing it.

Add a Site Specific FCS URL

When a site specific FCS URL is defined for a store or location, all users associated with that site will be able to access the store or location through that URL. A site specific FCS URL overrides the internal and external URLs.

To add a site specific URL to a store or location:

  • In MQL, add the following property to the store or location to define a site specific route. The syntax for stores is shown:

    add property siteSITE on store NAME value URL;

    Where SITE is the name of the site, NAME is the name of the store to which you are adding the property and URL is the FCS URL.

    For example:

    add property siteFrance on store Documents value http:/host3:port3/enovia;