Jump to: navigation, search

Setting ORS Dependencies

You must perform the following configuration steps to enable the Orchestration Server (ORS) to work with your Genesys Mobile Services installation.

You do not need ORS for chat scenarios.

Setting ORS Options


  1. Start Configuration Manager.
  2. In Configuration Manager, select Environment > Applications.
  3. Locate and open the Application object for your Orchestration Server.
    You must use the same Application object that the one in your GMS connections.
  4. Select the Options tab.
  5. Open the orchestration section.
  6. Set the value of the option parse-start-params to false.
  7. Set the value of the option mcr-pull-by-this-node to true.
  8. If you installed your Orchestration Server without Cassandra, disable the Cassandra persistence as detailed in Recovery of Voice Calls Without Persistence in ORS documentation.
    Set the value of the option sessionid-with-nodeid to true.
    Set the value of the option cassandra-nodes option to unknown.
  9. Click OK to save your changes.


Deploying DFM Files

Included with your installation are special configuration files, called DFM, which are required for Orchestration Server-based services. These files define Genesys Mobile Services-specific SCXML constructs that are required for the execution of SCXML applications used within Orchestration Server-based Services. For the Orchestration Server-based Services to function correctly, the following DFM files need to be configured in your Orchestration Server Application object:

  • Storage
  • Notification
  • Callback
  • Genesys Mobile-Based Services

The latest DFM definition files are included with the GMS installation and are available for download through the Service Management User Interface.

Starting 8.5.104, you must update the DFM files deployed locally with the latest version provided in the GMS Admin UI.

These files are default configuration files which need to be edited before being deployed. See Configuring DFMs. Details about deploying these DFM files in your environment are provided below.

After deploying these DFM files, you can use either an actual device with the demo application or an HTTP client (such as RestClient) to send API requests to Orchestration Server-based services. Refer to the Genesys Mobile Services API Reference for syntax of the requests.

You must restart Orchestration Server after deploying DFM files for the changes to take effect.


  1. Download the DFM files from the Service Management User Interface.
  2. Copy the DFM files onto your local file system where Orchestration Server (ORS) is running.
  3. Start Configuration Manager.
  4. In Configuration Manager, select Environment > Applications.
  5. Locate and open the Application object for your ORS. Note: This should be the same Application object you created a connection to when configuring your Genesys Mobile Services Application object.
  6. Select the Options tab.
  7. Click Add to create the dfm section.
  8. In the dfm section, create and configure one option for each DFM, using the option value to specify the file path. Details are provided in the table below.
  9. Click OK to save your changes.
  10. Restart Orchestration Server (ORS). ORS reads the DFM configuration on startup.


List of DFM Options for Orchestration Server (Modified in:
Service Option Name Option Value
Storage gsgStorage file://c:\dfms\storage.jsp
Notification gsgNotification file://c:\dfms\notification.jsp
Genesys Mobile-Based Services gsgBasedServices file://c:\dfms\services.jsp
Callback gsgCallback file://c:\dfms\callback.jsp
Statistics gsgStatistics file://c:\dfms\statistic.jsp

Additional ORS Configuration

See the Orchestration Server Deployment Guide to perform the following additional configuration steps.

  1. Set up the Cluster object in the transactions list object.
  2. Set up the Application object in the transactions list object.
  3. Valid customer numbers should include a + sign if needed. If true, edit the valid-digits option in the gts section of your SIP Switch object:
    [gts] valid-digits = +0123456789
    Refer to ORS documentation for further details.
This page was last edited on June 29, 2022, at 16:05.
Comments or questions about this documentation? Contact us for support!