Installing an EMS Package

From RAD Studio
Jump to: navigation, search

Go Up to Extending the EMS Server‎


You can install a new EMS Package in the EMS Server (loading EMS Resources to extend its functionalities), in order to test them in a developer environment or deploy them in a real scenario.

Installing an EMS Package for Testing

To install EMS Packages in the EMS Developer Server that is delivered with RAD Studio:

  1. In the Project Manager right-click the EMS Package project and select Options > Debugger
  2. Make sure that the following parameters for the target platform are set:
    • Host application:
      • 32-bits Windows applications: $(BDS)\bin\EMSDevServer.exe
      • 64-bits Windows applications: $(BDS)\bin64\EMSDevServer.exe
    • Parameters: -l$(TargetName)
  3. Click the OK button.
  4. To run the project, right-click it and select Run or just press F9.

If the EMS Server registers successfully the new resource, you can see a message in the EMS Server Log (in the EMS Server Window):

{"Load":{"Filename":"C:\Users\esvmw7prox64\Documents\Embarcadero\Studio\Projects\.\Win32\Debug\Project2.bpl"}}
{"RegUnit":{"Filename":"C:\Users\esvmw7prox64\Documents\Embarcadero\Studio\Projects\.\Win32\Debug\Project2.bpl","Filename":"Unit1"}}
{"RegResource":{"Resource":"sample","Endpoints":["Get","GetItem","PostUpdates","PutItem","DeleteItem"]}}

Installing an EMS Package for Deployment on Windows

You can install a new EMS Package in an existing EMS Server that is already deployed. Edit the EMSserver.ini file of your EMS Server adding your server extension packages. You can find the EMSserver.ini file at the following location: C:\Users\Public\Documents\Embarcadero\EMS\

  1. Go to the [Server.Packages] section.
  2. List the EMS Packages as follows:
[Server.Packages]
; server extension packages go here
;c:\mypackages\basicextensions.bpl=mypackage description

Installing an EMS Package for Testing on Linux

To install EMS Packages in the EMS Developer Server that is delivered with RAD Studio

  1. Before starting, if the EMS Environment has not been set, configure the EMS Environment as described in the Setting Up the EMS Server section.
  2. In the Project Manager right-click the EMS Package project and select Options > Debugger
  3. Make sure that the following parameters for the target platform are set:
    • Host application:
      • 64-bits Linux applications: /usr/lib/ems/EMSDevServerCommand
    • Parameters: -l$(TargetName)
  4. Click the OK button.
  5. To run the project, right-click it and select Run or just press F9.

Installing an EMS Package for Deployment on Linux

You can install a new EMS Package in an existing EMS Server that is already deployed. Edit the EMSserver.ini file of your EMS Server adding your server extension packages. You can find the EMSserver.ini file at the following location: /etc/ems/

  1. Go to the [Server.Packages] section.
  2. List the EMS Packages as follows:
[Server.Packages]
; server extension packages go here
;/etc/ems/bplbasicextensions.so=mypackage description


See Also