Installing a RAD Server Package

From RAD Studio
Jump to: navigation, search

Go Up to Extending the RAD Server Engine‎


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

Installing a RAD Server Package for Testing

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

  1. In the Projects Window right-click the RAD Server 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 RAD Server Engine registers successfully the new resource, you can see a message in the RAD Server Engine Log (in the RAD Server Engine 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 a RAD Server Package for Deployment on Windows

You can install a new RAD Server Package in an existing RAD Server Engine that is already deployed. Edit the EMSserver.ini file of your RAD Server Engine 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 RAD Server Packages as follows:
[Server.Packages]
; server extension packages go here
;c:\mypackages\basicextensions.bpl=mypackage description

Installing a RAD Server Package for Testing on Linux

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

  1. Before starting, if the RAD Server Environment has not been set, configure the RAD Server Environment as described in the Setting Up the RAD Server Engine section.
  2. In the Projects Window right-click the RAD Server 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 a RAD Server Package for Deployment on Linux

You can install a new RAD Server Package in an existing RAD Server Engine that is already deployed. Edit the EMSserver.ini file of your RAD Server Engine 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 RAD Server Packages as follows:
[Server.Packages]
; server extension packages go here
;/etc/ems/bplbasicextensions.so=mypackage description


See Also