.
contact contact

B.08.30 / Release Notes / Installation

Installation on Windows

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

Please refer to the "Installation" section in the Eloquence B.08.30 Release Notes for information which is not Windows specific, such as licensing, configuration files and manual procedures when upgrading from prior Eloquence versions.

Supported Windows versions

Eloquence is available for 32-bit (x86) and 64-bit (x64) Windows.

Required minimum Windows version:

  • Desktop: Windows 7 (July 2016 update rollup, KB3172605)
  • Server: Windows Server 2008 Service Pack 2

32-bit and 64-bit Windows versions are supported. Selected Eloquence components are installed both as 32-bit and 64-bit binaries, such as the database server and the client libraries. On 64-bit Windows the installation program allows to choose between activating the 32-bit or the 64-bit database server.

New installation directory

The default installation directory is "Program Files\Eloquence\8.3" ("Program Files (x86)\Eloquence\8.3" on 64-bit Windows).

Eloquence B.08.30 may coexist with previous Eloquence versions if all installed Eloquence versions use different installation directories.

Installed subdirectories

bin
32-bit binary files and shared libraries
bin64
64-bit binary files and shared libraries
(installed on 64-bit Windows)
dll
Eloquence DLLs
etc
Configuration files
(new Eloquence 8.30 configuration template files are installed in the newconfig\config subdirectory)
html
On-line help and documentation
(installed depending on selected installation categories)
include
C/C++ development header files
(installed depending on selected installation categories)
lbin
eloq.cgi program
(installed depending on selected installation categories)
lib
Related files, 32-bit development library support files
(installed depending on selected installation categories)
lib64
64-bit development library support files
(installed on 64-bit Windows, depending on selected installation categories)
newconfig\config
New Eloquence 8.30 configuration template files
(template files are copied to the etc directory if not present)
share
Additional documentation and support files

System requirements

A default Eloquence installation requires disk space as indicated below:

32-bit Windows (x86)
"C:\Program Files" 20 MB

64-bit Windows (x64)
"C:\Program Files (x86)" 20 MB

Note that on systems running the eloqsd or eloqdb services, the Eloquence software should be installed on a local disk, not on a network drive.

Prerequisites

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

vcredist_x86.exe
Microsoft Visual C++ 2015 Redistributable (x86)
Minimum version: 14.0.24210 (Update 3)
Required on any system where Eloquence B.08.30 is installed.
vcredist_x64.exe
Microsoft Visual C++ 2015 Redistributable (x64)
Minimum version: 14.0.24210 (Update 3)
Required in addition on 64-bit Windows.

Please note that Eloquence B.08.30 no longer requires installation of a 3rd party OpenSSL library. The required OpenSSL components are now included in the Eloquence B.08.30 installation.

License note

Eloquence B.08.30 requires a license key version B.08.30 or above. For a new Eloquence installation or when upgrading from a previous Eloquence version a new license key must be obtained to use the Eloquence server components.

To use the database encryption feature, an additional ENC license key is required. Eloquence database encryption allows to designate fields with sensitive contents for encrypted storage. It helps protecting database volume files, forward logs, as well as dbstore output files against unauthorized access to sensitive data. Please refer to the database encryption documentation for additional details, located on the Eloquence web site at: https://eloquence.marxmeier.com/support/B0810/relnotes/encryption.html

The basic FTS functionality is included in the base product. To use enhanced FTS indexing functionality, an additional FTS or FTC license key is required.

The installation program by default grants a 30 days temporary license if Eloquence B.08.30 is installed for the first time. This option may be disabled in the Custom Setup dialog if a temporary license is not needed.

To request a permanent license key, please use the form included with the delivery or use the license request form on the Eloquence web site at: https://eloquence.marxmeier.com/license/

The Eloquence software id (SWID) necessary to request a license key may be obtained using the gethwid utility. The installed license keys may be verified using the chklic utility.

It is necessary to install Eloquence to use these utilities. They are located in the Eloquence etc installation subdirectory, by default:

32-bit Windows
C:\Program Files\Eloquence\8.3\etc\gethwid
C:\Program Files\Eloquence\8.3\etc\chklic
64-bit Windows
C:\Program Files (x86)\Eloquence\8.3\etc\gethwid
C:\Program Files (x86)\Eloquence\8.3\etc\chklic

Please refer to the Eloquence B.08.30 License Key documentation for additional details, located on the Eloquence web site at: https://eloquence.marxmeier.com/support/B0830/relnotes/license.html

Upgrading from a previous Eloquence B.08.xx

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 of a previous Eloquence B.08.xx version to Eloquence B.08.30.

A backup copy is created if a migrated configuration file already exists in the Eloquence B.08.30 etc configuration directory.

If multiple previous Eloquence B.08.xx versions are present, for example both Eloquence B.08.10 and B.08.20, only the configuration files of 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

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.

Upgrading from Eloquence B.07.10 or older

The installation program unconditionally migrates and uninstalls any existing Eloquence version B.07.10 or older.

