Installing an EMS Package
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.
Contents
Installing an EMS Package for Testing
To install EMS Packages in the EMS Developer Server that is delivered with RAD Studio:
- In the Project Manager right-click the EMS Package project and select Options > Debugger
- 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
- 32-bits Windows applications:
- Parameters:
-l$(TargetName)
- Host application:
- Click the OK button.
- 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\
- Go to the [Server.Packages] section.
- 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
- Before starting, if the EMS Environment has not been set, configure the EMS Environment as described in the Setting Up the EMS Server section.
- In the Project Manager right-click the EMS Package project and select Options > Debugger
- Make sure that the following parameters for the target platform are set:
- Host application:
- 64-bits Linux applications:
/usr/lib/ems/EMSDevServerCommand
- 64-bits Linux applications:
- Parameters:
-l$(TargetName)
- Host application:
- Click the OK button.
- 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/
- Go to the [Server.Packages] section.
- List the EMS Packages as follows:
[Server.Packages] ; server extension packages go here ;/etc/ems/bplbasicextensions.so=mypackage description