.
contact contact

B.08.40 / Release Notes / Installation

Installation on Windows

 
.
  This document contains installation instructions specific to the Windows platform.

Please refer to the general installation notes in the Eloquence B.08.40 Release Notes for information that is not Windows specific, such as licensing, configuration files and manual procedures when upgrading from previous Eloquence versions.


Supported Windows versions

Eloquence B.08.40 is available for 64-bit (x64) Windows versions. It supports both 32 bit and 64 bit applications on 64 bit systems.

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

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"

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/


 
 
 
  Privacy | Webmaster | Terms of use | Impressum Revision: 2024-05-28  
  Copyright © 1995-2024 Marxmeier Software AG