SAP Knowledge Base Article - Public

1370542 - How To: Simplified configuration for Crystal Reports Server Embedded (All version) Round Robin usage


How to configure Crystal Reports Server Embedded Round Robin RAS servers


SAP Crystal Reports Server (OEM) All Versions


  1. Sample source code for .NET C# test application:
using System;
using System.Collections.Generic;
using System.Text;
using CrystalDecisions.ReportAppServer.ClientDoc;
using CrystalDecisions.ReportAppServer.Controllers;
using CrystalDecisions.ReportAppServer.DataDefModel;
using CrystalDecisions.Enterprise.Admin;
using CrystalDecisions.Enterprise;
namespace EROMTestApp 
    class Program
        static void Main(string[] args)
           int i=0;           
           ReportClientDocument rcd;
            //= new ReportClientDocumentClass();
           string reportPath = "C:\\World Sales Report.rpt";
           object reportPathAsObject = (object)reportPath;          
           for (i = 0; i < 5; i++)
               rcd = new ReportClientDocumentClass();
               rcd.Open(ref reportPathAsObject, 0);              
               if (rcd != null)
                   System.Console.WriteLine("The report application used is:" + rcd.ReportAppServer);
 Round Robin of the RAS Services is handled by the use of an XML file as described below:    
  1. CRSE2K8PC1 is the name of the test Server and the IP address is the second server.
  2. The IP address is used for this test.
  3. The PC name can be used depending on how the DNS servers are set up.
  4. It is located in this folder only:
C:\Program Files\Business Objects\BusinessObjects Enterprise 12.0\win32_x86\clientSDKOptions.xml
<CrystalReports.ClientSDKOptions xmlns:xsi="" version="2" xsi:type="CrystalReports.ClientSDKOptions"> 
<ServerInfos version="2" xsi:type="CrystalReports.ServerInfos" id="1">
 <ServerInfo version="2" xsi:type="CrystalReports.ServerInfo" id="2">
 <ServerInfo version="2" xsi:type="CrystalReports.ServerInfo" id="3">
 <ServerInfo version="2" xsi:type="CrystalReports.ServerInfo" id="4">
Warning: XML file must not have any Carriage Returns or line breaks. If you find this is not working check the xml file first.
  1. You no longer need to use the SC command line function to add RAS services.
  2. Use the Crystal Configuration Manager (CCM) from the start menu and to add one or more local RAS services to the local PC or one located on another computer.
  3. You must specify a new IPPORT so they do not conflict with each other as well as the CPU ( affinity) assignment.
  4. The default port for the first RAS Service is 1566.
  5. It is not necessary to manage which RAS service to send the report to, RAS will do this automatically.
  6. Required steps:
    1. Stop RAS
    2. Click on Properties
    3. Select the Parameter tab
    4. Choose Server in the drop down list for Option type
    5. Browse to the directory where your reports will be saved.
    6. The Document has more information on how to configure this directory.
    7. It defaults to our sample report location which does not exist with Crystal Reports Server Embedded install.
    8. You can use the locations from Crystal Report Designer for testing.

ALSO NOTE: .NET will sequencially pass each job to the next RAS Service listed in the xml file. A Java application will randomly assigned the next report

To run RAS in Console mode for debugging purposes see attached KBA - 2832968


CRSE, Round Robin, .net , KBA , BI-DEV , Business Intelligence Software Development Kits (SDKs) , How To


Crystal Reports Server 2008 V1, OEM edition ; SAP Crystal Reports Server 2011, OEM edition ; SAP Crystal Reports Server 2013, OEM edition ; SAP Crystal Reports Server 2016, OEM edition ; SAP Crystal Reports Server 2020, OEM edition