• Supported Windows versions
• New installation directory
• Installed subdirectories
• Prerequisites
• Upgrading from a previous Eloquence B.08.xx version
• Installation instructions
• Accessing Eloquence configuration files
• Multiple Eloquence versions on the same system
• Summary of changes to previous Eloquence versions

Supported Windows versions

Required minimum Windows version:

• Desktop: Windows 10
• Server: Windows Server 2016

As an option, the installation program allows to choose that 32-bit (x86) Eloquence B.08.40 libraries are installed in addition. These libraries may be required by third party software.

New installation directory

Typically this is:
"C:\Program Files\Eloquence\8.4"

Eloquence B.08.40 can coexist with previous Eloquence versions. Please note that for various technical reasons the installation directory is fixed and cannot be changed.

Installed subdirectories

bin

64-bit binary files and shared libraries

dll

Eloquence DLLs

etc

Configuration files
(new Eloquence B.08.40 configuration template files are installed in the newconfig\config subdirectory)

include

C/C++ development header files

lbin

eloq.cgi program

lib

64-bit development library support files

newconfig\config

New Eloquence B.08.40 configuration template files
(template files are copied to the etc directory if not present)

share

Additional documentation and support files

x86\bin

32-bit binary files and shared libraries
(installed if the "32-bit libraries" installation option is selected)

x86\lib

64-bit development library support files
(installed if the "32-bit libraries" installation option is selected)

Prerequisites

Eloquence B.08.40 requires the Microsoft Visual C++ 2015-2022 runtime libraries, available for download on the Eloquence web site at:
https://eloquence.marxmeier.com/download/B0840/windows/vc/

vc_redist.x64.exe

Microsoft Visual C++ 2015-2022 Redistributable (x64)
Current version: 14.38.33135.0
Minimum version: 14.30.30704.0

vc_redist.x86.exe

Microsoft Visual C++ 2015-2022 Redistributable (x86)
Current version: 14.38.33135.0
Minimum version: 14.30.30704.0

Upgrading from a previous Eloquence B.08.xx version

If the installation program detects an existing Eloquence B.08.xx it provides two additional options in the Custom Setup dialog:

Migrate previous Eloquence

If selected, the installation program will migrate the existing configuration files and the configured services of a previous Eloquence B.08.xx version to Eloquence B.08.40.

If multiple previous Eloquence B.08.xx versions are present, for example both Eloquence B.08.30 and B.08.20, only the most recent previous version is migrated, while any older B.08.xx installation is not touched.

If the "Uninstall" option below is selected in addition, any migrated configuration file is deleted in the previous Eloquence B.08.xx etc configuration directory.

Uninstall previous Eloquence

If selected, an existing previous Eloquence B.08.xx version is uninstalled.

If multiple previous Eloquence B.08.xx versions are present, only the most recent previous version is uninstalled, while any older B.08.xx installation is not touched.

By default, both options are selected. The "Uninstall" option cannot be selected if the "Migrate" option is deselected.

Installation instructions

The Eloquence B.08.40 installation program needs administrative privileges when executing the installation and displays an UAC elevation prompt before the installation starts.

The Custom Setup dialog allows to select the Eloquence B.08.40 installation features.

Eloquence B.08.40

This contains the required Eloquence B.08.40 components and cannot be deselected.

32-bit libraries

This may optionally be selected to install the 32-bit libraries into the x86 subdirectory. These libraries may be required by third party software.

Changing this after the initial installation is possible at any time by using the installation program in modify maintenance mode (Settings » Apps » Apps & features).

Migrate previous Eloquence

This option is only available during the initial installation if an existing previous Eloquence B.08.xx version is detected.

If selected, the installation program will migrate the existing configuration files and the configured services of a previous Eloquence B.08.xx version to Eloquence B.08.40.

If multiple previous Eloquence B.08.xx versions are present, for example both Eloquence B.08.30 and B.08.20, only the most recent previous version are migrated, while any older B.08.xx installation is not touched.

If the "Uninstall" option below is selected in addition, any migrated configuration file is deleted in the previous Eloquence B.08.xx etc configuration directory.

Uninstall previous Eloquence

This option is only available during the initial installation if an existing previous Eloquence B.08.xx version is detected.

If selected, an existing previous Eloquence B.08.xx version is uninstalled.

If multiple previous Eloquence B.08.xx versions are present, only the most recent previous version is uninstalled, while any older B.08.xx installation is not touched.

This option cannot be selected if the "Migrate" option is deselected.

Accessing Eloquence configuration files

The installation program creates a local group named "Eloquence Administrators" is created which has modify/delete permissions on the Eloquence etc configuration directory and files.

The installing user is automatically made a member of this group.

After the installation has finished, it may be necessary to log off and log on again to activate this new group membership and also to activate the modified PATH environment variable.

To add other users to the "Eloquence Administrators" group:

1. Open the Computer Management Console

   From the Start Menu, navigate to:
   Administrative Tools » Computer Management

   Alternatively, enter "compmgmt" into the Start Menu search field, then select the "Computer Management" search result.

2. In the left pane, choose
     Local Users and Groups » Groups

3. In the right pane, locate the "Eloquence Administrators" group and open its properties with a doubleclick. The properties dialog allows to change the group's list of members.

Users added to the "Eloquence Administrators" group may need to log off and log on again to activate this new group membership.

Multiple Eloquence versions on the same system

If multiple Eloquence versions are installed on the same system, the PATH environment variable may contain references to different Eloquence executable directories, where only those appearing first are in effect.

The installation program puts the Eloquence B.08.40 bin directory before any existing executable directory of previous Eloquence versions.

If the 32-bit libraries are installed, the Eloquence B.08.40 x86/bin directory is added right after the bin directory.

As a result, executables of previous Eloquence versions need to be invoked with their full path. The PATH variable needs to be modified if a different behavior is intended.

Summary of changes to previous Eloquence versions

• Installation directory

  Eloquence B.08.40 is installed into the 64-bit Program Files directory at:
  "%ProgramFiles%\Eloquence\8.4"

  Typically this is:
  "C:\Program Files\Eloquence\8.4"

  The installation directory is fixed and cannot be changed.

  If selected, the 32-bit libraries are installed below the x86 subdirectory.

• Registry root key

  The registry root key is located in the 64-bit registry at:
  HKEY_LOCAL_MACHINE\SOFTWARE\Marxmeier\Eloquence\8.4

  If the 32-bit libraries are installed, an equivalent 32-bit registry key is installed at:
  HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Marxmeier\Eloquence\8.4

• Configuration template files

  The new Eloquence B.08.40 configuration template files are installed in the newconfig\config subdirectory.

  Eloquence versions before B.08.30 installed them as .sam files in the etc subdirectory.

• Start menu program group

  The start menu program group is: Eloquence 8.40

  Eloquence versions before B.08.30 installed a version specific subdirectory below the Eloquence program group. However, recent Windows versions no longer support program group subdirectories.

• OpenSSL components

  The required OpenSSL 3.0 libcrypto and libssl libraries are included in the Eloquence B.08.40 installation.

• Obsolete runsrv/dlgsrv components

  Please note that the runsrv32/dlgsrv32 and also the dlgsrv32.dev components are available as separate download at:
  https://eloquence.marxmeier.com/download/unsupported/dlg/