.
contact contact

B.08.20 / 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.20 Release Notes for information that 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) systems.

  • Windows XP, Server 2003 or later is required

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.2" ("Program Files (x86)\Eloquence\8.2" on 64-bit Windows).

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

System requirements

A default Eloquence installation requires disk space as indicated below:

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

64-bit systems (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.

License note

Eloquence B.08.20 requires a license key version B.08.20 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.

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.20 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: http://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.2\etc\gethwid
C:\Program Files\Eloquence\8.2\etc\chklic
64-bit Windows
C:\Program Files (x86)\Eloquence\8.2\etc\gethwid
C:\Program Files (x86)\Eloquence\8.2\etc\chklic

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

Upgrading from Eloquence B.08.10 or B.08.00

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

Migrate Eloquence B.08.10

If selected, the installation program will migrate the existing Eloquence B.08.10 configuration files to Eloquence B.08.20. A backup copy is created if a migrated configuration file already exists in the Eloquence B.08.20 etc configuration directory.

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

Uninstall Eloquence B.08.10

If selected, an existing Eloquence B.08.10 version is uninstalled.

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.00 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.20, administrative privileges are required. Recent 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 directory. The related .lib and .def files are installed in the Eloquence lib directory.

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 directory.

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 (eloqdb32.exe) and the 64-bit database server (eloqdb64.exe) are installed to the Eloquence bin directory. 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.20 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 Eloquence B.08.10
This option is only available if an existing Eloquence B.08.10 is detected on this system.

If selected, the installation program will migrate the existing Eloquence B.08.10 configuration files to Eloquence B.08.20. A backup copy is created if a migrated configuration file already exists in the Eloquence B.08.20 etc configuration directory.

If the "Uninstall" option below is selected in addition, any migrated configuration file is deleted in the Eloquence B.08.10 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 Eloquence B.08.10
This option is only available if an existing Eloquence B.08.10 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 Eloquence B.08.10 version is uninstalled. This option cannot be selected if the "Migrate" option is deselected.

Using database encryption

The Eloquence database encryption feature 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: http://eloquence.marxmeier.com/support/B0810/relnotes/encryption.html

Database encryption is an optional add-on requiring an extra license key. Besides installing this license key, encryption requires that the OpenSSL library is installed. Eloquence was tested against OpenSSL versions 0.9.8o and 1.0.0a available through the OpenSSL for Windows link located at: http://openssl.org/related/binaries.html

You need to install the 32-bit "Win32 OpenSSL Light" version, and also the 64-bit version in addition if the 64-bit database server is used. Moreover, you may need to install the "Visual C++ Redistributables" in case the OpenSSL installation program indicates that these are not yet present on the system.

Accessing Eloquence configuration files

On recent 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 directory was 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 directories, where only the first one is 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 directory 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 directory is 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.2

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

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

    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).

  • Obsolete components

    The components below are obsolete and no longer part of the Eloquence distribution:

    • runsrv32 (run server)
    • dlgsrv32 (dlg server)
    • eqexec32 (rexec client utility)
    • eloqcfg (configuration utility and control panel)
    • dlgsrv32.dev (dlg server development files)

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


 
 
.
 
 
  Privacy | Webmaster | Terms of use | Impressum Revision:  2014-03-04  
  Copyright © 2011 Marxmeier Software AG