Configuring Your RAD Server Engine or RAD Server Console on Windows

From RAD Studio
Jump to: navigation, search

Go Up to Setting Up Your RAD Server Engine

Go Up to Setting Up Your RAD Server Console


To set up your RAD Server (EMS) properly, you need the resources and the stand-alone developer applications that are delivered with RAD Studio.

RAD Server Configuration Files

RAD Studio provides the scripts to render the web-browser console, the RAD Server Engine configuration file and the script to create the RAD Server database, and the stand-alone applications to run the RAD Server Console and the RAD Server Engine (EMS Server).

In C:\Program Files (x86)\Embarcadero\Studio\23.0\ObjRepos\en\EMS folder you can find:

  • webresources folder: This folder contains scripts to render the web-browser console. You can customize the appearance of your RAD Server Console by modifying the layouts, templates and styles defined here.
  • emsserver.ini file: This is a template for the RAD Server Engine configuration file (for the RAD Server Engine (EMS Server) and for the RAD Server Console).
  • RAD Server Database creation files:
    • emsmserver.sql and emsserver.sql files. SQL script files to create the RAD Server Database.
    • EMSMSERVER.IB and EMSSERVER.IB files. License template files to create the RAD Server Database.

The stand-alone applications (EMSDevConsole.exe and EMSDevServer.exe) are located in the following folders:

  • Windows 32-bit: C:\Program Files (x86)\Embarcadero\Studio\23.0\bin
  • Windows 64-bit: C:\Program Files (x86)\Embarcadero\Studio\23.0\bin64

Configuring Your RAD Server Environment for the First Time

The EMSDevServer.exe and EMSDevConsole.exe programs only run the setup wizard when there is no registry key or if the emsserver.ini file does not exist.

Note: For a production environment, you need to set up the Interbase RAD Server database properly before running the RAD Server Setup Wizard.

To start the RAD Server Setup Wizard:

  1. Locate one of the following stand-alone applications on your system, and double-click:
    • EMSDevConsole.exe: The RAD Server Development Console opens with a confirmation dialog.
    • EMSDevServer.exe: The RAD Server Development Server opens with a confirmation dialog.
  2. Click Yes to run the configuration RAD Server Setup Wizard. The RAD Server Setup Wizard opens to create a new RAD Server database.
  3. The New Database page opens.
    • Enter the following values on the New Database page to specify its connection parameters:
      • Server Instance: Specify the InterBase instance that hosts the RAD Server database. Leave it blank for a developer environment; for a production environment use EMS
      • DB File Name: emsserver.ib
      • DB File Directory: The default path is C:\Users\Public\Documents\Embarcadero\EMS
      • DB User Name: sysdba as the parameter by default.
      • DB Password: masterkey as the parameter by default.
        Note: Select Show password to see the unencrypted password.
      • Click Next.
    DevCon3.jpg
  4. The Database creation page opens.
    • Select how to create the new RAD Server database from the delivered files.
      • Copy the license template file.
      • Run the SQL script.
      • Click Next.
    EMSSetup DBCreation.png
  5. The Sample Data page opens.
    • Select one or more options indicating the sample data to be generated in the RAD Server database.
    DevCon4.jpg
  6. Click Next. The Console page opens.
    • Specify a Console User Name and a Console Password. The default values are: consoleuser and consolepass.
      Note: The user name and password are saved in the emsserver.ini file in plain text.
    DevCon5.jpg
  7. Click Next. The Finalize page opens.
    • Click Finish to create the following files in the default path: C:\Users\Public\Documents\Embarcadero\EMS
      • DB File: The RAD Server Database file (emsserver.ib). You need to have an InterBase server running.
      • Configuration File: The RAD Server Engine configuration file (emsserver.ini).
      • Registry Key: The RAD Server Registry key on the system.
    Note: The RAD Server registry key has been moved from HKCU (current user) toHKLM (local machine).
    DevCon6.jpg
  8. An Information wizard appears with the files created and the data added to the database. Click OK.
    EMSSetup Confirmation.png

If you are planning to have the RAD Server Engine and the RAD Server Console running on different servers, you need a configuration file (.ini) on each server.

In this scenario, you need to configure the .ini file on the Console Server to access the Interbase database on the RAD Server Engine.

Running the Setup Wizard

You can run the setup wizard again as follows:

  1. Open the command prompt (cmd.exe).
  2. Type the following command:
emsdevserver -setup
  1. Open the command prompt (cmd.exe).
  2. Navigate to the EMSDevServer.exe folder:
    • Windows 32-bit: C:\Program Files (x86)\Embarcadero\Studio\23.0\bin
    • Windows 64-bit: C:\Program Files (x86)\Embarcadero\Studio\23.0\bin64
  3. Type the following command:
EMSDevServer.exe -setup

See Also