| |
This document contains installation instructions specific to the Windows platform.
Please refer to the "Installation" section in the Eloquence B.08.00 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) Windows systems.
- Windows 2000 or later is required
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.
The Eloquence B.08.00 installation program will automatically detect
and uninstall any Eloquence version previous to Eloquence B.08.00.
Your existing configuration files will be preserved and migrated to
the new installation directory. The existing Eloquence services will
be migrated as well. Please note that this includes any of your own
customized database server instances if present.
To upgrade from a previous Eloquence version it is not recommended to
manually uninstall the previous version, as this would prevent the
Eloquence B.08.00 installation program to migrate the configuration
files and the Eloquence services.
To avoid that a reboot is necessary after installation, please make
sure that no program or library of the previous Eloquence version is
in use. However, you do not need to stop the Eloquence services, as
the installation program automatically stops and restarts them.
To install Eloquence B.08.00, administrative privileges are required.
Recent Windows versions starting with Windows Vista will automatically
request administrative privileges when starting the installation program.
Please check the Eloquence web site for any updates or recommended patches:
http://eloquence.marxmeier.com/support/B0800
In case the installation program complains about a missing or too old
Microsoft Windows Installer, please visit the Eloquence B.08.00 download
directory at: http://eloquence.marxmeier.com/download/B0800/windows/
- On Windows 95, 98 or ME, you may download and install InstMsiA.exe.
- On Windows NT4 or 2000, you may download and install InstMsiW.exe.
In case of Windows NT4, this requires installation of Service Pack 6.
(Please note that Eloquence B.08.00 does no longer support the Windows
versions 95, 98, ME or NT4. The Windows Installer updates for those
platforms are currently provided but may be removed without notice.)
In the Destination Folder dialog you may modify the directory where the
Eloquence software is installed. It is recommended to use the default
directory "Eloquence\8.0" below "Program Files" (or "Program Files (x86)" on
64-bit Windows).
In the Custom Setup dialog, the Eloquence components are grouped into
categories which may be selectively enabled or disabled for installation.
You may later use the installation program or the Add / Remove Programs
control panel to modify the selection at any time.
Except for the deprecated GUI components, all categories and features
are installed 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.
- Server
- This contains the Eloquence application server and database server
along with the server-related utilities and programs.
- 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 or using the "Add / Remove Programs" control panel. 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.00 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.
- 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.
- Deprecated GUI Components
- This contains the deprecated RUNSRV32 and DLGSRV32 programs. Future
Eloquence versions will no longer include these programs. By default,
they are not installed. If necessary, this category must be manually
enabled to install these programs.
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.
- Default installation directory and registry root key
The default installation directory and the registry root key contain
the product version. Starting with Eloquence B.08.00, this will allow
future Eloquence versions to coexist on the same system.
The default installation directory is:
C:\Program Files\Eloquence\8.0
On 64-bit Windows, the default installation directory is:
C:\Program Files (x86)\Eloquence\8.0
The registry root key is:
HKEY_LOCAL_MACHINE\SOFTWARE\Marxmeier\Eloquence\8.0
- Automatic uninstallation and migration of previous Eloquence versions
If the Eloquence B.08.00 installation program detects that an
Eloquence version previous to Eloquence B.08.00 is installed, the
previous Eloquence version is automatically uninstalled and the
previous configuration files and Eloquence services are migrated.
- Database server
The 32-bit database server executable is named "eloqdb32.exe" and the
64-bit database server executable is named "eloqdb64.exe".
The database server executables are installed in the Eloquence bin
directory.
In previous Eloquence versions, the database server executable was
named "eloqdb6.exe" and was installed in C:\Windows\System32.
The database service is named "eloqdb". In previous Eloquence versions
it was named "eloqdb6".
The default database server configuration is named "eloqdb.cfg".
In previous Eloquence versions it was named "eloqdb6.cfg".
When the installation program migrates the database server instance(s)
of a previous Eloquence version to Eloquence B.08.00, it renames the
"eloqdb6" service to "eloqdb" and the default "eloqdb6.cfg" file to
"eloqdb.cfg".
All database server instance(s) are configured to use the 32-bit
database server (on 64-bit Windows, the 64-bit database server may be
used, depending on the "64-bit Database Server" option in the Custom
Setup dialog).
- Database client and utility DLLs
The database client and utility DLLs are installed in the Eloquence
bin directory. In previous Eloquence versions, they were installed
in C:\Windows\System32.
Affected DLLs: eloqdb32.dll image3k.dll image3kC.dll fwutil.dll
On 64-bit Windows, the 64-bit database client and utility DLLs are
installed in the Eloquence bin directory.
Affected 64-bit DLLs: eloqdb64.dll image3k64.dll fwutil64.dll
The related .lib and .def files are installed in the Eloquence lib
directory.
- Deprecated components
The RUNSRV32 and DLGSRV32 programs are deprecated and not installed
by default. Future Eloquence versions will no longer contain these
programs.
- Obsolete components
Starting with Eloquence B.08.00, the components below are obsolete
and no longer part of the Eloquence distribution:
- eqexec32 (rexec client utility)
- eloqcfg (Eloquence configuration utility and control panel)
- dlgsrv32.dev (DLGSRV32 development files)
|
|
