|
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.
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.
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.
- 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
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.
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.
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
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.
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.
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.
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:
- 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 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.
- 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/
|
