Running a Driver from an Engine Service

It’s possible to run a recursive Service, which is a Service that runs a Driver on the Engine to call a Service. To do this, you must deploy the Driver packaged in a Grid Library.

To run a Driver from an Engine Service:

1.

In the GridServer Administration Tool, go to the top navigation bar, and click the Downloads icon.

2.

Click the SDK for your platform to download it.

3.

Package the driver.properties file in a Grid Library. (For more information about creating Grid Libraries, see Creating Grid Libraries.) In the grid-library.xml, set the environment variable DSDRIVER_DIR to the value $ds.GridLibraryRoot$. Also, set the jar-path element to $ds.GridLibraryRoot$. The grid-library.xml must look similar to the following code:

   <?xml version="1.0" encoding="UTF-8"?>
   <grid-library>
       <grid-library-name>
           driver-properties
       </grid-library-name>
      <grid-library-version>7.1</grid-library-version>
      <environment-variables>
           <property>
               <name>DSDRIVER_DIR</name>
               <value>$ds.GridLibraryRoot$</value>
           </property>
       </environment-variables>    
       <jar-path>
           <pathelement>
               $ds.GridLibraryRoot$
           </pathelement>
       </jar-path>        
   </grid-library>

4.

Create a Grid Library that contains all of the DLLs or JAR required to run the Driver. For example, to run CPPDriver for VC14, you would need to create a Grid Library that contained all of the DLLs from the cppdriver/bin/vc14 directory of the SDK in a bin/vc14 directory inside the Grid Library. Make this Grid Library dependent on the driver-properties Grid Library, and set the lib-path to the location of the DLLs. The grid-library.xml must look similar to the following code:

   <?xml version="1.0" encoding="UTF-8"?>
   <grid-library os="win64">
       <grid-library-name>
           cppdriver-win64-vc14
       </grid-library-name>
       <grid-library-version>7.1</grid-library-version>
       <dependency>
          <grid-library-name>
               driver-properties
           </grid-library-name>
       </dependency>    
       <lib-path>
           <pathelement>.\bin\vc14</pathelement>
       </lib-path>
   </grid-library>

5.

Upload and deploy both Grid Libraries on the Services > Services > Grid Libraries page.