Eloquence versions before B.08.00 use shared installation directories such as the Windows System directory, which complicates to make them coexist with other Eloquence versions on the same system.

When migrating an Eloquence version B.07.10 or older, the "eloqdb6" service is renamed to "eloqdb" and the default "eloqdb6.cfg" file is renamed to "eloqdb.cfg".

Please note that if the installation program detects an existing Eloquence B.08.xx along with an Eloquence version B.07.10 or older it assumes that you know what you are doing and does not touch the older Eloquence version.

Installation instructions

To install Eloquence B.08.30, administrative privileges are required. Windows versions starting with Windows Vista will automatically request administrative privileges.

In the Destination Folder dialog the default installation directory may be confirmed or modified.

In the Custom Setup dialog, the Eloquence component categories may be selectively enabled or disabled for installation.

You may later use the installation program in Modify maintenance mode to modify the selection at any time.

All categories and features are selected by default.

Client Runtime Environment
This contains the components necessary to start and run applications written in the Eloquence programming language.

Client Developer Tools
This contains the components necessary to develop applications using the Eloquence programming language.

Client Database Tools
This contains the database client programs and utilities.

Client Database Library
This contains the database client library, including the TurboIMAGE compatibility extension (Image3K) and the Query3K program.

The database client and utility DLLs are installed in the Eloquence bin and bin64 directories. The related .lib and .def files are installed in the Eloquence lib and lib64 directories.

Server
This contains the Eloquence application server and database server along with the server related utilities and programs.

The server executables are installed in the Eloquence bin and bin64 directories.

64 Bit Database Server
This option is only available on 64-bit Windows. It allows to select whether the 64-bit or the 32-bit database service is installed.

Please note that on Windows 64-bit, both the 32-bit database server (bin\eloqdb32.exe) and the 64-bit database server (bin64\eloqdb64.exe) are installed. However, depending on the selection here, either the eloqdb64.exe or the eloqdb32.exe are used to register the Windows service(s) for your database server instance(s).

You may later modify this selection by starting the installation program in Modify maintenance mode. This will cause your database server instance(s) to be stopped and restarted with either the 64-bit or the 32-bit database server executable.

Server Temporary License
This option is only available if an Eloquence B.08.30 temporary license was not yet installed on this system. If selected, a 30 days temporary license is granted. This includes the TurboIMAGE compatibility option. The generated temporary license keys are added to the license file located in the Eloquence etc directory.

As long as the temporary license was not yet installed on the system you may later choose to install it by starting the installation program in Modify maintenance mode.

On-line Documentation
This contains the on-line documentation in HTML format. This also includes the on-line help used by the Eloquence IDE program and the EqStart utility.

Migrate previous Eloquence
This option is only available if an existing previous Eloquence B.08.xx version is detected on this system.

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

A backup copy is created if a migrated configuration file already exists in the Eloquence B.08.30 etc configuration directory.

If multiple previous Eloquence B.08.xx versions are present, for example both Eloquence B.08.10 and B.08.20, only the configuration files of 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.

If you don't select the "Uninstall" option below, you may later use the "Migrate" option by starting the installation program in Modify maintenance mode. In this case, this option is not selected by default but must be manually enabled.

Uninstall previous Eloquence
This option is only available if an existing previous Eloquence B.08.xx version is detected on this system and if this is the initial installation (i.e., this option is not available in Modify maintenance mode).

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

On Windows versions starting with Windows Vista, 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 where the Eloquence bin and bin64 directories were added.

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

  1. Open the Computer Management Console

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

    Alternatively, from the Start Menu, open:
      All Programs » Accessories » Run
    Then enter "compmgmt.msc" and click OK.

  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 bin and bin64 directories, where only those appearing first are in effect.

This may affect Eloquence command line utilities and shared libraries if these are invoked without qualifying the path to the binary file.

The installation program appends the Eloquence bin and bin64 directories to the PATH variable. If multiple Eloquence versions are installed, it might be necessary to review the PATH variable to make sure the desired Eloquence bin and bin64 directories are in effect.

Summary of changes to previous Eloquence versions

  • Default installation directory and registry root key

    On 32-bit Windows, the default installation directory is:
    C:\Program Files\Eloquence\8.3

    On 64-bit Windows, the default installation directory is:
    C:\Program Files (x86)\Eloquence\8.3

    The registry root key is:
    HKEY_LOCAL_MACHINE\SOFTWARE\Marxmeier\Eloquence\8.3

    Please note that on 64-bit Windows this key is located in the 32-bit registry. The 64-bit Windows registry editor displays the key below HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node (there is a 32-bit registry editor available in addition, by default C:\WINDOWS\SysWOW64\regedit.exe, which displays the key in its usual location).

  • Configuration template files

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

    Previous Eloquence versions installed them as .sam files in the etc subdirectory.

  • Start menu program group

    The start menu program group is: Eloquence 8.30

    Previous Eloquence versions installed a version specific subdirectory below the Eloquence program group. However, starting with Windows 8, program group subdirectories are no longer supported.

  • 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: 2018-09-14  
  Copyright © 1995-2018 Marxmeier Software AG