Installing the RAD Server or the RAD Server Console on a Production Environment on Windows
Go Up to Setting Up Your RAD Server Engine
Go Up to Setting Up Your RAD Server Console
For a production environment, we recommend to set up the RAD Server Engine and the RAD Server Console on a web server. We currently support Microsoft IIS Server and Apache Server.
You need the InterBase database and configuration file (.ini). To create these files for the first time follow the steps in Configuring Your RAD Server Engine or RAD Server Console on Windows.
The default path to the EMSServer.IB and EMSServer.ini files is:
C:\Users\Public\Documents\Embarcadero\EMS\
Contents
Locating Binary Files that RAD Server Engine Requires
To run the RAD Server Engine in a different machine from the one you installed RAD Studio, you need the following files that you can find in the installation folders of the dlls:
For Microsoft IIS Support (Windows ISAPI):
borlndmm.dll
CustomIPTransport280.bpl
dbrtl280.bpl
EMSConsole.dll
EMSServer.dll
emsserverapi280.bpl
FireDAC280.bpl
FireDACCommon280.bpl
FireDACCommonDriver280.bpl
rtl280.bpl
FireDACIBDriver280.bpl
IndyCore280.bpl
IndyIPClient280.bpl
IndyIPCommon280.bpl
IndyProtocols280.bpl
IndySystem280.bpl
inet280.bpl
xmlrtl280.bpl
- If you use FireDAC with a database management system other than InterBase, you need its FireDAC driver, such as
FireDACSqliteDriver280.bpl
for SQLite.
emsserverapi280.bpl
FireDACCommon280.bpl
FireDACCommonDriver280.bpl
FireDACIBDriver280.bpl
IndyCore280.bpl
IndyIPClient280.bpl
IndyIPCommon280.bpl
IndyProtocols280.bpl
IndySystem280.bpl
inet280.bpl
mod_emsserver.dll
rtl280.bpl
xmlrtl280.bpl
- If you use FireDAC with a database management system other than InterBase, you need its FireDAC driver, such as
FireDACSqliteDriver280.bpl
for SQLite.
If you have created one or more packages of custom RAD Server resources, you must build them into package shared library files, which you need as well.
Microsoft IIS Support (Windows ISAPI)
The dlls to configure both the RAD Server Engine and RAD Server Console running on an IIS Server (EMSServer.dll and EMSConsole.dll) are located in the following folders:
- Windows 32 bits:
C:\Program Files (x86)\Embarcadero\Studio\22.0\bin
- Windows 64 bits:
C:\Program Files (x86)\Embarcadero\Studio\22.0\bin64
Follow these steps to set up your RAD Server Engine or Console running on a IIS Server.
Installing IIS 7
- Go to Control Panel > Programs and Features > Turn Windows features on or off.
- Note: This requires Privileged mode.
- Expand the Internet Information Services node of the Windows Features dialog box and then:
- In Web Management Tools, check IIS Management Console.
- In World Wide Web Services, expand the Application Development Features and then check ISAPI Extensions and ISAPI Filters.
- In World Wide Web Services, expand the Common HTTP Features and make sure that Default Document, Directory Browsing, HTTP Errors, and Static Content are checked as well.
- Click OK to start the installation.
Checking IIS 7
- After installing IIS 7, open the URL
http://localhost/
with a regular browser to make sure IIS is running and working.- Note: You might need to check your firewall settings and add an exception for port 80 TCP traffic if necessary.
Creating a New Site
Add a new site:
- Go to
C:\inetpub\wwwroot
and create a new folder, for example emsconsole or emsserver. - Paste the created EMSServer.ini file in Configuring Your RAD Server Engine or RAD Server Console on Windows (default location is
C:\Users\Public\Documents\Embarcadero\EMS\
) on the folder. - Copy the required binary files into the folder.
- (Only for the RAD Server Console) Copy the webresources folder from
C:\Program Files (x86)\Embarcadero\Studio\22.0\ObjRepos\en\EMS
toC:\inetpub\wwwroot\emsconsole
.- Note: When an application uses FireDAC persistent connection definitions or externally configured FireDAC drivers, then FDConnectionDefs.ini and FDDrivers.ini files must be copied into the created folder.
Configuring EMSServer.ini File (only for the Console)
Edit the EMSServer.ini file as follows:
[Console.Paths.ISAPI] ResourcesFiles= C:\inetpub\wwwroot\emsconsole\
Configuring IIS 7 for the ISAPI DLL
- Open Internet Information Service Manager (requires Privileged mode).
- Tip: Enter Inetmgr on Search programs and files to open the IIS Manager.
- Select the folder (emsserver or emsconsole) under Sites > Default Web Site.
- Right-click on the emsserver or emsconsole folder and select Convert to Application.
- Double-click Handler Mappings. This opens the Handler Mappings window.
- Select ISAPI-dll. It appears grayed.
- Click Edit from the Actions panel.
- On the Executable (optional) field enter the path to the dll file and click Open:
- emsserver.dll, for example
C:\inetpub\wwwroot\emsserver\emsserver.dll
- emsconsole.dll, for example
C:\inetpub\wwwroot\emsconsole\emsconsole.dll
.
- emsserver.dll, for example
- Click OK, then click Yes.
- Click Edit Feature Permissions… in Actions panel.
- An Edit Feature Permission dialog opens.
- Check Execute.
- Click OK to commit the changes.
Enabling ISAPI Modules
- Click the root node from the Connections tree.
- Double-click ISAPI and CGI Restrictions.
- Click Edit Feature Settings … in the Actions panel.
- Check the Allow unspecified ISAPI modules option. This option allows any ISAPI dll to be executed under IIS. If you do not use this option, you need to specify a list of ISAPI DLLs explicitly.
- Click OK.
Enabling 32 bits ISAPI DLL on IIS 7 x64
This is only required if you are using IIS 7 x64 and you would like to run 32 bits ISAPI DLL on the IIS. If your ISAPI DLL and IIS7 are both x86 or both x64, you may skip this step.
- Click Application Pools node.
- Click DefaultAppPool item.
- Click Advanced Settings … from the Actions panel.
- An Advanced Settings dialog opens.
- Set Enable 32-bits Applications to True.
- Click OK to commit the changes.
Configuring IIS to Allow Cross Domain Requests
If your Web Server is hosting the Web files resources of an RAD Server Console and you want to allow HTTP requests from different domains, you need to set up the HTTP-Response-Header.
- Go to
C:\inetpub\wwwroot
and create a new folder, for example Web files folder. - Paste the web files resources folders under webfilesresources.
- Note: You can not change the webresources folder name.
- Open Internet Information Service Manager.
- Select the Web files folder (webfilesresources) under Sites > Default Web Site.
- Double-click HTTP Response Headers.
- Click Add in the Actions panel.
- Enter one of the following configurations (Name: Value):
- Access-Control-Allow-Origin: *
- (More restrictive option) Access-Control-Allow-Origin: http://domain:port/
- Click OK to commit the changes.
- Note: See Hosting the RAD Server Console Web Files Resources in a Web Server for more information about it.
Apache Server Support
You can find the RAD Server Apache server module (mod_emsserver.dll
and the mod_emsconsole.dll
) in the following locations:
- Windows 32 bits:
C:\Program Files (x86)\Embarcadero\Studio\22.0\bin
- Windows 64 bits:
C:\Program Files (x86)\Embarcadero\Studio\22.0\bin64
Follow these steps to set up your RAD Server Engine or Console running on an Apache Server.
- Download and install Apache HTTP Server for Windows.
- Note: RAD Server Engine (EMS Server) only runs in Apache HTTP Server versions 2.0, 2.2, and 2.4.
- Copy the RAD Server Apache server module (
mod_emsserver.dll
) or the RAD Server Apache console module (mod_emsconsole.dll
) to a location:- For example, you can create the
C:/mod
folder.
- For example, you can create the
- Configure the Apache HTTP Server to load the RAD Server Apache server and RAD Server Apache console modules. Edit the
httpd.conf
file.- Add the following line to load the RAD Server Apache server module (
mod_emsserver.dll
)
LoadModule emsserver_module C:/mod/mod_emsserver.dll
- Add the following line to load the RAD Server Apache console module (
mod_emsconsole.dll
)
LoadModule emsconsole_module C:/mod/mod_emsconsole.dll
- Note: According to the Apache Documentation, add the '
_module
' suffix to the module name; Otherwise, Apache does not load the module.
- Add the
Location
tags to create a container where you can specify access control rules for a given URL.
<Location /ems-server> SetHandler mod_emsserver-handler </Location>
<Location /ems-console> SetHandler mod_emsconsole-handler </Location>
- Add the following line to load the RAD Server Apache server module (
- Change the
Listen
to change the default listener port. For example, change it to 8085.Listen 8085
- (Only for the RAD Server Console) Copy the webresources folder (from
C:\Program Files (x86)\Embarcadero\Studio\22.0\ObjRepos\en\EMS
) to the folder where you copied the Apache modules dlls (C:/mod
). - To check if the RAD Server Apache server module is properly running, open a web browser and type:
http://localhost:8085/ems-server/version
- You can access the RAD Server Apache console module by accessing:
http://localhost:8085/ems-console/
Configuring EMSServer.ini File (only for the Console)
Edit the EMSServer.ini file as follows:
[Console.Paths.Apache] ResourcesFiles = C:\mod\ ;WebFiles =