Upgrading Your EMS Server

From RAD Studio
Jump to: navigation, search

Go Up to Setting Up Your EMS Server

You can upgrade and make a backup of your EMS Database and configuration file, by using the EMS Upgrade Wizard.

If the EMS database version number is lower than the Version number expected by EMSDevServer.exe, the EMS Upgrade Wizard will be run automatically.

Use the EMS Upgrade Wizard to update your EMS database that was created with previous versions of RAD Studio.

Upgrading Your EMS Server

To start the EMS Upgrade Wizard:

  1. Open the command line tool and type the following command:
    emsdevserver -upgrade
    
  2. The EMS Upgrade Wizard opens to create a new EMS database or copy an existing EMS database.
  3. The New database content page opens.
    • Select whether to create an empty database or a database with content:
      • Copy an existing EMS database. You can copy the content of an existing EMS Database installed in your system.
        Note: The Source Database page opens to specify it.
      • Create an empty EMS database. You can create an EMS Database without content.
        Note: The New Database page opens then.
      • Create an EMS database with sample data. You can add test sample data to the new EMS Database.
        Note: The New Database page opens then.
    EMSUpgrade DBContent.png
  4. The Source Database page opens (only if you copy the content from an existing EMS database).
    • Enter the following values on the Source Database page to specify connection parameters to the existing source EMS database:
      • Server Instance. Specify the InterBase instance that hosts the source EMS database.
      • 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 the Test Connection button to test the connection parameters. If the connection is set up successfully, you will get a message with the current version number of the EMS database.
      • Click Next.
    EMSUpgrade SourceDB.png
  5. The New Database page opens.
    • Enter the following values on the New Database page to specify connection and configuration parameters for the new EMS database:
      • Server Instance. Specify the InterBase instance that hosts the EMS database.
      • DB File Name: emsserver1.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.
      • Click Next.
    EMSUpgrade DBConnection.png
  6. The Finalize page opens.
    • Click Finish to create the following files in the default path: C:\Users\Public\Documents\Embarcadero\EMS
      • DB File: The EMS Database file (emsserver.ib). You need to have an InterBase server running.
      • Configuration File: The EMS Server configuration file (emsserver.ini).
      • Backup Configuration File: A copy of the existing EMS Server configuration file (saved as emsserver.ini.backup).
    EMSUpgrade Paths.png
  7. An Information wizard appears with the files created and the data copied to the database. Click the OK button.
    EMSUpgrade Confirmation.png

Running the Upgrade Wizard From the Command Line

You can run the upgrade wizard as follows:

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

See Also