|
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.
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.
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.
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.
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
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.
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.
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.
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.
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:
- 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.
- In the left pane, choose
Local Users and Groups » Groups
- 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.
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.
- 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/
|
